loopback

Loopback 迭代开发循环

快速开始（推荐）

1. 直接启动（默认会进入“向导模式”）

/loopback "修复 X。完成后输出 <promise>DONE</promise>。" --completion-promise "DONE" --max-iterations 10

说明：

• 如果当前环境支持交互式输入，/loopback 会默认进入向导：先展示全局步骤，再一步步帮你完善参数与契约
• 如果当前环境不支持交互式输入，/loopback 会输出步骤概览，并在缺少关键契约时直接失败（避免跑飞）
• 如需跳过向导：加 --no-wizard

1. 不确定怎么传参：先看参数说明（不会创建状态文件、不会启动循环）

/loopback --guide

1. 参数看起来没问题：先用 --dry-run 预演（不会创建状态文件、不会启动循环）

/loopback "修复 X。完成后输出 <promise>DONE</promise>。" --completion-promise "DONE" --max-iterations 10 --dry-run

1. 正式启动

/loopback "修复 X。完成后输出 <promise>DONE</promise>。" --completion-promise "DONE" --max-iterations 10

什么是 Loopback？

Loopback 是一个基于 Ralph Loop 思想的迭代开发方法论，适配到 Codex CLI 环境。

核心概念：

while true; do
  # 从 .codex/loopback.local.md 读取同一条 PROMPT
  # 运行 Codex 一轮（例如：codex exec）
  # 检查停止条件（max-iterations / completion-promise / cancel）
  if is_complete; then break; fi
done

同样的提示词被反复发送给 Codex。Codex 通过以下方式"看到"自己的先前工作：

• 文件系统中的修改文件
• git 历史记录
• 之前生成的代码

⚠️ 注意：Codex CLI 本身不会“自动重复同一条 prompt”。Loopback 通过状态文件 .codex/loopback.local.md 持久化上下文，再由 driver 脚本反复调用 codex exec 来实现循环。

每次迭代：

1. Codex 接收相同的提示词
2. 在任务上工作，修改文件
3. 尝试完成
4. 检查完成条件
5. 如果未完成，进入下一次迭代
6. 看到之前的工作，逐步改进
7. 直到完成或达到最大迭代次数

命令

/loopback [OPTIONS]

在当前 Codex 会话中启动 Loopback 循环。

用法：

/loopback "重构缓存层" --max-iterations 20
/loopback "添加测试" --completion-promise "TESTS COMPLETE"
/loopback "修复认证 bug" --dry-run

选项：

• --max-iterations <n> - 最大迭代次数（默认：无限）
• --completion-promise <text> - 完成承诺短语（当该短语出现时停止）
• --guide - 输出轻量参数说明（不启动循环）
• --wizard - 强制启用向导流程（默认已启用；有些环境会自动降级为非交互预检）
• --no-wizard - 跳过默认向导（直接按原始参数运行）
• --allow-infinite - 允许缺少停止契约（危险：可能无限运行；不推荐）
• --dry-run - 仅显示计划，不执行
• --no-run - 仅创建状态文件，不启动 driver（用于手动运行 wrapper/调试）
• --reuse-session - 复用同一个 Codex session（默认，更像 Ralph Loop 的“同一对话”迭代）
• --fresh-session - 每轮启动新 Codex session（更隔离，但更不“自引用对话”）

/cancel-loop

取消活动的 Loopback 循环。

用法：

/cancel-loop

注意：不要把取消命令当成 prompt 传给 /loopback（例如 /loopback /cancel-loop）。取消应使用 /cancel-loop，或手动删除 .codex/loopback.local.md。