loops-overview.html
5.64 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width,initial-scale=1" />
<title>三层 Loop 模型 · LemonBoss PRD</title>
<link rel="preconnect" href="https://fonts.googleapis.com" />
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
<link href="https://fonts.googleapis.com/css2?family=Fraunces:opsz,wght@9..144,300;9..144,500;9..144,700&family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet" />
<link rel="stylesheet" href="assets/shell.css" />
</head>
<body data-page="loops-overview.html">
<div class="shell">
<aside id="sidebar"></aside>
<main class="page">
<header class="page-head">
<div class="crumb"><span class="pill">02 · LOOPS</span><span class="sep">/</span><span>三层 Loop 总览</span></div>
<h1>三层 Loop 模型</h1>
<p class="deck">L1 ⊂ L2 ⊂ L3。每一层是一个独立的有限状态机，触发条件、执行体、退出条件、回滚目标各不相同。本页给出全景对照，下面三页是各自细节。</p>
</header>
<article class="body">
<section>
<h2>对照矩阵</h2>
<table>
<thead><tr><th></th><th><span class="tag L1">L1</span> Unit</th><th><span class="tag L2">L2</span> Integration</th><th><span class="tag L3">L3</span> Human</th></tr></thead>
<tbody>
<tr><th>触发</th><td>units.json 有 pending</td><td>所有 Unit 状态 = passed</td><td>POST /devloop/requirement</td></tr>
<tr><th>主导 Agent</th><td>Coder + Tester</td><td>Integrator + BugTriager + Architect</td><td>PM + Architect</td></tr>
<tr><th>每轮产物</th><td>code/ · tests/ · runs/result.json</td><td>integration/runs/<i>{id}</i>/result.json + triage.json</td><td>prd.html rev+1 · sdd.html rev+1</td></tr>
<tr><th>退出</th><td>单测全绿 → unit passed</td><td>集成全绿 → project shipped</td><td>人类 sign-off</td></tr>
<tr><th>失败处理</th><td>retry coder ≤ N</td><td>归因 → 改 SDD → 回 L1</td><td>对话化追问，PRD 加 section</td></tr>
<tr><th>预算</th><td>每 unit retry ≤ 5</td><td>每项目 L2 修复 ≤ 3 轮</td><td>无限（人类驱动）</td></tr>
<tr><th>典型时长</th><td>1-3 分钟 / unit</td><td>2-10 分钟 / 轮</td><td>分钟 — 小时</td></tr>
</tbody>
</table>
</section>
<section>
<h2>嵌套关系（含数学描述）</h2>
<p>三个 Loop 严格嵌套：<b>L1 触发于 L2 内部</b>，L2 触发于 L3 内部。即：</p>
<pre class="code"><span class="c">// 用伪代码表达嵌套关系</span>
<span class="k">while</span> (<span class="n">human</span>.<span class="n">hasFeedback</span>()) <span class="p">{</span> <span class="c">// L3</span>
<span class="n">pm</span>.<span class="n">patchPRD</span>();
<span class="n">architect</span>.<span class="n">regenSDD</span>();
<span class="k">while</span> (!<span class="n">project</span>.<span class="n">integrationGreen</span>()) <span class="p">{</span> <span class="c">// L2</span>
<span class="k">while</span> (<span class="n">unitsPending</span>()) <span class="p">{</span> <span class="c">// L1</span>
<span class="n">parallel</span>(<span class="n">unitsPending</span>(), <span class="n">runUnit</span>);
<span class="p">}</span>
<span class="k">const</span> r = <span class="n">integrator</span>.<span class="n">run</span>();
<span class="k">if</span> (!r.<span class="n">ok</span>) <span class="p">{</span>
<span class="k">const</span> tri = <span class="n">triager</span>.<span class="n">analyze</span>(r);
<span class="n">architect</span>.<span class="n">applyPatch</span>(tri.<span class="n">sdd_patch</span>);
<span class="n">units</span>.<span class="n">reset</span>(tri.<span class="n">affected</span>);
<span class="p">}</span>
<span class="p">}</span>
<span class="p">}</span></pre>
</section>
<section>
<h2>三个 Loop 的色彩 token</h2>
<p>同一套颜色在 PRD 文档、看板 UI、Agent 日志、状态徽章里一致复用，便于跨界面识别当前所处的 Loop 层级。</p>
<div class="grid-3">
<div class="card l1">
<span class="tag L1">L1 · Unit</span>
<h3>Emerald · #0E8C5A</h3>
<p>短周期 / 高频 / 低单价。日志里所有 L1 事件都用这个色描边。</p>
</div>
<div class="card l2">
<span class="tag L2">L2 · Integration</span>
<h3>Amber · #C77C2C</h3>
<p>中周期 / 中频 / 中单价。Dashboard 中间状态栏专色。</p>
</div>
<div class="card l3">
<span class="tag L3">L3 · Human</span>
<h3>Violet · #6E48C3</h3>
<p>低频 / 高单价 / 决策性。看板 header / Hero 用此色作 accent。</p>
</div>
</div>
</section>
<section>
<h2>下一步阅读</h2>
<p>详细状态机在以下三页：</p>
<ul>
<li><a href="loops-l1.html"><b>L1 · Unit Loop</b></a> — 单 Unit 的写码—跑测—重试</li>
<li><a href="loops-l2.html"><b>L2 · Integration Loop</b></a> — 集成失败的归因与文档回写</li>
<li><a href="loops-l3.html"><b>L3 · Human Feedback Loop</b></a> — 增量需求的并入</li>
</ul>
</section>
</article>
<nav class="prev-next"></nav>
<footer class="site"><div><b>Section</b>02 · Loops</div><div><b>Page</b>loops-overview.html</div></footer>
</main>
</div>
<script src="assets/shell.js"></script>
</body>
</html>