VibeCoding 工作流 V3（快速执行版）

一个专为 RooCode + VibeCoding 优化的仓库模板，强调 代码优先的持续交付，而非以文档为中心的繁重治理。

此版本旨在解决智能体工作流中常见的失效模式：

• AI 可以持续运行，但实际代码产出缓慢
• 反复重新审计文档和待办事项状态
• 过度委派给架构师角色或只读分析模式
• 过小的切片导致频繁的重新规划和状态维护
• Token 消耗大量用于流程开销，而非实际实现

相较于慢速工作流的变更点

V3 更改了默认行为：

• 默认 = 直接编写代码
• 仅在模糊度或影响范围确实较大时才进行委派
• 除非文档阻塞了执行，否则不要先修复文档再编码
• 批量更新运行时文档，而不是每完成一个微步骤就更新
• 仅在真实触发条件下重新规划，而非每隔几个小切片就规划一次

简而言之：

更倾向于采用轻量治理的执行方式，而非偶尔执行的治理方式。

---

仓库用途

本仓库是一个 工作流模板仓库，而非项目运行时仓库。

它包含两部分内容：

.
├── project-runtime/
│   ├── AGENTS.md
│   └── docs/
│       ├── WORK_QUEUE.md
│       ├── SESSION_STATE.md
│       ├── ROADMAP.md
│       └── DONE.md
└── workflow-assets/
    ├── prompt/
    │   ├── PROMPT_BOOTSTRAP.md
    │   └── PROMPT_CONTINUE.md
    └── roo_modes/
        ├── Execution_Orchestrator.md
        ├── Focused_Executor.md
        └── Milestone_Reviewer.md

重要区分

将此模板应用于真实项目时：

• 仅将 project-runtime/ 中的文件复制到目标仓库
• 将 workflow-assets/ 保留在本模板仓库，或存放在你自己的本地 AI 工作流保管库中
• 切勿将整个模板仓库复制到目标项目中

这种分离可防止工作流元文件污染项目上下文。

---

需要复制到真实项目的运行时文件

将以下文件复制到目标项目中：

• project-runtime/AGENTS.md → <target-repo>/AGENTS.md
• project-runtime/docs/WORK_QUEUE.md → <target-repo>/docs/WORK_QUEUE.md
• project-runtime/docs/SESSION_STATE.md → <target-repo>/docs/SESSION_STATE.md
• project-runtime/docs/ROADMAP.md → 可选
• project-runtime/docs/DONE.md → 可选

推荐的运行时最小文件集

对于速度优先的开发方式，最小可用文件集为：

• AGENTS.md
• docs/WORK_QUEUE.md
• docs/SESSION_STATE.md

仅在需要里程碑方向指引时添加 ROADMAP.md。 仅在智能体反复重新处理已关闭工作时添加 DONE.md。

---

如何使用

1. 一次性引导项目

在你的真实项目仓库中：

1. 将运行时文件复制到项目中
2. 将占位符替换为真实项目信息
3. 从 workflow-assets/roo_modes/ 创建 Roo 模式
4. 使用 workflow-assets/prompt/PROMPT_BOOTSTRAP.md 中的引导提示词

引导过程应仅做四件事：

• 仅检查代码仓库以建立实际情况
• 实例化 WORK_QUEUE.md 和 SESSION_STATE.md
• 识别主线切片
• 立即开始执行第一个实现切片

它 不应 变成大规模的文档重写活动。

---

2. 日常工作中使用继续模式

引导完成后，日常执行应使用：

• AGENTS.md
• docs/WORK_QUEUE.md
• docs/SESSION_STATE.md
• workflow-assets/prompt/PROMPT_CONTINUE.md

每日继续模式应：

• 仅读取运行时状态文档
• 避免全仓库范围的重新审计
• 避免文档美化
• 直接执行当前切片
• 在取得有意义的进展后批量更新状态

---

Roo 模式映射

Execution Orchestrator（执行编排器）

将此作为主要模式。

它针对以下场景进行了优化：

• 直接实现
• 有限的委派
• 低中断
• 连续完成多个本地切片

Focused Executor（专注执行器）

当编排器需要一个独立实现单元来完成单个具体切片时使用。

Milestone Reviewer（里程碑审查器）

仅在以下情况使用：

• 队列实际情况与代码实际情况不再匹配
• 重复失败表明方向错误
• 下一个切片确实存在模糊性
• 长时间运行后需要清晰的重新优先级排序

它不应成为每个切片执行的常规部分。

---

推荐的运行时规则

以下是本仓库构建所依据的运营默认规则：

1. 代码优先
2. 仅在执行或恢复需要时才更新文档
3. 一次只处理一个活动切片
4. 最多保持三个待处理切片可见
5. 默认直接执行，而非默认委派
6. 正常继续运行期间不进行全仓库重新审计
7. 仅在真实模糊性或重复失败时才重新规划

---

从慢速工作流迁移的建议

如果你之前使用过旧版工作流：

• 旧的 Autonomous Orchestrator → 替换为 Execution Orchestrator
• 旧的 Slice Executor → 替换为 Focused Executor
• 保留 Milestone Reviewer，但减少调用频率
• 将旧的 WORK_QUEUE.md 替换为简化的活动切片格式
• 将旧的 SESSION_STATE.md 替换为更短的恢复格式
• 停止将提示词/模式/模板文件复制到每个目标仓库

---

在真实项目中编辑 AGENTS.md 后的最佳实践

在真实目标仓库中修改运行时 AGENTS.md 后，应在测试新行为之前启动一个 新的 Roo 聊天/会话。这是确保更新后的规则能从下次运行开始就干净应用的最安全方式。