install-loop

安装 Loop Engineering

目标

使用单个 CLI，为仓库搭建一个仅报告的循环、一个 Loop Ready 评分，以及明确的后续操作：

npx @cobusgreyling/loop

不要弃用或移除你发现的现有 loop-init / loop-audit 用法；两种入口仍然有效。新工作优先使用 loop。

步骤

1. 检测上下文

   • 如果 LOOP.md 或 STATE.md 已存在，只运行 doctor（除非人工要求重新搭建，否则跳过 init）：

     npx @cobusgreyling/loop doctor . --json
     npx @cobusgreyling/loop status .
     

   • 否则继续。

2. 选择模式（默认：daily-triage）

   痛点	模式
   早晨一团乱 / 优先级不明确	daily-triage
   PR 停滞	pr-babysitter
   CI 失败 / 不稳定	ci-sweeper
   CVE / Dependabot 噪音	dependency-sweeper
   合并后的 TODO	post-merge-cleanup
   过时的发行说明	changelog-drafter
   问题噪音	issue-triage
   只有一个 GitHub Action，文件几乎没有	thin-loop

3. 选择工具 — claude | grok | codex | opencode（默认 claude）。

4. 搭建

   npx @cobusgreyling/loop init . --pattern <pattern> --tool <tool>
   

   可选的 harness（仅当人工需要 Foundry 时）：添加 --with-foundry。

5. Doctor

   npx @cobusgreyling/loop doctor .
   

   • 退出码 0 = 健康 · 1 = 警告 · 2 = 阻塞
   • 按顺序执行打印出的前 3 项操作；不要自行设计额外架构。

6. 高频计划运行前检查成本：

   npx @cobusgreyling/loop cost -p <pattern> -l L1 -c 1d
   

7. 第一周规则

   • 仅报告。不自动修复，不自动合并。
   • 告诉人工 init 输出中的首个 /loop 或调度器命令。
   • 仅当评分较高时建议添加徽章：npx @cobusgreyling/loop badge .

兼容性

以下内容仍受全面支持（除非有人提出要求，否则不要改写现有文档/脚本）：

npx @cobusgreyling/loop-init .
npx @cobusgreyling/loop-audit . --suggest

停止条件

• 完成 doctor 和首次运行说明后停止，除非人工要求 L2+。
• 除非评分 ≥ 80 且人工选择加入，否则绝不扩展到 fleet/memory/foundry。