用途:为未见过当前对话、代码库探索或同类计划的执行者编写实施计划,即使作者预期自己执行也要如此,因为上下文会在会话边界丢失。计划基于意图而非规定,说明必须成立的结果、点名具体文件与符号、指向可模仿的范例,并用验证命令为每步设门禁。
主要能力:先做侦察,从仓库配置(justfile、package.json、noxfile、CI)核实构建/测试/lint/类型检查命令,收集约定与范例,确认所用 VCS 与当前修订,计划中带修订戳与漂移检查。按“一个计划=一个可独立落地、可评审的改动(约一个 PR)”拆分,必要时拆成编号计划并标明依赖顺序。单计划为一个文件,多计划用子目录加本地 README 索引,编号单调且不复用。计划中的代码以草图、伪代码、签名为主,仅在必须特定实现时写全。执行中遇到设计分叉时,执行者按模板 STOP 条件写回交,作者研究后写 memo 文件并修订计划。
使用方式:计划存放位置按项目既有约定、$AGENTS_PLANS_DIR、./docs/plans/、./plans/ 的顺序解析,不在项目中则询问。写作前阅读 references/plan-template.md,多计划最后用 references/index-template.md 写索引。规划期间只在计划目标目录写入,不编辑源码。
适用场景:需求已大致确定(请求、工单、设计讨论或其它技能交接)后编写实施计划。
限制:不负责构思、审计或设计辩论;缺失决策先尝试从代码库解决,剩余问题逐个向用户提问并附推荐答案;若仓库没有可用的验证命令,应说明,建立验证命令可能需作为第一个计划。