Codex review
Personal Agent Skills for Claude Code
npx -y skills add rysk-tanaka/skills --skill codex-reviewAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Codex CLIでコードレビューを実行し指摘内容を取得・対応 (user)
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
5.4 KB, as published. Nobody here has run it
Codex CLI コードレビュー
Codex CLI の codex review を実行し、レビュー結果を取得・整理してユーザーに報告する。
入力
$ARGUMENTS にベースブランチとオプションフラグが渡される。
- ベースブランチは省略可(デフォルト: main)
--bgフラグ指定でバックグラウンド実行モードに切り替え
例
/codex-review→ フォアグラウンド、ベースブランチ main/codex-review develop→ フォアグラウンド、ベースブランチ develop/codex-review --bg→ バックグラウンド、ベースブランチ main/codex-review develop --bg→ バックグラウンド、ベースブランチ develop
モード判定
$ARGUMENTS に --bg が含まれるかどうかで実行モードを判定する。
--bg を除いた残りの引数をスクリプトに渡す。
--bgなし → フォアグラウンドモード(デフォルト)--bgあり → バックグラウンドモード
フォアグラウンドモード(デフォルト)
1. レビューの実行
bash ${CLAUDE_SKILL_DIR}/review.sh $SCRIPT_ARGS を実行する。
$SCRIPT_ARGSが空の場合は引数なしで実行(デフォルト: main)- Bash tool の timeout パラメータは 600000(最大値)を指定する
- スクリプトが非ゼロ終了した場合は、エラー内容をユーザーに報告する
- codex セクションが抽出できない場合、スクリプトは stderr 全体をフォールバック出力する
2. 共通分析ステップへ
review.sh の出力を「共通分析ステップ」に従って処理する。
バックグラウンドモード(--bg)
起動フェーズ
1. レビューの開始
bash ${CLAUDE_SKILL_DIR}/review.sh $SCRIPT_ARGS を Bash tool の run_in_background パラメータを true にして実行する。
$SCRIPT_ARGSが空の場合は引数なしで実行(デフォルト: main)
2. ユーザーへの報告
以下を報告してスキルの実行を終了する。
- バックグラウンドで Codex レビューを開始したこと
- 他のコマンドを実行可能であること
- 完了したら自動的に結果を処理すること(手動確認は
/check-bg)
結果処理フェーズ
以下のいずれかの条件で結果処理フェーズを開始する。
- ユーザーが結果確認を依頼した場合
- メッセージに該当バックグラウンドタスクの system-reminder が含まれる場合
条件2の場合はまず BashOutput でステータスを確認し、まだ実行中であればユーザーのメッセージを優先して処理する(結果処理は行わない)。
3. レビュー結果の取得
BashOutput ツールで review.sh の出力を確認する。
- まだ実行中の場合はステータスを報告し、再度確認を依頼するよう案内する
- エラーで終了した場合は、エラー内容をユーザーに報告する
- シェルが見つからない場合(セッション消失)は
$HOME/.cache/claude-bg/codex-review-*.txtの最新ファイルを読み取る - codex セクションが抽出できない場合、スクリプトは stderr 全体をフォールバック出力する
4. 共通分析ステップへ
取得した出力を「共通分析ステップ」に従って処理する。
共通分析ステップ
出力の分割
出力に ---USAGE--- セパレータが含まれる場合、セパレータより前をレビュー結果、セパレータより後の JSON を使用量データとして分離する。
レビュー結果の分類
レビュー結果を以下のカテゴリに分類する。
- 重大な問題 - バグ、セキュリティリスク、データ損失の可能性
- 改善提案 - パフォーマンス、可読性、保守性の改善
- 軽微な指摘 - スタイル、命名、コメントの改善
- 情報提供 - 質問、確認事項、補足情報
構造化レポート
分類した結果を構造化してユーザーに報告する。
- カテゴリごとにグループ化
- 各指摘に対象ファイルと行番号を含める(レビュー結果に記載がある場合)
- 重大な問題がない場合はその旨を明記する
使用量データがある場合、レポート末尾に以下の形式で追加する。
Codex 使用量
- モデル: {model}
- トークン: {total_tokens} (入力: {input_tokens}, キャッシュ: {cached_tokens}, 出力: {output_tokens}, 推論: {reasoning_tokens})
- コスト: ${cost_usd}
- 残量: 5時間枠 {remaining_5h}% / 週間枠 {remaining_weekly}%
残量フィールドがない場合はその行を省略する。
使用量データがない場合はこのセクションを省略する。
修正提案
重大な問題と改善提案について、修正方針を提示する。
- ユーザーの承認を得てから修正を実施する
- 修正は最小限に留める(指摘された箇所のみ)
再レビューの提案
修正を実施した場合、再レビューを提案する。
修正が完了しました。再レビューを実行しますか? → /codex-review