codex-claude-loop

Codex-Claude エンジニアリングループスキル

ワークフローの基本方針

このスキルでは、バランスの取れたエンジニアリングループを実現します。

• Claude Code：アーキテクチャ、計画、実行
• Codex：検証とコードレビュー
• 継続的なレビュー：各 AI が相手の作業をレビュー
• コンテキストの引き継ぎ：最後にクリーンアップした側から必ず続行

フェーズ 1：Claude Code による計画

1. まず、タスクの詳細な計画を作成します
2. 実装を明確な手順に分割します
3. 前提条件と潜在的な問題を記録します
4. 構造化された形式で計画を出力します

フェーズ 2：Codex による計画の検証

1. ユーザーに確認します（AskUserQuestion 経由）。
   • モデル：gpt-5 または gpt-5-codex
   • 推論の強度：low、medium、または high
2. 検証のため、計画を Codex に送信します。

   echo "Review this implementation plan and identify any issues:
   [Claude's plan here]
   
   Check for:
   - Logic errors
   - Missing edge cases
   - Architecture flaws
   - Security concerns" | codex exec -m  --config model_reasoning_effort="" --sandbox read-only

3. Codex のフィードバックを記録します

フェーズ 3：フィードバックループ

Codex が問題を見つけた場合：

1. Codex の懸念事項をユーザーに要約して伝えます
2. フィードバックに基づいて計画を修正します
3. ユーザーに確認します（AskUserQuestion 経由）。「計画を修正して再検証しますか、それとも修正の実施に進みますか？」
4. 必要に応じてフェーズ 2 を繰り返します

フェーズ 4：実行

計画の検証が完了したら：

1. Claude が利用可能なツール（Edit、Write、Read など）を使ってコードを実装します
2. 実装を管理しやすい手順に分割します
3. 適切なエラー処理を行いながら、各手順を慎重に実行します
4. 実装内容を記録します

フェーズ 5：変更後の相互レビュー

変更のたびに：

1. Claude の実装を Codex に送信してレビューを依頼します。
   • バグの検出
   • パフォーマンスの問題
   • ベストプラクティスへの準拠の検証
   • セキュリティ上の脆弱性
2. Claude が Codex のフィードバックを分析し、次の対応を判断します。
   • 重大な問題はすぐに修正します
   • アーキテクチャの変更が必要な場合はユーザーと相談します
   • 判断内容を記録します

フェーズ 6：反復的な改善

1. Codex のレビュー後、Claude が必要な修正を適用します
2. 重大な変更については、再検証のため Codex に再送信します
3. コード品質の基準を満たすまでループを続けます
4. codex exec resume --last を使って検証セッションを続行します。

   echo "Review the updated implementation" | codex exec resume --last

注：再開後のセッションには、元のセッションのすべての設定（モデル、推論、サンドボックス）が引き継がれます

問題発生時の復旧

Codex が問題を特定した場合：

1. Claude が根本原因を分析します
2. 利用可能なツールを使って修正を実装します
3. 検証のため、更新したコードを Codex に再送信します
4. 検証に合格するまで繰り返します

実装エラーが発生した場合：

1. Claude がエラーや問題を確認します
2. 実装方針を調整します
3. 続行する前に Codex で再検証します

ベストプラクティス

• 実行前に必ず計画を検証します
• 変更後の相互レビューを省略しないでください
• AI 間で明確に引き継ぎを行います
• コンテキストを把握できるよう、誰が何を行ったかを記録します
• セッションの状態を保持するために、再開機能を使用します

コマンドリファレンス

フェーズ	コマンドパターン	目的
計画の検証	echo "plan" | codex exec --sandbox read-only	コーディング前にロジックを確認します
実装	Claude が Edit／Write／Read ツールを使用	Claude が検証済みの計画を実装します
コードレビュー	echo "review changes" | codex exec --sandbox read-only	Codex が Claude の実装を検証します
レビューの続行	echo "next step" | codex exec resume --last	検証セッションを続行します
修正の適用	Claude が Edit／Write ツールを使用	Claude が Codex に指摘された問題を修正します
再検証	echo "verify fixes" | codex exec resume --last	Codex が修正後に再確認します

エラー処理

1. Codex の終了コードが 0 以外の場合は停止します
2. Codex のフィードバックを要約し、AskUserQuestion 経由で対応方針を尋ねます
3. 変更を実装する前に、次の場合はユーザーに方針を確認します。
   • 大幅なアーキテクチャの変更が必要な場合
   • 複数のファイルに影響する場合
   • 互換性を損なう変更が必要な場合
4. Codex の警告が表示された場合、Claude が重大度を評価し、次の手順を判断します

完璧なループ

Plan (Claude) → Validate Plan (Codex) → Feedback →
Implement (Claude) → Review Code (Codex) →
Fix Issues (Claude) → Re-validate (Codex) → Repeat until perfect

これにより、次のような自己修正型の高品質なエンジニアリングシステムが実現します。

• Claude がすべてのコードの実装と変更を担当します
• Codex が検証、レビュー、品質保証を担当します