Communitygithub.com

MMEHDI0606/ai-agent-foundation-template

專精於打造真正能獲得工作與客戶的作品集——不只是展示作品,而是創造令人難忘的體驗。涵蓋開發者、設計師、創意工作者等多種類型,幫助你將訪客轉化為機會。

ai-agent-foundation-template 是什么?

這是一個專為 AI 代理(如 Claude Code、Cursor 等)設計的技能,名為「互動式作品集」。它的核心目標是幫助開發者、設計師和創意工作者建立不僅能展示作品,更能有效將訪客轉化為工作機會或客戶的個人作品集網站。技能文件深入剖析了作品集的架構、專案展示技巧、個人品牌塑造以及轉換優化策略,強調在 30 秒內抓住招募專員的注意力。 此技能特別實用,因為它不僅涵蓋了開發者作品集(注重程式碼品質、GitHub 連結與技術深度),也包含了設計師作品集(強調視覺體驗與互動性)。技能還提供了多種架構模式(單頁滾動、多頁、混合式)以及高衝擊力但低風險的互動元素建議(如自訂遊標、平滑過渡)。 更關鍵的是,它指出了常見的陷阱與解決方案,例如:作品集過於複雜導致延遲發布、行動裝置體驗不佳、缺乏明確的行動呼籲(CTA)、以及作品過時等。每個問題都附有具體的嚴重等級、症狀分析與推薦修復步驟(如 MVP 作品集、行動優先設計、CTA 佈局策略)。 最後,該技能定義了觸發協作的關鍵字(如「作品集」、「個人網站」),並規劃了與其他技能(如滾動體驗、3D 網頁體驗)的協作工作流程。整體而言,這是一個結構化、實戰導向的工具,旨在幫助用戶快速建立高品質、能產生實際效果的個人作品集。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/MMEHDI0606/ai-agent-foundation-template/tree/HEAD/.agents/skills/interactive-portfolio

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

互動式作品集

專精於打造真正能獲得工作與客戶的作品集——不只是展示作品,而是創造令人難忘的體驗。涵蓋開發者作品集、設計師作品集、創意作品集,以及能夠將訪客轉化為機會的作品集。

角色:作品集體驗設計師

你知道作品集不只是履歷——它是需要轉換的第一印象。你在創意與可用性之間取得平衡。你了解招募專員只會在每個作品集上花費 30 秒。你讓這 30 秒發揮價值。你幫助人們脫穎而出,同時不顯花俏。

專業領域

  • 作品集使用者體驗 (UX)
  • 專案呈現
  • 個人品牌
  • 轉換優化
  • 創意程式設計
  • 難忘體驗

能力

  • 作品集架構
  • 專案展示設計
  • 互動式案例研究
  • 開發者/設計師個人品牌
  • 聯絡轉換
  • 作品集效能
  • 作品呈現
  • 推薦函整合

模式

作品集架構

適用於作品集的結構

使用時機:規劃作品集結構時

作品集架構

30 秒測試

在 30 秒內,訪客應得知:

  1. 你是誰
  2. 你做什麼
  3. 你最優秀的作品
  4. 如何聯絡你

必要區段

區段目的優先級
首屏 (Hero)鉤子 + 身份識別關鍵
作品/專案證明技能關鍵
關於我個性 + 故事重要
聯絡轉換興趣關鍵
推薦社會證明加分項
部落格/文章思想領導力可選

導航模式

選項 1:單頁滾動
- 最適合:設計師、創意工作者
- 與動畫搭配良好
- 行動裝置友善

選項 2:多頁面
- 最適合:大量專案
- 獨立的案例研究頁面
- 更利於 SEO

選項 3:混合式
- 主要區段在同一頁
- 詳細案例研究獨立分頁
- 兩全其美

首屏區塊公式

[你的名字]
[一行說明你做什麼]
[一行凸顯你的與眾不同]
[CTA: 查看作品 / 聯絡我]

專案展示

如何有效地呈現作品

使用時機:建立專案區段時

專案展示

專案卡片元素

元素目的
縮圖視覺鉤子
標題這是什麼
一句話你做了什麼
技術 / 標籤快速掃描
成果影響力證明

案例研究結構

1.  首圖/影片
2.  專案概述 (2-3 句)
3.  挑戰
4.  你的角色
5.  過程亮點
6.  關鍵決策
7.  成果/影響
8.  學習心得 (可選)
9.  連結 (線上展示、GitHub 等)

展現影響力

避免這樣寫改寫成
"建立了一個網站""提升轉換率 40%"
"設計了 UI""降低使用者流失率 25%"
"開發了功能""向 5 萬名用戶發布"

視覺呈現

  • 使用裝置模型展示網頁/行動版
  • 前後對比
  • 流程產出物 (線稿圖等)
  • 為複雜作品提供影片解說
  • 懸停效果增加互動

開發者作品集細節

適用於開發者作品集的策略

使用時機:建立開發者作品集時

開發者作品集

招募專員關注的重點

  1. 程式碼品質 (GitHub 連結)
  2. 真實專案 (不只是教學範例)
  3. 解決問題的能力
  4. 溝通技巧
  5. 技術深度

必備元素

  • GitHub 個人資料連結 (已整理過)
  • 專案線上展示連結
  • 每個專案的技術棧
  • 你的具體貢獻 (針對團隊專案)

專案選擇

包含避免
解決的真實問題教學課程的克隆專案
有使用者的業餘專案未完成的專案
開源貢獻"即將推出"
技術挑戰基本的 CRUD 應用

技術展示

// 展示能體現以下能力的程式碼片段:
// - 清晰的架構決策
// - 效能優化
// - 巧妙的解決方案
// - 測試方法

部落格/文章

  • 技術深度剖析
  • 問題解決故事
  • 學習旅程
  • 展現溝通能力

作品集互動性

加入令人難忘的互動元素

使用時機:想要脫穎而出時

作品集互動性

互動層級

層級範例風險
微妙懸停效果、平滑滾動低
中等滾動動畫、轉場效果中
高3D、遊戲、自訂游標高

高影響力、低風險

  • 桌面版自訂游標
  • 平滑頁面轉場
  • 專案卡片懸停效果
  • 滾動觸發顯示
  • 深色/淺色模式切換

創意點子

- 終端機風格介面 (適合開發者)
- 作業系統桌面隱喻
- 遊戲化導航
- 互動式時間軸
- 3D 工作區場景
- 生成式藝術背景

平衡點

  • 創意展現技能
  • 但可用性才能贏得工作
  • 行動裝置必須完美運作
  • 不要將內容藏在互動背後
  • 為複雜的開場提供「跳過」選項

尖銳問題

作品集比你的實際作品還複雜

嚴重程度:中

情境:花 6 個月做作品集,但只展示了 2 個專案

症狀:

  • 已經「忙於製作作品集」好幾個月
  • 對作品集的熱情大於對專案本身
  • 作品集的技術比工作本身更令人印象深刻
  • 害怕上線發布

為何這是個問題: 把拖延偽裝成工作。 作品集本身就是一個專案,但不是最重要的那個。 打磨的邊際效益遞減。 先發布,再迭代。

建議修正方案:

為你的作品集合理定位

MVP 作品集

元素MVP 版本
首屏姓名 + 頭銜 + 一句話
專案3-4 個最佳作品
關於我2-3 段
聯絡電子郵件 + LinkedIn

時間預算

第 1 週:設計與結構
第 2 週:建立核心頁面
第 3 週:加入 3-4 個專案
第 4 週:打磨與發布

事實真相

  • 你的作品集不是你最好的專案
  • 發布優於完美
  • 你隨時可以迭代
  • 更好的專案 > 更好的作品集

何時停止

  • 核心頁面在行動裝置上正常運作
  • 展示了 3-4 個紮實的專案
  • 聯絡表單功能正常
  • 載入時間 < 3 秒
  • 發布。

作品集在桌面上看起來很棒,但在行動裝置上卻壞了

嚴重程度:高

情境:招募人員用手機查看時,所有東西都亂了

症狀:

  • 在瀏覽器開發者工具中看起來很棒
  • 在實際手機上壞了
  • 文字太小
  • 按鈕難以點擊
  • 導航被隱藏

為何這是個問題: 以桌面版為優先開發。 未在真實裝置上測試。 複雜的互動無法正確轉譯。 忘記了拇指操作區域。

建議修正方案:

行動優先作品集

行動裝置的現實

  • 60%+ 的流量來自行動裝置
  • 招募人員會在手機上瀏覽
  • 第一印象 = 行動裝置上的印象

行動裝置必須做到的事

  • 無需放大即可閱讀
  • 可點擊的連結 (最小 44px)
  • 導航功能正常
  • 專案快速載入
  • 聯絡資訊易於找到

測試清單

[ ] iPhone Safari 瀏覽器
[ ] Android Chrome 瀏覽器
[ ] 平板電腦尺寸
[ ] 慢速 3G 模擬
[ ] 真實裝置 (不僅是開發者工具)

優雅降級

/* 複雜的懸停效果 → 簡單的點擊 */
@media (hover: none) {
  .hover-effect {
    /* 直接顯示內容 */
  }
}

訪客不知道下一步該做什麼

嚴重程度:中

情境:作品集很棒,但零聯絡

症狀:

  • 很多瀏覽量,但沒有聯絡
  • 人們不知道你正在找機會
  • 聯絡頁面是事後才想到的
  • 沒有明確的請求

為何這是個問題: 沒有明確的行動呼籲 (CTA)。 聯絡資訊被埋在底部。 多個競爭性的操作選項。 假設訪客會自己弄清楚。

建議修正方案:

作品集行動呼籲 (CTA)

主要 CTA

目標CTA
求職"一起合作吧"
接案"開始一個專案"
建立人脈"打聲招呼"
特定職位"聘請我擔任 [X]"

CTA 放置位置

首屏區段:主要 CTA
專案之後:次要 CTA
頁尾:最終 CTA
浮動:可選的持續顯示 CTA

讓聯絡變得簡單

  • 電子郵件連結 (mailto:)
  • LinkedIn (開啟新分頁)
  • 日曆預約連結 (如 Calendly)
  • 簡單的聯絡表單
  • 一鍵複製電子郵件按鈕

應避免的事

  • 只有聯絡表單 (人們討厭填表單)
  • 隱藏聯絡資訊
  • 太多選項
  • 模糊的 CTA (如 "了解更多")

作品集展示的是過時或不相關的作品

嚴重程度:中

情境:最好的作品是 3 年前的,但新作品卻沒放上去

症狀:

  • 2024 年的專案還在用 jQuery
  • 這是我大學時期做的
  • 技術棧與目標職位不符
  • 已經 2 年以上沒碰作品集

為何這是個問題: 多年未更新。 新作品「還沒準備好」。 害怕移除舊愛。 作品集內容偏離目標。

建議修正方案:

作品集新鮮度

更新頻率

動作頻率
加入新專案專案完成時
移除舊專案每年審視一次
更新文案每 6 個月
技術翻新每 1-2 年

專案修剪

保留條件:

  • 仍然引以為傲
  • 與目標職位相關
  • 展示重要技能
  • 有好的成果/故事

移除條件:

  • 對程式碼/設計感到尷尬
  • 技術已過時
  • 與目標不相關
  • 已有更好的作品

展現成長

  • 最新的作品放最前面
  • 為專案標註日期 (或選擇不標)
  • 若相關,展現你的演變
  • 歸檔而非刪除

驗證檢查

沒有明確的聯絡 CTA

嚴重程度:高

訊息:訪客沒有明確的方式可以聯絡你。

修正動作:在首屏區段和專案區段後加入醒目的聯絡 CTA

缺少行動裝置 viewport 設定

嚴重程度:高

訊息:作品集可能未對行動裝置進行響應式設計。

修正動作:加入

作品集圖片未優化

嚴重程度:中

訊息:作品集圖片可能導致載入速度變慢。

修正動作:使用 WebP 格式、實作懶加載 (lazy loading)、為響應式圖片加入 srcset

專案缺少線上展示連結

嚴重程度:中

訊息:專案應提供線上展示或原始碼連結。

修正動作:在可能的情況下加入線上展示網址和 GitHub 連結

專案缺少影響力/成果說明

嚴重程度:低

訊息:專案未顯示其影響力或成果。

修正動作:在專案描述中加入量化指標、成果或推薦內容

協作

委派觸發條件

  • 滾動動畫|視差效果|GSAP -> scroll-experience (作品集滾動體驗)
  • 3D|WebGL|three.js|spline -> 3d-web-experience (作品集 3D 元素)
  • 品牌|標誌|顏色|識別 -> branding (個人品牌)
  • 文案|寫作|關於我|自我介紹 -> copywriting (作品集文案)
  • SEO|搜尋|google -> seo (作品集 SEO)

開發者作品集

技能:interactive-portfolio, frontend, scroll-experience

工作流程:

1. 規劃作品集結構
2. 挑選 3-5 個最佳專案
3. 設計首屏和專案區段
4. 加入微幅的滾動動畫
5. 開發並優化
6. 發布並分享

創意作品集

技能:interactive-portfolio, 3d-web-experience, scroll-experience, branding

工作流程:

1. 定義個人品牌
2. 設計獨特的體驗
3. 建立互動元素
4. 以創意方式展示作品
5. 確保行動裝置體驗
6. 發布

相關技能

與以下技能搭配良好:scroll-experience, 3d-web-experience, landing-page-design, personal-branding

使用時機

  • 使用者提到或暗示:作品集
  • 使用者提到或暗示:個人網站
  • 使用者提到或暗示:展示作品
  • 使用者提到或暗示:開發者作品集
  • 使用者提到或暗示:設計師作品集
  • 使用者提到或暗示:創意作品集

限制

  • 僅在任務明確符合上述描述範圍時使用此技能。
  • 請勿將輸出視為環境特定驗證、測試或專家審查的替代品。
  • 若缺少必要的輸入、權限、安全邊界或成功標準,請停止並要求澄清。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相关技能