executing-plans 技能 — 逐步执行书面计划
Datarim 如何将书面实施计划转化为可追踪、可验证的执行过程——包含明确的检查点、停止并询问规则,以及强制的收尾阶段。
书面计划只有在被按原样执行时才有价值。executing-plans 技能定义了如何加载计划、在触碰任何代码之前先审阅计划,并以明确的状态追踪和证据要求来执行每一项任务。
该技能专为单会话执行而设计。当运行时支持生成隔离的 agent 时,优先使用 subagent-driven-development——由独立 agent 分别处理实现和审查,可提升结构化执行的质量。对于线性的单 agent 工作,executing-plans 是合适的工具。
第 1 步 — 开始前先审阅
首先读取计划文件。任何关于其内容的疑问或顾虑都会在开始任何任务之前提出。该技能明确允许通过这一审阅来暴露问题——对于存在关键缺口、导致无法启动的计划,应当先解决问题,而不是绕过它。如果没有出现顾虑,则将计划中的任务枚举为工作清单:每项任务获得明确的 [ ] / [~] / [✓] 状态,然后开始执行。
第 2 步 — 带追踪地执行
每项任务在开始任何工作之前先标记为进行中,以便操作者始终知道当前活跃的任务是什么。计划步骤被严格遵循——该技能并不允许在执行中途重新诠释计划的方法。计划中指定的验证按原样运行。只有当任务的验证通过时,该任务才被标记为完成;证据——命令输出、文件路径、测试结果——会内联记录在清单中。
当出现阻碍时——缺少依赖、无法解决的失败测试、不清晰的指令——执行立即停止。该技能不允许靠猜测绕过阻碍。由操作者提供澄清后,执行从停止处恢复。
第 3 步 — 收尾阶段
所有任务验证完毕后,该技能移交给 finishing-a-development-branch。这是一个必需的子技能,而非可选。它涵盖关闭分支所需的操作:验证测试通过、确认分支干净,并向操作者呈现后续步骤。执行并不在最后一个清单项处结束——而是在收尾阶段结束时才结束。
一个具体示例
一个计划有六项任务:搭建模块骨架、添加单元测试、实现函数、运行测试套件、检查类型能否编译、更新变更日志。清单开始时六项均为 [ ]。实现函数后,测试套件因缺少导入而失败。执行停止。操作者指出正确的导入路径。执行恢复,应用修复,测试套件重新运行并通过,该任务被标记为 [✓],并将测试输出记录为证据。
另请参阅 writing-plans 技能文章,了解该技能所执行的计划是如何创建的;以及 Datarim 是什么,了解完整的流水线背景。