mcpField
O
oracle-codex

oracle-codex

github.com/paulrbergAgent 工作流102190 次安装今天更新
代码仓库

关于 oracle-codex

此技能将 OpenAI Codex CLI 用作只读分析工具，适用于规划、代码审查和分析。它要求先运行环境检查，并通过封装脚本调用 Codex，禁止实施代码更改。

主要功能

  1. 01只读 Codex 分析
  2. 02可配置推理强度
  3. 03调用前检查环境
  4. 04通过封装脚本调用

适用场景

  1. 01审查代码变更
  2. 02规划实现方案
  3. 03不修改代码地分析代码库

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/paulrberg/agent-skills --skill oracle-codex

安装后在 Claude Code 中输入/oracle-codex确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
codex-flags.md
scripts/
check-codex.sh
run-codex-exec.sh

详细介绍

Codex Oracle

将 OpenAI Codex CLI 用作只读预言机——仅用于规划、审查和分析。Codex 提供其视角；你负责综合结果并呈现给用户。

沙盒始终为 read-only。Codex 绝不能实施更改。

参数

解析 $ARGUMENTS：

  • query — 主要问题或任务（所有非标志内容）。必填——如果为空，告知用户提供查询，然后停止。
  • --reasoning <level> — 覆盖推理力度（low、medium、high、xhigh）。可选；默认值为 xhigh。

前提条件

在调用 Codex 之前运行检查脚本：

scripts/check-codex.sh

如果退出状态非零，显示错误并停止。所有 codex exec 调用都使用包装器：

scripts/run-codex-exec.sh

配置

设置默认值覆盖方式
模型gpt-5.5仅允许名单中的模型（参见 references/codex-flags.md）
推理xhigh--reasoning <level> 或用户描述
沙盒read-only不可覆盖
推理力度
复杂度力度超时标准
简单low300000ms<3 个文件，快速提问
中等medium300000ms3–10 个文件，聚焦分析
复杂high600000ms多模块、架构思考
最高xhigh600000ms完整代码库、关键决策

对于可能超过 10 分钟的 xhigh 任务，在 Bash 工具中使用 run_in_background: true，并设置 CODEX_OUTPUT，以便稍后读取输出。

完整的标志文档请参见 references/codex-flags.md。

工作流

1. 解析并验证
  1. 解析 $ARGUMENTS，提取查询和 --reasoning
  2. 运行 scripts/check-codex.sh——失败时中止
  3. 除非 --reasoning 指定其他值，否则使用 xhigh 推理力度
2. 构建提示词

根据用户查询及任何相关上下文（差异、文件内容、先前对话）构建聚焦的提示词。保持直接——说明希望 Codex 分析什么，以及需要哪种输出。不要实施更改；只要求分析和建议。

3. 执行

通过包装器使用 HEREDOC 调用。根据上方的推理力度表设置 Bash 工具超时。

EFFORT="<effort>" \
CODEX_OUTPUT="/tmp/codex-${RANDOM}${RANDOM}.txt" \
scripts/run-codex-exec.sh <<'EOF'
[constructed prompt]
EOF

对于 xhigh，可以考虑在 Bash 工具调用中使用 run_in_background: true，然后在完成后读取 CODEX_OUTPUT。

4. 呈现结果

读取输出文件并注明来源：

## Codex Analysis

[Codex output — summarize if >200 lines]

---
Model: gpt-5.5 | Reasoning: [effort level]

综合关键见解和可执行事项，提供给用户。

评论

支持 Markdown