Adoption

Agent Skills are supported by leading AI development tools.

VS Code Gemini CLI GitHub Goose Amp Cursor Claude Code Letta OpenCode Claude OpenAI Codex Factory VS Code Gemini CLI GitHub Goose Amp Cursor Claude Code Letta OpenCode Claude OpenAI Codex Factory

asiaostrich/sdd

Name: sdd
Author: asiaostrich

.gemini/skills/spec-driven-dev/SKILL.md

npx skillsauth add asiaostrich/universal-dev-standards sdd

Clean

TrivyContainer and dependency vulnerability scanner

Clean

SemgrepStatic code analysis for vulnerabilities

Clean

mcp-scan (Snyk)Model Context Protocol security validation

Skipped

Snyk (dep)Open source security scanning

Skipped

Socket.devSupply chain security analysis

Skipped

VirusTotalMulti-engine malware detection

Skipped

CrowdStrikeAdvanced threat intelligence

Skipped

OSV-ScannerOpen Source Vulnerability database check

Skipped

OWASP Dep-Check

規格驅動開發助手

語言: 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

asiaostrich/sdd

.gemini/skills/spec-driven-dev/SKILL.md

[UDS] 在撰寫程式碼前，建立、審查和管理規格文件

55 stars

tools

Updated Apr 3, 2026

$ install --global

skillsauth

npx skillsauth add asiaostrich/universal-dev-standards sdd

Install 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.

Scanners Passed

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 = 快速迭代的輕量微規格

快速檢查清單

搜尋現有規格：查看 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。

規格狀態

規格結構

# [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 區段：

使用方式

/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/spec-derive

tools

VerifiedTrustedCommunity

[UDS] 從規格衍生 BDD 場景、TDD 骨架或 ATDD 表格

71SKILL.mdUpdated May 30, 2026

asiaostrich/spec-derive

asiaostrich/methodology

development

VerifiedTrustedCommunity

[UDS] /methodology: 選擇並追蹤開發方法論（SDD/BDD/TDD）。 Use when: 選擇方法論、切換開發模式、查詢當前方法論狀態。若要查詢各階段對應指令請用 /dev-workflow。

71SKILL.mdUpdated May 30, 2026

asiaostrich/methodology

asiaostrich/spec-derive

testing

VerifiedTrustedCommunity

[UDS] Derive BDD scenarios, TDD skeletons, or ATDD tables from specifications

71SKILL.mdUpdated May 4, 2026

asiaostrich/spec-derive

asiaostrich/sdd

development

VerifiedTrustedCommunity

[UDS] Create or review specification documents for Spec-Driven Development

71SKILL.mdUpdated Apr 3, 2026

Download

For Claude Desktop. Download once, then upload the file in the app — no terminal needed.

Need help? View full Cowork setup guide →

Install manually

Choose your platform

# Clone the repo
git clone https://github.com/asiaostrich/universal-dev-standards.git

# Copy into Claude Code skills folder (global)
cp -r universal-dev-standards/.gemini/skills/spec-driven-dev ~/.claude/skills/

Claude Code Skills — official skills path docs.

Repository

asiaostrich/universal-dev-standards

55 stars

Compatible with

Claude Code

OpenAI Codex CLI

ChatGPT

Adoption

asiaostrich/sdd

$ install --global

Security Scan Results

SKILL.md

規格驅動開發助手

何時使用 /sdd vs uds spec

快速檢查清單

決策樹

工作流程

0. Discuss - 釐清範圍

1. Create - 撰寫規格

2. Review - 審查驗證

3. Approve - 核准

4. Implement - 實作

5. Verify - 驗證

6. Archive - 歸檔

規格狀態

規格結構

場景格式規則

變更操作

使用方式

下一步引導

參考

Related Skills

asiaostrich/spec-derive

asiaostrich/methodology

asiaostrich/spec-derive

asiaostrich/sdd

asiaostrich/sdd

$ install --global

Security Scan Results

SKILL.md

規格驅動開發助手

何時使用 /sdd vs uds spec

快速檢查清單

決策樹

工作流程

0. Discuss - 釐清範圍

1. Create - 撰寫規格

2. Review - 審查驗證

3. Approve - 核准

4. Implement - 實作

5. Verify - 驗證

6. Archive - 歸檔

規格狀態

規格結構

場景格式規則

變更操作

使用方式

下一步引導

參考

Related Skills

asiaostrich/spec-derive

asiaostrich/methodology

asiaostrich/spec-derive

asiaostrich/sdd

何時使用 `/sdd` vs `uds spec`

何時使用 `/sdd` vs `uds spec`