ultracode-token-optimization

Claude Code の Ultracode（Workflow機能） で複数エージェントのorchestration（agent() / parallel() / pipeline() / phase() 等を使うスクリプト）を書くときに読み込ませる、トークン最適化のための実行ルール集（skill）です。

背景

Fable 5（Orchestrator）× Codex（Executor）× 異質reviewer という体制で複数プロジェクトを並走させた実運用から、うまくいったパターン／失敗パターンを抽出し、Claude Codeの Skill として再利用できる形に落とし込みました。

最適化の対象は「トークン単価」そのものではなく、**差し戻し→再修正→再レビューという手戻り（重工）**です。役割の越境・生ログの垂れ流し・自己申告だけの完了判定・reviewerへの決定権付与といった、手戻りを生みやすいパターンをルールとして明文化し、スクリプトを書く前に必ず適用する運用にしています。

中身

• SKILL.md — このskill本体。frontmatter（トリガーキーワード）＋以下の内容:
  • Ultracode Workflowランタイムの実際の制約（agentType 一覧、モデル継承の挙動、budget 機構の実仕様など）
  • 役割ごとのモデル配置表（orchestrator / executor / reviewer / 機械的作業）
  • 「異質reviewer」代替方針（ベンダー起点の異質性確保）
  • Workflowスクリプトを書くときの絶対ルール16項目
  • 提出前セルフチェックリスト
  • このskillの効果と限界についての率直な注記（ソフトな行動誘導であり、ハードなトークン上限は保証しない）

使い方

~/.claude/skills/ultracode-token-optimization/ に配置すると、Claude Codeが description 内のトリガーキーワード（「Ultracode」「Workflow」「複数エージェント」「orchestrator」「トークン最適化」等）を検知して自動的に提示します。Workflowスクリプトを書く/直す前に、このskillのルールに沿っているかを確認してから実装するという運用を想定しています。

前提・限界

• このskillはあくまでソフトな行動誘導です。トークン消費のハード上限を保証する機構ではありません。
• 記載されている agentType（codex-consultant / codex-implementer / codex-reviewer / Explore / Plan / general-purpose 等）やモデル名（fable / opus / sonnet / haiku）は、Claude Codeの特定の環境設定に依存します。環境によって利用可能なagentTypeやモデルが異なる場合は、内容を読み替えてください。
• 特定の企業・個人の機密情報は含まれていません。

ライセンス

MIT License（LICENSE 参照）