| source | ../../../../skills/spec-driven-dev/SKILL.md |
| source_version | 1.2.0 |
| translation_version | 1.2.0 |
| last_synced | "2026-03-23T00:00:00.000Z" |
| status | current |
| description | [UDS] 在撰寫程式碼前，建立、審查和管理規格文件 |
| name | sdd |
| allowed-tools | Read, Write, Grep, Glob, Bash(git:*) |
| scope | universal |
| argument-hint | [spec name or feature | 規格名稱或功能] |
規格驅動開發助手
語言: English | 繁體中文
在撰寫程式碼前，建立、審查和管理規格文件。
何時使用 /sdd vs uds spec
| 場景 | /sdd | uds spec |
|---|
| 正式功能開發（含審查流程） | ✅ | ❌ |
| 完整規格生命週期（Draft → Archived） | ✅ | ❌ |
| 快速原型 / Vibe coding | ❌ | ✅ |
| 小增量改動 | ❌ | ✅ |
| 需要利害關係人簽核 | ✅ | ❌ |
| 從自然語言意圖建立微規格 | ❌ | ✅ |
/sdd = 正式開發的完整規格生命週期
uds spec = 快速迭代的輕量微規格
快速檢查清單
- 搜尋現有規格：查看
specs/、docs/specs/ 或專案規格目錄
- 決定範圍：新功能 vs 修改現有功能
- 選擇唯一的規格 ID：
SPEC-NNN 或 kebab-case 變更 ID
- 撰寫包含明確 AC（Given/When/Then 格式）的提案
- 實作前取得核准
- 依序實作任務，對照規格驗證
- 完成後歸檔規格
決策樹
新需求？
├─ 修復符合規格行為的 Bug？ → 直接修復
├─ 錯字/格式/註解？ → 直接修復
├─ 相依套件更新（不破壞相容性）？ → 直接修復
├─ 新功能/能力？ → 建立提案
├─ 破壞性變更？ → 建立提案
├─ 架構變更？ → 建立提案
└─ 不確定？ → 建立提案（較安全）
工作流程
DISCUSS ──► CREATE ──► REVIEW ──► APPROVE ──► IMPLEMENT ──► VERIFY ──► ARCHIVE
0. Discuss - 釐清範圍
在撰寫規格前，捕捉模糊地帶、建立治理原則、解決歧義。
1. Create - 撰寫規格
定義需求、技術設計、驗收條件和測試計畫。
2. Review - 審查驗證
與利害關係人檢查完整性、一致性和可行性。
3. Approve - 核准
在實作開始前取得利害關係人簽核。
4. Implement - 實作
依據已核准的規格進行開發，參照需求和驗收條件。
5. Verify - 驗證
確保實作符合規格，所有測試通過，驗收條件已滿足。
6. Archive - 歸檔
歸檔已完成的規格，連結至 commits/PRs。
規格狀態
| 狀態 | 說明 | State | Description |
|---|
| Draft | 草稿中 | Draft | Work in progress |
