AgentSkillsCN

codex

使用OpenAI Codex CLI进行代码评审、分析、向代码库提问。适用场景:(1) PR自评、(2) 整体代码库分析、(3) 关于实现的提问、(4) Bug调查、(5) 重构建议。触发器:“codex”、“代码评审”、“评审”、“分析”、“/codex”

SKILL.md
--- frontmatter
name: codex
description: OpenAI Codex CLIを使用したコードレビュー、分析、コードベースへの質問を実行する。使用場面: (1) PRセルフレビュー、(2) コードベース全体の分析、(3) 実装に関する質問、(4) バグの調査、(5) リファクタリング提案。トリガー: "codex", "コードレビュー", "レビューして", "分析して", "/codex"

Codex

OpenAI Codex CLIを使用してコードレビュー・分析を実行するスキル。

実行コマンド

bash
codex exec --full-auto --sandbox read-only --cd <project_directory> "<request>"

パラメータ

パラメータ説明
--full-auto完全自動モードで実行
--sandbox read-only読み取り専用サンドボックス(安全な分析用)
--cd <dir>対象プロジェクトのディレクトリ
"<request>"依頼内容(日本語可)

使用例

PRセルフレビュー(主要ユースケース)

bash
codex exec --full-auto --sandbox read-only --cd /path/to/project "このPRの変更をレビューして、以下の観点で問題を指摘してください:
- 型安全性(any型、型アサーション)
- セキュリティ(OWASP Top 10)
- テストの有無
- コード規約違反
指摘は🔴必須/🟡推奨/💡提案に分類してください"

コード分析

bash
codex exec --full-auto --sandbox read-only --cd /path/to/project "このプロジェクトのコードをレビューして、改善点を指摘してください"

バグ調査

bash
codex exec --full-auto --sandbox read-only --cd /path/to/project "認証処理でエラーが発生する原因を調査してください"

リファクタリング提案

bash
codex exec --full-auto --sandbox read-only --cd /path/to/project "このコンポーネントのリファクタリング案を提案してください"

PRセルフレビューとしての使用

PR作成後のセルフレビューでは、以下の手順で実行する:

1. PR差分の確認

bash
gh pr diff

2. Codexでレビュー実行

bash
codex exec --full-auto --sandbox read-only --cd $(pwd) "このPRの変更をレビューして、CLAUDE.mdの品質基準に照らして問題を指摘してください。
指摘は以下に分類してください:
- 🔴必須: セキュリティ問題、any型使用、テスト欠如、ESLintエラー
- 🟡推奨: 型アサーションの改善、命名規則違反、パフォーマンス改善
- 💡提案: リファクタリング提案、より良いパターン"

3. 指摘への対応

分類対応
🔴必須必ず修正
🟡推奨可能な限り修正
💡提案任意で検討

🔴必須・🟡推奨の指摘がなくなるまで修正を繰り返す(最大3回)

実行手順

  1. ユーザーから依頼内容を受け取る
  2. 対象プロジェクトのディレクトリを特定する(デフォルト: 現在のworktree)
  3. 上記コマンド形式でCodexを実行
  4. 結果をユーザーに報告

注意事項

  • --sandbox read-only により、コードの変更は行われない(安全)
  • 結果は読み取り専用で分析結果のみ出力
  • 日本語でのリクエストに対応
  • 大規模なコードベースでも効率的に分析可能