القائمة
Loopback 迭代开发循环 - 基于 Ralph Loop 思想实现的 Codex 版本。用于创建自引用的迭代开发循环，让 AI 在多次迭代中逐步改进代码，直到任务完成。Use when: (1) 需要多次迭代改进的任务, (2) 复杂功能需要分步实现, (3) 需要自我修正的代码生成, (4) 迭代优化已有代码.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
指导编码智能体以 capability-runtime 为业务落地入口，交付基于 capability-runtime 的 skills / agents / workflows，并在 Greenfield 或 Legacy Convergence 场景下优先使用 Runtime public surface、structured output、NodeReport、host summary 与 service/session surfaces。只要任务目标是用 capability-runtime / capability_runtime 落地业务代码、收敛下游 runtime boundary，或涉及 Runtime.run / Runtime.run_stream / run_structured / run_structured_stream / AgentSpec / PromptRenderMode / prompt_render_mode / _runtime_prompt / precomposed_messages / multimodal / vision / image input / 多图输入 / 视频抽帧输入 / OpenAI-compatible messages / image_url content parts / WorkflowSpec / NodeReport / RuntimeServiceFacade / describe_capability / summarize_host_run，就应优先使用本技能。不要用于普通通用编码、prompt-only 任务、直接学习上游原生框架 API，或任何明确要求“直接用 skills-runtime-sdk / Agently / provider SDK，不走 capability-runtime”的任务；若已触发但随后识别出这是反目标，必须立即退出，并停止提供任何上游实现细节、伪代码或 API 猜测。
Turn vague ideas into a validated design/spec through structured brainstorming. Use before any creative work - new features, UI/components, behavior changes, refactors, architecture decisions. Trigger whenever a user asks to brainstorm, define requirements, propose approaches, write a design doc, or says something like 'I want to build X' or 'how should we approach Y'. Even seemingly simple tasks benefit from a quick design pass.
用 Skills Runtime SDK（Python）开发复杂业务 agent、skills、workflow 的编码智能体指南。用户一旦提到 skills_runtime、Skills Runtime SDK、overlay YAML、FakeChatBackend、AgentBuilder、Coordinator、skill_ref_read、skill_exec、approvals/sandbox、WAL/replay、exec sessions、spawn_agent/send_input/wait、waiting_human/resume、examples/apps/workflows，或要在本仓上落地复杂业务开发/修复/回归，就应优先使用本技能。不要用于与本框架无关的通用编码或纯文案任务。
Trace and document the complete call chain / data flow of any feature or process in a codebase. Use this skill whenever the user asks to understand how a feature works end-to-end, trace a call chain, analyze code flow, map data flow across layers, reverse-engineer a process, or asks questions like "how does X call Y", "what happens when the user clicks Z", "trace the request from frontend to database". Also use it when the user wants the analysis exported to a file for offline reading.
Use only when the user explicitly wants to build with the Agently framework (mentions Agently/agently/OpenAICompatible/TriggerFlow/ToolExtension/ChromaCollection, or says “用 Agently 做/用 agently 做”). Deliver runnable code plus regression tests validating schema/ensure_keys and streaming (delta/instant/streaming_parse), with optional tools (Search/Browse/MCP), TriggerFlow orchestration, KB (ChromaDB), and serviceization (SSE/WS/HTTP). Do not use for generic streaming/testing questions that are not about Agently, or for prompt-only writing without tests/structure.
用 tmux 稳定驱动交互式 CLI：启动 session、发送按键、等待输出就绪，并支持 worker 向 controller pane 回传结果（backchannel）。
| name | loopback |
| version | 0.1.1 |
| description | Loopback 迭代开发循环 - 基于 Ralph Loop 思想实现的 Codex 版本。用于创建自引用的迭代开发循环，让 AI 在多次迭代中逐步改进代码，直到任务完成。Use when: (1) 需要多次迭代改进的任务, (2) 复杂功能需要分步实现, (3) 需要自我修正的代码生成, (4) 迭代优化已有代码. |
/loopback "修复 X。完成后输出 <promise>DONE</promise>。" --completion-promise "DONE" --max-iterations 10
说明：
/loopback 会默认进入向导：先展示全局步骤，再一步步帮你完善参数与契约/loopback 会输出步骤概览，并在缺少关键契约时直接失败（避免跑飞）--no-wizard/loopback --guide
--dry-run 预演（不会创建状态文件、不会启动循环）/loopback "修复 X。完成后输出 <promise>DONE</promise>。" --completion-promise "DONE" --max-iterations 10 --dry-run
/loopback "修复 X。完成后输出 <promise>DONE</promise>。" --completion-promise "DONE" --max-iterations 10
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 通过以下方式"看到"自己的先前工作：
⚠️ 注意：Codex CLI 本身不会“自动重复同一条 prompt”。Loopback 通过状态文件
.codex/loopback.local.md 持久化上下文，再由 driver 脚本反复调用 codex exec 来实现循环。
每次迭代：
在当前 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（更隔离，但更不“自引用对话”）取消活动的 Loopback 循环。
用法：
/cancel-loop
注意：不要把取消命令当成 prompt 传给 /loopback（例如 /loopback /cancel-loop）。取消应使用 /cancel-loop，或手动删除 .codex/loopback.local.md。
为了标记任务完成，Codex 必须输出一个 <promise> 标签：
<promise>TASK COMPLETE</promise>
Loopback 会查找这个特定的标签。如果没有它（或 --max-iterations），Loopback 会无限运行。
强烈建议在 PROMPT 里把“完成标准”写得像可验证的契约，而不是一句“做完就说 DONE”。例如：
目标：修复认证 bug。
验收：
- `pytest -q` 全绿
- 复现步骤 A 不再报错
完成后输出：<promise>DONE</promise>
若未完成：说明阻塞点 + 下一步要做什么 + 哪些验证已完成/未完成（不要输出 promise）
为了避免无限跑飞（尤其在非交互环境），Loopback 默认会要求你至少提供一个停止条件（满足其一即可）：
--completion-promise 'DONE'--max-iterations 10如果你确实要允许无限循环（不推荐），需要显式声明：
--allow-infinite实现细节：driver 会将每一轮输出写入 .codex/loopback.outputs/iteration-N.log，并在该输出中检测
是否出现 <promise>COMPLETION_PROMISE</promise>。
更稳健的实现：在 --reuse-session 模式下，driver 会使用 codex exec --json/codex exec resume --json，
从 JSON 事件 thread.started.thread_id 获取 session_id，避免依赖本地 session 文件名/日期推断。
另外：driver 会在“当前目录不是 git repo”时自动为 codex exec 添加 --skip-git-repo-check，这样你可以在
类似 ~/Documents/GitHub 这种“仓库集合目录”里直接跑用例（仍然建议在目标仓库根目录运行以提升速度/减少上下文噪音）。
"循环"不意味着 Codex 与自己对话。它的意思是：
/loopback "修复 auth.ts 中的令牌刷新逻辑。当所有测试通过时输出 <promise>FIXED</promise>。" --completion-promise "FIXED" --max-iterations 10
你会看到 Loopback：
适用于：
不适用于：
| 特性 | Ralph Loop (Claude Code) | Loopback (Codex) |
|---|---|---|
| 环境 | Claude Code CLI | Codex CLI |
| 迭代机制 | stop hook | 文件状态检查 |
| 状态存储 | .claude/ralph-loop.local.md | .codex/loopback.local.md |
| 命令 | /ralph-loop, /cancel-ralph | /loopback, /cancel-loop |
| 工作原理 | 拦截退出信号 | 检查完成条件 |
当运行 /loopback 命令时：
.codex/loopback.local.md 状态文件driver 每次迭代会：
.codex/loopback.local.mdcodex exec（同一条 PROMPT）.codex/loopback.outputs/iteration-N.log--max-iterations<promise>COMPLETION_PROMISE</promise>/cancel-loop 删除（视为取消）iteration 并进入下一轮当运行 /cancel-loop 时：
.codex/loopback.local.md 是否存在