メインコンテンツへ移動
AIチュートリアル

Fable Orchestratorでルーティング型コーディングワークフローを構築

Claude Fable 5.1を計画と裁定に活用し、設定済みのGPT-5.6 LunaおよびDeepSeek V4 Flashエージェントに実装を委任する、ローカルファーストのCodexルーティングスキルFableのインストール、呼び出し、テスト、安全な運用方法を解説します。

Fable Orchestratorでルーティング型コーディングワークフローを構築

Fableの機能

Fableは、Codex向けの小規模なローカルファーストのルーティングスキルです。計画と実装を分離します。Claude Fable 5.1が作業を計画して意思決定を裁定し、Codexはランタイムとしてワークスペースを管理し、範囲を限定した実装タスクをOpenCode Goエージェントに委任します。

通常の実装はGPT-5.6 Lunaに割り当てられます。ループ、反復作業、高スループットの実装を伴う作業はDeepSeek V4 Flashに割り当てられます。Claude Fable 5.1は実装グラフの外部に留まり、コードの作成やワークスペースの管理は行いません。

Fableはオーケストレーションスキルであり、単独で動作するモデルゲートウェイや開発ダッシュボードではありません。

主な機能

  • ローカルファーストの動作: スキルはローカルのCodexスキルディレクトリにインストールされます。
  • 明確な役割分担: Fableが計画と裁定を行い、Codexが作業を実行して検証します。
  • 範囲を限定した委任: 実装ノードは、許可されたGPT-5.6 LunaまたはDeepSeek V4 Flashのルートのみを使用します。
  • 並列実行: Codexは、適切な場合に実行可能なワーカーを並列で起動できます。
  • 証拠に基づく検証: Codexはワーカーの証拠を収集し、ワークフローを完了する前に結果を検証します。
  • フェイルセーフルーティング: 許可されたOpenCode Goルートのいずれも呼び出せない場合、未承認のモデルに置き換えるのではなく、ワークフローがブロッカーを報告します。
  • 安全で反復可能なインストール: インストーラーはドライラン、カスタムターゲット、べき等なコピーに対応しています。

リポジトリを理解する

リポジトリには、インストール可能なスキル、インストーラー、テスト、アーキテクチャアセットが含まれています。

skill/fable/\n├── SKILL.md\n├── agents/openai.yaml\n└── scripts/ask_fable.sh\nassets/fable-orchestrator.svg\ninstall.sh\ntests/test_skill.sh

skill/fable/内の3つのファイルがインストール可能なスキルを構成します。ask_fable.shスクリプトは実行可能で、セッションを永続化せずにClaude Codeのローカルなfableエイリアスを呼び出します。

前提条件

スキルをインストールする前に、Codex Routerを通じて呼び出し可能なopencode-go/およびopencode-go-responses/エージェントを設定してください。Fableはこれらのエージェントを使用しますが、独自のプロキシ、ダッシュボード、モデルカタログ、認証情報ストア、APIキーは提供しません。

プロバイダーまたはエージェントの定義を変更した後は、Codexを再起動してください。これにより、新しいタスクが現在のルーティング設定を認識できます。

Fableをインストールする

1. インストールをプレビューする

リポジトリのルートから、ドライランモードでインストーラーを実行します。

./install.sh --dry-run

ファイルを作成せずに、正確な保存先とコピー操作が表示されます。変更を加える前にインストーラーの動作を確認するために使用してください。

2. デフォルトディレクトリにインストールする

スキルをデフォルトのCodexスキル保存先にコピーします。

./install.sh --copy

デフォルトの保存先は~/.codex/skills/fableです。インストーラーは必要なディレクトリのみを作成し、繰り返し安全に実行できます。

3. カスタムスキルディレクトリを選択する

デフォルトの保存先以外にインストールする場合は、--targetを使用します。

./install.sh --copy --target "$PWD/.local/codex/skills"

インストーラーが読み取るのは、リポジトリと保存先のパスのみです。認証情報の読み取り、作成、変更は行いません。

基本的な使い方

新しいCodexタスクを開始し、目的を指定してスキルを呼び出します。

$fable build the feature

Fableは範囲を限定した作業グラフを返します。Codexはそのグラフを検証し、適切な場合は実行可能なワーカーを並列で起動し、証拠を収集して、成果物を検証します。別の計画上の判断が必要になった場合、CodexはFableに裁定を求めます。

ルーティングの仕組み

  1. Fableが目的を分析し、範囲を限定した計画を作成します。
  2. Codexが実行前に提案されたグラフを検証します。
  3. 通常の実装ノードはGPT-5.6 Lunaにルーティングされます。
  4. 反復の多い実装ノードや高スループットの実装ノードはDeepSeek V4 Flashにルーティングされます。
  5. Codexが証拠を収集し、最終結果を検証します。
  6. 追加の裁定が必要な場合、Fableに再度相談します。

すべての実装ノードは、許可された2つのOpenCode Goルートのいずれかを使用する必要があります。どちらも利用できない場合は、ルーティングポリシーを回避しようとせず、報告されたブロッカーを設定上の問題として扱ってください。

計画パケットを安全に扱う

ask_fable.shに渡すパケットには、意思決定とワークスペースの事実のみを含める必要があります。認証情報、APIキー、トークン、その他の秘密情報をパケットに含めないでください。

スクリプトはセッションを永続化せずにローカルのfableエイリアスを呼び出すため、各リクエストには、その計画または裁定のステップに必要な関連事実を含めてください。

インストールをテストする

リポジトリのルートから、依存関係の少ないテストスイートを実行します。

tests/test_skill.sh

テストの対象は次のとおりです。

  • シェル構文。
  • インストーラーがコピーするソースファイル。
  • 必須のルーティング文字列。
  • 基本的なYAML構造。
  • xmllintによる任意のXML検証。
  • SVGの安全性に関する制約。
  • 一時ホームディレクトリを使用したドライラン。
  • べき等なコピー操作。
  • 一般的な認証情報形式の文字列の検査。

このテストにはPyYAMLや有効なClaudeログインは必要ないため、軽量なローカル検証に適しています。

高度な運用のヒント

スキルのデバッグ前にルーティングを検証する

Fable が、許可された実装ルートを呼び出せないと報告した場合は、まず Codex Router の opencode-go/ と opencode-go-responses/ の定義を確認してください。プロバイダーまたはエージェントの定義を変更した後は、Codex を再起動して新しいタスクを開始してください。

カスタムデプロイではドライランを使用する

プロジェクト固有または標準外のスキルディレクトリにインストールする場合は、コピーする前に --dry-run と --target を組み合わせて使用してください。

./install.sh --dry-run --target "$PWD/.local/codex/skills"
./install.sh --copy --target "$PWD/.local/codex/skills"

これにより、選択したディレクトリを変更する前に、コピー先と予定されているファイル操作を確認できます。

更新時はインストールを再実行する

コピー操作はべき等であるため、リポジトリからインストール済みのスキルを更新するときも安全に再実行できます。コピー後に tests/test_skill.sh を実行して、リポジトリのチェックを検証してください。

責務を分離する

Fable を実装担当のワーカーとして扱わないでください。文書化されている責務は、計画策定と最終裁定です。ランタイム制御、ワークスペースの所有、委任、証拠収集、検証は Codex が引き続き担います。

まとめ

Fable は、Codex に制約付きの計画策定とモデルルーティングを追加するための、焦点を絞った方法を提供します。OpenCode Go エージェントを設定し、スキルをプレビューしてコピーし、明確な目的で呼び出し、付属のテストで設定を検証してください。認証情報を計画パケットに含めず、ルーティング定義を変更した場合は必ず Codex を再起動してください。