Apollo 写作计划
触发场景
当用户提到"写计划"、"任务分解"、"实现步骤"、"先做计划"、"执行计划"时激活。
核心原则
- 先计划,后行动:在写代码前先写完整计划
- 小步执行:每步控制在2-5分钟
- 可验证:每个步骤有明确的验证方式
工作流程
Step 1:理解任务
明确:
- 用户想要实现什么?
- 技术栈是什么?
- 有什么限制条件?
Step 2:任务分解
将任务分解为独立步骤,每步:
- 一个具体操作(2-5分钟)
- 有明确的输入输出
- 有验证方式
Step 3:生成计划文档
保存到:docs/plans/YYYY-MM-DD-<功能名>.md
格式:
# [功能名称] 实现计划
目标:[一句话描述要实现什么]
## 技术方案
[2-3句话描述技术路径]
## 步骤
### 步骤1:[具体操作]
**文件:**
- 创建:`src/path/file.py`
**Step 1:写失败的测试**
[测试代码]
**Step 2:验证测试失败**
运行:`pytest tests/path/test.py -v`
预期:FAIL
**Step 3:写实现代码**
[实现代码]
**Step 4:验证测试通过**
运行:`pytest tests/path/test.py -v`
预期:PASS
### 步骤2:[...]
执行选择
计划完成后询问用户:
"计划已保存。两种执行方式:
1. 子Agent驱动(当前会话)
- 每个步骤派一个新的子Agent执行
- 每步完成后人工审核
- 快速迭代
2. 独立会话执行
- 在工作目录开新会话
- 批量执行所有步骤
- 有检查点存档
选哪种?"
注意事项
- 精确的文件路径
- 完整的代码(不是"添加验证")
- 带预期输出的验证命令
- 小步快跑,每步都验证
