agent-fleet

让谁做	适合什么	命令示例	派用者顺位参考
gpt	编码、调研、报告、只读复核；本机 Codex GPT-6.1 Sol	fleet-go new fix --to gpt --auth local --goal "修复问题" --body task.md	网关 gpt-sol → Grok
claude	Claude 月度额度任务；默认 sonnet	fleet-go new check --to claude --tier haiku --goal "复核报告" --body task.md	code → 网关 gpt-sol → Grok → Gemini（仅文本）
grok	视频与图片（生成、搜索）、X 平台（热点与实时讨论）、编码、检索调研、成人题材	fleet-go new trend --to grok --goal "整理 X 热点" --body task.md	Claude 顺位下一档 Gemini（仅文本）
gemini	文案、翻译、摘要、批量机械任务（--bulk）	fleet-go new copy --to gemini --goal "写页面文案" --body task.md	—
jev	分类、选择、打分等结构化判断	fleet-go new decide --to jev --goal "按正文判据分类" --body task.md	—

中途插话（所有执行者都能改方向，不要杀掉重派）

统一入口：fleet say <任务> "新指令" 或 fleet-go amend <名字> --say "补充要求"（--restart 只作最后兜底）。

执行者	插话方式	说明
gpt（Codex，非 --review）	同一轮里 turn/steer（每个任务自己的 codex app-server）	失败降级为 SIGINT + codex exec resume（新一轮，同会话），再降级为 --restart；steer 被接受不等于立即停下正在执行的命令，已完成的写入撤不回
gpt --review（只读 exec）	不支持同轮	改方向用 amend --restart
grok	停掉当前进程，用 grok -r <sessionId> 在同一会话续跑（新一轮，保留上下文）	拿到 sessionId 之前拒绝，当前任务继续运行
claude、gemini（网关与 SDK 任务）	经收件箱送入运行中的任务	fleet say 即可
jev	单次请求，无需插话
fleet web（网页版 ChatGPT）	fleet web say <会话名> "追问"
Agent 工具里的 executor-*	SendMessage	不属于 fleet

fleet team / fleet-go team 一屏检查五产品能力、顺位参考和可用性，只显示登录/凭据存在状态，不显示密钥或 token。

派单前必读 每次用 /agent-fleet 派单前、每次 Codex 任务完成后，主线程先跑 node ~/Project/kcsx/macmini/yan-skills/agent-fleet/bin/fleet-archive-sweep.mjs，定期扫掉漏归档线程。只归档 originator=agent_fleet 且已结束、闲置至少 10 分钟的线程；可 --dry-run，可用 thread/unarchive 回滚。运行中的任务仍出现在 Codex APP，结束后归档。 ⓪ 默认用 fleet-go new 派单（见下「快速派单」）：只写任务独有的正文，归类行、REPORT 行、授权覆盖、已知坑、验收、逐字规则句由它自动补全。不要再手写整份 brief、也不要用 python 拼接旧 brief；手写 brief + fleet code 只留给需要完全自定义的少数情形。 ① 唯一正确写法：一条 Bash 调用，命令只含 fleet-go new ... 、fleet-go relaunch <name> 或 fleet <子命令> brief.md ...，工具参数 run_in_background: true（可重定向到输出文件）。 ② 命令中一律禁止：末尾 &、(... &)、> /dev/null 2>&1 &、nohup、setsid、disown、... & sleep、fleet ... && 别的命令 &。 这些写法会让任务脱离工具，没有完成通知，工具任务列表里也看不到。 ③ 补救：发现已经用错，或新会话接手未结束任务，不要杀掉重派；先 fleet status --running --json。 对每个 run 各开一条新的 Bash：fleet wait <runId>，工具参数 run_in_background: true，重新挂上完成通知。 ④ 启动后自检：工具应返回「Command running in background with ID …」；输出文件持续有内容或任务仍是 running，而不是几秒内就 completed。

快速派单（默认写法）

一条 Bash 调用，工具参数 run_in_background:true，命令里不加 &；fleet-go 自身保持前台，完成即通知。正文只写独有内容（背景、要做的事、验收），其余样板自动带上。

# 改代码（本地，不部署）
fleet-go new fix-card --to gpt --auth local --write /path/to/project --goal "修复卡片布局" <<'BRIEF'
只修卡片在窄屏溢出；验收：现有构建通过，窄屏可完整阅读。
BRIEF

# 只读复核（checker）
fleet-go new review-card --to gpt --review --auth review --read /path/to/project --goal "复核 fix-card 的改动" <<'BRIEF'
对照 git diff 与 fix-card 报告，列必修项；结论写在最终回复里。
BRIEF

# 部署生产（授权边界与回滚条件占位由模板补全，正文写具体版本与回读清单）
fleet-go new deploy-site --to gpt --auth deploy-prod,readonly-web --goal "部署 <HEAD> 并回读" --body body.md

# 花钱生成（必须带预算）
fleet-go new gen-test --to gpt --auth paid,local --budget "$1，失败最多重试 1 次" --goal "..." --body body.md

# 文案 / 调研
fleet-go new page-copy --to gemini --goal "写 XX 页英文文案，正面表述" --body body.md

• --to gpt|claude|grok|gemini|jev 必填；--tier haiku|sonnet|opus|fable 仅 Claude，默认 sonnet；--review 用于 GPT/Grok，只读；GPT 可用 --low，Grok 可用 --model <id>、--subagents，Gemini 可用 --bulk。--auth、--write/--read、--forbid、--pitfalls、--budget、--goal、--why、--report 沿用，默认已知坑按产品选择。
• --make image 叠加图片产物样板，不改变执行者：绝对输出目录、逐张编号文件名、尺寸比例、共享风格、No text, no letters, no logos, no watermarks.、做不出如实报告的逃生口、逐文件绝对路径/实际像素/字节数/alpha/方法回报。不得交占位图、ASCII、纯色块或下载图。GPT 使用 imagegen 的 Codex image_gen；Grok 使用内置 image_gen / image_edit，不传 model 参数。
• --make video 仅 Grok，用内置 image_to_video / reference_to_video，不传 model 参数；ZDR/privacy 错误如实报告原因与处理方法，不交占位文件。
• --body body.md 只接受现存文件路径；--body - 显式读取 stdin，也可以省略 --body 使用 heredoc。不存在的路径会明确报错。
• 重新拉起已有任务：fleet-go relaunch <name> [--to <产品>] [--tier <档位>]，沿用唯一同名 brief、--name 和 --report，由派用者显式决定执行者；仍有未结束同名任务时拒绝重复派发。
• 先预览再派：fleet-go new ... --dry-run（只打印 brief，命令写 stderr）；--no-launch 只写 brief 不派发；fleet-go lint brief.md 检查样板（归类行、REPORT 行、逐字规则句、授权/禁止小节、密钥字面量）。
• 改方向：用 fleet-go amend <name> "补充要求"，它给 brief 顶部追加「修订 N」并（--say）尽量发给运行中的任务；Codex 优先同轮 steer，失败尝试中断后续会话；两者不可用时会提示，此时才考虑 --restart（只停止所选 run，按 runId/brief/--name 核验残留，最多等 60 秒、每 0.5 秒轮询，再走 relaunch；不按 cwd 判断。超时已确认 stopped 且无同一 runId 存活时告警并重新拉起，否则保留修订并报错）。不要手工 kill 后重派，也不要用脚本拼接旧 brief。
• 看进度：fleet-go status（默认非终态及最近 1 小时，--all 查看全部本地历史；脱离启动的任务带 ⚠）；仍可用 fleet status --running --json。
• 一个任务一次 Bash 调用；多个独立任务同一条消息里并行发多条 Bash。同一份共享工作树同一时刻只能有一个写入者的任务，别并发。
• 已有 Claude Code 的 PreToolUse hook ~/.claude/hooks/check-fleet-launch.py：命令里带 fleet/fleet-go 派单子命令又带 &、nohup、setsid、disown 会被直接拦下。
• 标准块在 skill/templates/blocks/（规则句取自 ~/.claude/CLAUDE.md §4.1、报告模板取自 §4.2），想调整样板改这里，不要改每份 brief。

本机多模型任务入口：使用 fleet 运行 brief，结束后按实际产物验收。先核对目标模型当前配置、真实 Key 是否存在、工作目录信任边界和任务归属；密钥只看状态，不打印值。

命令速查

下表是保留的底层入口；新派单主推顶部的 fleet-go new --to ...。

命令	用途
fleet copy brief.md	Gemini 文案、翻译
fleet grok brief.md	Grok 调研
fleet grok-cli brief.md [--review] [--model id]	本机 xAI 完整编码 Agent，默认禁止子代理；详见 Grok CLI
fleet web start/say/close/list；兼容 fleet web "问题" [--followup "追问" ...] [--close]	网页版 ChatGPT，少量串行问答
fleet bulk brief.md	Gemini 批量处理
fleet gpt brief.md	托管 GPT 任务
node ~/Project/kcsx/macmini/yan-skills/agent-fleet/bin/fleet-archive-sweep.mjs [--dry-run]	派单前及 Codex 完成后补扫归档
fleet code brief.md [--low] [--cwd dir]	本机 Codex GPT-6.1 Sol：默认入口
fleet code brief.md --review	本机 Codex 只读审查
fleet haiku|sonnet|opus|fable brief.md	Claude 官方端点直连，走订阅附赠的每月 API 额度（ANTHROPIC_CREDIT_API_KEY），不占 Claude App 用量；Claude 侧任务优先走这里
fleet judge state.txt questions.json	JEV 结构化判断
fleet run --model name --prompt "任务"	旧的完整模型入口
fleet run-many --config batch.json	批量任务
fleet status / fleet tail [--follow]	看任务和日志
fleet say latest "消息"	向运行中的任务插话（Codex 优先同轮 steer，降级为中断后续会话；网关 streaming input，Grok sessionId 续跑）
fleet stop latest / fleet resume latest	收尾或续跑
fleet list-models / fleet help	看配置或用法
fleet media list	看 Kollab 当前托管的图片、视频、音频、视觉工具与必填参数
fleet media run <tool> --model <id> --prompt "..." [--input-json '{}'] [--out dir]	调用托管多模态工具并落盘
fleet media models [--source openrouter] [--search text]	查 Kollab 模型目录

brief 若是现存文件路径就读取内容，否则作为任务文本。短命令和 run 默认当前目录、不限轮数、安静写日志；--verbose 输出进度。--cwd、--max-turns、--system-prompt 等可显式指定。旧的 agent-fleet run ... 写法仍可用。完整结果在 ~/.agent-fleet/runs/*.result.md，过程在同名 .log；stdout 默认只给简报。

多模态认证优先用 KOLLAB_API_KEY 或 KOLLAB_STANDALONE_API_KEY（kollab api-key create 获取），其次用进程级 KOLLAB_API_TOKEN 或 kollab login 会话；TEST 必须显式设置 KOLLAB_API_URL，不要复用生产 profile。先运行 fleet media list 看实时支持清单和模型 id，再用 fleet media run generate_image --model <id> --prompt "一只猫"；默认文件写入当前目录 fleet-media/。其他工具按清单传 --input-json 的必填字段，详见 多模态用法。普通配图也可用 imagegen。

models.config.json 的可选字段 maxOutputTokens 必须是正整数，限制该模型每次请求的最大输出 token 数；fleet 将它传为 CLAUDE_CODE_MAX_OUTPUT_TOKENS，未配置则沿用默认值。Kollab 网关条目统一设为 16000。 Kollab 网关 402 会话预算：本小时预算按首次请求时的余额定死，充值后要到下一个整点（UTC）才放开；期间用 maxOutputTokens 限制即可通过（仍须有足够预算）。

Grok CLI 收尾与续跑

使用 streaming-json，cost/turns 为 Grok 自报；保存 stopReason/sessionId/usage。退出码 0 仍可能 cancelled（无头工具批准被取消），非 end_turn 判 fail，无明确最终结论判 suspect。review 使用自动批准避免取消；本机沙箱不生效，只读靠提示与事后文件快照，发现改动列路径并判 suspect。fleet say / fleet-go amend --say 停当前 Grok 进程并以 sessionId 续会话，fleet resume 同理，沿用 name/report。代理 HTTPS_PROXY/HTTP_PROXY/ALL_PROXY 及小写原样透传，Rust 不认 NODE_USE_ENV_PROXY；详见 Grok CLI。

失败上报与派用者顺位参考

失败上报给派用者：verdict 为 fail，结果文件和简报只记录执行者与档位、脱敏原始错误摘要（stderr 末尾、HTTP 状态、结构化错误）、已完成步骤、产物与 dirty 状态。fleet 不分类错误、不提供建议、不更换执行者。

下面的顺位表只供派用者自行判断，代码不消费：

• Claude 额度档：claude → code → kollab-gateway-gpt-sol → grok → gemini（Gemini 仅文本）。
• GPT 档：code → kollab-gateway-gpt-sol → grok；GPT 档含本机 Codex 与网关 gpt-sol 两跳。

派用者决定后，用 fleet-go relaunch <name> --to <产品> [--tier haiku|sonnet|opus|fable] 沿用同份 brief、--name 与 --report 重派。切换至网关 GPT 用底层 fleet gpt brief.md --name <name> --report <report>。Gemini 静态拒绝编码、UI 或带 --expect-changes 的任务；这是产品边界检查。成功任务不产生失败上报。

产品与任务边界

按顶部五产品速查表派单。GPT 主力负责编码，Grok 可做备选与复核；文案、翻译、摘要交 Gemini，批量机械任务用 --bulk。Claude 用月度 API 额度，默认 sonnet；JEV 只做结构化判断，不生成自由文本。底层网关 GPT 与 DeepSeek、DeepSeek/Kimi 直连条目保留，可用 fleet list-models 核对。

文案遵守 文案语气规范，Gemini 自动注入，brief 给事实清单与禁止项；纯机械改写可用 --no-voice。编码与只读复核见 Codex 编程与 review。范围以本次 brief 的一个目标、授权与验收为准，相关改动可做，无关线索只列出。最终回复约 15 行，长内容写入 REPORT；退出码与实际验收分开记录。

/design 画布：设计与上传分工

画布文件（.dc.html、css、canvas.json 改动）由 fleet sonnet（难的 fleet opus）写到本地目录；fleet 通道没有本应用的 Artifact 工具，不能上传。上传由内置 executor-haiku（Agent 工具）用 Artifact 工具按目录逐页发布，便宜且有权限。同一画布的上传一次只派一个 haiku，保证 canvas.json 合并不冲突。画布 brief 带上全局 CLAUDE.md §5.8 的页面组织和 Design System 规则。

行动范围

一单只做 brief 指定的一个目标及必要改动，方法由执行者选择；小障碍记入报告「偏差」，超出授权或缺少交付必需输入时如实停止。完整规则与自动注入的逐字范围句见 行动范围。

简报与验收

verdict	含义与处理
ok	正常结束；按任务核对产物和测试
partial	到轮数上限但已有改动；验收现有产物或 resume
suspect	疑似假成功或要求改动却零改动；核对结果和 diff
needs-review	JEV 置信度不足；人工核对
fail	执行失败、空结果或裸控制 token；看错误后修复
stopped	已收尾中断；检查已完成部分

ok 只说明进程结果，不能代替任务验收；空结果、裸 tool-call 控制 token、suspect 或 fail 都不能算成功。核对 brief、产物和要求的检查；dirty 和 commits 也可能包含同一工作树里其他人的改动。细节见 README。

详细派单规则

启动与跨会话接续、网页 ChatGPT、brief 路径核实及安全边界见 操作细则。

JEV judge

fleet judge state.txt questions.json [--json] 做结构化判断，问题可用 noul、choice 或 score；后两者必须给 criteria。完整格式与示例见 JEV 用法。