Communitygithub.com

MMEHDI0606/ai-agent-foundation-template

擅長建立真正能獲得工作與客戶的作品集——不單展示作品,而是創造令人難忘的體驗。涵蓋開發者、設計師、創意類別,以及能將訪客轉化為機會的作品集。

ai-agent-foundation-template 是什麼?

此技能旨在協助開發者、設計師與創意工作者打造高效的作品集網站,其核心目標是將訪客轉化為工作機會或客戶。技能涵蓋從作品集架構規劃、專案展示設計、互動元素添加,到個人品牌塑造與轉換率優化的完整流程。它特別強調「30 秒測試」——在短時間內讓招募人員清楚知道你是誰、做什麼、最佳作品與聯絡方式。技能支援多種平台(如 Claude Code、Cursor、Codex)並提供具體的實作範本,包括英雄區塊公式、專案卡片元素、案例研究結構等。此外,它還包含了常見問題的診斷與修復建議,例如行動裝置相容性、缺乏明確的行動呼籲(CTA)、作品過時等,幫助使用者避免常見錯誤,快速打造出行動優先、轉換率高且令人印象深刻的作品集。

相容平台~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 秒發揮最大價值。你幫助人們脫穎而出,但不流於花俏。

專業領域

  • 作品集使用者體驗
  • 專案呈現
  • 個人品牌經營
  • 轉換率最佳化
  • 創意編碼
  • 令人難忘的體驗

能力

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

模式

作品集架構

適用於作品集的結構

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

作品集架構

30 秒測試

在 30 秒內,訪客應得知:

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

必要區段

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

導覽模式

選項 1:單頁滾動
- 最適合:設計師、創意工作者
- 動畫效果佳
- 行動裝置友好

選項 2:多頁面
- 最適合:專案數量多
- 個別案例研究頁面
- SEO 較佳

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

英雄區塊公式

[你的名字]
[一行簡述你的工作]
[一行描述你的差異化]\n[行動呼籲:查看作品 / 聯絡我]

專案展示

如何有效呈現作品

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

專案展示

專案卡片元素

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

案例研究結構

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

呈現影響力

與其寫不如寫
"建置了一個網站""提升轉換率 40%"
"設計了 UI""減少使用者流失 25%"
"開發了功能""服務 5 萬名使用者"

視覺呈現

  • 網頁/行動裝置模型圖
  • 前後比較
  • 流程產出物(線框圖等)
  • 複雜作品的影片解說
  • 懸停效果增加互動

開發者作品集要點

適用於開發者作品集

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

開發者作品集

招募人員關注的重點

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

必備項目

  • GitHub 個人檔案連結(已整理乾淨)
  • 線上專案連結
  • 每個專案的技術棧
  • 你的具體貢獻(團隊專案)

專案選擇

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

技術展示

// 展示能呈現下列特質的程式碼片段:
- 清晰的架構決策
- 效能最佳化
- 巧妙解法
- 測試方法

部落格/文章

  • 技術深度探討
  • 問題解決故事
  • 學習歷程
  • 展現溝通能力

作品集互動性

加入令人難忘的互動元素

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

作品集互動性

互動程度

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

高影響力、低風險

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

創意點子

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

平衡之道

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

尖銳邊緣

作品集比實際作品還複雜

嚴重程度:中

情況:花了 6 個月做作品集,卻只有 2 個專案可展示

症狀:

  • 已經「弄作品集」好幾個月
  • 對作品集的熱情高於專案本身
  • 作品集的技術比實際作品更令人印象深刻
  • 害怕上線

為何會出問題: 以工作為名行拖延之實。 作品集本身是一個專案,但不是最重要的那個。 打磨的邊際效益遞減。 先發佈再迭代。

建議修正:

為作品集瘦身

MVP 作品集

元素MVP 版本
英雄區姓名 + 職稱 + 一句話
專案3-4 個最佳作品
關於我2-3 段落
聯絡Email + LinkedIn

時間預算

第 1 週:設計與架構
第 2 週:建置核心頁面
第 3 週:加入 3-4 個專案
第 4 週:打磨與上線

事實真相

  • 你的作品集不是你最棒的專案
  • 上線勝過完美
  • 永遠可以迭代
  • 更好的專案 > 更好的作品集

何時該停手

  • 核心頁面在行動裝置上正常運作
  • 已展示 3-4 個紮實的專案
  • 聯絡表單可正常提交
  • 載入時間少於 3 秒
  • 發佈它。

作品集桌機版漂亮,行動版卻一團糟

嚴重程度:高

情況:招募人員用手機瀏覽,所有東西都亂掉

症狀:

  • 在瀏覽器 DevTools 中看起來很棒
  • 在真實手機上卻壞掉
  • 文字太小
  • 按鈕難以點擊
  • 導覽選單被隱藏

為何會出問題: 以桌機版為優先開發。 未在真實裝置上測試。 複雜的互動無法完整對應。 忘記了拇指熱區。

建議修正:

行動優先作品集

行動裝置現實

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

行動裝置必備

  • 不需縮放即可閱讀
  • 可點擊的連結(至少 44px)
  • 導覽功能正常
  • 專案載入迅速
  • 聯絡資訊容易找到

測試清單

[ ] iPhone Safari
[ ] Android Chrome
[ ] 平板尺寸
[ ] 慢速 3G 模擬
[ ] 真實裝置(不只是 DevTools)

優雅降級

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

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

嚴重程度:中

情況:作品集很棒,卻沒人聯絡你

症狀:

  • 瀏覽量高,但無人聯絡
  • 大家不知道你正在接案
  • 聯絡頁面被當作次要
  • 沒有明確的要求

為何會出問題: 沒有清楚的行動呼籲。 聯絡資訊藏在最底下。 多個互相競爭的行動選項。 預設訪客會自己找到方法。

建議修正:

作品集行動呼籲

主要行動呼籲

目標行動呼籲
找工作"一起合作吧"
接案"開始一個專案"
拓展人脈"打聲招呼"
特定職位"僱用我擔任 [職位]"

行動呼籲擺放位置

英雄區:主要行動呼籲
專案之後:次要行動呼籲
頁尾:最終行動呼籲
浮動:可選的常駐行動呼籲

讓聯絡變簡單

  • Email 連結 (mailto:)
  • LinkedIn(開新分頁)
  • 預約連結(Calendly)
  • 簡單的聯絡表單
  • 複製 Email 按鈕

應避免的事

  • 只有聯絡表單(使用者不喜歡表單)
  • 隱藏聯絡資訊
  • 太多選項
  • 模糊的行動呼籲("了解更多")

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

嚴重程度:中

情況:最棒的作品已是 3 年前,較新的作品卻沒放上去

症狀:

  • 2024 年還放 jQuery 專案
  • 這是我大學時做的
  • 技術棧不符合目標職缺
  • 超過 2 年沒更新作品集

為何會出問題: 多年未更新。 較新的作品「還沒準備好」。 捨不得移除舊愛。 作品集逐漸偏離目標。

建議修正:

作品集新鮮度

更新頻率

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

專案修剪

保留條件:

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

移除條件:

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

展現成長

  • 最新作品放最前面
  • 為專案標註日期(或選擇不標)
  • 若有脈絡則可展現演變過程
  • 以封存代替刪除

驗證檢查

無明確聯絡行動呼籲

嚴重程度:高

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

修正動作:在英雄區及專案區段後加入顯眼的聯絡行動呼籲

缺少行動裝置 viewport

嚴重程度:高

訊息:作品集可能不具備行動裝置響應式設計。

修正動作:加入

未最佳化的作品集圖片

嚴重程度:中

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

修正動作:使用 WebP 格式、實作懶載入、加入 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.

相關技能