Claude Codeスキルとしてのレビューループ実装（/codex-review）

[keitakn]

issueURL

#4

この PR で対応する範囲 / この PR で対応しない範囲

対応する範囲

• /codex-review スキルの定義（SKILL.md）とCodex構造化出力用JSON Schemaの追加

対応しない範囲

• 既存の src/ 配下のTypeScriptコードの変更は一切行わない（Issue ClaudeCodeが作成した実装プランをCodexでレビューする為の機能を開発する #3 の実装はそのまま維持）

変更点概要

Issue #3 で実装したスタンドアロンCLI方式（planloop run）の実機テストで、毎ラウンドのファイル編集ベースのトリアージが重い・前回の文脈を覚えていない・途中で止められない等の問題が判明した。

これを解決するため、Claude Codeのスキル（.claude/skills/codex-review/）として再実装した。スキルとして実装することで:

• トリアージが自然な会話になる: ファイル編集不要で「finding-1は対象外としてください」と言うだけ
• Claude Code自身が修正する: 子プロセス起動が不要、自分のEditツールで直接planFileを修正
• 途中で止められる: 通常のClaude Codeの対話として中断可能
• Codexのセッションが引き継がれる: codex exec resume <thread_id> で前回の文脈を保持し、同じ指摘の繰り返しを防止

TypeScriptの新規コード追加は不要で、Issue #3 のロジック（プロンプトテンプレート、Waiver適用、フィンガープリント生成、エビデンス検証等）をスキル定義内の手順として記述している。

レビュアーに重点的にチェックして欲しい点

• SKILL.md のプロンプトテンプレート（初回レビュー / 再レビュー / フィードバック反映）が設計書と整合しているか
• Codex CLI の呼び出しコマンド（特に codex exec resume <thread_id> のセッション引き継ぎ部分）
• トリアージ表示の情報量が判断に十分か（E2E検証で改善済み）

補足情報

• E2E検証済み: 意図的に6件の不整合を含むテスト計画を作成し、Codexが全件検出→計画修正→再レビューで0件になることを確認
• codex exec resume は --output-schema をサポートしないため、2回目以降はプロンプト内にJSON出力形式を明記して代替