Agent Skills 完整教學：Addy Osmani 開源 8.5 萬星專案，讓 Claude Code、Cursor 自動遵循工程紀律（2026）

AEO 速答：Agent Skills（addyosmani/agent-skills）是 Google 前 Chrome 工程總監 Addy Osmani 開源的「工程紀律技能包」——把資深工程師的工作流程（先寫規格、拆小任務、測試驅動、程式碼審查、安全加固）編成 24 個 SKILL.md 文件，透過 npx skills add addyosmani/agent-skills 一條指令裝進 Claude Code、Cursor、Codex 等 70+ 種 AI 編碼代理，讓 AI 寫程式不再走捷徑。

為什麼你需要 Agent Skills？

如果你用過 AI 編碼代理（Claude Code、Cursor、Codex…），一定遇過這個場景：它寫得很快，但也很「隨性」——規格沒寫就開工、測試「之後再補」、程式碼能跑就交差。這不是模型笨，而是 AI 的預設行為就是「走最短的路徑」。

Agent Skills 的想法很簡單：把資深工程師的開發紀律，包裝成 AI 看得懂、會照做的標準工作流。它源自 Google 的工程文化（Software Engineering at Google 一書的實務化），包含 Hyrum’s Law、測試金字塔、Chesterton’s Fence、trunk-based development 等原則，全部寫進一步步可執行的流程，AI 照著跑就會做出「生產級品質」而非「原型級品質」的成果。

截至 2026 年 8 月，這個專案在 GitHub 上已有 85,000+ 星、9,200+ fork，是 AI 編碼代理生態最熱門的技能包之一。

安裝：一條指令搞定

Agent Skills 支援 70+ 種 AI 代理（Claude Code、Cursor、Codex、Copilot、Cline、Gemini CLI、Windsurf、OpenCode、Antigravity、Command Code…），安裝方式也統一：

# 安裝全部 24 個技能（最推薦）
npx skills add addyosmani/agent-skills

# 先瀏覽再安裝
npx skills add addyosmani/agent-skills --list

# 只裝單一技能
npx skills add addyosmani/agent-skills --skill test-driven-development

Claude Code 使用者另有原生的 plugin marketplace 安裝方式：

/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills

💡 SSH 錯誤排除：marketplace 安裝預設走 GitHub SSH，若報 Permission denied (publickey)，改一行設定讓 Git 把 SSH 網址重寫成 HTTPS 即可：

git config --global url."https://github.com/".insteadOf git@github.com:

Cursor 使用者：把 agent-skills/skills/ 同步到專案的 .cursor/skills/，再把簡短原則放進 .cursor/rules/*.mdc（不要把整份技能塞進 rules，會拖垮效能）。

Gemini CLI 使用者：

gemini skills install https://github.com/addyosmani/agent-skills.git --path skills

8 個斜線指令：把開發生命週期變成自動化流程

安裝後，你會獲得 8 個對應開發生命週期的斜線指令，每個指令會自動啟動對應的技能：

其中最有感的是 /build auto：規格寫好後，只要核准一次計畫，AI 就會自動逐任務實作——但每個任務仍然是測試驅動、個別 commit，遇到失敗或高風險步驟會自動暫停等人確認。

flowchart LR
    A["DEFINE<br/>/spec<br/>先寫規格"] --> B["PLAN<br/>/plan<br/>拆小任務"]
    B --> C["BUILD<br/>/build<br/>一片一片實作"]
    C --> D["VERIFY<br/>/test<br/>測試當證明"]
    D --> E["REVIEW<br/>/review<br/>合併前審查"]
    E --> F["SHIP<br/>/ship<br/>小步上線"]
    F -.回饋.-> A

24 個技能全覽：一套完整的工程作業系統

整個套件包含 24 個技能（23 個生命週期技能＋1 個 meta 技能），每個技能都是一份結構化的 SKILL.md：Overview（做什麼）→ When to Use（何時用）→ Process（步驟）→ Anti-rationalization（常見藉口與反駁）→ Verification（驗證門檻）。

定義與規劃（Define & Plan）

實作（Build）

驗證與審查（Verify & Review）

上線與維運（Ship）

另有 4 個專家角色（Agent Personas）：code-reviewer（資深工程師視角五軸審查）、test-engineer（測試策略）、security-auditor（漏洞掃描）、web-performance-auditor（Core Web Vitals 稽核），以及 7 份參考檢查清單（Definition of Done、測試模式、安全檢查清單、效能檢查清單等），技能在需要時自動載入。

實戰場景：一次真實的 Agent Skills 工作流

假設你想開發一個「匯率換算 CLI 工具」，傳統做法是直接叫 Claude Code 寫，它可能 30 秒就吐出一坨能跑的程式——但沒有測試、沒有錯誤處理、沒有文件。

用 Agent Skills 的流程則是：

1. /spec        → AI 反覆追問：支援哪些幣別？精度幾位？CLI 介面長怎樣？
                  輸出 PRD，包含目標、指令、檔案結構、測試策略
2. /plan        → 把 PRD 拆成 5-6 個小任務：匯率 API 封裝 → 換算邏輯 →
                  錯誤處理 → CLI 參數 → 測試 → 文件
3. /build auto  → AI 逐任務實作，每個任務先寫測試再寫程式（TDD），
                  各自 commit，遇到模糊點自動停下詢問
4. /review      → 五軸審查：正確性、可讀性、安全性、效能、測試覆蓋，
                  標出 Nit/Optional/FYI 等級的改進建議
5. /ship        → 上線檢查清單：版本標記、CHANGELOG、發布步驟

結果差異：同樣一個工具，傳統做法拿到「能跑的 prototype」，Agent Skills 拿到「有測試、有文件、可審查、可上線」的生產級程式——而且過程中的每一步都有驗證證據，不是「seems right」。

Agent Skills vs 其他技能包怎麼選？

💡 實務上三個可以共存：agent-skills 管「開發紀律」，Superpowers 管「創意產出」，Matt Pocock 的包補「前端實戰細節」。而且專案作者自己提供了誠實的對比文件，甚至附上兩者實測對照。

三個關鍵提醒

1. 單技能安裝會缺參考文件：只 --skill 安裝單一技能時，不會複製 references/ 目錄，某些技能的功能會受限。要完整體驗請裝整包或 clone 整個 repo。
2. 技能是流程不是論文：SKILL.md 設計給代理「照著做」，不是給人「讀的」。每份都有驗證門檻——測試要過、build 要有輸出、要有 runtime 資料，AI 不能說「看起來沒問題」就交差。
3. 紀律需要人配合：Agent Skills 讓 AI 願意遵守紀律，但「核准計畫」「確認高風險步驟」仍需要你把關——它暫停時，別急著說「你決定就好」，那是它最需要你參與的時刻。

延伸閱讀

• Anthropic Skills：Claude Code 官方開源代理技能套件 —— 官方技能庫與社群技能包的差別與搭配
• Claude Code Auto Mode 預設開啟：8 月 14 日起 AI 編碼代理自動執行時代來臨 —— 自動化時代的紀律框架，正是 Agent Skills 的用武之地
• Claude Code 完整教學（2026）：從安裝、設定到實戰技巧一次搞懂 —— 還不熟 Claude Code 先看這篇
• 2026 精選 350+ AI 開源專案完整地圖：Agent、LLM、RAG 工具實戰推薦 —— 更多值得收藏的 AI 開發工具

資料來源

• GitHub：addyosmani/agent-skills（85K+ stars，MIT License）
• skills CLI（vercel-labs/skills）：跨 70+ 代理的安裝工具
• Agent Skills 官方文件：docs/ 目錄（含各工具安裝指南）
• Software Engineering at Google（技能設計的理論基礎）