Loop Engineering 实操手册：14 步构建最小可行循环

原文链接：https://mp.weixin.qq.com/s/kICrdEkPCYAiyOiwI-Gt1Q

摘要

Codez 总结的 14 步 Loop Engineering 实操路线图，全网 220 万浏览。综合 Anthropic 工程文档和 Addy Osmani 长文。三层次递进：判断要不要 loop → 学会五块积木 → 搭最小不坑人的循环。

一、四个前置问题

Loop 不是免费的——烧 token、花时间搭、要 debug 你没亲眼看它跑的系统。

1. 任务是重复的吗？ 一次性的活，好 prompt 更快更省
2. 有东西能自动判定「干砸了」？ 测试、类型检查、linter、构建，至少一个。没有的话你得逐行读 diff，loop 没帮你省时间
3. token 预算扛得住浪费吗？ loop 反复读上下文、重试、试探，不产出也烧钱
4. Agent 能跑自己写的代码吗？ 需要日志、能复现、看得到哪崩

附加题（比上面四个都重要）：你打算 review 它产出的代码吗？ 不打算就别建。

适合上手：有强测试套件的团队，干 CI 失败分类、依赖升级、lint-and-fix、issue 转 PR 草稿（重复 + 能机器校验 + 出事范围小）。

不适合：消费级套餐个人开发者、测试覆盖不够的代码库、瓶颈在 review 而不在打字速度的团队。

二、五个核心构件

@0xCodez 的拆法，每个都能单独用、单独试：

1. Automations — loop 的心跳。按节奏触发（定时/事件），跑完停下等下一轮。关键是停止条件写死，别让它无限跑。
2. Worktrees — 并行不打架。多 Agent 同时干活，git worktree 给每人独立工作区，最后再合。
3. Skills — 把背景写下来。项目框架、约定、踩过的坑写成 skill 存着，Agent 每轮直接读。
4. Connectors — 连上真实工具链。MCP 接 GitHub（开 PR）、Linear/Jira（更新 ticket）、Slack（发汇总）、Sentry（查告警）。
5. Sub-agents — 写和验分开。最有用的改造。写代码的模型给自己打分太宽容，换另一个 Agent 验收能抓到第一个自我说服过去的问题。

三、最小可行 Loop 搭建

别上来建全能系统，先建能用最小版：

1. 一个 automation：按节奏触发，明确条件停
2. 一个 skill：存项目背景
3. 一个状态文件：记完做什么、下一步干啥、经验教训
4. 一道闸门：测试/类型检查/构建不过就自动拒

顺序很重要： 先一次手动运行稳定 → 做成 skill → 包成 loop → 再去调度。

盯一个指标：每个被接受的改动的成本。 接受率低于 50%，loop 就在亏本。

四、三种翻车 + 一个安全问题

三种翻车：

1. 假装干完了（Ralph Wiggum 循环）— Agent 提前发「完成」信号，活干一半就退。原因：没硬闸门。
2. 理解债务 — loop 交付越多你没写过的代码，「仓库里有什么」和「你理解什么」差距越大。总有一天要 debug 团队里没人读过的系统。
3. 认知投降 — 慢慢不自己判断，loop 返回啥就收啥。即使有 loop 也要读 diff、抽查闸门、不让 loop 碰架构。

安全红线： 无人值守的 loop = 无人值守的攻击面。

• 生成代码需 SAST、依赖审计、密钥扫描
• Skill 是注入入口：社区 17022 个 skill 里 520 个会泄露凭证
• 生产 loop 关 verbose 日志
• 每 30 天复审一次权限

五、14 步路线图

第一段 · 先想清楚要不要做（5 步）

• 确认重复、有自动判定机制、token 预算够、Agent 能跑自己代码、打算 review

第二段 · 搭最小能跑的 Loop（8 步）

• 手动稳定 → 沉淀 Skill → 加状态文件 → 设闸门 → 配 Automation → 上 Worktree → 接 Connectors → 拆 Sub-agents

第三段 · 上线后守住（1 步，最难）

• 盯每个被接受的改动成本，定期复审权限、读 diff、别让 loop 碰架构

两年来，与编码 Agent 协作的杠杆一直在提示词上。而现在，工作流成了真正的护城河。