spec-driven-development skill 是什麼、怎麼安裝使用：Addy Osmani 的「先寫規格再寫代碼」Skill（分階段把關）

本文根據 addyosmani/agent-skills 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。所在倉庫 addyosmani/agent-skills 在 GitHub 約 10.4 萬 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

Addy Osmani 在這套技能裏反覆表達一個觀點：沒有規格的代碼就是猜。spec-driven-development 是其中最上游的一個。description：在編碼之前創建規格；開始新項目、新功能或重大改動而尚無規格時使用，起草帶目標和範圍的 PRD 或需求文檔、需求不清或只是模糊想法時使用，一個需求橫跨多個可獨立測試的能力、需要先拆成模組能力圖時也使用。

技能把規格定義為你和智能體之間共同的事實來源：要做什麼、為什麼做、怎樣算做完。

核心是一個帶關卡的工作流，每個階段結束都要經人確認：

• 階段 0，範圍檢查：需求是否大到需要先拆分；
• 階段 1，規格：寫清目標、範圍與驗收條件；
• 階段 2，計劃：技術方案；
• 階段 3，任務：拆成可執行的小任務；
• 階段 4，實現。

另有一節「讓規格保持鮮活」：實現過程中發現規格有誤，應該回頭改規格，而不是讓代碼和文檔悄悄分叉。和該庫的其他技能一樣，末尾有三張固定的表：常見的自我開脫說法、危險信號、完成前的核對項。

怎麼安裝

倉庫 README 給出了單獨安裝某個技能的寫法：

bash
npx skills add addyosmani/agent-skills --skill spec-driven-development

想整套安裝，Claude Code 用 /plugin marketplace add addyosmani/agent-skills 加 /plugin install agent-skills@addy-agent-skills，Codex 用 codex plugin marketplace add addyosmani/agent-skills 加 codex plugin add agent-skills@agent-skills。README 提示，插件安裝遇到 SSH 權限報錯時改用倉庫的 HTTPS 地址。

倉庫整體介紹和其他安裝方式，詳見本站《addyosmani/agent-skills 是什麼、怎麼安裝：Addy Osmani 的 25 個生產級工程 Skills（/spec、/plan、/build）》。

怎麼用

• 「我想做一個團隊內部的值班排班工具，先別寫代碼，按規格先行來」。
• 「這個需求涉及通知、權限和導出三塊，先幫我拆成能力圖」。
• 做到一半需求變了：「先更新規格，再告訴我哪些任務受影響」。

這個技能只有一份 SKILL.md。

適合誰 / 侷限

適合中大型功能和多人協作的項目，以及希望對智能體的產出有明確驗收依據的人。改一個文案、修一個小 bug 走完整流程得不償失；它與 Superpowers 的 brainstorming / writing-plans、mattpocock 的 to-spec 解決的是同一類問題，選一套即可。

注意事項

• 許可：MIT。
• 不執行腳本、不聯網；會在倉庫裏創建規格與計劃文檔。
• 每個關卡都需要你認真看，敷衍通過就失去了這套流程的意義。