Menu
[UDS] 在撰寫程式碼前，建立、審查和管理規格文件
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/AsiaOstrich/universal-dev-standards --skill sddThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Showing SKILL.md
Based on SOC occupation classification
| 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/ 或專案規格目錄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
[UDS] 以 Claude 原生 Agent tool 编排多任务执行计划（DAG-based，无外部引擎）。 Use when: executing a plan.json file with parallel/sequential task dependencies. Keywords: orchestrate, plan, execute, DAG, task plan, 编排, 执行计划, 并行.
[UDS] 从 Spec 文档、OpenSpec 变更或自由文本需求生成 plan.json。 Use when: converting specifications into executable task plans for /orchestrate. Keywords: plan, spec, task plan, 计划, 规格, 任务, plan.json, DAG.
[UDS] AI 辅助 git push 安全层：质量门禁 + 协作护栏。 Use when: pushing commits, force pushing, pushing to protected branches, pushing feature branches. Keywords: git push, force push, protected branch, quality gate, push receipt, PR automation, 推送, 保护分支, 质量门禁.