内容
<div align="center">
[](https://github.com/ayeshakhalid192007-dev/LoopEngineering-CrashCourse/stargazers)
[](https://github.com/ayeshakhalid192007-dev/LoopEngineering-CrashCourse/commits)
[](https://github.com/ayeshakhalid192007-dev/LoopEngineering-CrashCourse)
[](https://github.com/ayeshakhalid192007-dev/LoopEngineering-CrashCourse/graphs/contributors)
[](https://github.com/ayeshakhalid192007-dev/LoopEngineering-CrashCourse/actions/workflows/loop-ready.yml)
[](LICENSE)
[](docs/00-start-here/README.md)
[](starters/getting-started.md)
[](starters/getting-started.md)
[](docs/assessments/loop-ready-certification.md)
[](LICENSE)
[](LOOP.md)
[](CONTRIBUTING.md)
</div>
<!-- HERO-START -->
<div align="center">
# Loop Engineering Crash Course
*停止每次只发送一条消息。设计循环。*
**学习构建 AI 代理循环 — 具有心跳、身体、检查器、脊柱和可证明停止的自主系统。**
</div>
<!-- HERO-END -->
控制权已经转移：它不再存在于完美的提示中，而是存在于**控制系统**中，该系统使代理在一段时间内不断朝着目标努力。本门免费、开源的课程从头到尾教授该学科 — 14 个步骤、20 个现成的循环工具包、评分实验室、操作手册和认证。你在这里不会阅读关于循环的内容；你会构建它们，使用两个工具，从第一个会话循环到认证的机队。
<div align="center">
*真实命令，真实分数 — 此图像是从实际运行中渲染的 [Loop Ready 审计](scripts/loop-ready-audit.mjs)，并且 [CI 重新渲染它](.github/workflows/loop-ready.yml) 每次推送。如果工具包失败，此终端将变为红色。*
</div>
想要在第一课之前在自己的项目中运行循环？一条命令：
```bash
# 查看 20 个现成的循环工具包
npx @loop-engineering/loop-kit list
# 在您要监视的项目中安装一个
npx @loop-engineering/loop-kit ci-sweeper
```
> **我们自己吃自己做的东西。** 这是一个关于循环的课程，它是由循环**构建**的。规则手册位于 [`LOOP.md`](LOOP.md)，耐用的脊柱位于 [`STATE.md`](STATE.md)，每个运行都被记录，一行一行地记录在 [`shared/loop-run-log.md`](shared/loop-run-log.md)。
## 📌 快速链接
| 我想... | |
| --- | --- |
| **注册** — 60 秒内找到我的起点 | [**查看 →**](docs/00-start-here/README.md) |
| 查看完整的学习轨迹地图，附有入口检查 | [**查看 →**](docs/00-start-here/learning-tracks.md) |
| 设置我的代理（Claude Code、OpenCode、Codex、Grok） | [**查看 →**](docs/01-prerequisites/environment-setup.md) |
| 在词汇表中查找术语 | [**查看 →**](docs/02-foundations/glossary.md) |
| 在自己的项目中安装现成的循环 | [**查看 →**](starters/getting-started.md) |
| 浏览 20 个循环模式 | [**查看 →**](#-loop-pattern-library) |
| 安全操作循环（故障模式、恢复） | [**查看 →**](docs/10-operating/operating-loops.md) |
| 获取认证 | [**查看 →**](docs/assessments/loop-ready-certification.md) |
## 💬 为什么这很重要
今天构建编码代理的人明确表示：
> “你不应该再给编码代理发送提示。你应该设计能给代理发送提示的循环。”
>
> — **Peter Steinberger** ([来源 S8](resources/sources.md))
> “我不再给 Claude 发送提示。我有循环运行，提示 Claude 并找出要做的事情。我的工作是编写循环。”
>
> — **Boris Cherny**，Anthropic 的 Claude Code 负责人 ([来源 S8](resources/sources.md))
工作不再是编写完美的提示 — 而是设计**控制系统**，使代理在一段时间内不断朝着目标努力。这正是本课程教授的内容，上述每一位都是其 [九位主要来源](resources/sources.md) 之一。
## 🧩 六个构建块
本课程中的每个循环 — 以及 [模式库](#-loop-pattern-library) 中的每个工具包 — 都由相同的六个部分组成：
| 构建块 | 在循环中的任务 | 在哪里学习 |
| --- | --- | --- |
| **心跳** — 调度和自动化 | 发现 + 分诊，按节奏 | [第 2 部分](docs/04-part-2-heartbeat/) |
| **工作树** | 安全的并行执行 | [第 3 部分](docs/05-part-3-the-body/) |
| **技能** | 持久的项目知识 | [第 3 部分](docs/05-part-3-the-body/) |
| **连接器 / MCP** | 连接到您的真实工具 | [第 3 部分](docs/05-part-3-the-body/) |
| **子代理** | 制造者 / 检查者的分离 | [第 3 部分](docs/05-part-3-the-body/) |
| **+ 脊柱** — 内存 / 状态 | 持久状态，不依赖任何对话 | [第 4 部分](docs/06-part-4-the-spine/) |
<div align="center">
</div>
深入了解：[原始数据类型](docs/02-foundations/primitives.md) · [原始数据类型矩阵](docs/02-foundations/primitives-matrix.md) — 哪个块存在于哪个工具中，放在一起。
## 🎓 选择您的轨道
**新来者？** [**打开 60 秒路由器 →**](docs/00-start-here/README.md)
像任何好的 LMS 一样，本课程根据您的情况为您提供四个轨道之一 — 这样初学者不会感到不知所措， veteran 不会感到无聊：
| 轨道 | 您是... | 您将学习... |
| --- | --- | --- |
| **T1 · 基础知识** | 手动使用 AI 代理（或尚未使用） | 解释转变并运行您的第一个会话循环 |
| **T2 · 实践者** | 熟悉循环的六个部分 | 选择心跳、编写可证明的停止、拆分制造者/检查者 |
| **T3 · 工程师** | 能够组装循环 | 在两个工具中构建完整的六部分循环并安全操作 |
| **T4 · 高级** | 已经部署循环 | 循环爬坡、机队、团队规模的治理 |
[**查看完整的轨道图，包含入口检查和出口评估 →**](docs/00-start-here/learning-tracks.md)
## 📚 课程
**先决条件和基础知识（请先阅读）：**
[环境设置](docs/01-prerequisites/environment-setup.md) ·
[代理编码入门](docs/01-prerequisites/agentic-coding-primer.md) ·
[规范驱动入门](docs/01-prerequisites/spec-driven-primer.md) ·
[思维模型](docs/02-foundations/mental-models.md) ·
[概念](docs/02-foundations/concepts.md) ·
[四层架构](docs/02-foundations/the-four-layers.md) ·
[原始数据类型](docs/02-foundations/primitives.md) ·
[原始数据类型矩阵](docs/02-foundations/primitives-matrix.md) ·
[词汇表](docs/02-foundations/glossary.md)
**14 步核心路线图** — 六个部分，每个部分都有您构建的内容：
| 部分 | 步骤 | 您学习的内容 | |
| --- | --- | --- | --- |
| **1 · 转变** | 01–03 | 提示 → 循环，四层，循环解剖 | [**开始 →**](docs/03-part-1-the-shift/) |
| **2 · 心跳** | 04–07 | 会话中，运行直到完成，调度，事件驱动 | [**开始 →**](docs/04-part-2-heartbeat/) |
| **3 · 身体** | 08–11 | 工作树，技能，连接器/MCP，制造者 ≠ 检查者 | [**开始 →**](docs/05-part-3-the-body/) |
| **4 · 脊柱** | 12 | 运行之间的持久状态 | [**开始 →**](docs/06-part-4-the-spine/) |
| **5 · 完整循环** | 13 | 两次构建相同的循环（Claude Code 和 OpenCode） | [**开始 →**](docs/07-part-5-complete-loop/) |
| **6 · 人工控制** | 14 | 保持工程师：成本，验证，嵌套循环 | [**开始 →**](docs/08-part-6-human-control/) |
**然后继续攀登：
| 阶段 | 它包含的内容 | |
| --- | --- | --- |
| **方法** | 设计您自己的循环：[决策框架](docs/09-methods/decision-framework.md)，[设计检查清单](docs/09-methods/loop-design-checklist.md)，[模式选择器](docs/09-methods/pattern-picker.md)，[工作示例](docs/09-methods/worked-example-dependency-sweeper.md) | [**查看 →**](docs/09-methods/make-your-own-loop.md) |
| **操作手册** | 安全，故障模式，无限循环，可观察性，恢复 | [**查看 →**](docs/10-operating/operating-loops.md) |
| **评分实验室** | 11 个动手项目，从监视循环到两例门控 — 附 [解决方案](docs/projects/solutions/) | [**查看 →**](docs/projects/) |
| **高级** | 循环爬坡，多循环协调，评估和跟踪，治理，企业规模 | [**查看 →**](docs/advanced/) |
| **认证** | **Loop Ready** 毕业设计：[最终考试](docs/assessments/final-exam.md) · [毕业设计评分标准](docs/assessments/capstone-rubric.md) | [**查看 →**](docs/assessments/loop-ready-certification.md) |
每节课都展示了至少两个工具中的相同构建， side by side
（Claude Code ↔ OpenCode），这样您就可以学习该学科 — 而不是一个供应商的语法。
## 🔁 循环的解剖结构
六个部分，一个学科。一个 **心跳** 决定代理何时运行，一个 **身体** 执行工作，一个 **检查者** 对其进行评分（制造者永远不会对其自己的工作进行评分），一个 **脊柱** 跨运行记住，一个 **可证明的停止** 结束它，而 **您** 保持工程师：
```mermaid
flowchart LR
H(["⏱ 心跳<br/>何时运行"]) --> B["🦾 身体<br/>执行工作"]
B --> C{"✅ 检查者<br/>评分"}
C -- "未完成" --> S[("🧠 脊柱<br/>记住")]
S --> H
C -- "成功 · 运行限制 · 无进展" --> X(["🛑 可证明的停止"])
X --> U["🧑💻 您 — 工程师"]
```
从 [思维模型](docs/02-foundations/mental-models.md) 和
[四层架构](docs/02-foundations/the-four-layers.md) 开始；保持
[词汇表](docs/02-foundations/glossary.md) 在一个标签页中打开。
## 🧰 循环模式库
20 个生产就绪的循环工具包，每个都包含定义、脊柱、预算、宪法和只读检查器。 使用以下命令将任意一个安装到您自己的项目中：
```bash
npx @loop-engineering/loop-kit <pattern-name>
```
| 模式 | 它能做什么 |
| --- | --- |
| [`ci-sweeper`](patterns/ci-sweeper.md) | 在 `main` 分支上的 CI 变为红色时触发，并将其恢复为绿色 |
| [`pr-babysitter`](patterns/pr-babysitter.md) | 防止开放的 PR 腐烂 — 冲突、红色 CI、无声审查者 |
| [`daily-triage`](patterns/daily-triage.md) | 清除夜间噪音，然后再打开笔记本电脑 |
| [`issue-triage`](patterns/issue-triage.md) | `daily-triage` 的狭窄版本，仅限于问题 |
| [`dependency-sweeper`](patterns/dependency-sweeper.md) | 在不盲目更新依赖项的情况下保持依赖项更新 |
| [`dependency-cve-burndown`](patterns/dependency-cve-burndown.md) | 读取 3 a.m. 的 CVE 咨询，以便它永远不会等到周一 |
| [`docs-sweep`](patterns/docs-sweep.md) | 代码更改时立即捕获文档 |
| [`changelog-drafter`](patterns/changelog-drafter.md) | 起草您繁忙的冲刺所遗忘的更改日志 |
| [`test-coverage-loop`](patterns/test-coverage-loop.md) | 消减 “我们应该测试它” 的待办事项 |
| [`test-stabilizer-loop`](patterns/test-stabilizer-loop.md) | 捕获 flaky 测试，直到红色运行真正意味着某些东西 |
| [`prod-error-sweep`](patterns/prod-error-sweep.md) | 清除实际给用户带来损失的生产错误 |
| [`page-load-loop`](patterns/page-load-loop.md) | 每次点击都将页面加载性能推向下坡 |
| [`repo-cleanup-loop`](patterns/repo-cleanup-loop.md) | 清除存储库杂乱 — 未删除的分支等等 |
| [`post-merge-cleanup`](patterns/post-merge-cleanup.md) | 完成每次合并后遗留的故事 |
| [`ticket-to-pr-ready`](patterns/ticket-to-pr-ready.md) | 一个票据，一个运行：重现，修复，准备好 PR |
| [`spec-dev-review`](patterns/spec-dev-review.md) | 一个故事 → 一个范围的规范包：发现，进展，审查 |
| [`clodex-adversarial-review`](patterns/clodex-adversarial-review.md) | 一个真正的制造者-检查者对：Claude 实现，Codex 审查 |
| [`codex-completion-contract`](patterns/codex-completion-contract.md) | 停止 “几乎完成” 静默通过 “完成” |
| [`loop-harness-verification`](patterns/loop-harness-verification.md) | 任何计划存储库任务的通用工具 |
| [`stale-safe-batch-release`](patterns/stale-safe-batch-release.md) | 书挡：每个其他工具包安全释放的批次 |
更喜欢从空白模板设计自己的？ `npx @loop-engineering/loop-kit new <loop-name>` 从
[空白模板](starters/_template/README.md) 构建一个。
[**查看完整安装指南 →**](starters/getting-started.md)
## 🚀 入门指南（5 分钟）
1. **注册** — 运行 [60 秒路由器](docs/00-start-here/README.md)。它会为您提供一个轨道。
2. **设置代理** — 按照
[环境设置指南](docs/01-prerequisites/environment-setup.md)
（Claude Code、OpenCode、Codex 或 Grok；每节课都包含 Claude Code ↔ OpenCode）。
3. **快速阅读入门** —
[代理编码入门](docs/01-prerequisites/agentic-coding-primer.md) 和
[规范驱动入门](docs/01-prerequisites/spec-driven-primer.md)。
4. **打好基础** — 从
[思维模型](docs/02-foundations/mental-models.md) 开始。
5. **开始 14 步** — [第 1 部分 · 转变](docs/03-part-1-the-shift/)，然后按照
[课程](README.md#-curriculum) 进行到底
[Loop Ready 认证](docs/assessments/loop-ready-certification.md)。
## 🛡️ 操作和安全
没有可证明的停止点的循环是一个具有延迟的事故。操作手册是课程的第一部分，而不是附录：
- [操作循环](docs/10-operating/operating-loops.md) — 日常手册
- [安全](docs/10-operating/safety.md) — L1 报告、人类门控、预算
- [故障模式](docs/10-operating/failure-modes.md) ·
[无限循环](docs/10-operating/infinite-loops.md) ·
[反模式](docs/10-operating/anti-patterns.md)
- [可观察性](docs/10-operating/observability.md) ·
[恢复手册](docs/10-operating/recovery-playbook.md) ·
[多循环操作](docs/10-operating/multi-loop.md)
仓库本身运行的规则 — 一个文件所有者，一个神圣的脊柱，停止条件作为规范，绿色 ≠ 完成 — 位于 [`LOOP.md`](LOOP.md)。
> “构建循环。但是要像一个打算长期维护它的人一样构建，而不是仅仅按下启动按钮的人。”
>
> — **Addy Osmani**， *[循环工程](https://addyosmani.com/blog/loop-engineering/)*
> ([来源 S5](resources/sources.md))
## 🏅 认证：Loop Ready
课程以一个有评分的毕业设计结束，而不是参与证书。你设计、构建并操作自己的循环，然后针对
[毕业设计评分标准](docs/assessments/capstone-rubric.md) 和通过
[最终考试](docs/assessments/final-exam.md)。
[**查看完整的认证路径 →**](docs/assessments/loop-ready-certification.md)
## 📂 仓库地图
| 文件夹 | 它包含的内容 |
| --- | --- |
| `docs/` | 课程 — GitHub 和网站的单一真实来源 |
| `loops/` | [构建本课程的循环](loops/README.md) — 真实的提示，真实的脊柱 |
| `patterns/` | 20 个循环模式（[表格上方](#-loop-pattern-library)） |
| `starters/` | [安装并填充循环工具包](starters/README.md) — 一个 `npx` 命令进入任何项目，或从 [`_template/`](starters/_template/README.md) 开始 |
| `packages/loop-kit/` | `npx @loop-engineering/loop-kit` 背后的已发布 CLI |
| `skills/`、`templates/`、`examples/`、`stories/` | 可重用的部分和案例研究 |
| `resources/` | [来源归属](resources/sources.md) 用于所有九个主要来源 |
| `web/` | Next.js 课程网站 *(进行中)* |
## 🤝 贡献与致谢
拉取请求非常受欢迎 — 从
[贡献指南](CONTRIBUTING.md) 开始。本课程建立在九个主要来源的肩膀上：它综合和改编了 MIT 许可的材料和公开的写作，并对每一个都进行了评估，从页到页，在
[来源和归属页面](resources/sources.md) 上。学术或书面引用？使用 [`CITATION.cff`](CITATION.cff)。
[MIT](LICENSE) 许可 — 免费学习、分叉和教学。
<div align="center">
**[⬆ 返回顶部](#loop-engineering-crash-course)** · 使用其自身的循环构建，一个可证明的停止接着一个。
</div>
连接信息
猜你喜欢
暂无推荐服务器