10769 stars · MIT 许可 · TypeScript · 支持 Claude Code / Grok / Codex / Opencode
一句话介绍
loop-engineering 是一个「围绕代码库运行 Agent 的模式库」。它不教你写更长的提示词，而是教你设计一个「循环」，让 agent 自动发现工作、执行任务、验证结果、持久化状态。
环境要求
- Node.js 环境（运行 CLI）
- 至少一个已安装的 coding agent 工具（Claude Code / Codex / Grok / Opencode，任选其一）
5 分钟快速开始
# 初始化一个「每日分诊」循环，使用 Claude
npx @cobusgreyling/loop init . –pattern daily-triage –tool claude
# 检查循环健康度
npx @cobusgreyling/loop doctor .
# 估算运行成本
npx @cobusgreyling/loop cost –pattern daily-triage –level L1
–tool 省略时默认 claude，可替换为 grok、codex、opencode。第一周为「仅报告」模式（L1），不会碰你的代码。
核心概念：8 个模式
| 每日分诊 daily-triage | 1 天–2 小时 | L1 报告 | 低 |
| 精简循环 thin-loop | 事件 + 1 天 | L1 快照 | 极低 |
| PR 保姆 pr-babysitter | 5–15 分钟 | L1 观察 | 高 |
| CI 清扫器 ci-sweeper | 5–15 分钟 | L2 谨慎 | 极高 |
| 依赖清扫器 dependency-sweeper | 6 小时–1 天 | L2 仅补丁 | 中 |
| 变更日志起草器 changelog-drafter | 1 天或打标签 | L1 草稿 | 低 |
| 合并后清理 post-merge-cleanup | 1 天–6 小时 | L1 非高峰 | 低 |
| Issue 分诊 issue-triage | 2 小时–1 天 | L1 仅建议 | 低 |
完整任务表见 docs/jobs.md，交互式选择器见官方展示页。
关键机制：L1 → L2 → L3 信任阶梯
这是本项目最值得学习的设计。自动化程度分三级：
- L1 报告：agent 只观察、只报告，不碰代码；
- L2 辅助：agent 可以动手，但需要人确认；
- L3 无人值守：验证器连续一周表现正确，才允许全自动。
落地建议：先用 L1 跑满一周验证可靠性，再逐步放权到 L2、L3。这样能把 AI 写代码的风险控制住。
架构要点
核心是一个「无头核心」（headless core），把 API、身份、策略、调度器、agent 循环解耦，状态和记忆存 Postgres。支持 Slack + Web 双入口，每个成员有独立 workspace 和权限边界。
中文版
我已将项目 README 和核心文档完整中文化，发布了中文版仓库：
https://github.com/yangshun2005/loop-engineering-cn
文档全中文，模式库、信任阶梯、快速开始都已翻译，降低上手门槛。
如果这个项目对你有帮助，也欢迎动动小手去原仓库点个 Star，支持作者持续维护。
