用途:读取 .specs/specs/<slug>.md 中的规格说明,将其拆解为可演示的多阶段垂直切片实现计划,并保存到 .specs/plans/<slug>.md,供后续 /build、/test 按阶段执行。若未提供参数,会列出 specs 供用户编号选择;若计划文件已存在,则提示覆盖或另取名字。
主要能力:一、先探索代码库,梳理架构、模式与集成点,遵循“先代码库、后文档”的研究顺序,无法验证的论断标记为不确定而不编造;二、识别跨阶段的持久架构决策,如路由结构、数据库 schema、核心数据模型、认证授权方式、第三方服务边界;三、按垂直切片划分阶段,每阶段贯穿 schema→service→API→UI→tests 各层,可独立演示,阶段命名用目标短语而非分层名;四、声明阻塞关系,默认线形链,仅在互不门控时声明独立边;五、Done when 为原子可验证的复选框(须指明测试文件/名称、命令或文件与内容),拒绝纯文字条件;六、对复杂 schema 或宽范围机械重构给出分层先建、expand→migrate→contract 等例外处理;七、按“涉及模块数”控制阶段数量阈值,超限时提示拆分规格或继续;八、可给任务打上 [skill:diagnose]、[agent:test-auditor]、[skill:code-review] 等标签。
使用方式:通过斜杠命令调用并传入 slug;工作流为读规格、探索代码库、提取架构决策、起草切片、向用户展示分解并等待确认(可合并、拆分、迭代),确认后保存计划。保存格式含 Architectural Decisions、逐阶段(User stories、Blocked by、What to build、Done when)、Out of Scope(逐字沿用)、Open Questions。完成后逐阶段打印一行摘要,并询问是否运行 /build <slug>、/test <slug> 或就此结束;实施由 /build <slug> 负责分支创建、实现、反馈循环、勾选与提交,每次调用推进一个阶段。
限制与规则:阶段必须源自规格中的用户故事,不得虚构;每阶段须端到端可演示;Done when 必须是可测试的复选框;单个阶段超过 5 项 Done when 需先拆分;不得修改源规格内容;Out of Scope 逐字沿用。官方文本中未提供的定价、平台支持、依赖或性能数据暂未提供。