宜博 / lemonboss

loops-overview.md 2.24 KB

三层 Loop 模型

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

对照矩阵

L1 Unit L2 Integration L3 Human
units.json 有 pending 所有 Unit 状态 = passed POST /devloop/requirement
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。

下一步阅读

详细状态机在以下三页：