名称: codex-review 描述: “向Codex寻求第二意见。AI之间无偏见的严格评审。在用户提到’Codex 评审’、‘第二意见’、‘Codex 的意见’、'使用Codex评审’或’Codex 设置’时使用。不要为以下加载：‘让Codex实现’、‘Codex Worker’、‘让Codex制作’、‘请求实现’。” 描述-en: “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制作’, ‘请求实现’.” 描述-ja: “Codexにセカンドオピニオンを求める。AI同士の忖度なしガチレビュー。Use when user mentions ‘Codex 评审’, ‘第二意见’, ‘Codex 的意见’, ‘使用Codex评审’, or ‘Codex 设置’. Do NOT load for: ‘让Codex实现’, ‘Codex Worker’, ‘让Codex制作’, ‘请求实现’.” 允许的工具: [“Bash”, “Read”, “Write”, “Edit”] 参数提示: “[代码|计划|范围]” 钩子:

事件: 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/后端 → 排除可访问性和SEO
- 仅文档更改 → 优先质量、架构师、计划评审员、范围分析师（安全和性能可排除）
从有效的专家的 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"

🔄 评审工作流程

单机模式

/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: "Review the code and output issues and improvement suggestions"
    # 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