Loop Engineering（循环工程）完全指南

什么是 Loop Engineering（循环工程）？

Loop Engineering（循环工程）指的是设计一套能够反复驱动 AI 编码智能体运行的系统——不再是你一条一条手动输入提示词，而是搭建一台机器：找到待办任务、给智能体下达提示、检查结果，并决定是继续循环还是停止。

提示词工程优化的是单轮对话里的一句指令；循环工程优化的是这句指令外层的整套循环——智能体开始前读取什么状态、用什么命令验证它的产出、满足什么条件才停止。技能的重心从"我该怎么写这句提示词"变成了"我该搭一套什么系统来持续给它下达提示词"。

为什么是这个词，为什么是现在

到 2026 年年中，编码智能体在长周期任务上的可靠性已经足够高，瓶颈随之转移。现在决定效果的不再是单次请求写得多精准，而是你有没有搭建一套能够把范围明确的任务交给智能体、客观验证结果、并在无人盯守的情况下自动重试的"框架（harness）"。

这个说法由 Addy Osmani 推广开来，其思路建立在 Peter Steinberger 与 Anthropic（Claude Code 的开发方）的 Boris Cherny 此前提出的观点之上。Claude Code 本身就内置了四种循环原语——具体如何对应到这套框架，见《Claude Code 里的四种循环类型》。

相关术语速查

这些词在网上经常被混用，但它们描述的其实是同一套体系里不同的层次：

• 提示词工程（Prompt engineering）——优化单轮对话里手动输入给模型的一条指令。
• 上下文工程（Context engineering）——决定智能体在响应前能看到哪些信息（文件、记忆、检索到的文档），贯穿整个会话。
• 框架工程（Harness engineering）——设计智能体运行所处的整套系统：工具、护栏、可观测性与权限。智能体 = 模型 + 框架（harness）。
• 循环工程（Loop engineering）——框架工程具体应用到"重试与验证"这个环节上：目标、检查命令、退出条件，以及每一轮之间该发生什么。本文讲的正是这一层。
• 图工程（Graph engineering）——循环之上的一层：把多个各自运行循环的智能体，接成一张由节点、边和共享状态组成的显式的图。完整指南 →
• Ralph loop / Ralph Wiggum 技巧——循环工程里的一种具体模式，每一轮都让智能体从干净的上下文重新启动，靠读取磁盘上的状态文件推进进度。完整解读 →
• Reflexion——一种智能体模式（最早来自学术研究），智能体在尝试失败后写一段简短的自我反思，下一轮重试前先读取它。

一个循环的四要素

一个成型的循环，都会明确回答同样四个问题——在把任务交给智能体之前，把它们写清楚非常关键：

• 目标（Goal）——定义"完成"的那一句话。目标含糊，循环要么过早停止，要么永远停不下来。
• 检查命令（Check command）——用来判断当前状态是否通过的、可机器执行的客观命令。npm test、gh pr checks、某个 lint 命令——任何不需要人眼判断的命令都可以。
• 退出条件（Exit condition）——检查命令的输出要满足什么，循环才能停止。比如"所有测试通过""PR 检查全部为绿""覆盖率达到 80% 以上"。
• 最大迭代次数（Max iterations）——一个硬性上限，防止一个永远无法收敛的循环把你的 CI 账单跑爆。

MCP.so 的循环工作流目录里的每一条工作流，都是围绕这四个字段搭建的，外加一段可以直接粘贴给智能体使用的启动提示词——因为这才是一个真正能跑起来的循环该有的样子，而不是架在概念之上的空谈。

常见的命名循环模式

只要开始留意，就会发现几种命名模式反复出现：

• Ralph 式循环——每一轮都让智能体从干净的上下文重新启动，靠读取磁盘上的状态文件来推进，而不依赖对话记忆。完整解读见《Ralph Loop 到底是什么》，实际案例见Ralph Story Executor。
• Reflexion 式循环——智能体每次尝试失败后都会写一段简短的反思，下一轮开始前先读取它，从而避免重复同一个错误修法。参见Reflexion Debug Loop。
• Guardrails 式循环——当同一种失败连续出现两次，循环会把它写成一条固定规则记录到护栏文件里，后续每一轮都会自动遵守。参见Guardrails Learning Loop。

这些模式都不需要额外的编排软件——本质上就是提示词加状态文件再加一个 shell 循环，这也是这套做法能迅速流行起来的重要原因。

如何上手

上手循环工程最快的方式，是先复用一条已经跑通的循环，而不是从零设计。几条值得先试的：

• Ship PR Until Green——实现改动、推送、开 PR，并持续修复 CI 直到可以合并。
• Test Until Green——运行测试套件，修复影响最小的根因，重复直到全部通过。
• Fix CI Until Green——拉取最近一次失败的 CI 记录，本地复现、修复、验证。

完整且持续更新的循环工作流列表见 MCP.so 循环工作流，支持按分类筛选、按热度排序——每一条都配有可直接粘贴使用的启动提示词、用于验证的检查命令，以及适配的编码智能体。