Communitygithub.com

administrakt0r/AI-Agents-Safe-Coding-Skills

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

AI-Agents-Safe-Coding-Skills 是什麼?

這項技能將 AI 代理化身為「作品集體驗設計師」,專注於打造高轉換率的互動式作品集。它強調作品集是求職的第一印象,而非單純的履歷清單,因此核心目標是讓瀏覽者在30秒內快速掌握「你是誰、做什麼、最佳作品、如何聯絡」。技能涵蓋作品集架構規劃、專案展示設計、互動案例研究、開發者作品集最佳化,以及聯絡轉換等能力。支援單頁滾動、多頁與混合式導覽模式,並提供英雄區塊公式、專案卡片元素、案例研究結構等實用模板。此外,它明確指出「模板化作品集」、「華而不實」與「履歷網站」等反模式,並警告作品集過於複雜、行動裝置斷裂、缺乏明確行動呼籲等常見問題。這項技能適用於 cursor、claude-code、codex、aider 等開發工具平台,並可與 scroll-experience、3d-web-experience、landing-page-design、personal-branding 等技能搭配使用。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/administrakt0r/AI-Agents-Safe-Coding-Skills/tree/HEAD/plugins/AI-Agents-Safe-Coding-Skills-claude/skills/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 萬名用戶」|

### 視覺呈現
- 網頁/行動裝置的裝置 mockup
- 前後對比
- 流程產出物(線框圖等)
- 複雜作品的影片解說
- 懸停效果增加互動

開發者作品集特定事項

適合開發者作品集的作法

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

## 開發者作品集

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

### 必備項目
- GitHub 個人檔案連結(整理乾淨)
- 上線專案連結
- 每個專案的技術棧
- 你的具體貢獻(團隊專案)

### 專案選擇
| 包含 | 避免 |
|---------|-------|
| 解決的真實問題 | 教學範本複製品 |
| 有使用者的 side project | 未完成專案 |
| 開源貢獻 |「即將推出」|
| 技術挑戰 | 基本 CRUD 應用 |

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

部落格/寫作

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

## 反模式

### ❌ 模板化作品集

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

**改進方式**:加入個人特色。
自訂設計元素。
獨特的專案呈現方式。
在你的文案中注入個人風格。

### ❌ 華而不實

**為什麼不好**:華麗動畫,但專案內容薄弱。
風格重於實質。
面試官一眼看穿。
沒有技能證明。

**改進方式**:專案優先,風格其次。
真正有影響力的實作。
重質不重量。
深度勝於廣度。

### ❌ 履歷網站

**為什麼不好**:無聊、易忘。
沒有善用媒介特性。
缺乏個性。
列舉而非說故事。

**改進方式**:呈現,而非告知。
視覺化案例研究。
互動元素。
從頭到尾展現個人風格。

## ⚠️ 尖銳邊緣

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

## 相關技能

與以下技能搭配使用效果佳:`scroll-experience`、`3d-web-experience`、`landing-page-design`、`personal-branding`

## 使用時機
此技能適用於執行概述中所述的工作流程或操作。

Individual skills in this repo

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

相關技能