Addyosmani Agent Skills 教學手冊
addyosmani/agent-skills 教學手冊 版本:v2.0.0(基於 agent-skills v0.6.0) 更新日期:2026-05-17 適用對象:資深工程師、架構師、Tech Lead、DevSecOps 工程師 技術棧:addyosmani/agent-skills、Claude Code(Plugin Marketplace)、Cursor、Gemini CLI、GitHub Copilot、Kiro IDE、Spring Boot、Vue 3 授權:MIT License 參考來源:addyosmani/agent-skills(42.7k+ stars,4.7k forks,26 位貢獻者) 目錄 第 1 章:前言與概觀 1.1 addyosmani/agent-skills 是什麼 1.2 為何需要 Agent Skills 1.3 專案發起背景 1.4 核心理念:將資深工程師紀律轉化為結構化 AI 約束 1.5 Agent Skills 與傳統 Prompt Engineering 的本質差異 1.6 適用場景與不適用場景 1.7 addyosmani/agent-skills 與 mattpocock/skills 比較 1.8 專案資訊 第 2 章:核心架構設計 2.1 三層可組合架構 2.2 組合規則 2.3 SKILL.md 骨架設計 2.4 漸進式揭露策略 2.5 Token 效率設計原則 2.6 完整專案目錄結構 第 3 章:完整 23 個 Skills 深度解析 3.1 Meta 階段 3.2 Define 階段(定義需求) 3.3 Plan 階段(任務拆解) 3.4 Build 階段(增量實作) 3.5 Verify 階段(驗證品質) 3.6 Review 階段(合併前審查) 3.7 Ship 階段(部署上線) 第 4 章:Agent Personas 詳解 4.1 code-reviewer(Senior Staff Engineer) 4.2 test-engineer(QA Specialist) 4.3 security-auditor(Security Engineer) 4.4 Persona 與 Skill 的互動規則 4.5 自定義 Persona 第 5 章:7 個 Slash Commands 詳解 5.1 /spec — 定義要建什麼 5.2 /plan — 規劃如何建造 5.3 /build — 增量式建構 5.4 /test — 證明它可運作 5.5 /review — 合併前審查 5.6 /code-simplify — 簡化程式碼 5.7 /ship — 部署到生產環境 第 6 章:Reference Checklists 詳解 6.1 testing-patterns.md 6.2 security-checklist.md 6.3 performance-checklist.md 6.4 accessibility-checklist.md 6.5 orchestration-patterns.md 第 7 章:融入的頂尖 Google 工程實踐 7.1 Hyrum’s Law 7.2 Beyoncé Rule 7.3 Chesterton’s Fence 7.4 Spec-Driven Development 7.5 測試金字塔 7.6 其他核心原則 第 8 章:安裝與環境設定 8.1 安裝方式總覽 8.2 Claude Code(首要支援平台) 8.3 Cursor 8.4 Gemini CLI 8.5 Windsurf 8.6 OpenCode 8.7 GitHub Copilot 8.8 Kiro IDE & CLI 8.9 Codex / 其他 Agents 8.10 安裝後驗證 8.11 多工具共存 第 9 章:SSDLC 整合實戰 9.1 SSDLC 各階段與 Agent Skills 映射 9.2 需求分析階段 9.3 設計階段 9.4 開發階段 9.5 測試階段 9.6 審查階段 9.7 部署階段 9.8 維運階段 9.9 合規對應 第 10 章:AI Agent Team 建立指南 10.1 Agent Team 角色分配 10.2 Skills 組合配置 10.3 協作模式與 Human-in-the-Loop 10.4 不同規模團隊的導入差異 10.5 Agent Teams(實驗性功能) 10.6 不同規模團隊的採用策略 第 11 章:Web Application 開發實戰案例 11.1 端到端開發流程 11.2 後端案例(Spring Boot) 11.3 前端案例(Vue 3) 11.4 API 設計案例 第 12 章:系統 Framework 升級實戰 12.1 升級流程概覽 12.2 Java EE → Jakarta EE 實戰 12.3 Spring Boot 升級實戰 第 13 章:軟體逆向工程實戰 13.1 逆向工程流程 13.2 Legacy System 現代化 第 14 章:安全性治理 14.1 三層邊界系統 14.2 OWASP Top 10 防護對應 14.3 Auth Patterns 與 Secrets Management 14.4 SAST / DAST 整合 14.5 Prompt Injection 防護 第 15 章:CI/CD 與 DevSecOps 整合 15.1 GitHub Actions 範例 15.2 Quality Gate Pipeline 15.3 Feature Flag 生命週期 第 16 章:Context Engineering 與 Prompt 策略 16.1 五層 Context 階層 16.2 Context Packing 策略 16.3 MCP 整合 16.4 Anti-Hallucination 策略 第 17 章:測試策略 17.1 測試金字塔實踐 17.2 Red-Green-Refactor 流程 17.3 Prove-It Pattern 17.4 Mock 策略 第 18 章:Hooks 與 Session 管理 18.1 Hooks 目錄結構 18.2 Session Lifecycle Hooks 18.3 自定義 Hooks 第 19 章:自定義 Skill 開發指南 19.1 Skill Anatomy 完整規格 19.2 Writing Principles 19.3 完整自定義 Skill 範例 第 20 章:企業導入策略與治理 20.1 導入路線圖 20.2 AI Governance 治理機制 20.3 品質指標 20.4 合規考量 第 21 章:最佳實務 第 22 章:常見反模式 第 23 章:Troubleshooting 第 24 章:FAQ 第 25 章:附錄 附錄 A:23 個 Skills 速查表 附錄 B:7 個 Commands 速查表 附錄 C:3 個 Personas 速查表 附錄 D:Reference Checklists 速查表 附錄 E:設定範例 附錄 F:導入 Checklist 第 1 章:前言與概觀 1.1 addyosmani/agent-skills 是什麼 addyosmani/agent-skills 是由 Google Chrome 團隊工程主管 Addy Osmani 發起的開源專案,核心目的是將**資深軟體工程師的開發紀律與標準作業程序(SOP)**轉化為結構化的 Markdown 框架,用以約束並提升 AI 程式碼生成代理(AI Coding Agents)的交付品質。 ...