| description | VibeCoding 执行阶段：计划排期(P)和执行实现(E)。由 vibecoding-workflow 编排调度，不直接触发。包含 Sprint Contract 协商、任务拆分、编码执行、Reflexion 自查。仅在 workflow 指示进入 P 或 E 阶段时使用。 |
| name | VibeCoding Execute |
执行阶段
P 计划排期 (Path B+)
目标：方案 → 可执行的原子任务序列
操作：
- 将 D 阶段确定的方案拆分为原子任务：
- 每个任务 ≤ 1 个文件的修改 或 1 个函数的实现
- 标注任务间依赖关系
- 标注预估复杂度（简单/中等/复杂）
- 如 .ai_state/ 存在，写入 feature_list.json：
{
"features": [
{"id": 1, "desc": "任务描述", "file": "路径", "status": "pending", "deps": []},
{"id": 2, "desc": "任务描述", "file": "路径", "status": "pending", "deps": [1]}
],
"completed": 0,
"total": 5
}
Sprint Contract
P 阶段完成后、E 阶段开始前，向用户确认：
Sprint Contract
- 范围: 本次完成任务 #1 ~ #N
- 排除: 明确不做的内容
- 验收标准: 怎么算完成
- 预估: 约 N 个文件修改
确认后开始编码。Sprint 中不接受范围变更，新需求记入积压。
用户确认后 → 如 .ai_state/ 存在，写 state.json {"phase":"E",...} → 进入 E 阶段
E 执行实现 (All Paths)
目标：按计划逐个完成任务
Path A (快速修复)
不需要 P 阶段的任务清单，直接：
- 定位问题代码
- 修复 / 实现
- 自检无语法错误
- 进入 T 阶段
Path B+ (标准流程)
按 feature_list.json 的任务顺序执行：
For each Task:
1. 先读目标文件，理解现有代码
2. 编写实现
3. 确认无语法错误
4. [Reflexion] 自问：
- 这段代码是否做了且只做了 Task 描述的事？
- 有没有"顺手"改了别的东西？
- 错误处理是否完整？
- 是否遵循了项目现有代码风格？
5. 如 .ai_state/ 存在，更新 feature_list.json: status → "done"
6. 如 .ai_state/ 存在，更新 progress.json: percent → (completed / total * 100)
7. 继续下一个 Task
生成策略 (Cursor 原生能力利用)
| 场景 | 策略 |
|---|
| 单文件简单修改 | 直接编辑 |
| 多文件协调修改 | 在一轮中完成所有相关文件，保持一致性 |
| Path C/D 复杂任务 | 建议用户使用 /worktree 在隔离分支中开发 |
| 不确定的库 API | 先搜索代码库中的现有用法，再查文档 |
Sisyphus 规则
任务清单全部完成前不能停止：
- 上下文接近上限 → 保存所有状态到 .ai_state/ → 告知用户：
"已完成 N/M 个任务，进度已保存。请新开会话后说'继续'恢复。"
- 不要在中间任务半完成时停止。要么完成当前任务再停，要么回退当前任务的修改
范围变更处理
Sprint 执行中用户提出新需求：
- 判断是否属于当前 Sprint 范围
- 如果不属于 → 记录到 .ai_state/state.json 的 backlog 字段
- 回复："已记录，当前 Sprint 完成后处理"
- 继续当前任务
