القائمة
[UDS] 在撰寫程式碼前，建立、審查和管理規格文件
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
[UDS] 從已批准的 SDD 規格生成衍生工件（BDD/TDD/ATDD）
[UDS] 在提交程式碼前驗證品質關卡，確保程式碼庫穩定性
[UDS] 分析 AC 與測試的追蹤關係及覆蓋率
[UDS] 建立、管理和追蹤架構決策記錄（ADR）
[UDS] 從專案原始檔案產生使用文件（速查表、參考手冊、使用指南）
[UDS] 引導事故回應、根因分析和事後檢討文件撰寫
| 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 | 繁體中文
在撰寫程式碼前，建立、審查和管理規格文件。
specs/、docs/specs/ 或專案規格目錄SPEC-NNN 或 kebab-case 變更 ID新需求？
├─ 修復符合規格行為的 Bug？ → 直接修復
├─ 錯字/格式/註解？ → 直接修復
├─ 相依套件更新（不破壞相容性）？ → 直接修復
├─ 新功能/能力？ → 建立提案
├─ 破壞性變更？ → 建立提案
├─ 架構變更？ → 建立提案
└─ 不確定？ → 建立提案（較安全）
DISCUSS ──► CREATE ──► REVIEW ──► APPROVE ──► IMPLEMENT ──► VERIFY ──► ARCHIVE
在撰寫規格前，捕捉模糊地帶、建立治理原則、解決歧義。
定義需求、技術設計、驗收條件和測試計畫。
與利害關係人檢查完整性、一致性和可行性。
在實作開始前取得利害關係人簽核。
依據已核准的規格進行開發，參照需求和驗收條件。
確保實作符合規格，所有測試通過，驗收條件已滿足。
歸檔已完成的規格，連結至 commits/PRs。
| 狀態 | 說明 | State | Description |
|---|---|---|---|
| Draft | 草稿中 | Draft | Work in progress |
| Review | 審查中 | Review | Under review |
| Approved | 已核准 | Approved | Ready for implementation |
| Implemented | 已實作 | Implemented | Code complete |
| Archived | 已歸檔 | Archived | Completed or deprecated |
# [SPEC-ID] Feature: [Name]
## Overview
簡短描述提案變更。
## Motivation
為什麼需要這個變更？解決什麼問題？
## Requirements
### Requirement: [Name]
系統 SHALL [行為描述]。
#### Scenario: [成功案例]
- **GIVEN** [初始情境]
- **WHEN** [執行動作]
- **THEN** [預期結果]
## Acceptance Criteria
- AC-1: Given [context], when [action], then [result]
## Technical Design
[架構、API 變更、資料庫變更]
## Test Plan
- [ ] [元件] 的單元測試
- [ ] [流程] 的整合測試
#### Scenario: (h4 標題) 撰寫每個場景修改現有規格時，使用 delta 區段：
| 操作 | 說明 |
|---|---|
## ADDED Requirements | 新增功能 |
## MODIFIED Requirements | 修改行為 |
## REMOVED Requirements | 移除功能 |
## RENAMED Requirements | 重新命名 |
/sdd - 互動式規格建立精靈/sdd auth-flow - 為特定功能建立規格/sdd review - 審查現有規格/sdd --sync-check - 檢查同步狀態/sdd 完成後，AI 助手應建議：
規格文件已建立。建議下一步：
- 執行
/derive從規格推導測試工件- 執行
/derive bdd僅推導 BDD 場景- 執行
/derive tdd僅推導 TDD 骨架- 審查 AC 完整性，確保所有驗收條件可測試
- 檢查 UDS 規範覆蓋率 → 執行
/audit --patterns