用途:当规格或需求需要在改代码前形成持久、多步骤的实现计划时使用。计划是仓库产物,不依赖聊天记录。
主要能力:以假定读者为熟练工程师、但几乎不了解本工具链与问题域的方式编写计划;明确每个可独立验证任务所需的文件、接口、行为、测试、文档和命令;前置做范围检查(多子系统需拆分为独立计划)、文件结构设计和任务粒度划分;每步为单一动作(约2-5分钟),常以写失败测试、运行确认失败、最小实现、通过测试、编译、审查 diff、提交结束;含自审清单(规格覆盖、占位符扫描、类型一致性);保存后提供委派执行或内联执行两种选择。
使用方式:开始时声明使用本技能;计划保存到 .agents/plans/YYYY-MM-DD-<feature-name>.md,Markdown 加 YAML frontmatter(id、name、kind、category、status、description);状态从 draft 起,自审后转 pending,实现时 running,验证后 done,另设 blocked、superseded。可用命令跟踪: find .agents/plans -maxdepth 1 -type f -name '*.md' -print | sort rg -n '^status:' .agents/plans rg -l '^status: (pending|running|blocked)$' .agents/plans 计划头需含目标、架构、技术栈、规格路径、全局约束。任务需列 Files(创建/修改/测试路径)、Interfaces(Consumes/Produces)与带复选框的步骤。
限制:禁止占位符(如 TBD、TODO、待补细节、写针对上述的测试而无实际代码);不得用“与任务N类似”代替重复代码;不得引用未在任何任务中定义的类型或函数;任务仅在有独立可测试交付物处切分;不得隐藏无关清理;未记录编译结果、diff 审查和提交哈希的任务不算完成;不以意图或代理成功报告作为完成依据。