name: codex-review description: “向 Codex 寻求第二意见。AI 之间无妥协的严格评审。当用户提到 ‘Codex レビュー’、‘セカンドオピニオン’、‘Codex の意見’、‘Codex でレビュー’ 或 ‘Codex セットアップ’ 时使用。不要加载用于: ‘Codex に実装させて’、‘Codex Worker’、‘Codex に作らせて’、‘実装を依頼’。” description-en: “向 Codex 寻求第二意见。AI 之间无妥协的严格评审。当用户提到 ‘Codex レビュー’、‘セカンドオピニオン’、‘Codex の意見’、‘Codex でレビュー’ 或 ‘Codex セットアップ’ 时使用。不要加载用于: ‘Codex に実装させて’、‘Codex Worker’、‘Codex に作らせて’、‘実装を依頼’。” description-ja: “向 Codex 寻求第二意见。AI 之间无妥协的严格评审。当用户提到 ‘Codex レビュー’、‘セカンドオピニオン’、‘Codex の意見’、‘Codex でレビュー’ 或 ‘Codex セットアップ’ 时使用。不要加载用于: ‘Codex に実装させて’、‘Codex Worker’、‘Codex に作らせて’、‘実装を依頼’。” allowed-tools: [“Bash”, “Read”, “Write”, “Edit”] argument-hint: “[code|plan|scope]” hooks:

event: PreToolCall type: command command: “${CLAUDE_PLUGIN_ROOT}/scripts/check-codex.sh” once: 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: "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