pilotfish – Claude Code 的编排策略

它是什么

pilotfish 是一个策略包，为 Claude Code（Anthropic 的 AI 编程助手）添加了多模型编排层。它定义了一组轻量级的“角色代理”（例如，侦察员、机械执行器、安全审查员）和一个调度策略，该策略自动将编码会话的部分内容路由到最具成本效益的模型，同时保持一个中央“主会话”（Opus 系列）负责高级规划和最终判断。

为什么存在

典型的 Claude Code 会话在重复、低风险的工作（搜索、格式化、测试脚手架）上花费大量令牌。pilotfish 将这些有界任务拆分到更便宜的模型（Haiku、Sonnet），并且仅将更昂贵的 Opus 模型用于规划、安全审查和验证，从而在不牺牲监督的情况下降低令牌成本。

它是如何工作的

• 角色 – 预定义的代理文件（~/.claude/agents/*.md），每个都绑定到特定的模型和努力级别（低/中/高）。
• 策略 – 一个 CLAUDE.md 块，根据交互形状（co_discover、explore_then_plan、execute）和任务的难度来决定调用哪个角色。
• 调度流程 – 主会话（Opus）进行编排，可以调用侦察员进行仓库侦察，调用机械执行器进行机械代码生成，调用执行器进行判断密集型实现，以及调用验证器（新的 Opus 上下文）来证伪结果。与安全相关的工作通过只读审查员和中度努力执行器进行。
• 努力级别 – 策略尊重 Claude Code 的 CLAUDE_CODE_EFFORT_LEVEL 覆盖；否则，它会根据角色选择努力级别（例如，scout = 低，plan-verifier = 中，security-reviewer = 高）。

安装选项

1. 插件（macOS / Linux） – 通过 install/PLUGIN-INSTALL.md 进行原生市场安装。将策略添加为基于钩子的插件；需要 Claude Code 2.1.219+ 和 Ubuntu 20.04+/Debian 10+/Alpine 3.19+（对于 Linux）。
2. 传统全局安装 – 克隆一个标记的发布版本（例如，v1.5.0）并使用运行手册运行 Claude Code，该手册将策略文件写入 ~/.claude/。安装程序是幂等的，并在任何更改之前显示合并计划。

操作系统

• 使用提供的 CLI 包装器（/pilotfish）或插件 UI 为会话启用策略。
• 通过 docs/usage.md 调整模型别名、努力阈值，或启用/禁用委派。
• 所有更改都是可逆的；安装程序可以卸载八个角色文件和策略块。

文档与证据

• 包含详细设计（docs/design.md）、模型经济学研究（docs/research.md）和现场报告日志。
• 基准测试（调度制动、自发调度、接力激活、提示压缩、验证器边界）提供了关于委派发生频率及其令牌影响的实证限制。

谁应该使用它

• 依赖 Claude Code 进行大型编码会话并希望降低令牌成本同时保持安全检查的开发人员。
• 需要在 AI 工作流程中内置结构化安全审查和验证步骤的团队。
• 熟悉编辑 Claude Code 配置文件并在 macOS 或 Linux 上管理插件安装的高级用户。

成熟度

• MIT 许可，具有版本化的发布历史记录和变更日志。
• 关于行为兼容性的声明由付费模型运行支持；持续的赞助资金用于进一步的验证。
• 不支持 Windows；Linux 支持是“合同限定”的（已测试但未正式验证）。

---

以上所有信息均直接取自仓库的 README；没有推断额外的功能。