Spec-Driven Development Assistant | 規格驅動開發助手
Create, review, and manage specification documents before writing code.
在撰寫程式碼前,建立、審查和管理規格文件。
Workflow | 工作流程
CREATE ──► REVIEW ──► APPROVE ──► IMPLEMENT ──► VERIFY
- Create - Write Spec | 撰寫規格
Define requirements, technical design, acceptance criteria, and test plan.
- Review - Validate | 審查驗證
Check for completeness, consistency, and feasibility with stakeholders.
- Approve - Sign Off | 核准
Get stakeholder sign-off before implementation begins.
- Implement - Code | 實作
Develop following the approved spec, referencing requirements and AC.
- Verify - Confirm | 驗證
Ensure implementation matches spec, all tests pass, AC satisfied.
Spec States | 規格狀態
State Description 說明
Draft Work in progress 草稿中
Review Under review 審查中
Approved Ready for implementation 已核准
Implemented Code complete 已實作
Archived Completed or deprecated 已歸檔
Spec Structure | 規格結構
Feature: [Name]
Overview
Brief description.
Requirements
- REQ-001: [Description]
Acceptance Criteria
- AC-1: Given [context], when [action], then [result]
Technical Design
[Architecture, API changes, database changes]
Test Plan
- Unit tests for [component]
- Integration tests for [flow]
Usage | 使用方式
/sdd - Interactive spec creation wizard | 互動式規格建立精靈 /sdd auth-flow - Create spec for specific feature | 為特定功能建立規格 /sdd review - Review existing specs | 審查現有規格 /sdd --sync-check - Check sync status | 檢查同步狀態
Next Steps Guidance | 下一步引導
After /sdd completes, the AI assistant should suggest:
規格文件已建立。建議下一步 / Specification document created. Suggested next steps:
-
執行 /derive 從規格推導測試工件 — Derive test artifacts from spec
-
執行 /derive bdd 僅推導 BDD 場景 — Derive BDD scenarios only
-
執行 /derive tdd 僅推導 TDD 骨架 — Derive TDD skeletons only
-
審查 AC 完整性,確保所有驗收條件可測試 — Review AC completeness
-
檢查 UDS 規範覆蓋率 → 執行 /audit --patterns — Check UDS standard coverage → Run /audit --patterns
Reference | 參考
-
Detailed guide: guide.md
-
Core standard: spec-driven-development.md