asiaostrich/sdd
.gemini/skills/spec-driven-dev/SKILL.md
[UDS] 在撰寫程式碼前，建立、審查和管理規格文件
$ install --global
skillsauthnpx skillsauth add asiaostrich/universal-dev-standards sddInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 3, 2026, 10:51 AM17.1s2 files scanned
SKILL.md
- source:
- ../../../../skills/spec-driven-dev/SKILL.md
- source_version:
- 1.2.0
- translation_version:
- 1.2.0
- last_synced:
- 2026-03-23
- 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 | | 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 標題) 撰寫每個場景 - 每個需求必須至少有一個場景
- 使用 GIVEN/WHEN/THEN 格式描述結構化行為
- 使用 SHALL/MUST 表達強制需求，SHOULD 表達建議
變更操作
修改現有規格時，使用 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
參考
- 詳細指南：guide.md
- 核心規範：spec-driven-development.md
Related Skills
asiaostrich/sweep
development
VerifiedTrustedCommunity
[UDS] 扫描代码库的调试残留与代码质量问题；可自动修正安全模式。 Use when: before committing, during PR review, or periodic codebase cleanup. Keywords: sweep, debug cleanup, console.log, debugger, TODO, ts-any, code quality, 扫描, 清理.
69SKILL.mdUpdated Jun 4, 2026
asiaostrich/spec-derive
tools
VerifiedTrustedCommunity
[UDS] 从规格衍生 BDD 场景、TDD 骨架或 ATDD 表格
69SKILL.mdUpdated Jun 4, 2026
asiaostrich/skill-builder
development
VerifiedTrustedCommunity
[UDS] 识别重复流程并以正确的开发深度构建 Skill
69SKILL.mdUpdated Jun 4, 2026
asiaostrich/push
tools
VerifiedTrustedCommunity
[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, 推送, 保护分支, 质量门禁.
69SKILL.mdUpdated Jun 4, 2026