• 文档
• 教程
• AI Agent
• 人工智能

《Loop Engineering 橙皮书》（loop-engineering-orange-book）是一本免费的中文 + English 大白话指南 PDF，作者花叔在开篇就把话挑明了：别再自己一句句指挥 AI Agent，去设计一个替你指挥它的系统。而让这套系统「在你睡觉时跑」的第一块基石，就是选对定时调度方案——本地任务、桌面定时任务还是云端调度？今天这篇文章，就带你一次选明白。

为什么是「调度」，而不是更强的模型 🔁

很多人一听 Loop Engineering，就以为是换个更大的模型。不是的。橙皮书把过去两年那串「XX Engineering」拆成了四层栈，每一层管一件更大的事：

循环转一圈只有五个动作：发现、交付、验证、持久化、调度。前四个做得再漂亮，没有调度，也只是「你兴致来了跑一遍」的一次性手工活。橙皮书引了 Addy Osmani 的原话：

Automations are what make a loop an actual loop and not just one run you did once. 自动化，才是让循环成为真正循环的东西，而不只是你跑过一次的那一次。

调度（Automations）是橙皮书「六个零件」里排第一的零件——发动机不点火，剩下五个零件都只是摆设。

本地 vs 云端：一张表看懂三种 AI Agent 定时调度方案

「让循环在你睡觉时跑」是橙皮书里最性感的一句话，但最容易讲歪。真相是：不是所有调度都能在你关机时跑。橙皮书 §06 把方案摊开成了这样一张表：

本地/loop（Claude Code）用的是标准 cron 表达式，最小粒度 1 分钟，有三种形态：

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

有两个细节要记牢，免得踩坑：它是 session-scoped 的，recurring 任务7 天后过期；它跑在你本机，机器关了 loop 就停。嫌 cron 烦的话，设个CLAUDE_CODE_DISABLE_CRON=1就全关了。

两个真实场景，一分钟选对调度方案 ✅

橙皮书给了两个可以直接对号入座的场景：

场景一：每分钟盯一下本地正在跑的开发服务器→ 只能是本地/loop。云端看不到你机器里那个进程，间隔也下不到 1 分钟。代价：机器得开着。

场景二：每天凌晨三点扫一遍仓库的 open issue，该提 PR 就提 PR→ 这种活根本不该绑在你的笔记本上——笔记本会合盖、会断电、会被你带出门。这时GitHub Actions 的 schedule 触发或Cloud Routines才是正解：它们跑在一台永远醒着的机器上，你睡你的。代价：最小间隔 1 小时，每次都是干净的 clone。

一句话判断标准：你的 loop 是「粘本地」还是「能离开本地」。要频繁、要看本地文件，用本地/loop；要关机也跑、不依赖本地状态，上云。别混——本地/loop是「我在场时让它替我多跑几轮」，云端调度才是「我不在场它也照跑」。

Codex 用户看这里：Automations 方案怎么选

用 Codex 的话，对应入口是Automations 标签页：可以设 daily、weekly，也能用 cron 自定义。它跑在一个专用的 background worktree 里，结果汇进一个 Triage 收件箱等你回来看。

注意两点：本地的 automation 同样要开机，想关机跑得靠云，而Codex 自己的云端 Jobs 还在规划里；另外/loop、/goal是 Claude Code 的命令名，Codex 上没有，别把命令安错门。

上线前：给调度装上六道保险 🛡️

橙皮书反复提醒：一个没人看着的循环，也是一个没人看着犯错的循环。搭好定时调度后，上线前对着这六条过一遍：

前两条决定你的 loop 能不能跑，后四条决定它跑起来会不会闯祸。尤其 token 上限——循环会自己孵化帮手、自己重试、自己在定时器上跑，一个 bug 空转一整晚，你睡醒看到的就是张陌生的账单。上线前先钉死单次预算和最大重试次数。

免费下载 Loop Engineering 橙皮书（中英双语 PDF）📖

本文核心内容来自橙皮书 §06「让循环在你睡觉时跑：三个真实的 Loop」和 §09「今天就动手」。完整版本（含 Addy 的早间 triage、Stripe 每周 1300 个 PR 的一手案例、四笔代价账）可以直接从本仓库下载：

• 中文版 PDF：Loop-Engineering橙皮书-v260615.pdf
• 英文版 PDF：Loop-Engineering-The-Complete-Guide-v260615.pdf
• 项目说明（含本书结构与适合人群）：README_zh.md
• 许可协议：LICENSE（MIT，可自由使用与分发）

今天就动手：从一条/loop定时任务起步，配上状态文件、一个会说不的 evaluator 和一个人工复核点——第一个 loop，宁可小，也要把保险装齐。然后，安心去睡觉。

• 文档
• 教程
• AI Agent
• 人工智能