用途:在已有规格或需求、准备进行多步骤任务但尚未改动代码时,编写一份可直接执行的实施计划。默认假设执行工程师熟悉开发但对本项目工具链和问题域几乎不了解。计划文件默认保存到 docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md,用户对位置的偏好可覆盖此默认值;该流程应在专用 worktree 中运行。
主要能力:先做范围检查,若规格涉及多个相互独立的子系统,建议拆成每个子系统一份计划;在定义任务前先规划文件结构,明确每个文件由谁负责、边界与接口,倾向更小更聚焦的文件,按职责而非技术层拆分,现有代码库遵循既有模式。任务按小步骤拆分,每步是一个 2 至 5 分钟的动作:运行展示当前行为的检查、做最小改动、再次运行同一检查确认结果、提交。仅在能防止重复失败、稳定契约、非显而易见的逻辑或高影响行为时才新增测试,测试期望值来自规格或真实数据而非新代码输出。计划必须带固定头部(目标、架构、技术栈等),每个任务需列出文件、检查命令,并以复选框步骤记录执行过程。
使用方式:计划开头声明正在使用该技能。文中给出确切文件路径、每一步的完整代码、确切命令与预期输出,并频繁提交。禁止使用占位符,例如 TBD、TODO、稍后实现、填写细节、添加适当错误处理、为上述写测试(却不给测试代码)、与任务 N 类似,或引用任何任务中未定义的类型、函数、方法。完成后自行对照规格自检:规格覆盖、占位符扫描、类型一致性(如任务 3 用 clearLayers() 任务 7 却写 clearFullLayers() 即为缺陷),发现问题就地修复,缺少任务则补上。最后给执行者两种选择:子代理驱动(推荐,每个任务派新子代理并在任务间审查)或内联执行(本会话批量执行并设检查点)。
适用场景:多步骤功能或改造的前置规划,尤其需要交接给不熟悉上下文的执行者。
限制:资料未给出具体收费、平台、运行环境或效果数据,暂未提供。