Menu
双 Agent 全面审查修复框架。Antigravity + Codex MCP 独立审查 → 交叉验证 → 协作修复。内置 Codex session 监控、权限管控、双向状态追踪、清理策略。触发词："Ralph Loop"、"raphaloop"、"全面审查"、"零容错审查"、"/ralph-loop"。适用场景：代码审查、数据质量检查、发布前终验、跨 Agent 协作修复。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
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.
| 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 时创建 |
| 内容 | 任务清单、实施计划、最终汇报 |
| 用途 | 记录整个审查过程的规划和结果 |
| 删除后果 | 丢失审查过程的完整记录 |
| 默认建议 | 🟡 建议保留 |
以下参考资料按需加载，无需全部阅读：