loop-engineering CI/CD部署指南用GitHub Actions与loop-action实现Agent循环无人值守运行【免费下载链接】loop-engineeringPractical patterns, starters CLI tools for loop engineering with AI coding agents. Design systems that prompt and orchestrate agents (inspired by Addy Osmani and Boris Cherny). Includes loop-audit, loop-init, loop-cost.项目地址: https://gitcode.com/gh_mirrors/lo/loop-engineeringloop-engineering 是一个面向 AI 编码代理AI coding agents循环工程的开源项目提供成熟的模式库、起步套件与 CLI 工具。其中的loop-action复合 Action 可以安全地在 GitHub Actions 的 CI/CD 流水线中执行 AI Agent它自动完成就绪审计、Token 预算熔断和隔离工作树让 Agent 循环真正具备无人值守运行的条件。本指南带你用不到 10 分钟把 Agent 循环接入自己的 CI/CD 部署流水线。为什么需要把 Agent 循环放进 CI/CD传统做法是CI 失败了人去翻日志、手动修复、手动重跑。循环工程的思路是设计一个系统让它自动发现工作、派发给 Agent、验证结果并持久化状态而不是你亲自敲下一条条提示词。官方给出的循环结构Anatomy of a Loop如下调度触发 → 分诊技能 → 状态记忆 → 隔离工作树 → 实现/验证子代理 → 人工关口把这个结构搬到 GitHub Actions 中正是loop-action解决的问题。loop-action一个步骤封装三重安全防线loop-action是一个官方 GitHub Composite Action源码见 action.yml你不需要再手写复杂的 shell 脚本来实现熔断和隔离——它按顺序执行四步就绪审计loop-audit检查仓库是否具备循环所需文件STATE.md、gate.yaml、约束文件等电路断路器loop-context循环陷入失败循环或耗尽每日 Token 预算时立即中止并升级给人工安全写入命令脚本command通过环境变量传递并原样写入临时文件避免引号、管道符被 YAML 二次解析执行 Agent 命令开启沙箱时经由loop-sandbox在临时 git worktree中运行改动被捕获为可审查的.patch文件主工作树保持干净否则直接在主树上执行。整个循环工程由五大原语支撑调度、工作树、技能、MCP 插件与状态记忆环环相扣快速上手第一个 Agent 循环工作流在仓库根目录先完成脚手架初始化无需克隆本项目npx cobusgreyling/loop init . --pattern daily-triage --tool claude npx cobusgreyling/loop doctor .然后在工作流中加入loop-action一步。下面是精简版的每日分诊工作流完整版见 daily-triage.ymlname: Daily Triage Loop on: schedule: - cron: 0 8 * * 1-5 # 周一至周五 08:00 UTC workflow_dispatch: # 支持手动触发 permissions: contents: read issues: read jobs: triage: runs-on: ubuntu-latest steps: - uses: actions/checkoutv7 - name: Invoke Triage Agent uses: cobusgreyling/loop-engineering/tools/loop-actionmain with: pattern: daily-triage level: L1 sandbox: false command: | # 替换为你自己的 Agent 调用命令例如 # npx grok-cli run --skill .grok/skills/loop-triage/SKILL.md echo Run loop-triage skill. Update STATE.md. Report only. 第一周铁律只做报告report-only。不自动修复、不自动合并先读完循环产出的状态文件再逐步放开权限。5 个输入参数详解参数必填默认值说明pattern✅—循环模式名如ci-sweeper、daily-triage必须与loop-budget.md中登记的模式一致command✅—Agent 的调用命令支持多行command: |块以bash -eo pipefail执行level❌L1自主级别L1 只读报告 → L2 辅助 → L3 无人值守用于预算校验sandbox❌false设为true时经loop-sandbox在临时 worktree 中隔离执行sandbox-shell❌falseloop-sandbox的兼容选项常规使用无需修改完整说明见 tools/loop-action/README.md。为不同场景选择合适的触发策略项目为每种模式都提供了 schema 完整的参考工作流目录examples/github-actions/按触发事件分为两类参考工作流触发方式适用模式典型场景daily-triage.yml工作日 Cron 手动Daily Triage每天早上汇总 CI 与仓库健康状况ci-sweeper.ymlworkflow_run失败事件CI SweeperCI 一挂Agent 自动定位并尝试修复issue-triage.yml每 2 小时 新 Issue 事件Issue Triage自动归类、打标签、评估优先级post-merge-cleanup.ymlPush 到 main 夜间Post-Merge Cleanup合并后清理临时代码与技术债dependency-sweeper.ymlCronDependency Sweeper定期升级依赖并验证以 CI Sweeper 为例它的触发条件非常简洁main 分支上任意 workflow 失败即唤醒 Agent见 ci-sweeper.ymlon: workflow_run: workflows: [*] types: [completed] branches: [main] jobs: sweep: if: ${{ github.event.workflow_run.conclusion failure }} steps: # checkout、记录失败上下文后调用 loop-action - uses: cobusgreyling/loop-engineering/tools/loop-actionmain with: pattern: ci-sweeper level: L2 sandbox: true command: | # 接入你的 Agent分类失败、在 worktree 修复、验证、开 PR从 L1 到 L3无人值守的三步升级路径不要一开始就无人值守。loop-engineering 的推荐路径是逐级放开L1 只读报告第 1 周level: L1Agent 只写状态文件、只提建议。人工审阅输出是否符合预期。L2 辅助修复第 2 周起level: L2sandbox: true。Agent 可在沙箱中尝试修复产出.patch供审查验证器verifier连续一周表现正确后再升级。L3 无人值守最后预算、运行日志与人工关口齐备后才开启。此时熔断器是关键防线——loop-context会在连续 3 次相同错误、连续 5 次失败或触顶 Token 预算时退出并升级给人工详见 tools/loop-context/README.md。上线前先算清楚成本npx cobusgreyling/loop cost --pattern ci-sweeper --level L2 --cadence 15m并在loop-budget.md中为每个循环登记每日最大运行次数与 Token 上限参考本仓库的 loop-budget.md。安全要点无人值守不等于失控最小权限工作流只申请必要的permissions如contents: readpull-requests: writeGITHUB_TOKEN权限宁小勿大命令注入防护严禁把 Issue 标题、PR 描述等外部不可信内容直接拼接进command——它将以 shell 脚本权限执行正确做法是先验证/转义或写入文件让 Agent 读取合并门禁通过 gate.yaml 定义 denylist**/.env、**/auth/**等永不自动改动的路径由loop-gate机械强制执行沙箱不等于容器loop-sandbox提供 git worktree 级隔离进程仍保留 OS 级文件与网络访问应用 patch 前务必人工检查。完整的安全与护栏模型见 docs/safety.md常见失败模式与反模式见 docs/failure-modes.md。延伸资源资源路径5 分钟快速上手docs/QUICKSTART.mdloop-action 使用文档tools/loop-action/README.md全部 GitHub Actions 示例examples/github-actions/README.md循环模式库patterns/起步套件starters/安全护栏规范docs/safety.md按照「L1 报告 → L2 辅助 → L3 无人值守」的节奏配合loop-action的三重安全防线你的 CI/CD 流水线将从「人盯着 Agent 跑」进化为「Agent 自己跑人只审关口」——这才是 CI/CD 部署 Agent 循环的正确打开方式。【免费下载链接】loop-engineeringPractical patterns, starters CLI tools for loop engineering with AI coding agents. Design systems that prompt and orchestrate agents (inspired by Addy Osmani and Boris Cherny). Includes loop-audit, loop-init, loop-cost.项目地址: https://gitcode.com/gh_mirrors/lo/loop-engineering创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考