用途:在单一技能内管理业务功能规格的完整生命周期,产出无技术术语的 8 节功能规格,使任何团队可仅凭规格在任意技术栈上重建该功能。第 8 节测试用例登记表(TC-{FEATURE}-{NNN})为业务测试用例的唯一事实来源,并可追溯到实际执行的测试代码。
主要能力:支持七种模式——draft(从想法/需求编写临时规格,无代码,证据为 TBD)、init(无 docs/specs/{Bucket}/ 时从源码编写完整 8 节规格)、update(代码变更后按节影响映射更新)、audit(按节输出陈旧度报告,不改文档)、amend(缺陷修复流程中的最小回归范围修订)、tests(生成或更新第 8 节测试规格)、sync(协调第 8 节测试用例与执行测试代码,含前向/反向/采集、孤儿与陈旧检测)。
使用方式:先解析模式,显式 [mode=<x>] 优先,否则依据请求与仓库状态推断,含糊时直接询问用户;随后读取对应 references/{author,tests,sync}.md 正文执行,不得凭记忆运行;开始前拆分任务并跟踪状态。规格固定 8 节:概述、术语表、用户故事与验收标准、业务规则、领域模型、流程与交互面、权限与角色、测试规格。第 1-7 节正文严格无技术术语,技术标识仅出现在证据载体、frontmatter 与 mermaid 块中。
适用场景:功能规格编写与维护、测试规格生成、规格与测试代码同步、规格陈旧审计、缺陷修复后的规格修订。
限制:需遵循 M1-M7 强制要求与规范测试用例格式,违反 M1-M5 或 M7 即判定产物失败;第 8 节测试用例须携带可验证的 [Source: namespace/service/id] 证据,仅 draft 模式例外;update 不得覆盖已有测试用例;INDEX.md 与 ERD 为派生产物,由 $spec-index 生成,本技能不直接触发。具体安装命令与收费信息暂未提供。