02 · LOOPS/三层 Loop 总览

三层 Loop 模型

L1 ⊂ L2 ⊂ L3。每一层是一个独立的有限状态机,触发条件、执行体、退出条件、回滚目标各不相同。本页给出全景对照,下面三页是各自细节。

对照矩阵

L1 UnitL2 IntegrationL3 Human
触发units.json 有 pending所有 Unit 状态 = passedPOST /devloop/requirement
主导 AgentCoder + TesterIntegrator + BugTriager + ArchitectPM + Architect
每轮产物code/ · tests/ · runs/result.jsonintegration/runs/{id}/result.json + triage.jsonprd.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 分钟 / unit2-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。

下一步阅读

详细状态机在以下三页: