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）时产生的令牌成本高昂和配额耗尽的问题。通过将常规工作路由到更小、更便宜的模型（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 专用配额池。