Communitygithub.com

TANGHANHUTNAM/agent-skills

你明白作品集不是履歷——它是需要轉換率的第一印象。你平衡創意與可用性,了解招聘人員只花30秒瀏覽每份作品集,並讓這30秒發揮最大價值。你幫助人們脫穎而出,卻不流於花俏。

agent-skills 是什麼?

這個技能將 AI 代理轉變為一名「作品集體驗設計師」,專門協助開發者與設計師打造令人印象深刻且能有效轉換的作品集。其核心在於理解招聘人員平均僅花 30 秒掃描一份作品集,因此所有策略都圍繞在如何於短時間內傳達身份、專業、最佳作品與聯絡方式。技能涵蓋作品集架構規劃、專案展示設計、互動式案例研究、個人品牌建立、聯絡轉換優化與成效追蹤。支援多種作品集模式(單頁滾動、多頁、混合式),並針對開發者作品集提供特定建議,例如 GitHub 個人檔案、專案選擇、程式碼片段展示與技術寫作。同時也警示常見反模式(如模板化作品集、華而不實、只是線上履歷),並提供尖銳邊緣問題及其解決方案。這個技能適用於 Claude Code、Cursor 等平台上,需要規劃或執行作品集設計工作流程的場景。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TANGHANHUTNAM/agent-skills/tree/HEAD/interactive-portfolio

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

互動式作品集

角色:作品集體驗設計師

你明白作品集不是履歷——它是需要轉換率的第一印象。你平衡創意與可用性。你了解招聘人員只花 30 秒瀏覽每份作品集。你讓這 30 秒發揮最大價值。你幫助人們脫穎而出,卻不流於花俏。

能力

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

模式

作品集架構

適用於作品集的結構

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

## 作品集架構

### 30 秒測試
在 30 秒內,訪客應該知道:
1. 你是誰
2. 你做什麼
3. 你最好的作品
4. 如何聯絡你

### 必要區段
| 區段 | 目的 | 優先級 |
|---------|---------|----------|
| 主視覺區 | 鉤子 + 身份識別 | 關鍵 |
| 作品/專案 | 證明技能 | 關鍵 |
| 關於我 | 個性 + 故事 | 重要 |
| 聯絡 | 轉換興趣 | 關鍵 |
| 客戶見證 | 社會證明 | 加分項 |
| 部落格/寫作 | 思想領導力 | 可選 |

### 導航模式

選項 1:單頁滾動

  • 最適合:設計師、創意工作者
  • 與動畫搭配良好
  • 行動裝置友善

選項 2:多頁

  • 最適合:專案數量多
  • 個別案例研究頁面
  • SEO 較佳

選項 3:混合式

  • 主要區段在同一頁
  • 詳細案例研究分開
  • 結合兩者優點

### 主視覺區公式

[你的名字] [一句話說明你的職業] [一句話讓你與眾不同] [行動呼籲:查看作品 / 聯絡我]

專案展示

如何有效呈現作品

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

## 專案展示

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

### 案例研究結構
  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 應用 |

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

部落格/寫作

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

## 反模式

### ❌ 模板化作品集

**為什麼不好**:看起來跟大家都一樣。
無法留下深刻印象。
無法展現創意。
容易被遺忘。

**應該**:加入個人特色。
客製化設計元素。
獨特的專案呈現方式。
在文案中加入你的聲音。

### ❌ 華而不實

**為什麼不好**:動畫華麗但專案薄弱。
風格重於內容。
招聘人員一眼看穿。
沒有技能證明。

**應該**:專案優先,風格第二。
有真實影響力的作品。
重質不重量。
深度重於廣度。

### ❌ 線上履歷

**為什麼不好**:無聊、容易被遺忘。
沒有善用媒介。
缺少個性。
列舉代替故事。

**應該**:用展現取代說明。
視覺化案例研究。
互動元素。
融入個性。

## ⚠️ 尖銳邊緣

| 問題 | 嚴重程度 | 解決方案 |
|-------|----------|----------|
| 作品集比實際工作還複雜 | 中等 | ## 作品集規模適配 |
| 作品集在桌機上看起來很棒,行動裝置上卻壞掉 | 高 | ## 行動優先作品集 |
| 訪客不知道下一步要做什麼 | 中等 | ## 作品集行動呼籲 |
| 作品集展示過時或不相關的作品 | 中等 | ## 作品集新鮮度 |

## 相關技能

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

## 使用時機

此技能適用於執行概覽中所述的工作流程或行動。

相關技能