Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/AsiaOstrich/universal-dev-standards --skill sdd명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
[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, 推送, 保护分支, 质量门禁.
SKILL.md 표시 중
SOC 직업 분류 기준
| 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