循环工程（Loop Engineering）

循环工程（Loop engineering）就是取代你自己作为提示 agent 的那个人。你设计一个系统来做这件事。

新来的？ 快速入门（5分钟） · 交互式选择器

面向使用 Grok、Claude Code、Codex、Cursor 及其他 AI 编码 agent 的开发者。

一个 loop（循环）是一个递归目标：你定义一个目的，AI 不断迭代（通常借助子 agent、验证和外部状态），直到目标完成或 loop 决定交回给你。

目录

• 快速入门（5分钟）
• 快速链接
• 为什么这很重要
• 五大构建块 + 记忆
• 模式
• 开始使用（5分钟）
• 按工具分类的示例
• 运行与安全
• 注意事项
• 贡献
• 来源
• 许可证

快速链接

为什么这很重要

Peter Steinberger：

“你不应该再手动提示编码 agent 了。你应该设计 loop 来提示你的 agent。”

Boris Cherny（Anthropic 的 Claude Code 负责人）：

“我不再手动提示 Claude 了。我有 loop 在运行，它们提示 Claude 并决定该做什么。我的工作是编写 loop。”

杠杆点已经从编写单个 prompt 转移到了设计随时间编排 agent 的控制系统。

五大构建块 + 记忆

完整细节：docs/primitives.md · 跨工具矩阵：docs/primitives-matrix.md

视觉概览

Loop 的解剖结构

flowchart LR
    A[Schedule / Automation] --> B[Triage Skill]
    B --> C[Read + Write STATE / Memory]
    C --> D[Isolated Worktree]
    D --> E[Implementer Sub-agent]
    E --> F[Verifier Sub-agent<br/>tests + gates]
    F --> G[MCP / Git / Tickets]
    G --> H{Human Gate?}
    H -->|safe / allowlisted| I[Commit / PR / Action]
    H -->|risky / ambiguous| J[Escalate to human<br/>with full context]
    I --> A
    J --> A

此参考仓库现在在每次推送/PR 时运行自己的 validate-patterns + audit 工作流（参见 .github/workflows/）。我们还添加了 LOOP.md，描述将维护它的 loop。

模式

不确定选哪个？试试交互式选择器或模式选择器。

机器可读索引：patterns/registry.yaml（7 个模式）

开始使用（5分钟）

# 1. 脚手架一个启动器（或手动复制 — 参见 starters/）
npx @cobusgreyling/loop-init . --pattern daily-triage --tool grok

# 2. 估算你的节奏的 token 消耗
npx @cobusgreyling/loop-cost --pattern daily-triage --level L1

# 3. 审计就绪度（预算 + 运行日志现在已评分）
npx @cobusgreyling/loop-audit . --suggest

# 可选：将 Loop Ready 徽章粘贴到你的 README 中
npx @cobusgreyling/loop-audit . --badge

# 4. 查看分数攀升：空 → L1 → L2
bash scripts/before-after-demo.sh

# 5. 开始仅报告模式（Grok 示例）
/loop 1d Run loop-triage. Update STATE.md. No auto-fix in week one.

所有三个 CLI 都从标记版本发布到 npm — 参见 docs/RELEASE.md。无需克隆。

从源码开发（monorepo 贡献者）：

cd tools/loop-init && npm ci && npm test && node dist/cli.js /path/to/project --pattern daily-triage --tool grok
cd tools/loop-audit && npm ci && npm test && node dist/cli.js /path/to/project --suggest
cd tools/loop-cost && npm ci && npm test && node dist/cli.js --pattern ci-sweeper --cadence 15m

分阶段推出：L1 报告 → L2 辅助修复 → L3 无人值守 — 参见 loop-design-checklist。

按工具分类的示例

• Grok
• Claude Code
• Codex
• GitHub Actions

运行与安全

• 故障模式 — 事件式目录
• 反模式 — 生产前的设计错误
• 多 Loop 协调 — 当 loop 冲突时
• 运行 Loop — 成本、日志记录、何时终止
• 安全 — 拒绝列表、自动合并、MCP 范围
• 安全性 — 报告和无人值守自动化风险
• 概念 — 意图债务、理解债务、约束与 loop
• MCP 食谱 — 按模式分类的连接器示例

注意事项

循环工程会放大判断力——无论好坏。

• Token 成本可能因子 agent 和长时间运行的 loop 而激增。
• 验证仍然是你的事。 无人值守的 loop 会犯无人值守的错误。
• 理解债务增长更快，除非你阅读 loop 交付的内容。
• 两个人运行同一个 loop 可能得到相反的结果。Loop 不知道。你知道。

Addy Osmani：

“构建 loop。但要像打算一直做工程师的人那样构建它，而不仅仅是按下启动按钮的人。”

贡献

分享生产模式、工具映射和失败故事。参见 CONTRIBUTING.md、采用者和 GitHub Discussions。

来源

• Cobus Greyling – 循环工程（Substack）
• Addy Osmani – 循环工程
• 归属与进一步阅读

许可证

MIT

实用的、工具感知的循环工程参考——可克隆的模式、可对照检查的清单，以及包含失败经历的故事。