Agent Skills 是 Google 工程師 Addy Osmani 開源、MIT 授權的生產級 AI agent 技能包,把資深工程師建構軟體時的工作流、品質關卡與最佳實務打包成 agent 會穩定遵循的步驟。8 個斜線指令對應開發生命週期,24 個技能各自是帶步驟、驗證關卡與「反合理化」表格的結構化工作流,另含 4 個專家 persona 與 6 份參考清單。本手冊涵蓋安裝、技能總覽、設計原則與一段實戰示範。
Agent Skills 由 Google 工程師 Addy Osmani 開源,定位是「給 AI coding agent 的生產級工程技能」。它要解決的問題很明確:AI agent 預設走最短路徑,常常跳過寫規格、寫測試、做安全審查這些讓軟體可靠的步驟。Agent Skills 給 agent 一套結構化工作流,把資深工程師帶進生產環境的那種紀律強加進去。
每個技能不是給 agent「讀」的參考文件,而是給它「照著走」的流程:有步驟、有檢查點、有退出條件。技能彼此會依工作內容自動啟用——設計 API 觸發 api-and-interface-design、做 UI 觸發 frontend-ui-engineering。8 個斜線指令是入口,對應 DEFINE → PLAN → BUILD → VERIFY → REVIEW → SHIP 六個階段。
技能裡編進的是 Google 工程文化的具體實務,而非抽象原則:API 設計的 Hyrum's Law、測試的 Beyoncé Rule 與測試金字塔(80/15/5)、code review 的變更大小(約 100 行)與審查速度規範、簡化的 Chesterton's Fence、git 的 trunk-based development、CI/CD 的 Shift Left 與 feature flag,以及一個把程式視為負債的專門 deprecation 技能。出處是《Software Engineering at Google》與 Google 的 engineering practices guide。
官方推薦 Claude Code,透過 plugin marketplace 兩行安裝:
技能本體是純 Markdown,任何接受 system prompt 或 instruction 檔的 agent 都能用。常見 host 安裝方式:
| 工具 | 安裝方式 |
|---|---|
| Antigravity CLI | agy plugin install https://github.com/addyosmani/agent-skills.git |
| Gemini CLI | gemini skills install https://github.com/addyosmani/agent-skills.git --path skills |
| Cursor | 把任一 SKILL.md 複製進 .cursor/rules/,或引用整個 skills/ 目錄 |
| Windsurf | 把技能內容加進 Windsurf rules 設定 |
| OpenCode | 透過 AGENTS.md 與 skill 工具做 agent 驅動執行 |
| Kiro IDE / CLI | 技能放在 .kiro/skills/(專案或全域層級),也支援 AGENTS.md |
| GitHub Copilot | 用 agents/ 作 persona,技能內容放 .github/copilot-instructions.md |
| Codex / 其他 agent | 技能是純 Markdown,任何吃 system prompt 或 instruction 檔的 agent 都能用 |
claude --plugin-dir /path/to/agent-skills 載入。每個 host 的完整步驟在 docs/ 下對應的 setup 指南(cursor-setup.md、gemini-cli-setup.md 等)。
8 個斜線指令是入口,各自會自動啟用對應的技能。下面先列指令,再用一張表把 24 個技能依生命週期分組。指令是手動入口,技能則會依你正在做的事自動觸發。
/build auto 核准一次後自動跑完全部任務。指令是入口,底下是完整的 24 個技能(23 個生命週期技能 + 1 個 meta 技能)。每個都能直接引用。
| 階段 | 技能 |
|---|---|
| Meta | using-agent-skills——把工作對應到正確技能,定義共用操作規則 |
| Define | interview-me · idea-refine · spec-driven-development |
| Plan | planning-and-task-breakdown |
| Build | incremental-implementation · test-driven-development · context-engineering · source-driven-development · doubt-driven-development · frontend-ui-engineering · api-and-interface-design |
| Verify | browser-testing-with-devtools · debugging-and-error-recovery |
| Review | code-review-and-quality · code-simplification · security-and-hardening · performance-optimization |
| Ship | git-workflow-and-versioning · ci-cd-and-automation · deprecation-and-migration · documentation-and-adrs · observability-and-instrumentation · shipping-and-launch |
code-reviewer(資深 staff 工程師)、test-engineer(QA)、security-auditor(資安)、web-performance-auditor(Web 效能)。參考清單則涵蓋測試、安全、效能、無障礙、可觀測性與多 persona 編排模式,技能會在需要時自動拉入。
以下八條全部來自官方 README 與 docs,說明這套技能的設計選擇與正確用法。每張卡標注出處段落。
技能是 agent 照著做的工作流,不是它讀的參考文件。每個技能都有步驟、檢查點與退出條件。設計時優先放可執行步驟,而非說明性散文。
來源 · 官方 README「How Skills Work」每個技能內建一張表,列出 agent 常用來跳過步驟的藉口(例如「測試之後再補」)與對應的反駁。這是它逼流程走完的關鍵機制。
來源 · 官方 README「Key design choices」每個技能都以證據要求收尾:測試通過、build 輸出、runtime 資料。官方原話:「Seems right」永遠不夠。要的是可驗證的證據,不是感覺對。
來源 · 官方 README「Key design choices」SKILL.md 是入口,支援性參考檔只在需要時才載入,讓 token 用量維持最小。不必一次把所有知識塞進 context。
規格就緒後,/build auto 會生計畫並在一次核准內實作每個任務。它拿掉的是「任務之間」的人工介入,不是驗證:每個任務仍 test-driven、逐一提交,遇失敗或高風險步驟會暫停。
不必每次手動選技能。設計 API 自動觸發 api-and-interface-design、建 UI 觸發 frontend-ui-engineering。8 個指令只是手動入口。
需要特定視角時呼叫 persona:code-reviewer 用「staff 工程師會核准嗎」的標準、security-auditor 做 OWASP 評估。編排規則見 docs/agents.md,且「persona 不呼叫 persona」。
Hyrum's Law、Beyoncé Rule、測試金字塔、Chesterton's Fence、trunk-based development、Shift Left 都直接編進步驟裡,出處是《Software Engineering at Google》與 Google eng-practices guide。
來源 · 官方 README「Why Agent Skills?」
以下示範把一個新功能跑完整個生命週期:/spec 先逼出規格、/plan 拆成原子任務、/build 逐片實作、/test 取得證據、/review 過品質關卡、/ship 上線。指令與原則均取自官方 README。
六個指令不是六段獨立操作,而是一條有交班的流程:/spec 產出的 PRD 餵給 /plan,任務拆解餵給 /build,每一步都在 agent 想跳過時被「反合理化」表格擋下來。最後的 /review 用嚴重度標籤分流,把非阻擋項丟進 backlog 而非卡住合併。
示範中的測試數、變更行數與標籤是說明性數值,實際結果取決於你的任務與 codebase。要少手動介入,可在規格就緒後改用 /build auto 一次核准跑完。
/spec 這類指令入口。
...agent-skills.git)強制 HTTPS clone。
docs/comparison.md 誠實對比 Superpowers 與 Matt Pocock 的 skills,說明三者形狀不同、各有適用場景。挑工具前值得讀。
裝好、跑通一輪生命週期之後,下面幾步把 Agent Skills 從「個人工作流」推進到「團隊一致的工程規範」。
1. 客製化技能。每個 SKILL.md 都是純 Markdown,打開就能改步驟、加你公司的 lint 規則與命名慣例、補你自己的反合理化條目。
2. 用 persona 編排審查。讀 docs/agents.md 的決策矩陣,讓 code-reviewer、security-auditor、web-performance-auditor 組成定向審查;記住「persona 不呼叫 persona」這條編排規則。
3. 把參考清單接進關卡。把 security-checklist.md、performance-checklist.md、accessibility-checklist.md 接到 CI 或上線前 gate,讓品質要求可被檢核。
4. 跨工具同步同一套規則。技能是純 Markdown,可同時放進 Claude Code、Cursor、Windsurf、Kiro、Copilot。團隊用不同編輯器也能共用同一份工程規範。
5. 自己評估,再決定要不要用。讀 docs/comparison.md 的對比與 head-to-head 實驗,對照 Superpowers 與 Matt Pocock 的 skills,挑最適合你團隊的形狀。
① docs/skill-anatomy.md——技能格式規格:Frontmatter、Process、Rationalizations、Red Flags、Verification。
② docs/agents.md——persona 決策矩陣、編排規則,以及與技能、指令如何組合。
③ docs/comparison.md——與 Superpowers、Matt Pocock skills 的誠實對比與適用場景。