codex-claude-handoff は何をしますか？
Codex と Claude Code が同一プロジェクトで自動連携するための、6 フェーズ状態機械＋ファイルハンドシェイクプロトコル
概要
このスキルは、handoff-state.json というファイルベースのハンドシェイクプロトコルを使用して、OpenAI Codex と Anthropic Claude Code の2つの主要なAIコーディングエージェント間で自動的なタスク引き継ぎを実現します。
動作の仕組み
-
6段階状態機械:
AWAITING_INPUT: ユーザー入力を待機PLANNING: 計画フェーズIMPLEMENTATION: 実装フェーズREVIEW: コードレビューフェーズCOMPLETED: 完了フェーズHANDOFF_REQUESTED: 引き継ぎ要求フェーズ
-
ファイルハンドシェイク: エージェントは
handoff-state.jsonを読み書きすることで、現在の状態と次に実行すべきアクションを通信します。 -
自動トリガー: 一方のエージェントがタスクを完了すると、状態ファイルが更新され、他方のエージェントが自動的に作業を継続します。
サポート対象プラットフォーム
- Codex CLI
- Claude Code
- Codebuff
- その他CLIベースのAIエージェント
セットアップ
// .claude/settings.json または CLAUDE.md に追加
{
"skills": ["chentao326/codex-claude-handoff"]
}
使用方法
- プロジェクトのルートに
handoff-state.jsonを作成します - 初期状態を
AWAITING_INPUTに設定します - エージェントを順番に実行します
- 各エージェントがタスクを完了すると、自動的に次のエージェントに引き継ぎます
ライセンス
MIT