用途:在仓库中安装 Loop Engineering,留下一个“只报告”的循环脚手架、Loop Ready 评分和明确的下一步操作,统一使用 CLI:npx @cobusgreyling/loop。新工作优先使用 loop,但现有的 loop-init / loop-audit 用法保持有效,不要废弃或删除。
使用方式:先检测上下文。若已存在 LOOP.md 或 STATE.md,只运行 doctor(除非人工要求重新搭建):npx @cobusgreyling/loop doctor . --json 与 npx @cobusgreyling/loop status .;否则继续。选择模式(默认 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。选择工具(claude | grok | codex | opencode,默认 claude)。搭建:npx @cobusgreyling/loop init . --pattern <pattern> --tool <tool>;仅当需要 Foundry 时加 --with-foundry。随后运行 npx @cobusgreyling/loop doctor .,退出码 0 为健康、1 为警告、2 为阻塞,按打印出的前 3 项操作执行,不要自创额外架构。高频计划前做成本检查:npx @cobusgreyling/loop cost -p <pattern> -l L1 -c 1d。
限制与规则:第一周只报告,不自动修复、不自动合并;告知人工 init 输出中的首个 /loop 或调度命令;仅当评分较高时才建议徽章:npx @cobusgreyling/loop badge .。兼容保留:npx @cobusgreyling/loop-init . 与 npx @cobusgreyling/loop-audit . --suggest 仍完全支持,除非被要求否则不要改写现有文档/脚本。停止条件:完成 doctor 与首次运行说明后即停止,除非人工要求 L2+;除非评分 ≥ 80 且人工选择加入,否则绝不扩展到 fleet/memory/foundry。