用途:spec-dd 编排规范优先的开发流程,覆盖行为规范、测试场景推导、测试实现规划、测试实现、功能实现、跨产物对齐审查等阶段。阶段间的质量门为建议性质,可提示问题并建议处理,但用户可覆盖并继续。
主要能力与命令:/spec-dd 自动识别阶段、评估状态并推荐下一步;其余子命令对应各阶段——/spec-dd:product-spec(产品规范,Phase 0,包含问题、可证伪的赌注、成功标准与评估)、/spec-dd:spec(行为规范)、/spec-dd:test(测试规范)、/spec-dd:test-impl(测试实现规范)、/spec-dd:verify(实现验证)、/spec-dd:review(对齐审查)。命令可接受可选的功能名参数,如 /spec-dd:spec user-auth;/spec-dd:verify 还接受规范文件路径作为首个参数,可对任何规范文件(包括非本工作流产出的非正式文档)进行验证。未提供功能名且存在多个功能时,会列出可选功能请用户选择。
产物:所有产物位于 docs/specs/,每个功能一组文件,命名分别为 <feature>-product-spec.md、-specification.md、-test-specification.md、-test-implementation-specification.md、-verification.md、-implementation-review.md。
使用方式:任一命令调用时,先读取 references/ 下对应参考文件(spec 对应 specification.md,test 对应 test-specification.md,test-impl 对应 test-implementation-specification.md,verify 对应 verify.md,review 对应 review.md);随后扫描清单文件自动检测项目语言(package.json、requirements.txt、pyproject.toml、go.mod、Cargo.toml、pom.xml、build.gradle),据此决定测试框架、模式、惯用法与交接提示。子阶段命令会检查前序产物是否存在,发现缺口时建议先完成更早阶段但不阻塞。
阶段要点:行为规范定义系统做什么(行为契约而非实现细节),审查模糊用语、缺失边界、未定义术语与不可衡量验收标准,未决项标记 [NEEDS CLARIFICATION]。测试规范仅依据行为规范推导 Given/When/Then 场景,要求一个场景一个行为、一步一个动作,并建立覆盖矩阵与追溯。测试实现规范将每个测试场景映射到具体技术方案(框架、夹具、Mock、文件组织等)。测试实现与功能实现为交接阶段,本技能不编写测试代码或实现代码,而是提出交给编码代理的提示,测试需先失败,实现代码需在不修改测试文件的前提下使测试通过。验证阶段按需求级别生成 PASS/FAIL 清单,优先读代码验证,仅在必要时运行定向测试,对非确定性测试依据代码阅读判定。审查阶段交叉核对三份规范文档、实际测试与实现代码,并检测与运行项目测试命令。
适用场景与限制:适用于希望以规范驱动方式推进功能开发、并将测试与实现交接给编码代理的团队或个人。局限:质量门仅建议性;本技能不直接编写测试或实现代码;非确定性测试的验证基于代码阅读;其他收费、价格、平台支持等信息暂未提供。