asiaostrich/spec-derive
skills/spec-derivation/SKILL.md
[UDS] Derive BDD scenarios, TDD skeletons, or ATDD tables from specifications
$ install --global
skillsauthnpx skillsauth add asiaostrich/universal-dev-standards spec-deriveInstall 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: Jun 23, 2026, 4:15 AM38.6s2 files scanned
SKILL.md
- name:
- spec-derive
- scope:
- partial
- description:
- [UDS] Derive BDD scenarios, TDD skeletons, or ATDD tables from specifications
- allowed-tools:
- Read, Write, Grep, Glob
- argument-hint:
- [all|bdd|tdd|it|e2e|atdd] <spec-file>
- prerequisites:
- ["spec-approved"]
- disable-model-invocation:
- true
Forward Derivation | 正向推演
Generate derived artifacts (BDD scenarios, TDD skeletons, ATDD tables) from approved SDD specifications.
從已批准的 SDD 規格生成衍生工件（BDD 場景、TDD 骨架、ATDD 表格）。
Subcommands | 子命令
| Subcommand | Description | Output |
|------------|-------------|--------|
| all | Full derivation pipeline (BDD + TDD + IT + E2E + ATDD + Contracts) | .feature + .test.* + .it.test.* + .e2e.test.* + .md + .json |
| bdd | Generate BDD scenarios only | .feature |
| tdd | Generate TDD skeletons only | .test.* |
| it | Generate Integration test skeletons | .it.test.* |
| e2e | Generate E2E test skeletons | .e2e.test.* |
| atdd | Generate ATDD test tables | .md (Markdown tables) |
Workflow | 工作流程
- Read Spec - Analyze the input
SPEC-XXX.mdfile | 分析規格檔案 - Extract AC - Parse all Acceptance Criteria | 解析所有驗收條件
- Generate Artifacts - Create BDD/TDD/ATDD outputs | 產生衍生工件
- Verify - Ensure 1:1 mapping between AC and generated items | 驗證一對一對應
Anti-Hallucination Rules | 防幻覺規則
| Rule | Description | 說明 | |------|-------------|------| | 1:1 Mapping | Every AC has exactly one test/scenario | 每個 AC 對應一個測試 | | Traceability | All artifacts reference Spec ID and AC ID | 所有工件引用規格與 AC 編號 | | No Invention | Do not add scenarios not in the spec | 不新增規格外的場景 |
Generated Artifact Tags | 產生工件標籤
| Tag | Meaning | 含義 |
|-----|---------|------|
| [Source] | Direct content from spec | 直接來自規格 |
| [Derived] | Transformed from source | 從來源轉換 |
| [Generated] | AI-generated structure | AI 產生的結構 |
| [TODO] | Requires human implementation | 需人工實作 |
Usage | 使用方式
/derive all specs/SPEC-001.md - Full derivation pipeline | 完整推演管線
/derive bdd specs/SPEC-001.md - Derive BDD scenarios only | 僅推演 BDD 場景
/derive tdd specs/SPEC-001.md - Derive TDD skeletons only | 僅推演 TDD 骨架
/derive it specs/SPEC-001.md - Derive Integration test skeletons | 推演整合測試骨架
/derive e2e specs/SPEC-001.md - Derive E2E test skeletons | 推演 E2E 測試骨架
/derive atdd specs/SPEC-001.md - Derive ATDD tables | 推演 ATDD 表格
Next Steps Guidance | 下一步引導
After /derive completes, the AI assistant should suggest:
測試工件已產生。建議下一步 / Test artifacts generated. Suggested next steps:
- 執行
/tdd開始紅綠重構循環 ⭐ Recommended / 推薦 — Start Red-Green-Refactor cycle- 執行
/bdd細化 Gherkin 場景 — Refine Gherkin scenarios- 檢查產生的
[TODO]標記並補齊實作 — Review[TODO]markers and fill in implementations
Reference | 參考
- Detailed guide: guide.md
- Core standard: forward-derivation-standards.md
AI Agent Behavior | AI 代理行為
完整的 AI 行為定義請參閱對應的命令文件：
/deriveFor complete AI agent behavior definition, see the corresponding command file:
/derive
Related Skills
asiaostrich/spec-derive
tools
VerifiedTrustedCommunity
[UDS] 從規格衍生 BDD 場景、TDD 骨架或 ATDD 表格
71SKILL.mdUpdated May 30, 2026
asiaostrich/methodology
development
VerifiedTrustedCommunity
[UDS] /methodology: 選擇並追蹤開發方法論（SDD/BDD/TDD）。 Use when: 選擇方法論、切換開發模式、查詢當前方法論狀態。 若要查詢各階段對應指令請用 /dev-workflow。
71SKILL.mdUpdated May 30, 2026
asiaostrich/sdd
development
VerifiedTrustedCommunity
[UDS] Create or review specification documents for Spec-Driven Development
71SKILL.mdUpdated Apr 3, 2026
asiaostrich/ci-cd
development
VerifiedTrustedCommunity
Guide CI/CD pipeline design, configuration, and optimization. Use when: setting up pipelines, optimizing build times, configuring deployment stages. Keywords: CI/CD, pipeline, GitHub Actions, deployment, build.
71SKILL.mdUpdated Apr 3, 2026