codex-review
OpenAI Codex CLIを使用してコードレビューを実行する。Claude CodeからCodexにレビューを依頼したい時に使用。トリガー:「Codexにレビュー」「codexでコードレビュー」「差分をCodexでチェック」「Codexにコードを見てもらう」「レビューをCodexに依頼」
When & Why to Use This Skill
The Codex Review skill seamlessly integrates the OpenAI Codex CLI into the Claude Code environment, enabling automated and intelligent code analysis. It allows developers to delegate rigorous code reviews—ranging from staged changes to full branch comparisons—to OpenAI's specialized models, ensuring high code quality, security compliance, and performance optimization before deployment.
Use Cases
- Pre-commit Validation: Automatically review staged changes to identify potential bugs, logic errors, or style violations before committing code to the repository.
- Targeted Security Audits: Use custom instructions to perform deep-dive security reviews on sensitive files, such as authentication modules or API endpoints, to catch vulnerabilities early.
- Pull Request Preparation: Compare a feature branch against the main branch to generate a comprehensive review report, helping developers address issues before the formal peer review process.
- Performance and Refactoring: Analyze specific files or legacy codebases with a focus on performance bottlenecks and modern coding standards to improve system efficiency.
- Automated Documentation of Reviews: Generate and store structured review reports in the .codex-reviews/ directory for audit trails and team knowledge sharing.
| name | codex-review |
|---|---|
| description | OpenAI Codex CLIを使用してコードレビューを実行する。Claude CodeからCodexにレビューを依頼したい時に使用。トリガー:「Codexにレビュー」「codexでコードレビュー」「差分をCodexでチェック」「Codexにコードを見てもらう」「レビューをCodexに依頼」 |
Codex Review
Claude CodeからOpenAI Codex CLIにコードレビューを委譲するスキル。
前提条件
- Codex CLIインストール済み:
npm install -g @openai/codex - 認証済み: 初回
codex実行時に認証
レビューモード選択
| 状況 | モード | コマンド |
|---|---|---|
| コミット前チェック | staged |
scripts/review.sh staged |
| 作業中の全変更確認 | uncommitted |
scripts/review.sh uncommitted |
| 特定ファイル精査 | file |
scripts/review.sh file <path> |
| 複数ファイル一括 | files |
scripts/review.sh files <path1> <path2> |
| PR作成前 | branch |
scripts/review.sh branch <base> <target> |
| コミット検証 | commit |
scripts/review.sh commit <hash> |
| PRレビュー | pr |
scripts/review.sh pr <base_branch> |
基本ワークフロー
- レビュー対象を決定(差分/ファイル/ブランチ)
- 適切なモードで
scripts/review.shを実行 - Codexのフィードバックを確認
- 指摘事項を修正
使用例
# ステージング済み差分をレビュー
scripts/review.sh staged
# セキュリティ観点でレビュー
scripts/review.sh staged "Focus on security vulnerabilities"
# 特定ファイルをレビュー
scripts/review.sh file src/api/auth.ts
# feature/authブランチをmainと比較してレビュー
scripts/review.sh branch main feature/auth
# PRレビュー(origin/mainとの差分)
scripts/review.sh pr origin/main "Check for breaking API changes"
直接コマンド実行
スクリプトを使わず直接実行する場合:
# 差分をプロンプトに含めて渡す
codex exec "Review this code diff. Report issues with severity, file, line range.
$(git diff --staged)"
# ファイル内容を含めて渡す
codex exec "Review this TypeScript file for issues.
$(cat src/main.ts)"
カスタム指示
全モードで最後の引数にカスタム指示を追加可能:
"Focus on security"- セキュリティ脆弱性"Check TypeScript types"- 型安全性"Review for performance"- パフォーマンス"Check accessibility"- アクセシビリティ"Verify error handling"- エラーハンドリング
出力ファイル
レビュー結果は自動的に .codex-reviews/ に保存される。
ファイル名形式: {mode}_{context}_{timestamp}.md
.codex-reviews/
├── staged_20231230_143052.md
├── branch_main-feature-auth_20231230_150123.md
├── file_src-api-auth-ts_20231230_151234.md
└── commit_abc1234_20231230_152345.md
出力内容:
- 日時、モード、コンテキスト
- カスタム指示(指定時)
- Codexのレビュー結果
推奨: .gitignore に .codex-reviews/ を追加