loop-engineering

环境要求

• 可运行 npx 的 Node.js 环境（通过 npx 调用 @cobusgreyling/loop）
• 可访问 npm 仓库的网络（首次执行 npx 需下载 @cobusgreyling/loop 包）
• 一个待初始化循环工程的目录（示例中为当前目录 .）
• 已确定要使用的 AI 编程代理工具（示例为 claude）

安装与启动步骤

1. 1初始化循环工程

   在当前目录按指定模式生成循环脚手架，并用 --tool 指定代理工具。README 示例模式为 daily-triage、工具为 claude。

   npx @cobusgreyling/loop init . --pattern daily-triage --tool claude

   复制

2. 2体检当前配置

   用 doctor 检查工程目录中的循环配置是否完整可用，出现问题按提示修正后重跑。

   npx @cobusgreyling/loop doctor .

   复制

3. 3估算循环成本

   用 cost 查看指定模式在 L1 级别下的成本预估，据此决定是否升级到更高自动化等级。

   npx @cobusgreyling/loop cost --pattern daily-triage --level L1

   复制

4. 4跑一遍空仓库演示

   在克隆下来的仓库根目录执行该脚本，观察从空仓库到生成第一份 STATE.md 的完整过程。

   bash scripts/empty-to-state-demo.sh

   复制

5. 5阅读配套文档

   继续查看 Quickstart、jobs、refactor 与 loop-design-checklist 文档，明确任务目标与提交前检查项。

关键配置

如何确认成功

doctor 命令执行后无报错，且工程目录中出现 README 提到的 STATE.md 等循环文件。

常见问题

注意事项

• 严格按 L1 报告 → L2 辅助 → L3 无人值守的顺序渐进放权，不要跳级。
• Loop Ready 评分权重向近期运行倾斜，注意保持循环持续运行以维持等级。
• 空仓库上手可参考 scripts/empty-to-state-demo.sh，提交前对照 docs/loop-design-checklist.md 自查。