Agent Skills 是什麼？
Agent Skills 是由 Addy Osmani（Google Chrome 團隊資深工程師，Web 效能領域知名專家）建立的一個開源框架，旨在為 AI 程式設計助手（如 Claude Code、Cursor、Windsurf 等）提供生產級的工程技能和最佳實踐。
簡單來說，Agent Skills 將資深軟體工程師在開發過程中使用的工作流程、品質門禁和最佳實踐編碼成可重複使用的技能包，讓 AI Agent 能夠像經驗豐富的工程師一樣，在每個開發階段都保持一致的高標準。
為什麼需要 Agent Skills？
當前 AI 程式設計助手（Claude Code、Codex、Gemini CLI 等）雖然能產生程式碼，但往往缺乏系統性的工程思維：
- ❌ 直接寫程式碼，不先寫規格說明（Spec）
- ❌ 一次實作太多功能，任務粒度過大
- ❌ 缺少測試驅動開發的意識
- ❌ 程式碼審查流於形式
- ❌ 部署前沒有充分驗證
Agent Skills 透過 7 個 Slash 命令對應完整的開發生命週期，每個命令會自動啟用對應的技能模組：
| 你在做什麼 | 命令 | 核心原則 |
|---|---|---|
| 定義要建構什麼 | /spec |
先寫規格，再寫程式碼 |
| 規劃如何建構 | /plan |
小而原子的任務 |
| 增量式建構 | /build |
一次一個切片 |
| 證明它有效 | /test |
測試即證明 |
| 合併前審查 | /review |
提升程式碼健康度 |
| 簡化程式碼 | /code-simplify |
清晰勝於聰明 |
| 部署到生產環境 | /ship |
更快更安全 |
專案亮點
- 🚀 GitHub 38,971+ stars，社群活躍度高
- 🔧 支援多個 AI 平台：Claude Code、Cursor、Windsurf、OpenClaw 等
- 📦 模組化設計：每個技能獨立封裝，可按需啟用
- 🎯 自動化觸發：根據上下文自動啟用相關技能（如設計 API 時自動觸發
api-and-interface-design） - 🆓 完全開源免費：MIT 授權條款
安裝 Agent Skills
前置條件
- 已安裝 Claude Code 或其他支援的 AI 程式設計助手
- GitHub 帳號（用於 Marketplace 安裝）
方法一：透過 Claude Code Marketplace 安裝（推薦）
# 新增外掛
/plugin marketplace add addyosmani/agent-skills
# 安裝
/plugin install agent-skills@addy-agent-skills
如果遇到 SSH 錯誤（Marketplace 預設透過 SSH 複製儲存庫），可以改用 HTTPS URL：
/plugin marketplace add https://github.com/addyosmani/agent-skills.git
/plugin install agent-skills@addy-agent-skills
方法二：本機安裝（適合開發者除錯）
# 複製儲存庫
git clone https://github.com/addyosmani/agent-skills.git
# 指定外掛目錄啟動 Claude Code
claude --plugin-dir /path/to/agent-skills
方法三：Cursor 使用者
對於 Cursor 編輯器使用者，可以將任意 SKILL.md 檔案複製到 .cursor/rules/ 目錄下：
# 複製所有技能檔案
cp -r agent-skills/skills/* ~/.cursor/rules/
或者在 Cursor 設定中引用遠端儲存庫。
方法四：其他 AI 助手
Agent Skills 的核心是 Markdown 格式的技能描述檔案（SKILL.md），理論上任何支援自訂規則的 AI 程式設計助手都可以使用：
- Windsurf：將 SKILL.md 放入
.windsurfrules/ - OpenClaw：參考專案的
skills/目錄結構 - 自定義 Agent：解析 SKILL.md 並注入到 system prompt 中
核心功能實戰
1. /spec — 先寫規格，再寫程式碼
這是 Agent Skills 最重要的理念之一：在寫任何程式碼之前，先明確你要建構什麼。
使用方法：
/spec 我想建構一個 REST API，支援使用者註冊、登入和 JWT 認證
AI 會產生一份結構化的規格文件，包括：
- 功能需求清單
- API 端點設計
- 資料模型定義
- 技術棧選擇理由
- 驗收標準
範例輸出片段：
## API 規格說明
### 端點設計
- POST /api/auth/register
- 請求體: { email, password, name }
- 回應: { userId, token }
- 錯誤: 409 (電子郵件已存在), 400 (密碼強度不足)
- POST /api/auth/login
- 請求體: { email, password }
- 回應: { token, expiresIn }
### 資料模型
User:
- id: UUID
- email: string (unique, indexed)
- password_hash: string (bcrypt)
- created_at: timestamp
2. /plan — 小而原子的任務
有了規格後，不要急著寫程式碼。先用 /plan 將大任務拆解為小而原子的子任務，每個任務應該：
- 可在 15-30 分鐘內完成
- 有明確的輸入和輸出
- 可獨立測試
使用方法：
/plan 基於上面的規格，規劃實作步驟
AI 會產生類似這樣的任務清單：
## 實施計畫
### Phase 1: 專案初始化
- [ ] Task 1.1: 初始化 Node.js 專案，安裝 express、jsonwebtoken、bcrypt
- [ ] Task 1.2: 設定 ESLint + Prettier
- [ ] Task 1.3: 設定資料庫連線（PostgreSQL + Prisma）
### Phase 2: 使用者模型
- [ ] Task 2.1: 定義 User Schema
- [ ] Task 2.2: 撰寫單元測試：建立使用者、查詢使用者
### Phase 3: 認證邏輯
- [ ] Task 3.1: 實作密碼雜湊工具函式
- [ ] Task 3.2: 實作 JWT 產生和驗證
- [ ] Task 3.3: 撰寫整合測試：註冊 → 登入 → 驗證 token
...
3. /build — 增量式建構
這是最強大的命令之一。/build 會自動產生計畫並逐個執行所有任務，你只需核准一次計畫，然後它可以自主執行。
關鍵設計理念： - ✅ 移除人工逐步確認的繁瑣步驟 - ✅ 保留每個任務的測試驅動和獨立提交 - ✅ 遇到失敗或高風險步驟時自動暫停
使用方法：
/build 實作上述計畫
AI 會： 1. 顯示完整計畫供你審批 2. 核准後，逐個執行任務 3. 每個任務完成後自動執行測試 4. 測試通過後提交 git commit 5. 遇到錯誤時暫停並等待人工介入
4. /test — 測試即證明
Agent Skills 強調測試驅動開發（TDD）。在執行任何程式碼變更前，先確保有相應的測試。
使用方法：
/test 為新新增的使用者註冊介面撰寫測試
AI 會產生： - 單元測試（Jest/Vitest） - 整合測試（Supertest） - 邊界情況測試（空值、重複電子郵件、弱密碼等）
5. /review — 提升程式碼健康度
在合併程式碼前，使用 /review 進行程式碼審查。這不僅檢查 bug，還關注：
- 程式碼可讀性
- 效能隱患
- 安全漏洞
- 架構一致性
使用方法：
/review 審查最近的 PR #42
6. /code-simplify — 清晰勝於聰明
這個技能專門用於重構複雜程式碼，遵循「清晰勝於聰明」的原則。
使用方法：
/code-simplify 簡化 auth.middleware.js 中的邏輯
AI 會： - 提取長函式為小函式 - 消除巢狀過深的條件判斷 - 用更直觀的命名替換晦澀變數名稱 - 新增必要的註解
7. /ship — 更快更安全
部署前的最後檢查。/ship 確保：
- 所有測試通過
- 沒有未提交的變更
- CI/CD 管道正常
- 回滾方案就緒
使用方法：
/ship 準備部署到生產環境
自動觸發的技能
除了手動呼叫 Slash 命令，Agent Skills 還會根據上下文自動啟用相關技能：
| 場景 | 自動觸發的技能 |
|---|---|
| 設計 API | api-and-interface-design |
| 建構前端 UI | frontend-ui-engineering |
| 處理資料庫遷移 | database-migrations |
| 撰寫 TypeScript | typescript-best-practices |
| 最佳化效能 | performance-optimization |
| 處理安全性問題 | security-review |
這意味著你不需要記住所有命令——只需自然描述你的任務，Agent Skills 會自動配對合適的最佳實踐。
自訂技能
Agent Skills 的設計是模組化的，你可以建立自己的技能。每個技能是一個 SKILL.md 檔案，包含：
---
name: my-custom-skill
description: 我的自訂技能描述
---
## 何時使用
當滿足以下條件時使用此技能：
- 條件 1
- 條件 2
## 執行步驟
1. 第一步
2. 第二步
3. ...
## 注意事項
- 注意 1
- 注意 2
將檔案放入 skills/ 目錄即可生效。
與其他工具的對比
| 特性 | Agent Skills | Cursor Rules | Windsurf Flows |
|---|---|---|---|
| 開源 | ✅ | ❌ | ❌ |
| 跨平台 | ✅ | ❌ (僅 Cursor) | ❌ (僅 Windsurf) |
| 社群貢獻 | ✅ (GitHub PR) | ❌ | ❌ |
| 自動化觸發 | ✅ | 部分 | 部分 |
| 學習曲線 | 中 | 低 | 低 |
Agent Skills 的最大優勢是開放性和社群生態——任何人都可以貢獻技能，形成共享的最佳實踐庫。
總結
Agent Skills 代表了 AI 程式設計助手的下一個演進方向：從「能寫程式碼」到「會工程化」。
透過將資深工程師的經驗編碼為可重複使用的技能包，它讓 AI Agent 不再只是程式碼產生器，而是真正具備系統性思維的工程夥伴。
推薦閱讀路徑：
- 先閱讀官方文件了解完整技能清單
- 從
/spec和/plan開始，培養「先思考再編碼」的習慣 - 嘗試
/build體驗自動化執行的魅力 - 根據需要自訂或貢獻新技能
對於正在使用 Claude Code、Cursor 或其他 AI 程式設計助手的開發者來說，Agent Skills 是一個值得投入時間學習的生產力倍增器。
相關連結：