agent-fleet
把任务写成 brief,交给 fleet-go / fleet 的后台执行者去做;主线程只派单、验收、复盘。角色分工、授权红线、报告七节、复核分档和并发上限在全局 ~/.claude/CLAUDE.md(§2–§4),这里只写怎么做,不复述。
当前调遣令(自动注入,优先于下文所有路由与顺位)
!fleet-go order show || cat ~/.agents/dispatch-order.md || true
调遣令是用户临时发的全局指令(谁停用、谁省着用、谁优先、谁的额度已重置),全局唯一,存在 ~/.agents/dispatch-order.md。与下文路由、顺位冲突时以调遣令为准;fleet-go new / relaunch 会拦下被「停用」的执行者(--override-order "理由" 才放行,理由进 brief 偏差和账本),「省着用」只警告。
- 用户口头新发调遣令,或得知某执行者额度用完、已重置:立即
fleet-go order set <执行者> <优先|正常|省着用|停用> --until <重置时间> --reason "原话与日期"(恢复用fleet-go order clear <执行者>)。只在对话里说或写进项目 memory 都不算,因为别的会话读不到。 - fleet 的 run 因额度类原因失败时会自动记成「停用到重置时间」(原因以「自动:」开头;带「估计」的重置时间拿到准确值后手动改),到点自动恢复。Agent 工具的
executor-*不经 fleet,额度用完要手动记。 - 上面看到的若是命令原文而不是令的内容,说明没注入,先自己跑一次
fleet-go order show。
派单流程
- 选执行者:按下方路由原则。
- 写 brief:先读项目派单手册(
.rankup/infra/13-dispatch-kit.md,没有就.rankup/dispatch.md);正文只写任务独有的背景、要做的事、入口和验收,其余样板由fleet-go new自动补。写法见派单纪律 · Brief。 - 预览:
fleet-go new … --dry-run看拼好的 brief;入口、动作与授权不匹配会在这里被拦下。 - 启动:一条 Bash 调用只放一条
fleet-go new …、fleet-go relaunch <名>或fleet <子命令> …,工具参数run_in_background: true。命令里不加&、nohup、setsid、disown(PreToolUse hookcheck-fleet-launch.py会拦),否则收不到完成通知。工具应返回「Command running in background with ID …」,任务状态是 running 而不是几秒内 completed。多个独立任务在同一条消息里并行发多条 Bash。 - 挂定时:确认本会话已挂半小时巡检和交班检查,见巡检与换班。
- 验收:完成通知回来后读报告「结论」并核对真实产物;fleet 状态 done 只代表进程退出。见验收。
- 复核:按全局 §4.3 的风险分档另起只读复核单(
--review --for <被复核任务名>)。 - 复盘:这一单不顺(没做完、要续做、复核有必修项、启动被拦)就按派单复盘归因并整理规则。
新会话接手未结束任务:先 fleet status --running --json,对每个 run 各开一条 fleet wait <runId>(同样 run_in_background: true)重新挂上完成通知。
路由原则(长期)
Terra 与 Sol 的两问判断、Terra 交回 partial 先续做不改派、发布推进与巡检用 Luna、Gemini 只写文案,规则原文在全局 ~/.claude/CLAUDE.md §2「路由」;下表是对应的命令。用户点名优先;成本、额度、并发满时按工具链换手。
| 任务 | 执行者 | 命令 |
|---|---|---|
| 两问都是“能”:编码、复核、按已知源调研、机械改动、技术文档、数据整理、一般任务 | Codex Terra(medium) | fleet-go new <名> --to gpt |
| 任一问“不能”:自己摸入口、跨系统多步编码、总管、删除数据、新写或大改发布脚本 | Codex Sol,开派即用 | --to gpt --sol |
| 发布、部署推进(跑现成流水线、合并、等 CI、回读、生产实测、更新日志),不写代码 | Luna | --to gpt --luna --high |
| 改部署配置、写部署脚本 | Codex Terra | --to gpt |
| 巡检、监工、定时、核对整理 | Luna,--high 或默认 xhigh,不开 --max |
--to gpt --luna --high |
| 文案、翻译、多语言、校对 | Gemini(自动带文案语气规范,纯机械改写加 --no-voice) |
--to gemini,批量加 --bulk |
| UI、样式、视觉交互、建站设计、3D、游戏内容 | Sonnet;设计稿由 Claude 出,按稿实施可交 Terra | --to claude --tier sonnet;要 Browser pane 用 executor-sonnet |
| 方案、架构、方向未明的综合判断;硬性指标多轮达不到时先出方案 | Fable,只走 Agent 工具 | subagent_type=executor-fable,brief 带“这个代码库是你的,做成什么样你说了算,以后也是你接着维护。” |
| 较难的编程、Sonnet 反复打转 | Opus | --to claude --tier opus |
| 小杂活、摘要、核实、机械替换、取证 | Haiku | --to claude --tier haiku;要 Browser pane/MCP 用 executor-haiku |
| 视频、图片、X 热点与社媒实时检索、成人题材;Codex 不可用时承接编码 | Grok | --to grok,产物样板加 --make image|video,见 Grok CLI |
| 分类、是否、打分、成败校验 | JEV,置信度低于约 0.55 交回 | --to jev 或 fleet judge,见 JEV 用法 |
| 用 OpenAI API 额度做不急的编程 | OpenAI Terra,不用 Sol、不开 fast | --to openai,见 OpenAI API 入口 |
| 登录态浏览器采集(GSC、Semrush 等) | 现成脚本或 opencli adapter | 缺脚本先让 Claude 写脚本再沉淀 |
- Claude 档先走
--to claude(订阅附赠的月度 API 额度,独立于 Claude App 用量);需要本应用工具、MCP、Browser pane、ccd_*或本机登录态才用 Agent 工具的executor-*,每次显式传model。 - Codex 一律不开 fast,需要才显式
--fast。 - 执行者拒绝、不可用或并发满:按工具链换下一顺位,用
fleet-go relaunch <名> --to <产品>沿用 brief 重派;编码不派 Gemini。临时的停用和额度重置只记在调遣令里。 fleet-go team一屏看各产品的能力、顺位和登录状态(只显示凭据是否存在)。
快速派单
# 改代码(同仓库多个写入任务各加 --worktree)
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 --for fix-card --goal "复核 fix-card 的改动" --body review.md
# 发布推进(正文写齐目标、环境、回滚条件和回读清单)
fleet-go new deploy-site --to gpt --luna --high --auth deploy-prod,readonly-web --goal "部署 <HEAD> 并回读" --body body.md
# 文案
fleet-go new page-copy --to gemini --goal "写 XX 页英文文案" --body body.md
- 授权按动作选:改代码
local;要本地提交local-commit;推送和部署local-commit,deploy-prod;只读联网readonly-web;付费paid;只读复核review。 - 正文写
动作:行和## 入口(仓库: /绝对路径,非只读再加可写路径:);brief 引用的文件一律绝对路径。 - 默认在 Mac Mini 执行,路径或工具缺了就在 Mini 补齐后重派,不回退本机;确需本机用
--on local --local-reason "理由"。 - 改方向:
fleet-go amend <名> "补充要求" --say(运行中插话,已结束则按修订后的 brief 重派)。看进度:fleet-go status。读 Mini 上的报告:fleet-go read <名>。
全部参数、授权块、入口与动作字段、relaunch/amend 语义、worktree、续做闸门、名额池、执行位置配置和排障见 fleet-go 派单参考。
巡检与换班
规则在全局 ~/.claude/CLAUDE.md §3.2。派出后台任务后主线程不盯单,只做两件事:
挂会话内巡检(已挂不重复;7 天到期仍有任务就续挂)。把
<任务名列表>换成本会话负责的任务:CronCreate(cron="7,37 * * * *", prompt="【半小时巡检】先检查是否有后台任务在跑;没有则用 CronList 找到这条巡检并 CronDelete;有则在本会话按本机 ~/.agent-fleet/patrol-brief.md 派 Luna 巡检子单(--luna --high --on mini,run_in_background),只看本会话负责的任务:<任务名列表>;完成通知回来后,读它的「需要主会话处理」并逐条处理。")巡检子单回来后,读它最终回复第一段「需要主会话处理」并逐条裁定(补授权、改派、调整顺序、找用户、是否重派),不能只看巡检记录。
主会话自己也按时交班,不等用户提醒:本会话已被压缩过一次、连续派单值守约 4 小时、一批单验收完、或用户提到额度烧得快,满足任一条就交班。巡检的纠偏与换班判据、交班六步和已知坑见巡检与主会话交班。
中途插话
统一入口:fleet say <任务> "新指令" 或 fleet-go amend <名> "补充要求" --say;--restart 只作最后兜底。
| 执行者 | 插话怎么生效 |
|---|---|
gpt(含 --review) |
同一轮 turn/steer;失败降级为中断后 codex exec resume(新一轮,同会话)。steer 被接受不等于立刻停下,已完成的写入撤不回 |
grok |
停掉当前进程,用 sessionId 在同一会话续跑;拿到 sessionId 之前拒绝插话,任务继续 |
claude、gemini、openai |
经收件箱送进运行中的任务 |
jev |
单次请求,无需插话 |
| 网页版 ChatGPT | fleet web say <会话名> "追问" |
Agent 工具的 executor-* |
SendMessage,不属于 fleet |
验收
| verdict | 含义与处理 |
|---|---|
ok |
进程正常结束;仍要按 brief 核对产物和检查 |
partial |
有验收项没做完;fleet-go amend <名> --say 列出缺口续做 |
suspect |
疑似假成功,或要求改动却零改动;核对结果和 diff |
needs-review |
JEV 置信度不足;人工核对 |
fail |
执行失败、空结果或裸 tool-call 控制 token;看脱敏错误摘要后修复或换手 |
stopped |
被中断;检查已完成部分 |
dirty 和 commits 可能包含同一工作树里其他人的改动。失败的 run 只上报事实(执行者与档位、脱敏错误、已完成步骤、产物),错误归类和改派由主线程决定。报告核对、独立复核、失败重派和总管用法见派单纪律;账本与 fleet-go score 见账本。
清理
用户说“清理一下”默认 7 天,直接执行不先问:
fleet-go clean --older-than 7d # 直接删除;预览加 --dry-run,明细加 --json
证据和备份只列「待确认」,逐项核实并问过用户后才用 --include-backups <路径…> 删。保留范围和两机路径写法见操作细则 · 清理。
其他通道
- 底层
fleet短命令(fleet code/copy/grok/haiku/…、status/tail/stop/resume):新派单用fleet-go new,短命令速查见操作细则。 - Codex 编程与 review(档位、app-server 与 exec、阶段接力、review 提示词):codex-coding.md。
- Kollab 图片、视频、音频、3D:先
fleet media list看实时清单,再fleet media run <tool> --model <id> --prompt "…";见多模态用法。 - /design 画布:
--to claude --tier sonnet在本地写画布文件,executor-haiku用 Artifact 工具串行上传;见派单纪律 · /design 画布。
网页版 ChatGPT 通道
少量串行的调研问答用 fleet web start/say/close/list,走订阅额度,用完 close;限制与记忆开关检查见操作细则。
JEV judge
fleet judge state.txt questions.json [--json] 做结构化判断,问题类型 noul、choice、score,后两者必须给 criteria;格式与示例见 JEV 用法。