在 Claude Code 中以插件方式安装 loop-engineering 技能marketplace 配置、技能清单与第一周报告制循环实战【免费下载链接】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本指南讲解如何把 Loop Engineering 仓库中的 Agent 技能daily triage、budget、constraints、verifier 等以 Claude Code Plugin 的形式安装进你的会话而不是手动复制文件夹仓库本身即充当 plugin marketplace由.claude-plugin/marketplace.json声明随后用统一 CLI 脚手架loop initloop doctor补齐 STATE、LOOP、budget 等文件最后以「报告制第一周」的/loop命令开启循环。读完本文你将掌握插件安装的两条命令、市场与技能的组织方式、医生检查doctor的退出码语义以及上游格式变更时的回退方案。为什么用 Plugin 而不是复制文件夹examples/claude-code/plugin.md给出的核心动机非常直接把 Loop Engineering 的技能装进 Claude Code而不是靠人手拷贝目录。技能文件一旦散落在各项目里升级、去重和一致性都难以维护而通过 plugin marketplace 安装技能由仓库统一发布、统一版本化Claude Code 侧只需两条命令即可完成发现与安装。本仓库本身就是这个 marketplace。市场的声明文件位于 .claude-plugin/marketplace.json内容如下{ name: loop-engineering, owner: { name: Cobus Greyling }, metadata: { description: Practical loop engineering skills and starters for Claude Code., version: 1.0.0 }, plugins: [ { name: loop-engineering, source: ./, description: Triage, budget, constraints, and verifier skills. Pair with npx cobusgreyling/loop init . --tool claude } ] }配套的 .claude-plugin/plugin.json 声明了插件的名称、版本1.0.0与关键字loop-engineering、triage、skills、claude-code。也就是说插件描述里明确建议与npx cobusgreyling/loop init . --tool claude配合使用——安装插件负责注入「技能」CLI 负责生成「循环的运行骨架」二者各司其职。注意.claude-plugin/目录中的owner、author、homepage字段指向项目原作者的信息本仓库是它的镜像同步副本。安装命令中引用的 marketplace 名称与仓库名一致实际可用性以你在 Claude Code 中执行命令时的上游发布状态为准。安装命令两条命令完成发现与安装在 Claude Code 会话中或直接从 CLI 执行claude plugin marketplace add cobusgreyling/loop-engineering claude plugin install loop-engineering第一条命令把cobusgreyling/loop-engineering这个 marketplace 添加到 Claude Code 的插件源列表第二条命令把其中的loop-engineering插件安装进当前环境。安装完成后技能便以原样出现在 Claude Code 中。技能的本体全部存放在仓库根目录的 skills/ 下当前包含 7 个技能技能目录职责skills/loop-triage/SKILL.md对最近的 CI 失败、PR、issue 做分级产出 High-Priority / Watch / Noise 报告skills/loop-verifier/SKILL.mdmaker/checker 分离中的 checker默认立场是 REJECT 直到证据充分skills/loop-budget/SKILL.md预算相关的技能skills/loop-constraints/SKILL.md约束相关的技能skills/minimal-fix/SKILL.md最小修复技能skills/budget-negotiator/SKILL.md预算谈判技能skills/install-loop/SKILL.md指导 Agent 用统一 CLI 安装并 doctor 一个项目以最常用的 skills/loop-triage/SKILL.md 为例它声明了user_invocable: true输入是「循环」提供的最近 24h CI/测试失败、未合并 PR冲突、check 失败、BLOCKED、超过 7 天未答复的 issue、main 分支最近提交等输出是包含「High-Priority Items / Watch Items / Noise / State Updates」四节的 Markdown 报告并强调「Be brutally concise」「When in doubt, put it in Watch or Noise rather than creating work」——这是整个 triage 循环的信号纪律。安装后脚手架补齐 STATE、LOOP、budget插件只负责注入技能不负责生成项目的循环运行文件。因此 plugin.md 紧接着给出脚手架命令npx cobusgreyling/loop init . --pattern daily-triage --tool claude npx cobusgreyling/loop doctor .第一条命令用--pattern daily-triage和--tool claude生成项目文件第二条命令做一次健康检查。这两条命令来自统一 CLI 包 tools/loop/README.md 描述的前门设计cobusgreyling/loop不取代loop-init、loop-audit等独立工具而是对它们做转发并新增doctor与status。底层转发逻辑可见 tools/loop/src/pass-through.ts它维护了init → cobusgreyling/loop-init、audit → cobusgreyling/loop-audit、cost → cobusgreyling/loop-cost、sync → cobusgreyling/loop-sync等 9 条工具映射解析时依次尝试 monorepo 的dist/、node_modules 嵌套、仓库根 node_modules 提升路径最后才回退到npx --yes——也就是说在 monorepo 内联开发时它会直接执行兄弟包构建产物。init支持的模式选择可以参见 skills/install-loop/SKILL.md 中的「按痛点选模式」表痛点模式早晨混乱、优先级不清daily-triagePR 停滞pr-babysitterCI 变红/不稳定ci-sweeperCVE / Dependabot 噪音dependency-sweeper合并后 TODOpost-merge-cleanup发布说明过期changelog-drafterissue 噪音大issue-triage只需要一个 GitHub Actionthin-loop--tool的可选值是claude、grok、codex、opencode默认claude本插件场景固定为claude。Doctor 检查退出码 0 / 1 / 2 的含义loop doctor是激活循环的「一次健康检查」。根据 tools/loop/README.md 与 tools/loop/src/cli.ts 的帮助文本退出码语义如下退出码含义0健康Healthy1警告存在缺口、轻微漂移、budget/run-log 不完整2阻塞Loop Ready 得分 40、严重漂移或尚未脚手架化从 tools/loop/src/doctor.ts 的实现可以看到它实际做了三件事先调用loop-audit --json拿 Loop Ready 分数与推荐项再调用loop-sync --json检测 STATE ↔ LOOP 漂移syncLevel critical会给出修复命令最后做结构性文件检查——是否存在 STATE 文件、LOOP.md、loop-budget.md、loop-run-log.md、loop-constraints.md、gate.yaml、AGENTS.md。检查结果按优先级排序后输出 top 3 行动项例如若既无 STATE 又无 LOOP.md会提示先执行npx cobusgreyling/loop init . --pattern daily-triage --tool claude优先级 1若 Loop Ready 40会提示npx cobusgreyling/loop audit . --suggest提高分数后再调度无人值守工作若分数 ≥ 80会建议可选的下一步npx cobusgreyling/loop init . --with-foundry把循环版本化为 harness以及npx cobusgreyling/loop badge .分享徽章。输出可用--json获得机器可读格式npx cobusgreyling/loop doctor . --json npx cobusgreyling/loop status . --json第一次运行报告制第一周脚手架和健康检查完成后开启第一条循环。plugin.md 给出的第一周report-only命令是/loop 1d $loop-triage — update STATE.md. Report-only week one./loop是 Claude Code 侧的调度原语1d表示节奏每日$loop-triage引用刚安装的 triage 技能目标是更新 STATE.md。第一周铁律是report-only只读、只报告、不自动修代码。同样的命令在 examples/claude-code/daily-triage.md 中有更完整的措辞版本/loop 1d Run $loop-triage. Read STATE.md. Merge findings into High Priority and Watch List. Update Last run. Do not edit code.三周以后如果 triage 质量稳定可以升级为「带小自动修复」版本/loop 1d Run $loop-triage. For high-priority items that are single-file bugfixes: spawn implementer in worktree, then verifier agent. Update STATE.md. Escalate ambiguous items.注意后半段的结构对单个文件级的 bug 修复先在 worktree 中派生 implementer再交给 verifier agent 校验模糊项升级给人。这正是 maker/checker 分离在运行层面的落地——checker 的职责模板在 templates/SKILL.md.verifier 中写得很明确「You are the checker in a maker/checker split. Your job is to reject unless evidence is strong.」其 APPROVE 前提包括改动范围只涉及相关文件、不触碰 denylist 路径、测试由 verifier 亲自运行不轻信 implementer 的声明、无禁用测试或跳过断言的作弊行为、中高风险即使测试通过也建议人工复查。skill 侧对应的安装位置若不走插件直接复制时是templates/SKILL.md.loop-triage与templates/SKILL.md.verifier插件方式安装后则无需关心这些路径细节。回退方案上游格式变更时手工复制plugin.md 明确指出如果上游插件目录格式发生变化回退方案保持不变——直接复制starters/minimal-loop-claude/详细步骤见 examples/claude-code/daily-triage.md。手工复制的方式在 starters/minimal-loop-claude/README.md 中给出了完整命令cp -r starters/minimal-loop-claude/.claude/skills/loop-triage .claude/skills/ cp starters/minimal-loop-claude/.claude/agents/loop-verifier.md .claude/agents/ cp starters/minimal-loop-claude/STATE.md.example STATE.md cp starters/minimal-loop-claude/LOOP.md .复制后定制STATE.md的项目名然后启动循环/loop 1d Run $loop-triage. Read STATE.md first. Append high-priority and watch items. Update Last run timestamp. Do not auto-fix anything in week one.starter 中包含四类文件STATE.md.example状态主轴模板、loop-triage技能、loop-verifierchecker 子代理L2 使用、LOOP.md团队的循环配置文档。生成后的 starters/minimal-loop-claude/LOOP.md 本身就是一份可运行的循环配置示例Active Loops表声明「Daily Triage / 1d / L1 report-only //loop 1d Run $loop-triage」Human Gates规定 L2 checklist 完成前不允许自动修复Worktrees规定 implementer 子代理必须isolation: worktree一次修复一个 worktreeverifier REJECT 后丢弃Budget规定 L1 阶段每次运行子代理派生数为 0。这些字段恰好对应 doctor 检查的文件清单形成「配置 → 检查 → 运行」的闭环。相关资源与延伸阅读模式的完整定义patterns/daily-triage.md设计检查清单docs/loop-design-checklist.md三原语矩阵docs/primitives-matrix.md安全边界与 denylistdocs/safety.md统一 CLI 完整命令表与兼容性说明tools/loop/README.md给 Agent 的安装技能skills/install-loop/SKILL.md【免费下载链接】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），仅供参考