codex-claude-cursor-loop

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

中核となるワークフローの考え方

このスキルでは、3者による逐次検証のエンジニアリングループを実装します。

• Claude Code：アーキテクチャと計画、最終レビュー
• Codex：計画の検証（ロジック／セキュリティ）、コードレビュー（バグ／パフォーマンス）
• Cursor Agent：コードの実装と実行
• 逐次検証：Claude が計画 → Codex が検証 → Cursor が実装 → Codex がレビュー → Claude が最終確認 → 繰り返し

フェーズ 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 <model> --config model_reasoning_effort="<effort>" --sandbox read-only

3. Codex からのフィードバックを記録し、要約してユーザーに伝えます

フェーズ 3：計画の改善ループ

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

1. Codex の懸念事項を要約してユーザーに伝えます
2. フィードバックに基づいて計画を改善します
3. ユーザーに（AskUserQuestion を使って）「計画を修正して再検証しますか、それとも実装に進みますか？」と確認します
4. 必要に応じてフェーズ 2 を繰り返し、計画が十分に整うまで続けます

フェーズ 4：Cursor Agent による実装

Codex による計画の検証が完了したら：

セッション管理

1. ユーザーに（AskUserQuestion を使って）「新しい Cursor セッションを開始しますか、それとも既存のセッションを再開しますか？」と確認します

   • 新しいセッション：新規に開始します
   • セッションを再開：前回の作業を続行します

2. 再開する場合：

   # List available sessions
   cursor-agent ls

   # Let user select session ID
   # Store session ID for subsequent calls

3. 使用する Cursor モデル（例：composer-1、claude-3.5-sonnet、gpt-4o）をユーザーに確認します（AskUserQuestion を使います）

実装

4. 検証済みの計画を Cursor Agent に送信します。

新しいセッションの場合：

   cursor-agent --model "<model-name>" -p --force "Implement this plan:
   [Validated plan here]

   Please implement the code following these specifications exactly."

再開するセッションの場合：

   cursor-agent --resume="<session-id>" -p --force "Continue implementation:
   [Validated plan here]"

5. 重要：以降のすべての Cursor 呼び出しで使うため、出力されたセッション ID を保存します
6. 実装された内容と変更されたファイルを記録します

フェーズ 5：Codex によるコードレビュー

Cursor の実装後：

1. コードレビューのため、Cursor の実装を Codex に送信します。

   echo "Review this implementation for:
   - Bugs and logic errors
   - Performance issues
   - Security vulnerabilities
   - Best practices violations
   - Code quality concerns

   Files modified: [list of files]
   Implementation summary: [what Cursor did]" | codex exec --sandbox read-only

2. Codex のコードレビューのフィードバックを記録します
3. 調査結果を要約してユーザーに伝えます

フェーズ 6：Claude による最終レビュー

Codex のコードレビュー後：

1. Claude は Read ツールを使って実装済みのコードを読みます
2. Claude は次の両方を分析します。
   • Codex のレビュー結果
   • 実際の実装
3. Claude は最終評価を提示します。
   • 元の計画に沿っているか確認します
   • Codex の指摘が妥当か確認します
   • 追加の懸念事項を特定します
   • 最終的なアーキテクチャ上の判断を下します
4. 全体的な品質と準備状況を要約します

フェーズ 7：反復的な改善ループ

（Codex または Claude によって）問題が見つかった場合：

1. Claude は次の内容に基づいて詳細な修正計画を作成します。
   • Codex のコードレビュー結果
   • Claude の最終レビューで得た知見
2. 同じセッションを使って、修正計画を Cursor Agent に送信します。

   # IMPORTANT: Use --resume with the stored session ID
   cursor-agent --resume="<session-id>" -p --force "Fix these issues:
   [Detailed fix plan]

   Issues from Codex: [list]
   Issues from Claude: [list]"

3. Cursor による修正後、フェーズ 5（Codex によるコードレビュー）から繰り返します
4. すべての検証に合格するまでループを続けます
5. 注記：
   • 一貫性を保つため、同じ Codex モデルを使用します
   • コンテキストを維持するため、常に同じ Cursor セッション ID を使用します
   • セッションには変更履歴全体が保持されます

問題が見つかった場合の復旧

Codex が計画の問題を見つけた場合（フェーズ 2）：

1. Claude が Codex の懸念事項を分析します
2. すべての問題に対処するよう計画を改善します
3. 検証のため、Codex に再送信します
4. Codex が承認するまで繰り返します

Codex がコードの問題を見つけた場合（フェーズ 5）：

1. Claude が Codex の指摘をレビューします
2. 詳細な修正計画を作成します
3. 修正のため Cursor に送信します
4. Cursor による修正後、Codex のレビューに戻ります
5. Codex が承認するまで繰り返します

Claude が問題を見つけた場合（フェーズ 6）：

1. Claude が包括的な修正計画を作成します
2. 実装のため Cursor に送信します
3. 修正後、Codex が再度レビューします
4. Claude が最終確認を行います
5. Claude が承認するまで繰り返します

ベストプラクティス

• 実装前に、必ず Codex で計画を検証してください
• Cursor による実装後、Codex のコードレビューを省略しないでください
• アーキテクチャの監督に必要な Claude の最終レビューを省略しないでください
• 3 つすべての AI 間で、明確に引き継ぎを行ってください
• 状況を把握できるよう、誰が何を行ったか記録してください
• 一貫して同じモデルを使用してください（同じ Codex モデル、同じ Cursor モデル）
• セッション管理：
  • 反復的な修正では、必ず同じセッション ID を指定して --resume を使用してください
  • セッション ID は最初に保存し、その後も一貫して再利用してください
  • 過去のセッションを見つけるには cursor-agent ls を使用してください
  • まったく新しい機能を開始するときに限り、新しいセッションを開始してください

コマンドリファレンス

フェーズ	担当	コマンドパターン	目的
1. 計画	Claude	TodoWrite、Read、分析ツール	Claude が詳細な計画を作成します
2. 計画の検証	Codex	echo "plan" | codex exec -m <model> --config model_reasoning_effort="<effort>" --sandbox read-only	Codex がロジックとセキュリティを検証します
3. 改善	Claude	Codex のフィードバックを分析し、計画を更新	Claude が計画の問題を修正します
4. セッションの設定	Claude + User	新規か再開かを尋ね、必要に応じて cursor-agent ls を実行	Cursor セッションを設定または再開します
5. 実装	Cursor	cursor-agent --model "<model>" -p --force "prompt" OR cursor-agent --resume="<id>" -p --force "prompt"	Cursor が検証済みの計画を実装します
6. コードレビュー	Codex	echo "review" | codex exec --sandbox read-only	Codex がバグとパフォーマンスを確認します
7. 最終レビュー	Claude	Read ツール、分析	Claude がアーキテクチャを最終確認します
8. 修正計画	Claude	詳細な修正計画を作成	Claude がすべてのフィードバックに基づいて修正を計画します
9. 修正の適用	Cursor	cursor-agent --resume="<id>" -p --force "fixes"	Cursor が同じセッションで修正を実装します
10. 再レビュー	Codex + Claude	フェーズ 6～7 を繰り返す	修正が完璧になるまで検証します

エラー処理

1. Cursor Agent の出力を監視し、エラーがないか確認します
2. Cursor の実装結果と Claude のレビューを要約します
3. 次の場合は AskUserQuestion を使って、ユーザーに方針を確認します：
   • 大幅なアーキテクチャ変更が必要な場合
   • 複数のファイルに影響する場合
   • 破壊的変更が必要な場合
4. 問題が見つかった場合、Claude は Cursor に依頼する前に詳細な修正計画を作成します

完璧なループ

1. Plan (Claude)
   ↓
2. Validate Plan (Codex) → if issues → refine plan → repeat
   ↓
3. Implement (Cursor)
   ↓
4. Code Review (Codex) → captures bugs/performance issues
   ↓
5. Final Review (Claude) → architectural check
   ↓
6. Issues found? → Fix Plan (Claude) → Implement Fixes (Cursor) → back to step 4
   ↓
7. All passed? → Done! ✅

これにより、3 段階の検証と自己修正を行う、高品質なエンジニアリングシステムが実現します。

• Claude：計画、アーキテクチャ、最終的な監督をすべて担当します
• Codex：すべての検証（計画のロジックとコード品質）を担当します
• Cursor Agent：すべての実装とコーディングを担当します