核心用法
project-execution 是 Claude Code Attune 插件的最终执行阶段技能,设计用于在详细计划完成后系统化落地实施。核心工作流遵循严格的 TDD 循环(RED-GREEN-REFACTOR),每个任务都必须通过检查点验证(Checkpoint Validation)和质量门禁(Quality Gates)才能标记完成。
执行框架三阶段
1. 预执行阶段:加载实施计划、验证项目初始化状态、检查依赖关系、识别无依赖的起始任务
2. 任务执行循环:按依赖顺序逐个执行任务,每个任务包含 PRE-TASK → IMPLEMENT(TDD 循环)→ VALIDATE → CHECKPOINT 四个步骤
3. 执行后阶段:全量测试验证、代码质量检查、生成完成报告
关键纪律要求
- 立即标记完成:每个任务完成后必须立即调用
TaskUpdate()标记状态,禁止批量延迟 - 质量门禁必须通过:包含验收标准达成、测试通过、代码检查、文档更新等硬性条件
- 状态持久化:执行状态保存至
.attune/execution-state.json,支持断点续传
进度追踪与报告
内置每日站会(Daily Standup)和 Sprint 报告模板,支持燃尽图(Burndown)指标计算、阻塞问题(Blocker)管理与升级机制、速度(Velocity)跟踪与动态调整建议。
显著优点
- 结构化执行:将模糊的开发任务转化为可量化、可追踪的标准化流程
- TDD 原生集成:每个功能迭代强制遵循测试先行,提升代码质量和可维护性
- 质量内建(Quality Gates):在流程中嵌入多重验证,而非事后补救
- 断点续传能力:通过状态文件支持长时间跨度的项目执行
- 与 Superpowers 深度整合:可调用 executing-plans、systematic-debugging 等增强能力
潜在局限
- 框架开销较重:对于简单孤立任务,正式流程反而降低效率
- 依赖前置计划:若无完整实施计划,技能无法有效工作
- 学习曲线陡峭:TDD 和质量门禁对不熟悉者需要适应期
- 探索性开发不适用:原型验证、技术预研等场景不建议使用
适合人群
- 中大型项目团队:需要多人协作、长期追踪的复杂功能交付
- 质量敏感场景:金融、医疗等对代码可靠性要求极高的领域
- 远程异步协作:通过标准化状态和报告降低沟通成本
- TDD 实践者:希望将测试驱动开发融入日常工作流的开发者
常规风险
- 过度工程化风险:小项目套用完整框架导致效率损失
- 阻塞积累:单点阻塞若未及时升级可能拖累整体进度
- 状态文件冲突:多人协作时
.attune/execution-state.json需版本控制协调 - 工具链依赖:重度依赖 pytest、类型检查、linting 等外部工具,环境配置不当会导致执行失败
- 计划与执行脱节:若前期计划不完善,执行阶段会暴露设计缺陷导致返工