agent-fleet
使用本机 fleet 分派 Codex GPT-6.1 Sol、Gemini、Grok 或 JEV 任务,或调用 Kollab 图片/视频/音频/多模态能力时使用;包括用户点名 agent-fleet、Nano Banana、nanobanana、香蕉、便宜模型、多模型并行,用户说“让 Codex 或 GPT-6.1 Sol 做某事”的编码、调研与 review 派单,以及按全局 CLAUDE.md §2 路由任务。只做单一模型的直接任务且无需 fleet 时不触发;用户明确要直接操作 Codex CLI 原生命令(自选 sandbox、codex review、apply、resume)时用 codex Skill;普通生成图片也可用 imagegen。
yan-labs · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add yan-labs/yan-skills --skill agent-fleet技能说明
name: agent-fleet description: 使用本机 fleet 分派 Codex GPT-6.1 Sol、Gemini、Grok 或 JEV 任务,或调用 Kollab 图片/视频/音频/多模态能力时使用;包括用户点名 agent-fleet、Nano Banana、nanobanana、香蕉、便宜模型、多模型并行,用户说“让 Codex 或 GPT-6.1 Sol 做某事”的编码、调研与 review 派单,以及按全局 CLAUDE.md §2 路由任务。只做单一模型的直接任务且无需 fleet 时不触发;用户明确要直接操作 Codex CLI 原生命令(自选 sandbox、codex review、apply、resume)时用 codex Skill;普通生成图片也可用 imagegen。
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 一屏检查五产品能力、顺位参考和可用性,只显示登录/凭据存在状态,凭据值留在受控存储中。
派单前必读 每次用
/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 +fleet code。 ① 唯一正确写法:一条 Bash 调用,命令只含fleet-go new ...、fleet-go relaunch <name>或fleet <子命令> brief.md ...,工具参数run_in_background: true(可重定向到输出文件)。 ② 补救:发现已经用错,或新会话接手未结束任务,先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'
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沿用,默认已知坑按产品选择。- 需要本地提交时用
--auth local-commit代替local:允许在本地分支提交;与deploy-prod同传时推送、合入环境分支、流水线发布都已授权(执行者不得因“本块不含推送”停下),单独使用时不推送;验收报告要列提交哈希。可与readonly-web、带预算的paid组合;与local同传时取代local。只读审查、生产部署仍用各自的授权块。 --make image叠加图片产物样板,沿用所选执行者:绝对输出目录、逐张编号文件名、尺寸比例、共享风格、纯画面(文字、字母、logo 与水印留空)、受阻时报告已完成部分与缺口、逐文件绝对路径/实际像素/字节数/alpha/方法回报。交付实际生成的图片;占位图、ASCII、纯色块或下载图按缺少生成产物报告。GPT 使用 imagegen 的 Codeximage_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,失败尝试中断后续会话;任务已结束(常见:部分完成交回)时--say直接按修订后的 brief relaunch(整条命令放run_in_background),不必再单独 relaunch;运行中且两者都不可用时会提示,此时才考虑--restart(只停止所选 run,按 runId/brief/--name核验残留,最多等 60 秒、每 0.5 秒轮询,再走relaunch,以 run 身份判断。超时已确认 stopped 且无同一 runId 存活时告警并重新拉起,否则保留修订并报错)。调整沿用amend/relaunch保存的 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/(规则句由rule-sentence.md生成新句,校验兼容全局完整旧句;全局~/.claude/CLAUDE.md§4.1、§4.2 提供规则与报告的上下文),调整样板时在这里统一修改。
本机多模型任务入口:使用 fleet 运行 brief,结束后按实际产物验收。先核对目标模型当前配置、真实 Key 是否存在、工作目录信任边界和任务归属;配置读取用 safe-grep 或经 redact,只看名字、计数与存在状态。
命令速查
下表是保留的底层入口;新派单主推顶部的 fleet-go new --to ...。
| 命令 | 用途 |
|---|---|
fleet copy brief.md | Gemini 文案、翻译 |
fleet grok brief.md | Grok 调研 |
| `fleet grok-cli brief.md [--r |