今天就能跑：Loop Engineering 橙皮书手把手教你用 Claude Code /loop 搭第一个循环-平芜编程栈

文档
教程
AI Agent
人工智能

【免费下载链接】loop-engineering-orange-book

别再问我什么是 Loop Engineering — 橙皮书系列。A plain-language guide to loop engineering (中文 + English PDF). Free.

项目地址：https://gitcode.com/gh_mirrors/lo/loop-engineering-orange-book

Loop Engineering 橙皮书（loop-engineering-orange-book）是一本免费的循环工程指南：别再自己一句句喂 prompt，去设计一个替你指挥 agent 的自动循环系统。本文带你快速看懂它的四层栈概念，并手把手教你用 Claude Code 的 /loop 命令，今天就搭起你的第一个循环。

一句话看懂：什么是 Loop Engineering

过去两年，AI 圈冒出一串「XX Engineering」：Prompt、Context、Harness……现在轮到了 Loop。但和前面的词不同，它不是教你把活干得更好，而是让你从干活的位置上退出来——你不再坐在键盘前一句句指挥 agent，而是在循环外面，负责造那个循环。

Google Chrome 团队的工程师 Addy Osmani 给这件事命名，他的定义很短：

You shouldn't be prompting coding agents anymore. You should be designing loops that prompt your agents.
（你不该再去 prompt 编程 agent 了，你该去设计那些会 prompt 你 agent 的循环。）

橙皮书把这件事放进一张四层栈，一层管一件事，看清边界你就知道 loop 站在哪：

层	管什么	核心问题
Prompt engineering	写好一次提示词	我该告诉模型什么
Context engineering	这一刻窗口里放什么	检索什么、摘要什么、清掉什么
Harness engineering	单次运行的武装	给哪些工具、什么算完成
Loop engineering	在 harness 之上的调度	怎么让它自己一遍遍跑起来

每往上一层，你操心的东西就大一号。prompt 管一句话，context 管一窗户，harness 管一次跑，loop 管让它自己跑下去。

橙皮书讲什么：4 个部分、9 章一次看全

这本书 32 页、全免费，结构非常清楚：

部分	内容	章节
一 · 它是什么	定义、一周引爆的来龙去脉、四层栈	§01–02
二 · 它怎么转	一个循环的五个动作、六个零件、为什么 AI 不能给自己打分	§03–05
三 · 它在哪跑、要什么代价	三个真实 loop（Addy 的早间分诊、Stripe 的 Minions）和四笔代价	§06–07
四 · 你怎么开始	当工程师而不只是按启动键、今天就搭你的第一个 loop	§08–09

它特别适合两类人：已经在用 Claude Code / Codex 但还在一句句手动喂 agent 的开发者；以及好奇「你不该再 prompt 你的 agent 了」为什么一周内传疯的 AI 重度用户。

手把手教程：用 /loop 搭你的第一个循环

书里 §09 的核心建议是：别想着一步到位。Stripe 那种每周上千 PR 的流水线是终点，不是起点。第一个 loop 应该小到几乎不像个系统——从 Claude Code 自带的 /loop 定时任务开始，门槛最低，跑起来立刻能感觉到「哦，原来是这么回事」。

第一步：跑一个 /loop 定时任务

/loop 在 Claude Code v2.1.72 之后可用，作用就一个：按时间间隔把同一件事重跑一遍。它有三种形态，按需挑：

写法	效果
`/loop 5m check the deploy`	固定 5 分钟一次
`/loop check the deploy`	Claude 自己决定节奏（1 分钟到 1 小时之间）
`/loop`	裸跑，执行内置维护任务或你写在`.claude/loop.md`里的内容

时间单位是s/m/h/d，最小间隔 1 分钟。两个坑先记住：recurring 任务7 天后过期（不是有些教程说的 3 天）；它跑在你本机，机器关了它就停。

第二步：让它每天做 triage 分诊

光重跑一句话不算 loop，得让它读点东西、做点判断。最朴素的起点是一个 triage（分诊）任务：给它一个 prompt，让它每天早上看三样东西——

昨天的 CI 有没有失败
有哪些新开的 issue
最近的 commit 改了什么

看完挑出值得处理的，列个清单。到这一步，你已经有 loop 最核心的两个零件：定时触发的发现机制 + 会替你过一遍信息的分诊脑子。

第三步：加一个状态文件，让循环有记忆

分诊跑完，结果存哪？别让它留在对话窗口里，关掉就没了。开一个 markdown 文件，把每次的发现、处理到哪一步都写进去。

这个文件就是 loop 的记忆。Addy 的说法很形象：agent 会忘，仓库不会忘。有了它，今天没处理完的事，明天这个 loop 醒来还能接着干。

第四步：用 /goal 装一个会说「不」的评判器 ⚠️

这一步是整个 loop 里最关键的，也最容易被跳过。Claude Code 里有个现成工具 /goal（v2.1.139 之后可用）：它跑到某个条件满足为止，而判定条件成立的，是另一个全新的模型，不是干活那个。

用法很直接：

/goal all tests in test/auth pass and the lint step is clean

为什么非得换个模型？因为干活的 agent 太容易夸自己——它写完代码让你评价，多半自信地说「不错」。换个带着不同指令甚至不同模型的评判者，才能抓出它说服自己糊弄过去的地方。没人看着的循环，也是没人看着犯错的循环。

第五步：用 worktree 让 agent 并行不打架

想让它同时干好几件事，办法是 git worktree：Claude Code 用--worktree（或-w）给每个后台 agent 开一个独立工作目录。两个 agent 写同一个文件，跟两个工程师改同一行代码一样头疼；隔离开，它们才能并行而不打架。

到这儿，你的 loop 已经五脏俱全了。

上线前自查清单（6 条）

书里给了一张很实用的 checklist，前两条决定你的 loop 能不能跑，后四条决定它跑起来会不会闯祸：

要素	问自己
发现源	它定时去读什么？（CI / issue / commit）
状态文件	跨轮的记忆落在哪个磁盘文件上？
evaluator	有没有一个独立的、会说「不」的检查？
隔离	并行的 agent 是不是各一个 worktree？
token 上限	设没设花费的天花板？跑飞了谁拦得住？
人工复核点	哪一步停下来等你看一眼，而不是一路自动到底？

新手最容易只搭前两条就上线——结果就是一个没人看着、也没人能拦的循环在那自我点头。

循环的四笔代价：别只看到自动化

橙皮书 §07 专门摆出了另一半边：

验证债：自动开的 PR、自动改的代码，省下的时间变成一堆「还没人验证过」的产出，堆在那儿等你还
理解腐烂：循环交付你没写的代码越快，「实际存在的东西」和「你真正理解的东西」之间的差距就越大
token 失控：循环会自己孵化小帮手、自己重试，一个 bug 让它空转一整晚，睡醒看到的就是一张陌生的账单
认知投降：闭着眼合 PR 的那一刻，你就往「按钮」那边滑了一格

防线其实不复杂：上线前给循环设单次预算、每日预算、最大重试次数，到顶就停。这些数字不是为了省钱，是为了让一个空转的 bug 没法把整夜的额度烧光。

📖 如何阅读这本橙皮书

全书 32 页，PDF 直接下载即可，中英文两个版本都在仓库里：

中文版：Loop-Engineering橙皮书-v260615.pdf
English：Loop-Engineering-The-Complete-Guide-v260615.pdf
中文说明：README_zh.md，橙皮书系列与作者介绍
英文说明：README.md，书籍内容结构
许可协议：LICENSE（MIT，可自由使用、复制、分发，包括商用）

书里所有案例都来自公开一手来源：Addy Osmani 的奠基文、Anthropic 的 harness 工程博客、Stripe 的 Minions，以及 Claude Code / Codex 官方文档。读完 32 页、跑通一个 /loop，你会发现「loop engineering」四个字并没有想象中高深——它只是提醒你：从今天起，你的工作是造循环，不是按按钮。