How do I install the Spec Derive skill?

Run npx skillmds@latest add asiaostrich/spec-derive in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Spec Derive safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Spec Derive?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Spec Derive free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Spec Derive?

AsiaOstrich (@asiaostrich) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Spec Derive by asiaostrich — Agent Skill

Name: Spec Derive
Rating: 4.5 (4 reviews)
Author: AsiaOstrich

Spec Derive

[UDS] Derive BDD scenarios, TDD skeletons, integration and E2E tests, and ATDD tables from an approved specification. Use when: a spec has been approved and needs test artifacts, generating tagged test skeletons from acceptance criteria, producing contract stubs from a spec. Not for: recovering a spec from existing code — use /reverse; writing or reviewing the spec itself — use /sdd. Keywords: forward derivation, spec to test, BDD scenario, TDD skeleton, ATDD table, 正向推演, 規格衍生, 測試生成.

AsiaOstrich bb58d7a 2 files · 20.6 KB Updated Sep 10, 2026

File contents

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.md file | 分析規格檔案
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 行為定義請參閱對應的命令文件：/derive

For complete AI agent behavior definition, see the corresponding command file: /derive

---name: spec-derivedescription: [UDS] Derive BDD scenarios, TDD skeletons, integration and E2E tests, and ATDD tables from an approved specification. Use when: a spec has been approved and needs test artifacts, generating tagged test skeletons from acceptance criteria, producing contract stubs from a spec. Not for: recovering a spec from existing code — use /reverse; writing or reviewing the spec itself — use /sdd. Keywords: forward derivation, spec to test, BDD scenario, TDD skeleton, ATDD table, 正向推演, 規格衍生, 測試生成.---# 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 | 工作流程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 - 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](./guide.md)- Core standard: [forward-derivation-standards.md](../../core/forward-derivation-standards.md)## AI Agent Behavior | AI 代理行為> 完整的 AI 行為定義請參閱對應的命令文件：[`/derive`](../commands/derive.md#ai-agent-behavior--ai-代理行為)>> For complete AI agent behavior definition, see the corresponding command file: [`/derive`](../commands/derive.md#ai-agent-behavior--ai-代理行為)

Frequently asked questions