addyosmani/agent-skills 是什麼、怎麼安裝：Addy Osmani 的 25 個生產級工程 Skills（/spec、/plan、/build）

本文根據 addyosmani/agent-skills 倉庫 README 和相關官方文檔整理，資料核對於 2026-10-10。技能數量和命令會更新，以倉庫 README 為準。

是什麼

Addy Osmani 是在 Google 工作多年的知名工程師和技術作者。這個倉庫把資深工程師做軟件時的流程、質素關卡和最佳實踐，打包成智能體每個階段都會一致遵守的技能。README 的出發點是：編程智能體預設走最短路徑，常常跳過規格、測試、安全評審這些讓軟件可靠的環節；技能用帶步驟和驗證關卡的流程把這些環節補回來。

內容大量取自 Google 的工程文化（README 提到《Software Engineering at Google》和 Google 的工程實踐指南）：API 設計裏的海勒姆定律、測試金字塔、每次改動約 100 行的評審粒度、主幹開發、把代碼視為負債的棄用流程等。

截至 2026-10-10，GitHub 顯示該倉庫約 10.4 萬 Star、1.1 萬 Fork，最近一次推送在 2026-10-03。

包含哪些 Skill

共 25 個技能（24 個生命週期技能 + 1 個引導技能 using-agent-skills），按階段分組：

• 定義：interview-me（一次只問一個問題，問到把握足夠為止）、idea-refine、spec-driven-development（先寫 PRD 再寫代碼）、constraint-driven-development（定下質素門檻寫進 CONSTRAINTS.md）；
• 計劃：planning-and-task-breakdown（拆成帶驗收標準的小任務）；
• 構建：incremental-implementation（薄的縱向切片，做一片、測一片、提交一片）、test-driven-development、context-engineering、source-driven-development（框架用法以官方文檔為據並標註來源）、doubt-driven-development（對關鍵決定做對抗式覆核）、frontend-ui-engineering、api-and-interface-design；
• 驗證：browser-testing-with-devtools（用 Chrome DevTools MCP 看真實運行數據）、debugging-and-error-recovery；
• 評審：code-review-and-quality（五個維度的評審）、code-simplification、security-and-hardening（OWASP Top 10）、performance-optimization；
• 發佈：git-workflow-and-versioning、ci-cd-and-automation、deprecation-and-migration、documentation-and-adrs、observability-and-instrumentation、shipping-and-launch。

另外有 9 個斜槓命令作為入口：/spec、/plan、/build、/test、/constraints、/review、/webperf、/code-simplify、/ship；以及 4 個評審用的智能體角色（代碼評審、測試、安全審計、Web 性能審計）。

怎麼安裝

命令均來自 README。

任意智能體，一條命令（通過開源的 skills CLI）：

bash
npx skills add addyosmani/agent-skills            # install all 25 skills
npx skills add addyosmani/agent-skills --list     # browse before installing

只裝單個技能時加 --skill 技能名。README 提醒：單裝一個技能不會帶上倉庫級的 references/ 檢查清單目錄，技能仍可用，但引用的共享清單讀不到。

Claude Code（README 推薦）：

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

如果因為沒配 SSH 密鑰報錯，把第一條換成 /plugin marketplace add https://github.com/addyosmani/agent-skills.git。

Codex（CLI v0.122 以上）：

bash
codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills

Gemini CLI：gemini skills install https://github.com/addyosmani/agent-skills.git --path skills。Cursor、OpenCode、Windsurf、Copilot、Kiro、Antigravity 的做法見 README 和倉庫 docs 目錄。README 沒有提供 claude.ai 網頁版的安裝方式。

怎麼用

• 按生命週期走命令：新功能從 /spec 開始（先出規格），/plan 拆任務，/build 一次做一個切片，/test 證明它能工作，/review 合併前評審，/ship 上線前檢查。每個命令會自動激活對應的技能。
• 少一點手動步驟：規格確定後輸入 /build auto，它會生成計劃並在你批准一次之後連續實現所有任務；每個任務仍然是測試驅動、單獨提交，遇到失敗或高風險步驟會停下。
• 自動觸發：不輸命令也行——設計接口時會觸發 api-and-interface-design，做介面時觸發 frontend-ui-engineering。在 Codex 裏按 README 的寫法用 @ 提及技能，例如 @spec-driven-development。

適合誰 / 不適合誰

適合：

• 要把智能體用在正式上線項目上、看重規格、測試、評審和發佈紀律的團隊；
• Web 前端和全棧項目（性能、可訪問性、瀏覽器調試相關技能比較完整）；
• 想要一套「數量適中、結構清晰」的工程技能的人——25 個，比幾百個的大合集容易掌握。

不適合：

• 快速原型和一次性腳本，完整流程顯得偏重；
• 非 Web 領域（嵌入式、數據科學等）針對性不強；
• 已經裝了 Superpowers 或 mattpocock/skills 的項目——三者定位重疊，README 的 docs/comparison.md 有對比，建議選一套。

注意事項

• 許可證：MIT。
• 維護狀態：活躍（最近推送 2026-10-03）。
• 依賴 MCP 的技能：browser-testing-with-devtools 需要 Chrome DevTools MCP，會讓智能體操作真實瀏覽器，注意不要在登入了重要帳號的瀏覽器配置裏跑。
• 安全：技能是純 Markdown 流程加少量參考清單，風險面相對小；但 /build auto 會讓智能體連續提交代碼，務必在 Git 倉庫裏用並審查提交。第三方技能安裝前通讀 SKILL.md 的習慣同樣適用。
• 兼容性：各工具支持程度不同，README 提到 Antigravity CLI 某些版本里舊式命令找不到，需要直接調用技能；Codex 需要較新的 CLI 版本。