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モードです — モード検出を参照)。 - これは外部の「メタプロンプト」を置き換えます: 展開はスキル内部で行われます。以下の ラフな意図をワークフローにコンパイルする セクション全体がそのコンパイラです。
デフォルトの実行チェックリスト
すべての実行で、順序通りに(以下のセクションで各ステップを詳述):
- プリフライト Codexを1回(
handshake.js); 最新の最先端モデルを確認します。 - コンパイル ラフな意図を: ジョブの分類 → 規模 → アーキタイプ → パターン(防止する障害モードに名前を付ける) → タスク契約。前提条件を明示します。
- 作成 スクリプトをリポジトリに(
./<name>.workflow.js)。 - 設定:
--frontier· 規模に応じた effort(quick_harnessの場合は--effort medium、standard/deepの場合は--auto-effort) · 書き込みが必要な場合を除き--sandbox read-only· 上限付きの--budget· 厳格なスキーマ(additionalProperties:false)。 - サイズ調整 — 高価または複雑なワークフローの場合は、最初に
--planを実行します。 - 実行 Codexランナー上で(ネイティブの
Workflowツールは使用しない)。 - 結果表示 — インライン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回、または実行が接続に失敗した場合は、Codexが到達可能で認証されていることを確認します:
node ~/.claude/skills/codex-workflows/runner/test/handshake.jsこれにより
state: readyと利用可能なモデルが出力されます。失敗した場合は、ユーザーにcodex loginを実行するよう伝えてください(ランナーはPATHにログイン済みのcodexCLIが必要です)。そのリストから、最新の最先端モデルを確認します — 最新のフラッグシップ汎用モデル(-mini/-sparkバリアントではない;model/listはそれをisDefaultとしてフラグし、その説明はそれを最強としています)。GPT-5.6 CodexシリーズはSol(フラッグシップ)、Terra(バランス)、Luna(効率的)です; 現在の最先端はgpt-5.6-solです。実行内のすべてのエージェントがこれを使用します(モデルを参照)。 -
コンパイル ラフインテントをワークフローに(ラフな意図をワークフローにコンパイルするを参照): ジョブの分類 → 規模の選択 → アーキタイプの選択 → パターンの選択と防止する障害モードの命名 → タスク契約の構築 → フェーズの構成 → ペルソナのキャスト → 基準の適用。結果の前提条件を作成前にユーザーに明示します。
-
作成 そのコンパイルからワークフロースクリプトを(作成を参照)。ユーザーのプロジェクトに書き込み、読んで再実行できるようにします —
./<name>.workflow.js、または再利用可能なハーネスの場合はworkflows/<name>.workflow.js/examples/harness-zoo/<name>/。スクリプトは注入されたグローバルのみを使用するプレーンなJavaScriptです(インポートなし)。 -
実行設定の選択(実行デフォルトを参照):
--frontier、選択した規模のeffortフラグ(standard/deepハーネスの場合は--auto-effort、クイックハーネスの場合は--effort medium)、実行が書き込みを必要としない限り読み取り専用サンドボックス、および上限付きの--budget。高価または複雑なワークフローの場合は、最初に--plan— トークンを消費しないドライランで、フェーズ/effortごとのエージェント数をカウントし、--budgetを推定します。 -
実行 — 常に
--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ビューアー)を追加します — 実行 → ライブモニタリングを参照。 -
結果表示 ユーザーに(出力動作を参照)— 要約し、スクリプトパスに言及し、実行の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バグハント vsadversarial_verificationスイープ vssessionful_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 · 監視 — ループ
他の作業の合間にフリートダイジェストをポーリングします(そしてゲートが保留中の可能性がある場合は迅速に…
…[翻訳のために切り捨て]