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 个模式

完整任务表见 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，支持作者持续维护。