1. 项目概述
"executing-plans"是Superpowers框架中的一项核心技能,专门用于在独立会话中执行预先编写好的实现计划。这项技能在代码开发、自动化任务处理等场景中尤为实用,能够帮助开发者或AI助手高效、系统地完成复杂任务。
作为Superpowers技能体系的重要组成部分,executing-plans提供了一套标准化的计划执行流程,包括计划加载、关键审查、任务执行和完成报告四个主要阶段。这项技能特别强调执行过程中的质量控制,要求在每个步骤都进行验证,确保最终产出符合预期。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心功能解析
2.1 计划加载与审查
执行计划的第一步是加载并审查预先编写好的计划文件。这个过程不仅仅是简单的读取,而是需要进行关键性评估:
- 完整性检查:确认计划是否包含所有必要元素
- 可行性分析:评估每个步骤是否具备执行条件
- 风险识别:发现可能存在的问题或潜在障碍
重要提示:如果审查过程中发现任何问题,必须立即与人类伙伴沟通,而不是自行猜测或尝试解决。
2.2 任务执行机制
executing-plans技能采用分步执行的方式处理计划中的每个任务:
- 将任务标记为"进行中"状态
- 严格按照计划中的步骤执行
- 执行指定的验证操作
- 确认无误后将任务标记为"已完成"
这种机制确保了执行过程的可追踪性和可控性,特别适合需要精确控制的开发任务。
2.3 完成与报告流程
当所有任务执行完毕后,技能会自动触发"finishing-a-development-branch"子技能,完成以下工作:
- 运行测试验证
- 提供完成选项
- 执行用户选择的操作
- 生成最终报告
3. 使用场景与最佳实践
3.1 典型应用场景
executing-plans技能特别适用于以下场景:
- 复杂功能开发:将大型开发任务分解为可管理的小步骤
- 系统迁移/升级:执行预先规划好的系统变更流程
- 自动化部署:按照既定计划完成部署任务
- 代码重构:有序实施重构方案
3.2 使用前准备
为了获得最佳效果,建议在使用executing-plans技能前做好以下准备:
- 确保计划文件完整且详细
- 验证所有依赖项可用
- 准备必要的测试验证工具
- 确保执行环境配置正确
3.3 执行中的注意事项
在实际执行过程中,需要特别注意以下几点:
- 及时沟通:遇到任何问题立即停止并寻求帮助
- 严格验证:不跳过任何验证步骤
- 状态跟踪:准确更新任务状态
- 环境隔离:不在主分支上直接执行变更
4. 技术实现细节
4.1 核心工作流程
executing-plans技能的工作流程可以概括为以下步骤:
- 加载计划文件
- 创建待办事项列表
- 按顺序执行每个任务
- 标记任务状态
- 执行具体操作
- 运行验证
- 更新任务状态
- 完成所有任务后触发结束流程
4.2 关键子技能集成
executing-plans技能依赖于几个关键子技能:
- using-git-worktrees:确保工作空间隔离
- writing-plans:创建要执行的计划
- finishing-a-development-branch:完成开发后的收尾工作
这些子技能的协同工作确保了整个执行过程的完整性和可靠性。
4.3 错误处理机制
技能内置了完善的错误处理机制:
- 阻塞检测:自动识别执行障碍
- 验证失败处理:对重复验证失败采取适当措施
- 计划缺陷处理:发现计划缺陷时停止执行
- 指令理解检查:对不明确指令请求澄清
5. 常见问题与解决方案
5.1 执行受阻时的处理
当遇到执行障碍时,建议采取以下步骤:
- 立即停止当前操作
- 记录具体问题细节
- 与人类伙伴沟通问题
- 等待明确指示后再继续
5.2 验证失败的处理
如果验证步骤反复失败:
- 检查执行环境配置
- 确认依赖项版本
- 验证输入数据正确性
- 必要时回退到上一个稳定状态
5.3 计划缺陷的识别与处理
常见的计划缺陷包括:
- 缺少必要步骤
- 依赖项未明确
- 验证方法不明确
- 资源需求未说明
发现这些问题时,应该暂停执行并请求计划修订。
6. 性能优化建议
6.1 计划编写优化
为了提高执行效率,建议在编写计划时:
- 将大任务分解为小步骤
- 明确每个步骤的验证方法
- 注明可能的依赖关系
- 提供足够的上下文信息
6.2 执行环境配置
优化执行环境可以显著提高效率:
- 确保足够的系统资源
- 配置必要的工具链
- 准备测试数据
- 设置适当的超时参数
6.3 监控与日志
完善的监控和日志记录有助于:
- 快速定位问题
- 分析执行效率
- 优化后续计划
- 提供审计追踪
建议配置详细的执行日志,记录每个关键操作和验证结果。
7. 与其他Superpowers技能的协作
executing-plans技能通常与其他Superpowers技能配合使用:
- writing-plans:创建要执行的计划
- subagent-driven-development:在支持子代理的平台使用更高级功能
- using-git-worktrees:管理工作空间
- finishing-a-development-branch:完成开发流程
这种技能组合提供了从计划到完成的完整解决方案。
8. 平台适配与限制
8.1 支持的平台
executing-plans技能可以在多种平台上运行,但性能表现可能有所不同:
- 基础支持:所有Superpowers兼容平台
- 增强支持:支持子代理的平台(如Claude Code、Codex CLI等)
8.2 性能考量
在不同平台上的性能差异主要来自:
- 子代理支持程度
- 系统资源限制
- 执行环境隔离能力
- 工具链完整性
8.3 使用限制
需要注意以下限制:
- 不能在没有计划的情况下使用
- 需要人类监督关键决策点
- 复杂任务可能需要分多次执行
- 某些平台可能有特殊要求
9. 实际应用案例
9.1 案例一:功能开发
在一个Web应用开发项目中:
- 使用writing-plans创建功能开发计划
- 通过executing-plans执行计划
- 遇到API兼容性问题时暂停并请求帮助
- 根据反馈调整后继续执行
- 最终完成功能开发并通过所有测试
9.2 案例二:系统迁移
执行数据库迁移任务:
- 制定详细的迁移步骤和验证方案
- 使用executing-plans按步骤执行
- 在每个关键点进行数据一致性验证
- 完成迁移后进行全面的系统测试
- 生成迁移报告和回滚方案
10. 技能扩展与自定义
10.1 自定义验证方法
可以根据项目需求添加特定的验证方法:
- 性能基准测试
- 安全扫描
- 兼容性检查
- 用户体验评估
10.2 扩展执行步骤
支持添加自定义执行步骤:
- 代码质量检查
- 文档生成
- 部署后监控
- 用户通知
10.3 集成外部工具
可以集成各种开发工具:
- 持续集成系统
- 代码审查工具
- 测试框架
- 监控平台
这种扩展能力使得executing-plans技能可以适应各种复杂的开发场景。
