用途:为代码库中的新功能或系统变更创建规格说明(spec/PRD/执行计划),基于 research/ 目录中已有的研究文档,输出到 specs/ 目录,文件命名格式为 YYYY-MM-DD-topic.md。
主要能力:先判断项目是否必须保持向后兼容(是否允许破坏性变更),无法推断时向用户提问一次;在起草前选择工作路径——Path A(上下文足够,直接转为规格)或 Path B(问题、约束、设计方向或验收标准尚不清晰,先通过提问澄清,不臆造架构决策)。Path A 的工作顺序包括:加载本地规范与上下文、提取设计问题、探索实质不同的备选方案、定义类型化契约、描述调用栈与数据流、映射文件与模块、规划纵向 RGR TDD 切片,最终只产出设计规格,不实现变更。
核心设计理念:规格是入口点的理论。入口点(doors)是规格的一等产物,第 5 节围绕 doors 构建(类型化签名、命名失败、以类型表达的拒绝),并需通过一套评分标准。五条原则:命名领域接缝而非工具;诚实压缩;意图体现在拒绝中;为跨时间的陌生人写作;危险的门要少而诚实。评分标准逐项检查:是否为领域接缝、承诺能否用一句无“和”的陈述句表达、名称是否诚实、义务是否履行、每个出口是否守诺、拒绝是否真实、信任转换是否显式且唯一、不可逆效果是否经过单一咽喉点、边界处是否有气闸、陌生人能否仅凭门重建意图。
使用方式:调用时可通过 $ARGUMENTS 指定研究路径,未指定则使用整个 research/ 目录;研究文档位于 research/ 而非 specs/。建议使用 codebase-research-locator 和 codebase-research-analyzer 代理查找与分析研究文档,并在规格中引用相关研究。生成规格后,逐条处理“开放问题/未解决问题”一节,采用对比式澄清(给出 2-3 个具体选项及权衡)而非开放式提问,并据用户回答更新规格;最后提供执行摘要,列出 doors 名称并指出哪些门守护不可逆效果。
限制:本阶段不实现任何变更,仅创建规格;规格中不包含具体日期或时间线,改用显式阶段(Phase 1、Phase 2 等);若涉及评审门加最终动作的工作流,需将实现/评审验收与批准后的最终动作分开;若为工作流或提示词重构,要求本地、面向动作的阶段/评审/归约提示。其他细节(如具体平台、收费、价格)暂未提供。