用途
plan-and-execute 是一套面向编码工作的流程方法论,目标是在动手写代码之前先形成清晰、可执行的计划,再按步骤逐项落实。它源自 obra/superpowers(MIT 许可),核心规则只有一条:在编写任何代码之前,先写出详细计划。
主要能力
该方法论把工作划分为四个阶段。
阶段一:规划。 用自己的话复述目标;如果目标含糊,先与用户确认理解。识别输入、输出、约束和验收标准。把工作拆解成细粒度步骤,每一步应以分钟计而非以小时计。按依赖关系排序,确定什么必须先做。把计划明确写出来,并为每一步编号。
阶段二:逐步执行。 从计划中选取下一个未完成的步骤。只做这一步的工作,不顺手做别的。验证该步骤已完成,方式包括运行测试、阅读输出、检查文件。标记该步骤完成,并记录任何偏差或新发现。如果某一步暴露出计划需要更新,先更新计划再继续。
阶段三:处理阻塞。 如果卡住超过几分钟,就停下来。清楚说明:尝试了什么、发生了什么、预期是什么。向用户寻求指引,而不是靠猜测推进。绝不静默跳过某个步骤,也绝不未经说明就替换成另一种做法。
阶段四:收尾。 走查已完成的计划,确认每一步都经过验证。执行最终的端到端检查,例如完整构建、完整测试套件或手动走查。总结做了什么、改了什么,以及还有哪些未决事项。
使用方式
该方法论以规则和阶段的形式给出,使用时按上述四个阶段推进即可。实用规则包括:计划是活文档,随着了解加深要更新它;宁可用许多小步骤,也不要少数几个大步骤;每一步都应有明确的“完成”条件;如果执行中途范围扩大,要明确指出并重新规划;探索性步骤要设定时间上限,避免陷入无底洞。
适用场景
适合需要结构化推进的编码任务,尤其是步骤较多、依赖关系复杂、容易在过程中迷失方向或范围失控的工作。对于目标模糊、需要与用户反复确认的任务,其规划阶段和阻塞处理阶段也能提供明确的沟通框架。
限制
资料未提供该技能的具体平台支持、安装方式、收费模式、价格、效果数据或与其他工具的集成细节。资料中列出的反模式包括:没有计划就开始写代码;写了计划却弃之不用;把多个关注点打包成一个巨大步骤;卡住时静默改变方向而不沟通。