vibecoding-execute

description	VibeCoding 执行阶段：计划排期(P)和执行实现(E)。由 vibecoding-workflow 编排调度，不直接触发。包含 Sprint Contract 协商、任务拆分、编码执行、Reflexion 自查。仅在 workflow 指示进入 P 或 E 阶段时使用。
name	VibeCoding Execute

执行阶段

P 计划排期 (Path B+)

目标：方案 → 可执行的原子任务序列

操作：

1. 将 D 阶段确定的方案拆分为原子任务：
   • 每个任务 ≤ 1 个文件的修改 或 1 个函数的实现
   • 标注任务间依赖关系
   • 标注预估复杂度（简单/中等/复杂）
2. 如 .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 阶段的任务清单，直接：

1. 定位问题代码
2. 修复 / 实现
3. 自检无语法错误
4. 进入 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 执行中用户提出新需求：

1. 判断是否属于当前 Sprint 范围
2. 如果不属于 → 记录到 .ai_state/state.json 的 backlog 字段
3. 回复："已记录，当前 Sprint 完成后处理"
4. 继续当前任务