核心用法
project-execution 是 attune 工作流的最终执行阶段,在规划完成后接管任务实施。核心流程包括:预执行验证(加载计划、检查环境、确认依赖)→ 任务执行循环(PRE-TASK → TDD循环 → VALIDATE → CHECKPOINT)→ 后期验收(全量测试、质量报告、发布准备)。
TDD 工作流是其标志性实践:RED(写失败测试)→ GREEN(最小实现通过)→ REFACTOR(重构保绿)。每个任务完成后立即标记状态,绝不批量延迟。系统内置质量门禁(测试通过、代码审查、Lint零警告、文档更新等),未达标不得进入下一任务。
进度追踪通过 .attune/execution-state.json 实时持久化,支持燃尽图、日站会报告、阻塞升级等敏捷实践。阻塞管理遵循「2小时原则」:超时未解即升级,附带系统化调试框架(复现→假设→验证→解决→记录)。
显著优点
- 结构严谨:PRE/IMPLEMENT/VALIDATE/CHECKPOINT 四阶段闭环,消除遗漏
- 数据驱动:自动计算 velocity、预估完成日期、实时燃尽
- 质量内建:测试-重构-门禁三位一体,拒绝「先上线后补测试」
- 透明可控:JSON 状态文件 + Markdown 报告,任何时刻可断点续传
潜在局限
- 框架开销大:单任务执行无需此技能,适合多任务、多依赖的复杂项目
- 假设 Python 生态:示例大量引用
pytest、make,其他语言需适配 - 无自动触发:明确声明「执行阶段为终点」,不会自动进入部署或运维
- 依赖前置技能:若无
project-planning输出的实施计划,无法启动
适合人群
中大型软件项目团队、采用敏捷/TDD 的工程组织、需要向管理层汇报进度的技术负责人。不适合快速原型、一次性脚本或无测试文化的团队。
常规风险
- 进度幻觉:JSON 状态若未真实更新,会导致燃尽图失真
- 门禁形式主义:团队可能绕过 REFACTOR 阶段,留下技术债
- 阻塞升级延迟:2小时阈值若被忽视,关键路径风险累积
- 工具链锁定:
make+pytest假设与项目实际栈不匹配时产生摩擦