derive

SKILL.md

Forward Derivation | 正向推演

Generate derived artifacts (BDD scenarios, TDD skeletons, ATDD tables) from approved SDD specifications.

從已批准的 SDD 規格生成衍生工件(BDD 場景、TDD 骨架、ATDD 表格)。

Subcommands | 子命令

Subcommand Description Output
all Generate BDD + TDD (default) .feature + .test.*
bdd Generate BDD scenarios only .feature
tdd Generate TDD skeletons only .test.*
atdd Generate ATDD test tables .md (Markdown tables)

Workflow | 工作流程

  1. Read Spec - Analyze the input SPEC-XXX.md file | 分析規格檔案
  2. Extract AC - Parse all Acceptance Criteria | 解析所有驗收條件
  3. Generate Artifacts - Create BDD/TDD/ATDD outputs | 產生衍生工件
  4. 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           - Derive BDD + TDD | 推演 BDD + TDD
/derive bdd specs/SPEC-001.md           - Derive BDD scenarios only | 僅推演 BDD 場景
/derive tdd specs/SPEC-001.md           - Derive TDD skeletons only | 僅推演 TDD 骨架
/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 開始紅綠重構循環 — Start Red-Green-Refactor cycle
  • 執行 /bdd 細化 Gherkin 場景 — Refine Gherkin scenarios
  • 檢查產生的 [TODO] 標記並補齊實作 — Review [TODO] markers and fill in implementations

Reference | 參考

Weekly Installs
10
GitHub Stars
45
First Seen
Jan 29, 2026
Installed on
opencode9
gemini-cli9
antigravity9
github-copilot9
codex9
mcpjam8