项目介绍
Loop Engineering 是一套围绕代码库运行编程 Agent 的模式库与工具集。它不把自动化简化成一段超长 Prompt，而是把周期任务拆成带状态、预算、门禁、升级条件和停止规则的可观察循环。仓库内的 starter 覆盖每日巡检、PR 跟进、CI 清理、依赖检查等场景，统一 CLI 可以为 Codex、Claude Code、Grok 与 OpenCode 生成脚手架，同时建议先从只产出报告的模式开始。
核心功能
模式与 starter 库
可复用的 Prompt 工作流为常见仓库维护任务定义触发器、状态、输出、升级方式和停止行为。
多宿主脚手架
loop init 可生成 Codex、Claude Code、Grok 或 OpenCode 的宿主配置，不必从 examples 目录手动拼装。
就绪度、门禁与预算
doctor、audit、gate 和成本相关命令用于在定时运行前检查配置完整度、策略门禁、循环等级与预估开销。
有状态周期执行
STATE.md、LOOP.md、运行日志和预算文件让下一次执行继承上次进度，也给人工审核留下明确产物。
可选 MCP 与高级执行方式
仓库提供 MCP server，以及 worktree、sandbox 与 swarm 相关材料，供需要更大执行面的团队评估。
获取与使用
在一次性或低风险仓库运行统一 CLI，明确选择 Codex，逐项检查生成文件，并把第一周保持在 L1 仅报告模式。理解 doctor 与 audit 输出后再设置定时任务。
让 AI Agent 帮你安装
把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。
请帮我在一个低风险测试仓库中为 Codex 配置 Loop Engineering。使用 https://github.com/cobusgreyling/loop-engineering 的提交 c78d70f30dcef8d39686499287b41c867f5c17fb。先阅读 README.md、docs/QUICKSTART.md、docs/SAFETY.md、SECURITY.md、LICENSE 和 tools/loop/package.json。确认 Node.js 18+，并在运行前列出 `npx @cobusgreyling/loop init . --pattern daily-triage --tool codex` 将创建的文件。第一周保持 L1 仅报告模式。禁止读取或修改 secrets、credentials、基础设施、数据库迁移、认证、支付和账单路径。不要把 API key 写入 Prompt、STATE.md、日志或调度配置。初始化后运行 doctor 和 cost 检查。未经我明确批准，不要设置定时任务、启用 L2/L3、提高 token 预算、修改源代码、在 GitHub 评论或合并任何内容。- Node.js 18 或更高版本，并可运行 npx
- Git 与一个受版本控制的测试仓库
- 已安装并在目标仓库完成认证的 Codex
- 一个范围小、便于复核的首个模式，例如 daily-triage
- 明确的预算、禁止路径、停止条件和审批负责人
npx @cobusgreyling/loop init . --pattern daily-triage --tool codex- 1先读模式与安全说明
阅读 README、Quickstart、Safety、Security 和 daily-triage starter，确定循环可以读取哪些仓库数据，以及哪些路径和外部动作必须禁止。
- 2生成 Codex 循环脚手架
在低风险仓库执行 `npx @cobusgreyling/loop init . --pattern daily-triage --tool codex`，提交前逐个检查生成文件。
- 3运行 doctor 与成本检查
执行 `npx @cobusgreyling/loop doctor .` 和 `npx @cobusgreyling/loop cost --pattern daily-triage --level L1`，补齐门禁并设定保守的 token 预算。
- 4手动测试一次仅报告循环
手动运行每日巡检 Prompt，确认它只写预期的报告与状态产物，遵守禁止路径，并在需要人类决策时停止。
- 5谨慎设置定时与升级
手动结果稳定后再定时运行 L1。持续复核一周后才考虑范围很窄的 L2 修改，把 L3 视为单独的治理决策。
运行 `npx @cobusgreyling/loop doctor .`，检查生成的 LOOP.md、STATE.md、预算和日志配置，再用 `npx @cobusgreyling/loop cost --pattern daily-triage --level L1` 评估一次运行。第一次定时任务只应生成报告，不应修改源文件或合并变更。
- 确定需要跟踪的发布线后，在长期自动化中固定明确的 npm 包版本。
- GitHub Release 与统一 CLI 包当前版本号不同，变更记录应同时写明两者。
- L1 阶段应尽量把连接器权限保持为只读。
- 提交生成的状态与日志文件前，检查其中是否含敏感代码或 Issue 内容。
使用场景
每日代码库巡检
把失败检查、停滞 PR、新 Issue 与维护信号整理成报告，不修改源代码。
PR 跟进
监控一个 PR 的评审或 CI 变化，准备范围明确的后续工作，并把评论与推送权限放在显式门禁之后。
CI 与依赖清理
收集重复失败或过期依赖，应用预算和文件数量限制，把敏感或大范围变更升级给维护者。
循环就绪度审计
用 readiness 与 gate 检查现有 Agent 工作流是否具备状态、预算、停止规则、证据与明确负责人。
使用评价
Loop Engineering 更适合作为一套运行设计参考。它把 Prompt 与状态、预算、门禁和证据放在一起，而不是只交付一段指令。Codex 脚手架和 L1 仅报告起点让团队可以在不立即开放写权限的情况下评估。主要风险在版本理解和执行信任。仓库的 v1.6.0 Release 与 0.2.0 统一 CLI 属于不同版本面，近期活动也包含自动化提交；生成循环的实际表现仍由模型、宿主、连接器与代码库共同决定。本次没有运行 CLI。
值得一试的地方
- 模式不只写 Prompt，也说明运行产物、升级条件和停止规则
- Codex、Claude Code、Grok 与 OpenCode 都有直接脚手架路径
- L1、L2 与 L3 把权限增长显式化
- MIT 许可证、安全报告渠道与安全指南公开清楚
使用前要知道
- GitHub Release 与统一 CLI 使用不同版本号
- 无人值守结果仍随模型、宿主、连接器与仓库而变化
- 近期提交活动包含自动化维护产物
- 安装、成本估算和循环行为没有独立实测
README
Loop Engineering
Overview
Loop Engineering 提供可复制的 Prompt 模式、脚手架与 CLI，用于让 Codex、Claude Code、Grok 和 OpenCode 围绕代码库执行每日巡检、PR 跟进、CI 清理等受预算和人工门禁约束的循环。 用于设计和运行 AI 编程 Agent 循环的实用 Prompt 模式、starter 与 CLI 工具。
Getting started
- 在一次性或低风险仓库运行统一 CLI，明确选择 Codex，逐项检查生成文件，并把第一周保持在 L1 仅报告模式。理解 doctor 与 audit 输出后再设置定时任务。
- 仓库把循环工程定义为围绕 Agent 构建系统的工作。Prompt、上下文、状态、工具、权限、反馈、预算与停止条件需要一起设计。
- starter 覆盖每日巡检、轻量实现循环、PR 跟进、CI 清理、依赖清理、变更日志、合并后清理和 Issue 分流。每种模式都描述触发方式、产物、风险与升级点。
- 运行 `npx @cobusgreyling/loop doctor .`，检查生成的 LOOP.md、STATE.md、预算和日志配置，再用 `npx @cobusgreyling/loop cost --pattern daily-triage --level L1` 评估一次运行。第一次定时任务只应生成报告，不应修改源文件或合并变更。
Configuration
npx @cobusgreyling/loop init . --pattern daily-triage --tool codex