用途:把 spec 文件夹变成一份经评审的实现计划。规格位于 docs/specs/<slug>/:未指定时列出候选并询问;不存在时停下说明需要先有 spec,不要凭对话规划。读取该目录的 spec.md、已批准原型,以及仓库中的 GLOSSARY.md 与 docs/decisions/,探索代码库,起草 plan.md 并交给用户修正。若工作依赖某框架或托管服务,先确认其官方 agent context(skill、AGENTS.md、随附文档)已装入项目,按厂商推荐形式补齐缺失部分,再起草方案。
主要能力:整篇计划由你填写完整呈现,各节相互约束。仅对草稿无法定夺的分歧提问,每轮一个并给出推荐答案。用户的关键决定:方案选择、验收标准是否足以定义完成、代码中不可见的不许触碰区域、接受哪些风险。
文档结构:开头固定写“代码是地形,计划是地图:不一致时以地形为准;决策层面分歧回流到 spec.md”。六节:方案(所选策略及理由,被否方案各一行)、顺序(先落地什么、何处可验证,超过一次会话按会话粒度拆分,而非预先切割的任务清单)、验收标准(可观察的完成条件清单)、验证与接缝(测试抓在哪、什么高度,尽量用现有接缝)、禁区(不得触碰什么及原因)、风险与未决问题。
限制:约一页;只写模块与行为,不写文件路径或代码片段,唯一例外是原型产出的、比文字更精确表达决策的片段。草稿留在对话中,经用户批准后才在 spec.md 旁写 plan.md;已存在则作为修订呈现。