# 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`](./ai-development-protocol.md)；工位/范围/里程碑见 [`../knowledge/mvp-scope-and-milestones.md`](../knowledge/mvp-scope-and-milestones.md)；契约先行见 [`../skills/contract-first-development.md`](../skills/contract-first-development.md)；新增模块见 [`../skills/add-business-module.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`](../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`](../knowledge/mvp-scope-and-milestones.md)）。
- **边界 = 模块边界**：每个 Agent 拥有**互不重叠**的模块/文件，**零共享状态**，并行用 git worktree 隔离避免写冲突。跨模块只通过**契约**交互。

---

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

```mermaid
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`](../skills/add-business-module.md) |
| 2 | **契约先行强制** | 并行开发前必锁 API/DB/SDK/事件契约，写入 `contracts/` 提交 git | 解耦才能真并行；Agent 越多收益越大 | [`../skills/contract-first-development.md`](../skills/contract-first-development.md) |
| 3 | **复用优先于新建** | 写代码/造结构前先搜 `skills/` `knowledge/` 与既有代码 | 避免重复造轮子、重复函数、设计漂移 | [`../rules/engineering-conventions.md`](../rules/engineering-conventions.md) |
| 4 | **验证门禁前置 / fail-fast** | TDD + 7 门禁 + 完成前验证（evidence），早拦错 | **返工是头号效率杀手**，越早拦越省 | [`../rules/security-and-reliability.md`](../rules/security-and-reliability.md) |
| 5 | **并行边界 = 模块边界** | Agent 间零共享状态、worktree 隔离、只经契约交互 | 无写冲突 / 无串扰才能稳定并行 | 本篇 §1 |
| 6 | **`.agents` 复利沉淀** | 每个 Agent 交付后回写事实/红线/套路 | 知识不重置，后人站在前人肩上 | [`../README.md`](../README.md) 维护规则 |
| 7 | **昂贵步骤缓存** | 相同 Prompt hash 命中跳过 LLM 生成；Maven/构建缓存；产物缓存 | 运行期 + 构建期双重提速、省成本 | [`../skills/saa-graph-orchestration.md`](../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`](../rules/security-and-reliability.md)）。
- **集成**：Day11 起冒烟 5 条核心链路自动化通过；P0 bug 当天必修。
- **证据规则**：没有验证证据，不得声称"完成/通过/无问题"（见 [`./ai-development-protocol.md`](./ai-development-protocol.md)）。

---

## 6. 编排者每日节奏

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

---

## 7. 与通用协议的关系

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