Communitygithub.com

scasella/claude-dynamic-workflows-codex

動的ワークフロースクリプトをローカルのCodex App Server上で実行し、Claudeサブエージェントの代わりに複数のCodex/GPTエージェント(agent / parallel / pipeline / phase / budget DSL)を調整します。コードベース監査、大規模マイグレーション、マルチエージェントレビューや調査に最適です。

claude-dynamic-workflows-codex とは?

このスキルは、Claude Code内で動的ワークフロースクリプトを記述し、それをローカルで稼働するCodex App Serverにルーティングして実行するためのものです。通常のClaude動的ワークフローと同じ`agent()`、`parallel()`、`pipeline()`、`phase()`などのDSLを使用しますが、各`agent()`呼び出しはClaudeサブエージェントではなく、Codex(GPT)のスレッド兼ターンとして実行されます。このスキルは手動起動専用(`/codex-workflows`コマンド)であり、ユーザーがざっくりとした要件を1~2文で与えると、内部でジョブを分類し、最適な規模とアーキタイプを選択し、ハーネススクリプトを自動生成して実行します。`--multi`フラグを使用すると、複数のバリアントワークフローを同時に実行し、実行中にゲートを監視・介入できる「フリート」モードになります。コードベース監査、大規模リファクタリング、多角的な分析や調査など、Claude単体ではリソースが不足する複雑なタスクを、GPTエージェントの群れを使って効率的に処理できます。

対応✓Claude Code✓Codex CLI✓Cursor✓Antigravity
npx skills add scasella/claude-dynamic-workflows-codex

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Codexワークフロー

ローカルのCodex App Serverに対してClaude Codeの動的ワークフロースクリプトを実行します。作成インターフェースはネイティブの動的ワークフローと同一です — export const meta と、agent()、parallel()、pipeline()、phase()、log()、args、budget、workflow() を使用した本体 — ただし、各 agent() 呼び出しはClaudeサブエージェントではなく、1つのCodex(GPT)スレッド+ターンとして実行されます。

手動起動のみ。 Claudeはこのスキルを自動トリガーしません(disable-model-invocation: true)。ユーザーが /codex-workflows と入力するか、明示的にCodexワークフローを要求した場合にのみ実行されます。呼び出されたら、以下のループに従ってください — 作業はCodex/GPTエージェント上で実行されます。ユーザーが実際にClaudeサブエージェントを必要としている場合は、その旨を伝え、ネイティブのWorkflowツールを案内してください。

RUNNER とは、バンドルされたランナーディレクトリを意味します: このスキルのベースディレクトリからの相対パス runner/(スキル読み込み時に表示されます)。標準的なskills-dirインストールの場合、これは ~/.claude/skills/codex-workflows/runner です — 以下の例のリテラルパスはこれを想定しています。このスキルがプラグインとしてインストールされている場合は、ベースディレクトリを適宜読み替えてください。依存関係は不要で、Node ≥ 18が必要です。

デフォルトのラフインテントモード

1~2文のざっくりした記述で十分です。 このスキルに完全に設計された仕様を渡す必要はありません — やりたいことを説明するだけで(例: /codex-workflows この目標を実行する前に強化してください)、スキルが内部で運用可能なハーネスに自動コンパイルします。ジョブを分類し、最小限の実用的な規模、アーキタイプ、ハーネスパターンを選択し、タスク契約を構築し、フェーズを構成し、ペルソナをキャストし、品質/認識論的基準を適用し、スクリプトを作成し、安全な実行設定を選択し、実行します — その過程で前提条件を明示します。

このモードでの運用ルール:

  • ラフな意図が契約です。明示されていない点については合理的な前提を置き、それを明示してください。フォローアップでユーザーに尋問しないでください。
  • 最小限の有用なハーネスを選択し、可能な限り最大のものは選択しないでください(過剰構築禁止ルールを参照)。
  • ユーザーが貼り返すための巨大なプロンプトを出力しないでください。 コンパイルして作成/実行に進んでください。(唯一の例外は prompt-only モードです — モード検出を参照)。
  • これは外部の「メタプロンプト」を置き換えます: 展開はスキル内部で行われます。以下の ラフな意図をワークフローにコンパイルする セクション全体がそのコンパイラです。

デフォルトの実行チェックリスト

すべての実行で、順序通りに(以下のセクションで各ステップを詳述):

  1. プリフライト Codexを1回(handshake.js); 最新の最先端モデルを確認します。
  2. コンパイル ラフな意図を: ジョブの分類 → 規模 → アーキタイプ → パターン(防止する障害モードに名前を付ける) → タスク契約。前提条件を明示します。
  3. 作成 スクリプトをリポジトリに(./<name>.workflow.js)。
  4. 設定: --frontier · 規模に応じた effort(quick_harness の場合は --effort medium、standard/deep の場合は --auto-effort) · 書き込みが必要な場合を除き --sandbox read-only · 上限付きの --budget · 厳格なスキーマ(additionalProperties:false)。
  5. サイズ調整 — 高価または複雑なワークフローの場合は、最初に --plan を実行します。
  6. 実行 Codexランナー上で(ネイティブの Workflow ツールは使用しない)。
  7. 結果表示 — インラインASCIIマップ + summarize-run のハイライト; スクリプト、ジャーナル、ビューアー、レポート、実行サマリーのパスを記載します(出力動作を参照)。

モード検出

ユーザーの表現からモードを読み取り、それに応じて動作します:

モードトリガー動作
default (ラフインテント)1~2文のラフな文内部でコンパイル → 作成 → 実行。前提条件を明示。
--multi (フリート)--multi フラグ、または「フリート」/「複数のワークフローを同時に」フリート計画(2~4の同時実行バリアントワークフロー、類似および/または多様)をコンパイルし、バックグラウンドで起動し、監視: fleet status をポーリング、ゲートに応答、方向付け、強制終了、フォーク、最後に統合。フリートモードを参照。
prompt-only「プロンプトのみ」、「呼び出しのみ」、「実行しない」完全な /codex-workflows 呼び出し/仕様(以下のA~L構造)を出力し、停止 — 作成も実行もしない。
write-only「作成するが実行しない」、「作成のみ」ワークフロースクリプトを作成し、そのパスを表示し、実行前に停止。
run-existingスクリプトパスまたは保存済みワークフロー名コンパイルをスキップ; そのスクリプト/名前をランナーで実行。
quick「クイック」、「小さい」、「安い」quick_harness(2~5エージェント)にバイアス。
deep「深い」、「徹底的」、「網羅的」より大きな / deep_harness を許可; サイズを正当化。
no-write「ファイルを書き込まない」、「教えてくれるだけ」最終JSON/Markdownのみを返す; レポート/ソースファイルなし; --sandbox read-only。

2つの優先順位ルール: ユーザーがスクリプトパスまたは保存名を指定した場合は、それを実行します(再コンパイルしない)。ユーザーが詳細な仕様を指定した場合は、それをそのまま尊重しますが、以下の安全性と実行デフォルトは適用します。それ以外の場合はラフインテント → コンパイルします。

prompt-only では、出力する呼び出しはスキルが内部的に構築するのと同じA~L構造に従います: A 名前 · B 目的 · C タスク契約 · D 入力 / コンテキスト再構築 · E フェーズ · F ペルソナ · G アンチラッパー基準 · H 出力 · I 実行設定 · J 安全性 / 認識論 · K 最終応答形式 · L プロダクト化。その後停止 — 実行はしません。

ループ

デフォルトのラフインテントモードでは、ステップ1~2を静かに実行し、作成前に前提条件を明示します。以下の仕組み — ハンドシェイク、実行コマンド、インラインマップ — は変わりません; ステップ2と4でラフインテントがコンパイルされます。

  1. プリフライト — セッションごとに1回、または実行が接続に失敗した場合は、Codexが到達可能で認証されていることを確認します:

    node ~/.claude/skills/codex-workflows/runner/test/handshake.js
    

    これにより state: ready と利用可能なモデルが出力されます。失敗した場合は、ユーザーに codex login を実行するよう伝えてください(ランナーはPATHにログイン済みの codex CLIが必要です)。そのリストから、最新の最先端モデルを確認します — 最新のフラッグシップ汎用モデル(-mini/-spark バリアントではない; model/list はそれを isDefault としてフラグし、その説明はそれを最強としています)。GPT-5.6 CodexシリーズはSol(フラッグシップ)、Terra(バランス)、Luna(効率的)です; 現在の最先端は gpt-5.6-sol です。実行内のすべてのエージェントがこれを使用します(モデルを参照)。

  2. コンパイル ラフインテントをワークフローに(ラフな意図をワークフローにコンパイルするを参照): ジョブの分類 → 規模の選択 → アーキタイプの選択 → パターンの選択と防止する障害モードの命名 → タスク契約の構築 → フェーズの構成 → ペルソナのキャスト → 基準の適用。結果の前提条件を作成前にユーザーに明示します。

  3. 作成 そのコンパイルからワークフロースクリプトを(作成を参照)。ユーザーのプロジェクトに書き込み、読んで再実行できるようにします — ./<name>.workflow.js、または再利用可能なハーネスの場合は workflows/<name>.workflow.js / examples/harness-zoo/<name>/。スクリプトは注入されたグローバルのみを使用するプレーンなJavaScriptです(インポートなし)。

  4. 実行設定の選択(実行デフォルトを参照): --frontier、選択した規模のeffortフラグ(standard/deepハーネスの場合は --auto-effort、クイックハーネスの場合は --effort medium)、実行が書き込みを必要としない限り読み取り専用サンドボックス、および上限付きの --budget。高価または複雑なワークフローの場合は、最初に --plan — トークンを消費しないドライランで、フェーズ/effortごとのエージェント数をカウントし、--budget を推定します。

  5. 実行 — 常に --frontier を渡し、選択した規模のeffortフラグを追加します: standard/deepハーネスの場合は --auto-effort(各エージェントのeffortをそのレイヤーの並列幅にスケーリングするため、単独の合成/judgeゲートが最も強く考えます)、またはクイックハーネスの場合は --effort medium(Effortを参照)。--frontier はすべてのエージェントを最新の最先端モデルに固定します(モデルを参照):

    node ~/.claude/skills/codex-workflows/runner/bin/run-workflow.js <script.js> --frontier --auto-effort [other flags]
    #   quick_harness:  … <script.js> --frontier --effort medium [other flags]
    

    進行状況はstderrにストリーム出力されます; ワークフローの戻り値はstdoutにJSONとして出力されます。結果が大きい場合はstdoutをキャプチャします(… 1>/tmp/result.json)。実行をライブで監視するには、--tui(新しいターミナルウィンドウへのライブASCIIマップ)および/または --gui(ブラウザへのライブHTMLビューアー)を追加します — 実行 → ライブモニタリングを参照。

  6. 結果表示 ユーザーに(出力動作を参照)— 要約し、スクリプトパスに言及し、実行のASCIIマップをこの会話にインラインでレンダリングして、ユーザーが実行グラフをネイティブに確認できるようにします(開くウィンドウは不要):

    node ~/.claude/skills/codex-workflows/runner/bin/map-run.js --journal <journal> --no-color
    

    (<journal> は実行が ✎ journal: … としてログに記録したパス、デフォルトは .workflow-journal/<name>.jsonl)その出力を ```text ブロック内で返信に貼り付けてください — これはオーケストレーター → フェーズレイヤー → エージェントグリッド → 結果DAGであり、エージェントごとのモデル/effort/トークン/時間と1行の結果スニペットが含まれます。インラインでは常に --no-color を使用してください(生のANSIはチャットでガベージとしてレンダリングされます)。セッション内でのライブモニタリングのために、run_in_background でワークフローを実行し、実行中にこのスナップショットを数回再レンダリングします(実行中のエージェントは ⠋ … running… と表示されます); 代わりにスムーズなライブウィンドウの場合は、--tui/--gui を追加します(実行 → ライブモニタリングを参照)。

    実行は終了時に1行のコスト/信頼性の要約も出力します。より詳細な内訳 — フェーズごとのトークン、最も高価/低速なエージェント、および赤旗(多くのnull、ステージングされていない巨大なファンアウト、デフォルトeffortのコスト)については、ジャーナルに対して summarize-run を実行し、ハイライトを返信に折り込みます(実行の要約を参照)。

このスキルを使用している間は、ネイティブの Workflow ツールを呼び出さないでください。 スクリプトを作成して上記のCLIで実行することこそが、作業をCodexにルーティングする方法です; ネイティブツールを呼び出すと、代わりにClaudeサブエージェントが起動されます。

フリートモード(--multi): 起動、監視、方向付け

ユーザーが --multi を渡した場合(またはフリート/複数のワークフローを同時に要求した場合)、あなたはN個の同時実行のオペレーターです — 発射して忘れるランチャーではありません。フリート計画をコンパイルし、すべてのバリアントをバックグラウンドで起動し、監視ループを実行します: ステータスをポーリング、ゲートに応答、漂流するワーカーを方向付け、行き止まりを強制終了、有望なリードをフォーク、最後に統合します。人間はポリシーを一度設定します(目標、総予算、リスク許容度); あなたが、バリアント自身では行えない実行途中の判断を下します。

1 · フリート計画のコンパイル

意図を2~4のバリアントに分解し、起動前に計画(バリアント、それぞれが何に賭けるか、実行ごとの予算)を述べます。2つの軸があり、自由に組み合わせられます:

  • 類似 — 同じハーネス、異なるスライス: --args を使用して大きな入力を実行間で分割するか、異なる開始仮説/シードから同じ質問にアプローチします。1つのスクリプト + 実行ごとの --args + --run-id(ジャーナルが衝突しないように)、またはN個のスクリプトコピー。
  • 多様 — タスクの異なる理論に賭ける異なるハーネス形状: 例: 同じ目標を目指した、loop_until_dry バグハント vs adversarial_verification スイープ vs sessionful_controller_loop 調査。バリアントごとに1つのスクリプト。

ユーザーの全体的な予算をバリアント間で分割します(ステータスは各実行の支出を上限に対して表示します)。既存のGPT-5.5測定値を使用して、読み取り重視のファンアウトを現実的にサイジングします: ジョブがリポジトリ/コーパスの読み取りであるエージェントは、そのeffortティアに関係なく約400~600kトークンを消費します — 入力が支配的なため、--effort low はスイープを安くせず、--plan のeffortごとの推定値はそれを過小評価します(測定値: 4つの「low」スイープ = 2.1M、それぞれ525k、vs エージェントあたり150kの計画推定値)。xhigh では — --auto-effort がすべてのセッションフルワーカーのターンに与えるもの(幅1) — 読み取りターンは ~1~1.5M を実行します(測定値: ウォークスルーワーカーの最初のターン+1つのステアで2.5Mの上限に達しました)。予算 ≈ readers × 500k + xhigh reading turns × 1.2M + non-readers × the plan estimate、ヘッドルーム付き。上限に達した場合は回復可能です(--resume はプレフィックスを無料で再生します)が、監視ラウンドトリップのコストがかかります。フリートにも過剰構築禁止ルールを適用してください: 2つの適切に差別化されたバリアントは、4つの冗長なバリアントよりも優れています — すべてのバリアントは、他のバリアントが賭けていない何かに賭けなければなりません。

2 · 監視のための作成

すべてのバリアントはスーパーバイザーチェックポイントを取得します — 外部の判断が実行をリダイレクトできる岐路での human() ゲート:

const directive = await human(
  `ラウンド ${round} の調査結果: ${summary}. 次のラウンドの指示?`,
  { id: `round${round}`, choices: ["continue", "stop"], default: "continue", timeoutMs: 240_000 })
if (directive === "stop") break
if (directive !== "continue") await worker.steer(directive)   // 自由テキスト = ステア

これがステアチャネルです: 自由テキストの回答が指示であり、スクリプトがそれを適用します(session.steer(...)、次のラウンドの照準を再調整、範囲を絞り込みます)。ラウンド間、高価なフェーズの前、および不確実性のある場所にゲートを配置します。デフォルトは安全でなければなりません — 未回答のゲートはタイムアウトしてそのデフォルトになり、実行はハンズオフで劣化し、ハングすることはありません。(これはジャーナルされた human() チャネルに乗るため、--resume は再質問する代わりに回答を再生します。)

3 · 起動 — フリートごとに1つのディレクトリ、すべての実行をバックグラウンドで

バリアントは1つのディレクトリを共有します(それが fleet status <dir> が監視するものです)。それぞれを run_in_background で起動し、常に --interactive を指定します(ヘッドレスで応答チャネルを有効にします):

node ~/.claude/skills/codex-workflows/runner/bin/run-workflow.js hunt-orm.workflow.js \
  --frontier --auto-effort --interactive --budget 1500000 1>hunt-orm.result.json
# 同じスクリプト、異なるスライス → --run-id で分離:
node …/run-workflow.js hunt.workflow.js --args '{"slice":"auth"}' --run-id auth --interactive …

4 · 監視 — ループ

他の作業の合間にフリートダイジェストをポーリングします(そしてゲートが保留中の可能性がある場合は迅速に…

…[翻訳のために切り捨て]

関連スキル