Nanako0129/pilotfish

Multi-model orchestration layer for Claude Code — the frontier model plans, cheaper models execute, verification guards quality. One-prompt install.

解決的問題

pilotfish 是 Claude Code 的多模型編排層。它解決了在每個任務中都使用前沿模型（如 Fable 5 或 Opus）時產生的 Token 成本高昂和配額耗盡的問題。透過將常規工作路由到更小、更便宜的模型（Sonnet 和 Haiku），同時為規劃和驗證保留高智能模型，它可以在不犧牲品質的情況下降低成本並節省配額。

工作原理

它使用 ~/.claude/ 目錄中的三個配置層實現基於角色的委派系統：

  1. Machine Layer (settings.json): 設定主編排模型（例如 opus）和回退鏈。
  2. Roles Layer (agents/*.md): 根據所需的投入與能力，將八個專門的代理（例如 scout、executor、verifier）固定到特定的模型層級（Haiku、Sonnet 或 Opus）。
  3. Policy Layer (CLAUDE.md): 定義如何向這些角色委派工作，而不指明具體的模型。

工作流從主編排會話流向用於發現、執行和驗證的專業子代理。例如，在全新的 Opus 上下文中，使用 verifier 代理來對已完成的工作進行挑戰，以確保品質。

適用對象

希望透過在軟體工程任務中使用分層模型方法來優化 API 支出或訂閱配額的 Claude Code 開發者。

亮點

  • 成本感知路由：將低投入任務（如符號查找）路由到 Haiku，將中等投入的實作路由到 Sonnet，同時將規劃和安全審查保留在 Opus 中。
  • 獨立驗證：使用全新的上下文驗證子代理，其表現優於自我批判（self-critique）。
  • 優雅降級：使用模型別名和回退鏈，確保在主模型不可用時系統仍能保持功能。
  • 全域安裝：在全域 Claude 配置中進行一次性設定，即可應用於所有專案。
  • 訂閱優化：專門利用 Claude 訂閱中提供的額外 Sonnet 專用配額池。