名称: codex-review 描述: “向 Codex 寻求二次意见。AI 对 AI 的无偏见真实审查。当用户提及 ‘Codex レビュー’, ‘二次意见’, ‘Codex 的意见’, ‘用 Codex 审查’, 或 ‘Codex 设置’ 时使用。不要为以下情况加载: ‘让 Codex 实现’, ‘Codex Worker’, ‘让 Codex 制作’, ‘实现请求’.” 英文描述: “Ask Codex for second opinion. No-compromise AI peer review. Use when user mentions ‘Codex レビュー’, ‘セカンドオピニオン’, ‘Codex の意見’, ‘Codex でレビュー’, or ‘Codex セットアップ’. Do NOT load for: ‘Codex に実装させて’, ‘Codex Worker’, ‘Codex に作らせて’, ‘実装を依頼’.” 日文描述: “Codexにセカンドオピニオンを求める。AI同士の忖度なしガチレビュー。Use when user mentions ‘Codex レビュー’, ‘セカンドオピニオン’, ‘Codex の意見’, ‘Codex でレビュー’, or ‘Codex セットアップ’. Do NOT load for: ‘Codex に実装させて’, ‘Codex Worker’, ‘Codex に作らせて’, ‘実装を依頼’.” 允许工具: [“Bash”, “Read”, “Write”, “Edit”] 参数提示: “[code|plan|scope]” 钩子:

事件: PreToolCall 类型: command 命令: “${CLAUDE_PLUGIN_ROOT}/scripts/check-codex.sh” 一次: true

Codex 审查集成技能

使用 OpenAI Codex CLI 在 Claude Code 的代码审查时提供二次意见的技能。

不要加载的情况 (防止误动作)

以下关键词由 /work --codex 负责:

触发关键词	正确的技能	理由
“让 Codex 实现”	`/work --codex`	实现 ≠ 审查
“Codex Worker”	`/work --codex`	Worker = 实现角色
“让 Codex 制作”	`/work --codex`	制作 = 实现
“实现请求”	`/work --codex`	实现目的

🎯 使用场景

设置

首次设置: Codex CLI 的安装确认和 MCP 注册
认证设置: 向 Codex 的 OAuth / API 密钥认证

审查

二次意见: 在 Claude 的审查结果中添加 Codex 的视角
代码质量检查: 利用多个 AI 模型的擅长领域
设计审查: 多角度验证架构和实现模式

功能详细

功能	详细
MCP 设置	参见 references/codex-mcp-setup.md
审查集成	参见 references/codex-review-integration.md
4 并行审查	参见 references/codex-parallel-review.md
模式切换	参见 references/codex-mode.md

执行步骤

分类用户的请求
从上述“功能详细”中读取适当的参考文件
根据其内容执行设置或审查

⚠️ 并行审查时的必须规则

Codex 模式（review.mode: codex）下的审查执行时:

判定要调用的专家（只调用必要的，不是全部）:
- 设置中 enabled: false → 排除
- CLI/后端 → 排除 Accessibility, SEO
- 只更改文档 → 优先 Quality, Architect, Plan Reviewer, Scope Analyst（可以排除 Security, Performance）
从有效的专家的 references/experts/*.md 单独读取提示
只对有效的专家 在 Bash 后台进程中并行执行
绝对不要在一次调用中汇总多个观点

✅ 正确的（并行 CLI 执行）:
   # macOS: brew install coreutils
   TIMEOUT=$(command -v timeout || command -v gtimeout || echo "")
   $TIMEOUT 120 codex exec "$(cat /tmp/expert-security-prompt.md)" > /tmp/expert-security.txt 2>/dev/null &
   $TIMEOUT 120 codex exec "$(cat /tmp/expert-perf-prompt.md)" > /tmp/expert-perf.txt 2>/dev/null &
   $TIMEOUT 120 codex exec "$(cat /tmp/expert-quality-prompt.md)" > /tmp/expert-quality.txt 2>/dev/null &
   $TIMEOUT 120 codex exec "$(cat /tmp/expert-a11y-prompt.md)" > /tmp/expert-a11y.txt 2>/dev/null &
   wait

❌ 错误的:
   codex exec "审查安全和性能和品质"

详细: references/codex-parallel-review.md

📋 Codex CLI 执行方法

如果 Codex CLI 已安装，按以下方式调用：

方法	命令
单次审查	`$TIMEOUT 120 codex exec "$(cat prompt.md)" 2>/dev/null`
并行审查	各专家用 `&` 并行执行并用 `wait` 等待

🔧 快速开始

前提条件

Codex CLI 已安装
```
which codex  # 应显示路径
```

超时命令（macOS 的情况）

brew install coreutils  # 提供 gtimeout

已登录 Codex
```
codex login status  # 应已认证
```

动作确认

# Codex CLI 的响应测试
codex exec "echo hello"

🔄 审查工作流

Solo 模式

/harness-review 执行
    │
    ├── Claude 审查（传统方式）
    │
    └── Codex CLI 调用（有效时）
            │
            └── 结果统合

2-Agent 模式

PM（Cursor / Codex）
    │
    └── 任务委托
            │
            ├── Claude Code 实现
            │
            └── /harness-review
                    │
                    ├── Claude 审查
                    └── Codex 二次意见

⚙️ 设置

在 .claude-code-harness.config.yaml 中设置 Codex 集成：

review:
  codex:
    enabled: true           # 启用 Codex 二次意见
    auto: false             # true: 自动执行 / false: 每次确认
    prompt: "审查代码并输出问题和改进建议"
    # execution_mode: mcp   # 传统: MCP（无进度显示）

设置项目	默认值	说明
`enabled`	`false`	Codex 集成的启用/禁用
`auto`	`false`	自动审查执行
`prompt`	(上述)	向 Codex 的审查提示
`execution_mode`	`exec`	执行模式（`exec`: CLI直接，推荐）

注意: 所有 Codex 调用使用 exec (CLI)。并行专家在 Bash 后台进程 (& + wait) 中并行执行

💡 活用例

例1: 设置

用户: 「请设置以便也能用 Codex 审查」

Claude Code:
→ 读取 codex-mcp-setup.md
→ 确认 Codex 安装
→ 执行 MCP 注册
→ 更新设置文件

例2: 审查时

用户: 「请获取二次意见」

Claude Code:
→ 确认 codex.enabled = true
→ 通过 CLI 向 Codex 请求审查
→ 统合结果显示

⚠️ 注意事项

性能

Codex CLI 调用可能需要数秒到数十秒
对于大规模文件，推荐分块处理

成本

使用 Codex API 需要 OpenAI 的积分
推荐根据审查频率估算成本

故障排除

问题: Codex CLI 无响应 解决策:

用 which codex 确认安装
用 codex login status 确认认证
用 $TIMEOUT 10 codex exec "echo test" 测试超时

问题: 审查结果不返回 解决策:

确认网络连接
确认 API 积分余额
延长超时值重试

Codex代码审查集成技能Skill codex-review