codex-review

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Codex Review Integration Skill

Codex 评审集成技能

OpenAI Codex CLI を使って Claude Code のコードレビュー時にセカンドオピニオンを提供するスキル。

这是一项使用OpenAI Codex CLI在Claude Code进行代码评审时提供第二意见的技能。

Do NOT Load For (誤発動防止)

请勿加载场景（防止误触发）

以下のキーワードは

/work --codex

が担当します:

トリガーワード	正しいスキル	理由
"Codex に実装させて"	`/work --codex`	実装 ≠ レビュー
"Codex Worker"	`/work --codex`	Worker = 実装役
"Codex に作らせて"	`/work --codex`	作成 = 実装
"実装を依頼"	`/work --codex`	実装目的

以下关键词由

/work --codex

负责处理：

触发关键词	正确技能	理由
"让Codex实现"	`/work --codex`	实现 ≠ 评审
"Codex Worker"	`/work --codex`	Worker = 实现角色
"让Codex制作"	`/work --codex`	制作 = 实现
"委托实现"	`/work --codex`	实现目的

🎯 使用場面

🎯 使用场景

セットアップ

设置

初回設定: Codex CLI のインストール確認と
```
codex exec
```
動作確認
認証設定: Codex への OAuth / API キー認証

首次设置: 确认Codex CLI的安装及
```
codex exec
```
的运行情况
认证设置: Codex的OAuth / API密钥认证

レビュー

评审

セカンドオピニオン: Claude のレビュー結果に Codex の視点を追加
コード品質チェック: 複数 AI モデルの得意分野を活用
設計レビュー: アーキテクチャや実装パターンの多角的検証

第二意见: 在Claude的评审结果中加入Codex的视角
代码质量检查: 利用多个AI模型的专长领域
设计评审: 对架构及实现模式进行多角度验证

機能詳細

功能详情

機能	詳細
CLI セットアップ	See references/codex-mcp-setup.md
レビュー統合	See references/codex-review-integration.md
4並列レビュー	See references/codex-parallel-review.md
モード切替	See references/codex-mode.md

功能	详情
CLI 设置	参见 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 バックグラウンドプロセスで並列実行
絶対に1回の呼び出しで複数観点をまとめない

✅ 正しい（並列 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模式（
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 执行方法

Codex CLI がインストールされていれば、以下のように呼び出します：

方法	コマンド
単発レビュー	`$TIMEOUT 120 codex exec "$(cat prompt.md)" 2>/dev/null`
並列レビュー	各エキスパートを `&` で並列実行し `wait` で待機

若已安装Codex CLI，可按以下方式调用：

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

🔧 クイックスタート

🔧 快速开始

前提条件

Codex CLI がインストール済み

bash

which codex  # パスが表示されること

タイムアウトコマンド（macOS の場合）
bash
```
brew install coreutils  # gtimeout を提供
```

Codex にログイン済み

bash

codex login status  # 認証済みであること

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

超时命令（适用于macOS）

bash

brew install coreutils  # 提供gtimeout

已登录Codex

bash

codex login status  # 需处于已认证状态

動作確認

运行确认

bash

undefined

bash

undefined

Codex CLI の応答テスト

Codex CLI 响应测试

codex exec "echo hello"

---

codex exec "echo hello"

---

🔄 レビューワークフロー

🔄 评审工作流

Solo モード

单例模式

/harness-review 実行
    │
    ├── Claude レビュー（従来通り）
    │
    └── Codex CLI 呼び出し（有効時）
            │
            └── 結果統合

执行/harness-review
    │
    ├── Claude评审（常规流程）
    │
    └── 调用Codex CLI（启用时）
            │
            └── 结果整合

2-Agent モード

双Agent模式

PM（Cursor / Codex）
    │
    └── タスク依頼
            │
            ├── Claude Code 実装
            │
            └── /harness-review
                    │
                    ├── Claude レビュー
                    └── Codex セカンドオピニオン

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

⚙️ 設定

⚙️ 设置

.claude-code-harness.config.yaml

で Codex 統合を設定：

yaml

review:
  codex:
    enabled: true           # Codex セカンドオピニオン有効化
    auto: false             # true: 自動実行 / false: 毎回確認
    prompt: "Review the code and output issues and improvement suggestions"

設定項目	デフォルト	説明
`enabled`	`false`	Codex 統合の有効/無効
`auto`	`false`	自動レビュー実行
`prompt`	(上記)	Codex へのレビュープロンプト
`execution_mode`	`exec`	実行モード（ `exec` : CLI直接、推奨）

Note: 全ての Codex 呼び出しは
exec
(CLI) を使用。並列エキスパートは Bash バックグラウンドプロセス (
&
+
wait
) で並列実行

在

.claude-code-harness.config.yaml

中配置Codex集成：

yaml

review:
  codex:
    enabled: true           # 启用/禁用Codex集成
    auto: false             # true: 自动执行评审 / false: 每次需确认
    prompt: "Review the code and output issues and improvement suggestions"

配置项	默认值	说明
`enabled`	`false`	启用/禁用Codex集成
`auto`	`false`	自动执行评审
`prompt`	(如上所示)	发送给Codex的评审提示词
`execution_mode`	`exec`	执行模式（ `exec` : 直接通过CLI，推荐）

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

💡 活用例

💡 使用示例

例1: セットアップ

示例1：设置

ユーザー: 「Codex でもレビューできるようにして」

Claude Code:
→ codex-mcp-setup.md を読み込み
→ Codex インストール確認
→ `codex exec` 動作確認
→ 設定ファイル更新

用户：「让我也能用Codex进行评审」

Claude Code:
→ 读取codex-mcp-setup.md
→ 确认Codex安装情况
→ 确认`codex exec`运行情况
→ 更新配置文件

例2: レビュー時

示例2：评审时

ユーザー: 「セカンドオピニオンもらって」

Claude Code:
→ codex.enabled = true を確認
→ CLI 経由で Codex にレビュー依頼
→ 結果を統合して表示

用户：「帮我获取第二意见」

Claude Code:
→ 确认codex.enabled = true
→ 通过CLI向Codex发起评审请求
→ 整合结果并展示

⚠️ 注意事項

⚠️ 注意事项

パフォーマンス

性能

Codex CLI 呼び出しには数秒〜数十秒かかる場合があります
大規模ファイルの場合はチャンク分割が推奨

调用Codex CLI可能需要几秒到几十秒
对于大文件，建议进行分块处理

コスト

成本

Codex API 利用には OpenAI のクレジットが必要です
レビュー頻度に応じたコスト見積もりを推奨

使用Codex API需要OpenAI的信用额度
建议根据评审频率预估成本

トラブルシューティング

故障排除

問題: Codex CLI が応答しない 解決策:

```
which codex
```
でインストール確認
```
codex login status
```
で認証確認
```
$TIMEOUT 10 codex exec "echo test"
```
でタイムアウトテスト

問題: レビュー結果が返らない 解決策:

ネットワーク接続を確認
API クレジット残高を確認
タイムアウト値を延長して再試行

问题: Codex CLI无响应 解决方法:

用
```
which codex
```
确认是否已安装
用
```
codex login status
```
确认认证状态
用
```
$TIMEOUT 10 codex exec "echo test"
```
进行超时测试

问题: 无评审结果返回 解决方法:

检查网络连接
检查API信用额度余额
延长超时时间后重试

codex-review

Original

Translation

Codex Review Integration Skill

Codex 评审集成技能

Do NOT Load For (誤発動防止)

请勿加载场景（防止误触发）

🎯 使用場面

🎯 使用场景

セットアップ

设置

レビュー

评审

機能詳細

功能详情

実行手順

执行步骤

⚠️ 並列レビュー時の必須ルール

⚠️ 并行评审时的必守规则

📋 Codex CLI 実行方法

📋 Codex CLI 执行方法

🔧 クイックスタート

🔧 快速开始

前提条件

前提条件

動作確認

运行确认

Codex CLI の応答テスト

Codex CLI 响应测试

🔄 レビューワークフロー

🔄 评审工作流

Solo モード

单例模式

2-Agent モード

双Agent模式

⚙️ 設定

⚙️ 设置

💡 活用例

💡 使用示例

例1: セットアップ

示例1：设置

例2: レビュー時

示例2：评审时

⚠️ 注意事項

⚠️ 注意事项

パフォーマンス

性能

コスト

成本

トラブルシューティング

故障排除

📚 参考資料

📚 参考资料