games-development-ai/.agents/workflows/mvp-execution-orchestration.md

MVP 执行编排与复利提效（mvp-execution-orchestration）

适用：以 AI Agent 编排方式交付 MVP——10 个 Agent × 3 周（15 工作日）× 55 项 P0 产品功能（工作量≈137 技术项）。本篇是"我（编排者）怎么把活分下去、怎么让效率随推进复利增长"的作战手册。 决策来源：创始人确认（2026-06-07）——"你是执行者，10 人 = 10 个 Agent，3 周交付 MVP；规划如何做、如何复利提效。" 配套：承接任意任务的通用流程见 ./ai-development-protocol.md；工位/范围/里程碑见 ../knowledge/mvp-scope-and-milestones.md；契约先行见 ../skills/contract-first-development.md；新增模块见 ../skills/add-business-module.md。

⚠️ 现状注记（2026-06-11 harness 体检）：§1/§2/§6 的「10 固定 Agent × Day0-15 + 每日站会」是开工前的目标态编排模型；实际运行已演化为波次制——每波「双 spec（review+execution）→ Workflow/Ultracode 编排建设 → 主 agent 独立验证门 → 按 ../skills/wave-close-checklist.md 收口」，波次史见总账 §6。§3 复利 8 策略与 §5 验证门禁仍为现行权威；读 §1/§2/§6 时以波次制为准。

---

1. 角色与编排模型

• 编排者（我）：拆解契约、分派 Agent、审阅产出、解阻塞、把控集成与验证门禁、把经验回写 .agents/。我不亲自写每行代码，而是保证 10 个 Agent 高效并行且产出可集成。
• 10 个执行 Agent = 5 工位 × 2：WS1 平台基座 / WS2 AI 生成 / WS3 运行时与分发 / WS4 产品前端 / WS5 数据与变现（边界详见 ../knowledge/mvp-scope-and-milestones.md）。
• 边界 = 模块边界：每个 Agent 拥有互不重叠的模块/文件，零共享状态，并行用 git worktree 隔离避免写冲突。跨模块只通过契约交互。

---

2. 编排时序（pipeline 而非 barrier）

graph LR
  D0[Day0 契约锁定<br/>我主笔 7 个 Day-0 契约·全员 review] --> PAR[各 Agent 基于契约<br/>mock 依赖·并行开发]
  PAR --> WB[每模块完成即回写<br/>skills / knowledge]
  WB --> INT[Day11 集成<br/>唯一 barrier]
  INT --> GATE[验证门禁<br/>冒烟 5 链路 + 7 门禁]
  GATE --> DELIV[交付 / 种子内测]
  WB -.下一模块更快.-> PAR

关键：只有 Day11 集成是真 barrier，其余全程 pipeline。 A 模块进集成验证时，B 模块仍在开发——不互相等待，墙钟时间≈最慢单链路而非各阶段之和。

阶段	我做什么	Agent 做什么
Day0 契约	主笔 7 个 Day-0 契约、组织 review、锁定提交 git（Prompt Registry 为第 8 类契约）	评审契约、提出本工位 I/O 诉求
Day1–10 并行	分派、审阅产出、解阻塞、催回写	基于 mock 独立开发各自模块 + 单测/集成测
Day11–12 集成	编排联调顺序、裁决契约偏差	替换 mock 为真实依赖、修联调 bug
Day13–15 加固	把控验证门禁、决定是否交付	修 P0 bug、补冒烟、安全加固

---

3. 复利提效 8 策略（核心）

目标：让"第 N 次同类工作"比"第 1 次"显著更快。把每次产出沉淀为可复用资产，而非一次性消耗。

#	策略	做法	为什么复利	落位
1	黄金模板先行	先把 project 模块做到完美（分层/测试/迁移/Swagger 齐全），作为样板	第 1 个最慢；其余 12 个克隆骨架，指数加速	../skills/add-business-module.md
2	契约先行强制	并行开发前必锁 API/DB/SDK/事件契约，写入 contracts/ 提交 git	解耦才能真并行；Agent 越多收益越大	../skills/contract-first-development.md
3	复用优先于新建	写代码/造结构前先搜 skills/ knowledge/ 与既有代码	避免重复造轮子、重复函数、设计漂移	../rules/engineering-conventions.md
4	验证门禁前置 / fail-fast	TDD + 7 门禁 + 完成前验证（evidence），早拦错	返工是头号效率杀手，越早拦越省	../rules/security-and-reliability.md
5	并行边界 = 模块边界	Agent 间零共享状态、worktree 隔离、只经契约交互	无写冲突 / 无串扰才能稳定并行	本篇 §1
6	.agents 复利沉淀	每个 Agent 交付后回写事实/红线/套路	知识不重置，后人站在前人肩上	../README.md 维护规则
7	昂贵步骤缓存	相同 Prompt hash 命中跳过 LLM 生成；Maven/构建缓存；产物缓存	运行期 + 构建期双重提速、省成本	../skills/saa-graph-orchestration.md
8	可复现编排	用 Workflow 脚本固化"按模块 fan-out + 逐个 verify"	编排可重跑、可审计、可断点续跑	本篇 §6

---

4. 复利闭环：为什么会越做越快

project 黄金模板 ──固化──▶ add-business-module.md ──克隆──▶ 其余 12 模块更快
每个 Agent 踩的坑 ──回写──▶ rules/ ──▶ 后续 Agent 不再踩
契约稳定 ──▶ 联调成本逐轮递减
.agents 越厚 ──▶ 新 Agent 上手越快、越准、越稳

判定标准：一个任务结束时若没有任何可复用产出回写 .agents/，说明它只是"一次性消耗"——编排者要追问"这次学到的能不能让下次更快"，能则必沉淀。

---

5. 防返工的验证门禁（效率的下限保障）

返工吃掉的时间远超"一次做对"的成本。所有"完成"前必须过门禁：

• 代码：TDD 先行（先写测试）+ 单测>80% + 集成测覆盖 API。
• 生成游戏：7 道创作门禁（Prompt 安全→AI 产出合规→资产版权→组装 Schema→性能→可玩性→发布终审，见 ../rules/security-and-reliability.md）。
• 集成：Day11 起冒烟 5 条核心链路自动化通过；P0 bug 当天必修。
• 证据规则：没有验证证据，不得声称"完成/通过/无问题"（见 ./ai-development-protocol.md）。

---

6. 编排者每日节奏

• 每日站会（10:00，15 分钟）：审阅每个 Agent 的"昨天/今天/阻塞"，会后 10 分钟点对点解阻塞，不拖会。
• 阻塞 >30 分钟立即升级：编排者介入裁决或重分派。
• 检查点：Day5 / Day10 两次进度核对；某工位落后则其他工位支援（10 人天 ÷ 模块负载动态再平衡）。
• 用 Workflow 工具固化编排：把"每模块 → 生成骨架 → 实现 → 验证"写成可复现脚本，断点可续。

---

7. 与通用协议的关系

本篇是 ./ai-development-protocol.md 在"MVP 大规模并行"场景下的特化实例：通用协议讲"单个任务怎么承接→评审→执行→验证→沉淀"，本篇讲"把 55 项 P0 产品功能（≈137 技术项）拆给 10 个 Agent 怎么并行且复利"。两者一致，冲突时以通用协议的证据规则与停止规则为准。