mcpField
E
executing-plans

executing-plans

github.com/ericgandradeAgent 工作流8548 次安装25 周前更新
代码仓库

关于 executing-plans

executing-plans 是用于执行既有实现计划的 Agent 技能，通过分批处理、验证和反馈检查点来管理进度。

主要功能

  1. 01执行前审查计划
  2. 02分批完成计划任务
  3. 03每批前报告进度
  4. 04设置验证与评审检查点

适用场景

  1. 01按计划分阶段实现并接受评审
  2. 02对需要回归检查的改动进行执行

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/ericgandrade/claude-superskills --skill executing-plans

安装后在 Claude Code 中输入/executing-plans确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
evals/
evals.json
trigger-eval.json

详细介绍

执行计划

用途

分批执行已批准的实现计划，并设置检查点、验证和审查关卡。

适用场景

在以下情况下使用此技能：

  • 已有书面的实现计划
  • 工作必须定期通过审查检查点
  • 存在回归风险，需要严格遵循计划并进行验证

进度跟踪

在每批任务开始前显示计划执行进度：

[████░░░░░░░░░░░░░░░░] 20% — Phase 1: Loading & Reviewing Plan
[████████░░░░░░░░░░░░] 40% — Phase 2: Executing Batch N
[████████████░░░░░░░░] 60% — Phase 3: Reporting & Verification
[████████████████░░░░] 80% — Phase 4: Awaiting Feedback
[████████████████████] 100% — Phase 5: Final Verification Complete

对于包含许多任务的计划，应调整进度条以反映实际任务完成情况：X/Y tasks done (N%)。

工作流

  1. 加载并审查计划
  2. 执行第一批任务
  3. 汇报结果和验证输出
  4. 暂停以等待反馈，然后继续分批执行
  5. 完成分支并进行最终验证

概述

加载计划、审查计划、分批执行任务，并在各批次之间汇报以供审查。

核心原则： 分批执行，并设置检查点供架构师审查。

开始时宣布： “我将使用 executing-plans 技能来实现此计划。”

流程

第 1 步：加载并审查计划
  1. 读取计划文件
  2. 严格审查——指出计划中存在的疑问或顾虑
  3. 如果有顾虑：开始前先向你的合作伙伴提出
  4. 如果没有顾虑：创建 TodoWrite 并继续
第 2 步：执行一批任务

默认：前 3 项任务

对于每项任务：

  1. 标记为 in_progress
  2. 严格遵循每个步骤（计划中的步骤都应简明具体）
  3. 按照要求运行验证
  4. 标记为 completed
第 3 步：汇报

批次完成后：

  • 展示已实现的内容
  • 展示验证输出
  • 说明：“已准备好接收反馈。”
第 4 步：继续

根据反馈：

  • 必要时进行修改
  • 执行下一批任务
  • 重复上述流程，直到全部完成
第 5 步：完成开发

所有任务完成并通过验证后：

  • 宣布：“我将使用 finishing-a-development-branch 技能来完成这项工作。”
  • 必需的子技能： 使用 superpowers:finishing-a-development-branch
  • 遵循该技能来验证测试、提供选项并执行所选操作

何时停止并寻求帮助

遇到以下情况时，立即停止执行：

  • 在批次执行过程中遇到阻碍（缺少依赖项、测试失败、指令不明确）
  • 计划存在妨碍启动工作的重大缺陷
  • 你不理解某项指令
  • 验证反复失败

请先请求澄清，不要猜测。

何时重新审视前面的步骤

出现以下情况时，返回第 1 步重新审查：

  • 合作伙伴根据你的反馈更新了计划
  • 基本方案需要重新考虑

不要强行越过阻碍——停止并寻求帮助。

请记住

  • 先严格审查计划
  • 严格遵循计划步骤
  • 不要跳过验证
  • 计划要求使用技能时，请参考相应技能
  • 批次之间只需汇报并等待
  • 遇到阻碍时停止，不要猜测
  • 未经用户明确同意，绝不要在 main/master 分支上开始实现

集成

必需的工作流技能：

  • superpowers:using-git-worktrees——必需：开始前设置隔离的工作区
  • superpowers:writing-plans——创建此技能要执行的计划
  • superpowers:finishing-a-development-branch——所有任务完成后结束开发

关键规则

  • 遇到阻碍时立即停止并寻求澄清。
  • 不要跳过计划中指定的验证命令。
  • 未汇报并等待反馈之前，不要继续执行下一批任务。

错误处理

错误可能原因处理方式
未找到计划文件提供的路径不存在，或文件已移动请用户确认文件路径；列出 docs/plans/ 中可用的计划文件
任务描述有歧义计划中的步骤不清晰或说明不足停止并请用户澄清，然后再继续
任务依赖的前置任务失败较早的任务失败或被跳过报告依赖项失败；解决问题前不要继续
验证命令失败计划中定义的测试或检查未通过立即停止，报告完整的错误输出，并等待用户指示
执行期间遇到阻碍出现意外状态、文件冲突或上下文缺失暂停，报告确切的阻碍，并询问用户如何继续
批次完成但部分任务失败批次中的部分任务失败报告哪些任务成功、哪些失败；询问用户是重试还是跳过

使用示例

  1. “使用 executing-plans 实现 docs/plans/2026-02-20-api-hardening.md。”
  2. “使用 executing-plans 执行接下来的 3 个任务，然后暂停以供审查。”
  3. “使用 executing-plans 完成剩余任务并报告最终检查结果。”

评论

支持 Markdown