对照矩阵
| L1 Unit | L2 Integration | L3 Human | |
|---|---|---|---|
| 触发 | units.json 有 pending | 所有 Unit 状态 = passed | POST /devloop/requirement |
| 主导 Agent | Coder + Tester | Integrator + BugTriager + Architect | PM + Architect |
| 每轮产物 | code/ · tests/ · runs/result.json | integration/runs/{id}/result.json + triage.json | prd.html rev+1 · sdd.html rev+1 |
| 退出 | 单测全绿 → unit passed | 集成全绿 → project shipped | 人类 sign-off |
| 失败处理 | retry coder ≤ N | 归因 → 改 SDD → 回 L1 | 对话化追问,PRD 加 section |
| 预算 | 每 unit retry ≤ 5 | 每项目 L2 修复 ≤ 3 轮 | 无限(人类驱动) |
| 典型时长 | 1-3 分钟 / unit | 2-10 分钟 / 轮 | 分钟 — 小时 |
嵌套关系(含数学描述)
三个 Loop 严格嵌套:L1 触发于 L2 内部,L2 触发于 L3 内部。即:
// 用伪代码表达嵌套关系 while (human.hasFeedback()) { // L3 pm.patchPRD(); architect.regenSDD(); while (!project.integrationGreen()) { // L2 while (unitsPending()) { // L1 parallel(unitsPending(), runUnit); } const r = integrator.run(); if (!r.ok) { const tri = triager.analyze(r); architect.applyPatch(tri.sdd_patch); units.reset(tri.affected); } } }
三个 Loop 的色彩 token
同一套颜色在 PRD 文档、看板 UI、Agent 日志、状态徽章里一致复用,便于跨界面识别当前所处的 Loop 层级。
L1 · Unit
Emerald · #0E8C5A
短周期 / 高频 / 低单价。日志里所有 L1 事件都用这个色描边。
L2 · Integration
Amber · #C77C2C
中周期 / 中频 / 中单价。Dashboard 中间状态栏专色。
L3 · Human
Violet · #6E48C3
低频 / 高单价 / 决策性。看板 header / Hero 用此色作 accent。
下一步阅读
详细状态机在以下三页:
- L1 · Unit Loop — 单 Unit 的写码—跑测—重试
- L2 · Integration Loop — 集成失败的归因与文档回写
- L3 · Human Feedback Loop — 增量需求的并入