构建或修复 Agent 迭代循环时使用——解决 Agent 过早宣称完成、活干到一半就停、假成功、循环停不下来等问题,设计验证器与终止条件,实现提议者-审核者(Proposer-Reviewer)双 Agent 循环。覆盖过早终止三种形态、验证器是循环瓶颈的原则、LoopX 持久控制面、LongHorizon-Harn
复制下面这句话,粘贴给 Claude Code、Codex、Cursor 等 AI 编程工具,它会读取安装说明并在你确认后完成安装。
请阅读 https://ai.atlankj.com/install/asset/gh-loop-engineering-717d17957da3 ,按照其中的说明把「loop-engineering」安装到你(当前 AI 工具)中。执行前先告诉我将运行的命令和写入的位置,等我确认。
查看 AI 将读取的安装说明正在读取 GitHub 原文…
内容来自 GitHub 原始文件,由原作者维护。在 GitHub 查看
| 形态 | 表现 | 根因 |
|---|---|---|
| 偷懒式假完成 | 只做一部分就宣称全部做完:代码写完测试没跑、部署没试就报"任务完成";交代两件事只办一件就汇报"都办好了" | 缺少覆盖全部验收项的验证清单 |
| 过早放弃 | 一条路走不通就宣布整件事办不成:打了一个电话被拒就告诉用户"办不了",其实还有表单、邮件等渠道 | 未枚举替代路径,无重规划机制 |
| 假成功 | 以为办成了,实际闭环没走完:对方口头同意退款,但用户还需在 App 确认一步,Agent 却报"已办妥" | 把中间确认当最终状态,缺端到端闭环校验 |
三种形态指向同一根源:完成的标准由模型自述,而非由验证器判定。
candidate = proposer(task, constraints)
evidence = execute_or_render(candidate) # tests, state, screenshot, facts
review = independent_reviewer(candidate, evidence)
while review.veto and budget_remaining:
candidate = proposer.repair(candidate, review.findings)
evidence = execute_or_render(candidate)
review = independent_reviewer(candidate, evidence)
if review.pass:
publish(candidate, evidence, review) # 连证据一起发布
else:
escalate_or_reject(review) # 预算耗尽则升级,不放水
三条最小不变量:
LoopX 决策 → Agent 执行 → 独立验证器证明 → LoopX 提交
把长程执行重新表述为任务状态管理,循环实现为 Manage–Execute–Audit:
价值在于把任务连续性从不断增长的执行历史中分离出来:上下文可以刷新、界面操作可能失败,下一轮仍从最近一次已核实的状态继续。论文在模型与执行后端相同、只改外层 loop 的对照中,WeaveBench PassRate 从 51.8% 提升到 80.7%,OSWorld 2.0 二元完成率从 2.8% 到 8.3%,Terminal-Bench 2.1 从 69.7% 到 77.2%;代价不固定——前两个基准分别多耗 2.3 倍总 token 与 3.6 倍输出 token,第三个反而少 24%。部署时还需处理旧状态失效,并用轮数、时间、费用预算防止恢复循环无限运行。
同一范式适用于:安全审查(提议者生成操作方案,审核者查合规与风险)、内容审核(起草回复,审核者查业务规则与用语规范)、代码审核(写代码,审核者查安全与最佳实践)。变体还包括规划者–生成者–评估者三 Agent:先约定每轮完成标准,评估者操作真实应用并提交缺陷报告。
chapter5/paper-to-ppt/ — Proposer 写 Slidev 代码,Reviewer 逐页真渲染 PNG 并用 Vision LLM 给结构化意见(page/issue_type/severity/suggestion + 总分与 pass),双 Agent 峰值上下文 24,186 vs 单 Agent 自审 92,601 tokenchapter5/video-edit/ — 两步 Vision 定位(10s 粗扫 → 1s 精扫)封装为子 Agent,Proposer 生成 Blender bpy / ffmpeg 剪辑脚本,Reviewer 采样关键帧复审迭代book/chapter10.md「对等协作模式」→「Loop 工程」book/chapter10.md「对等协作模式」→「提议者-审核者范式」