spec-driven-development：先寫規格，再讓 AI 動手
在寫程式前建立包含目標、限制、測試與邊界的規格，讓人與代理使用同一份完成標準。
學完會知道
- 理解 spec-driven-development 在開發流程裡負責的工作
- 判斷什麼情況適合使用 spec-driven-development
- 完成通用 Skills CLI、Codex 或 Claude Code 安裝
開始前先準備
- 可使用支援 Agent Skills 的 coding agent
- 準備一個能實際驗證的小型開發任務
這個 Skill 在做什麼
在寫程式前建立包含目標、限制、測試與邊界的規格，讓人與代理使用同一份完成標準。
為什麼有用
沒有規格時，代理只能一邊實作一邊猜。這個 Skill 把目的、結構、指令、測試方式與不能跨越的邊界先寫清楚，之後的 plan 和 review 才有共同依據。
適合什麼場景
- 新功能會碰到多個檔案或模組。
- 需求存在幾種合理解讀，選錯會造成返工。
- 準備做架構決定或超過半小時的變更。
和站內相近內容的差別
Matt Pocock 的 idea-to-ship 也會先把需求問清楚，再交給 to-spec。差別在於 spec-driven-development 是較通用的單一規格流程，不依賴特定 issue tracker 或專案設定。
如何安裝
想先查看可選清單，可以執行：
npx skills add addyosmani/agent-skills --list只安裝這一個 Skill：
npx skills add addyosmani/agent-skills --skill spec-driven-development安裝完整 24 個 Skills：
npx skills add addyosmani/agent-skills這個 Skill 的 SKILL.md 沒有引用上游根目錄的共用 references。只想使用這一個流程時，可以單獨安裝；若會串接其他開發階段，再裝整套會比較省事。
手動安裝時，先 clone 上游 repo，再把整個 Skill 資料夾放進代理使用的 skills 目錄：
git clone https://github.com/addyosmani/agent-skills.git來源資料夾是 skills/spec-driven-development/。如果上面列出共用 references，還要保留上游的相對路徑。
Codex
Codex CLI 0.122 以上可安裝整套原生外掛：
codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills安裝後重新開啟 session。手動指定時輸入 @spec-driven-development；也可以直接描述任務，讓 Codex 依 Skill 的 description 自動選用。
Claude Code
Claude Code 可從 marketplace 安裝：
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills此外掛也提供 /spec、/plan、/build、/test、/review、/code-simplify 與 /ship 等流程指令。這些指令會編排對應 Skills，不代表每個指令都只使用本頁這一個 Skill。
自動啟用還是手動指定
手動優先。規格會成為後續工作的依據，應由使用者知道它正在建立並核准內容，不宜默默產生後直接實作。
在 Codex 手動呼叫的寫法：
@spec-driven-development
請依這個 Skill 的原始流程處理目前任務，完成後列出驗證證據。