Menü
双 Agent 全面审查修复框架。Antigravity + Codex MCP 独立审查 → 交叉验证 → 协作修复。内置 Codex session 监控、权限管控、双向状态追踪、清理策略。触发词："Ralph Loop"、"raphaloop"、"全面审查"、"零容错审查"、"/ralph-loop"。适用场景：代码审查、数据质量检查、发布前终验、跨 Agent 协作修复。
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
| name | ralph-loop |
| description | 双 Agent 全面审查修复框架。Antigravity + Codex MCP 独立审查 → 交叉验证 → 协作修复。内置 Codex session 监控、权限管控、双向状态追踪、清理策略。触发词："Ralph Loop"、"raphaloop"、"全面审查"、"零容错审查"、"/ralph-loop"。适用场景：代码审查、数据质量检查、发布前终验、跨 Agent 协作修复。 |
三阶段、双 Agent 协作的代码/数据全面审查修复流程。核心思路来自 claude-review-loop，为 Antigravity + Codex MCP 环境深度定制。
1. 用户触发 → Antigravity 创建 task.md + implementation_plan.md
2. 确认权限配置（sandbox / MCP / 联网 / Skills）
3. Phase A: Antigravity 独立审查（只读）
4. Phase B: Codex 独立审查（只读，codex-monitor 监控）
5. Phase C: 合并 → 辩论 → 按优先级修复 → 交叉验证
6. 汇报：向用户提交完整报告 + 清理建议
7. 用户决策 → 执行清理 → 推送 → 更新 walkthrough.md
[!CAUTION] 每个 Phase 启动前必须确认权限配置。不得擅自提升权限等级。
| 配置项 | Phase A（Antigravity） | Phase B（Codex） | Phase C（协作修复） |
|---|---|---|---|
| sandbox | N/A（Antigravity 自身） | read-only | workspace-write（仅修复阶段） |
| approval-policy | N/A | never | never |
| 文件写入 | ❌ 只读 | ❌ 只读 | ✅ 仅修复文件 |
| 联网搜索 | 按需（查文档/API） | 按需（查文档/API） | 按需 |
| MCP 白名单 | sequential-thinking、context7 | 不限（Codex 内部管理） | sequential-thinking、context7、codex |
| Skills 访问 | 仅 ralph-loop 自身 | 无（独立审查） | ralph-loop + codex-monitor |
| commit/push | ❌ 禁止 | ❌ 禁止 | ✅ 需逐次确认 |
Codex 子 Agent 权限：继承父 session 的 sandbox 级别。Phase B 子 Agent 也必须是 read-only。
/tmp/ralph_loop_antigravity_issues.json通过 Codex MCP 启动独立审查 session，只读不改：
mcp_codex_codex({
model: "gpt-5.3-codex",
config: { "model_reasoning_effort": "xhigh" },
sandbox: "read-only",
approval-policy: "never",
cwd: "<项目路径>",
prompt: "<审查任务描述，包含 M1-M7 模块要求，明确禁止修改任何文件>"
})
输出问题清单到 /tmp/ralph_loop_codex_issues.json。
启动后立即进入双向监控（见下方「双向监控机制」）。
[!IMPORTANT] 每个审查步骤必须严格遵循以下五步，不得省略任何一步。
[!NOTE] 架构限制：Codex 作为 MCP server 被 Antigravity 调用，是单向关系。Codex 无法主动回调或监控 Antigravity 的状态。因此监控职责由 Antigravity 全权承担，Codex 仅在被调用时执行被动验证。
Antigravity 是整个 Ralph Loop 的调度中心，负责：
Phase B 监控 Codex：运行 codex-monitor 脚本
python3 <codex-monitor-skill-dir>/scripts/codex-monitor.py --watch
<codex-monitor-skill-dir>的定位方法：查找.agent/skills/codex-monitor/目录
状态速查：
| 图标 | 含义 | Antigravity 操作 |
|---|---|---|
| ✅ | 完成 | 读取输出 → 继续 Phase C |
| 🔄 | 运行中 | 等待，每 2-5 分钟检查一次 |
| ⏱️ | 超时（>10min） | 记录失败原因 → 修正 prompt → 手动重新启动 Codex session |
| ⚠️ | 可能停滞 | 再等 2 分钟，仍无进展则按超时处理 |
| ❌ | 出错 | 读取错误信息 → 修正 prompt → 手动重试 |
| 📭 | 空/未启动 | 检查 MCP 连接 → 重新调用 |
追踪内容：
/tmp/ralph_loop_codex_issues.json）异常恢复（全部由 Antigravity 手动执行）：
mcp_codex_codex()Codex 无法主动监控 Antigravity，但在 Phase C 被调用进行验证时，Antigravity 会通过 prompt 指示 Codex 检查：
git diff 是否只含预期变更/tmp/ralph_loop_codex_verify.json，由 Antigravity 读取并处理Codex 不具备主动轮询或回调 Antigravity 的能力。所有信息流方向为：Antigravity → 调用 Codex → 读取 Codex 输出。
codex-monitor.py --last 3~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl
每次启动 Codex session 后记录：
| 追踪项 | 说明 |
|---|---|
| Session ID | 前 8 位即可标识 |
| 启动时间 | 从 codex-monitor 输出获取 |
| 子 Agent 数量 | 检查 parent-child 关系树 |
| 完成状态 | ✅/🔄/❌/⏱️ |
| 输出物位置 | /tmp/ralph_loop_codex_issues.json 或其他指定路径 |
| Token 使用量 | 从 codex-monitor 输出获取 |
| Rate Limit | 百分比 |
# 定位脚本（首次使用时确认路径）
ls -la <codex-monitor-skill-dir>/scripts/codex-monitor.py
# 查看今天所有 session
python3 <codex-monitor-skill-dir>/scripts/codex-monitor.py today
# 实时监控（每 10s 刷新）
python3 <codex-monitor-skill-dir>/scripts/codex-monitor.py --watch
# 只看最近 N 个 session
python3 <codex-monitor-skill-dir>/scripts/codex-monitor.py --last 3
<codex-monitor-skill-dir>查找方法：find ~/.agent -path "*/codex-monitor/scripts/codex-monitor.py" -o -path "*/.agent/skills/codex-monitor/scripts/codex-monitor.py" 2>/dev/null | head -1
git pull --rebasegit pull[!IMPORTANT] 任务完成后必须向用户提交完整汇报，等待用户确认后才执行后续操作。
修复总结
变更文件清单
git diff --stat 输出中间产物清单（见「清理策略」）
Session 追踪报告
建议后续动作
[!CAUTION] 硬性规则（不可违反）：
- 禁止自动删除 — 在用户明确逐项批准之前，不得删除任何文件、session、对话或临时数据
- 禁止静默清理 — 不得在汇报中省略任何中间产物，不得以"已自动清理"的方式跳过用户决策
- 禁止批量删除 — 即使用户说"全部删除"，也必须先列出完整清单让用户确认
违反以上任何一条都是不可接受的严重错误。宁可多问一次，不可擅自删除。
Step 1: 扫描 → 生成中间产物清单（不删除任何东西）
Step 2: 分类标注 → 给每个产物标注建议（🟢/🟡/🔴）
Step 3: 提交给用户 → 使用 notify_user 展示完整清单
Step 4: 等待用户逐项批准 → 用户未回复则不操作
Step 5: 仅删除用户明确批准的项目 → 每删一个确认一个
| 标签 | 含义 | 说明 |
|---|---|---|
| 🟢 可安全删除 | Ralph Loop 过程中产生的临时中间文件，删除不影响任何功能 | 例：/tmp 下的问题清单 JSON |
| 🟡 建议保留 | 有追溯/参考价值，删除后无法恢复 | 例：Codex session 日志、审查记录 |
| 🔴 需用户确认 | 无法判断是否有价值，必须由用户决定 | 例：来源不明的相关文件 |
以下是 Ralph Loop 执行过程中会产生的所有中间产物：
| 属性 | 说明 |
|---|---|
| 文件 | /tmp/ralph_loop_antigravity_issues.json |
| 来源 | Phase A 中 Antigravity 独立审查后输出 |
| 内容 | JSON 数组，每项包含 module、severity、file、line、description、suggestion |
| 用途 | Phase C 中与 Codex 问题清单合并、辩论、修复 |
| 删除后果 | 无法追溯 Phase A 的审查细节；如果 Phase C 已完成则无影响 |
| 默认建议 | 🟢 Phase C 完成后可安全删除 |
| 属性 | 说明 |
|---|---|
| 文件 | /tmp/ralph_loop_codex_issues.json |
| 来源 | Phase B 中 Codex 通过 MCP 独立审查后输出 |
| 内容 | 同上格式，由 Codex 生成 |
| 用途 | Phase C 中与 Antigravity 清单合并 |
| 删除后果 | 同上 |
| 默认建议 | 🟢 Phase C 完成后可安全删除 |
| 属性 | 说明 |
|---|---|
| 文件 | /tmp/ralph_loop_codex_verify.json |
| 来源 | Phase C 中 Codex 被调用执行验证时输出 |
| 内容 | 修复验证结果：通过/失败 + 具体问题 |
| 用途 | 确认修复是否正确 |
| 删除后果 | 无法追溯验证细节 |
| 默认建议 | 🟢 Phase C 完成后可安全删除 |
| 属性 | 说明 |
|---|---|
| 文件 | ~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl |
| 来源 | 每次调用 Codex MCP 时自动生成 |
| 内容 | 完整的 Codex 对话记录：工具调用、Token 用量、Agent 消息、错误信息 |
| 用途 | 事后追溯 Codex 做了什么、为什么失败、消耗了多少资源 |
| 删除后果 | 不可恢复 — 丢失 Codex 的完整工作记录，无法事后排查问题 |
| 默认建议 | 🟡 建议保留至少 7 天 |
| 属性 | 说明 |
|---|---|
| 文件 | brain/<conversation-id>/task.md、implementation_plan.md、walkthrough.md |
| 来源 | Antigravity 在执行 Ralph Loop 时创建 |
| 内容 | 任务清单、实施计划、最终汇报 |
| 用途 | 记录整个审查过程的规划和结果 |
| 删除后果 | 丢失审查过程的完整记录 |
| 默认建议 | 🟡 建议保留 |
以下参考资料按需加载，无需全部阅读：
Monitor Codex CLI session status, detect timeouts, errors, and completion. Use when user asks about Codex session status, wants to check if Codex is still running, needs to debug a stalled session, or mentions "codex monitor", "session status", "codex 状态", "session 断了吗".
Manage long-running, multi-hour AI agent tasks using durable project memory — a structured 4-file system (SPEC, PLAN, RULES, STATUS) that prevents drift, ensures verification, and keeps work coherent across extended sessions. Use when the user asks to build something complex from scratch, run a multi-milestone project, delegate large autonomous coding work, set up a long-running agent session, create a project with 5+ milestones, or mentions "long horizon", "长任务", "长时间运行", "多里程碑", "自主编码", "autonomous coding", "durable memory". Based on OpenAI's Codex 25-hour design-tool experiment documented at https://developers.openai.com/cookbook/examples/codex/long_horizon_tasks.