- name
SKILL.md
스킬 파일은 게시자의 저장소에 그대로 있습니다.
복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add yan-labs/yan-skills --skill skill -a cursor -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add yan-labs/yan-skills --skill skill -a claude-code -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add yan-labs/yan-skills --skill skill -a codex -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add yan-labs/yan-skills --skill skill -a grok -y복사한 메시지를 Grok Bot 채팅에 보냅니다. Bot이 GitHub에서 이 SKILL.md를 가져와 모든 Bot이 공유하는 스킬에 추가합니다.
Install this skill: https://github.com/yan-labs/yan-skills/tree/HEAD/agent-fleet/skill게시자 제공
fleet-go clean --older-than 7d(一周也可写 1w,默认7d且直接执行删除,预览必须加 --dry-run,明细用 --json)按修改时间直接删除本机与已配置 Mini 的旧 runs、报告、巡检记录和已合并且无改动的 fleet worktree;保留运行/排队任务、账本、调遣令、配置/状态类文件(YAML/TOML、config/settings/state/checkpoint/cursor等JSON)、.env*、.keep-data白名单、patrol-brief.md。不回收、不备份。用户只说“清理一下”默认 7 天,直接执行普通清理不先问。报告按时限默认直接删除;证据和备份(路径含 backup/evidence/snapshot/dump,或 SQL、bak、数据库副本等)只列“待确认”,默认按目录/任务聚合到两机合计不超过约50行(路径前缀、文件数、总大小、最新时间、是否被引用);--json仍保留每项的大小、修改时间、任务/项目、文档引用与能否判断无用;未发现引用不等于无用。主线程逐项核实后问用户,同意后才加 --include-backups <路径…> 纳入删除,仍遵守时限及常驻/状态/运行中保护。普通路径仅作用于本机;Mini 的每项同意路径明确写 mini:/绝对路径,不自动映射两机。
!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。claude-sub(executor-*)不经 fleet,额度用完要手动记。fleet-go order show。任务名额分为轻量池(Luna、Gemini/copy/bulk、Haiku、JEV,默认 10)和编码池(其他模型,默认 4),分别排队;只读任务不占名额。FLEET_LIGHT_CAPACITY / FLEET_CODE_CAPACITY 可分别调整,FLEET_SLOT_CAPACITY 则覆盖为全局总名额。
fleet-go new <name> --to openai --auth local --goal "任务" --body task.md,或 fleet openai task.md。默认官方 gpt-6.1-terra,凭据变量 OPENAI_CREDIT_API_KEY 仅放本目录 .env(0600);不在 brief、命令、报告中填 Key。现有 --to gpt / fleet code 仍是 Codex,不自动改路由。
此入口复用 Claude Agent SDK 的本地工具、会话、收件箱、resume 与报告;每个 run 临时启动仅本机可访问的 Anthropic Messages→OpenAI Responses 适配器,官方 Key 只在父进程内发往 https://api.openai.com/v1,SDK 只拿临时本地 token,结束关闭适配器。不强制 fast,不经 Kollab 网关,不使用 Codex API Key 通道。
先在 ChatGPT/API Billing 激活并关联正确 API 组织,Key 必须属于该组织;普通 API 成功不等于赠送额度已到账。赠送额度先用,但耗尽后若有已购买余额仍可能继续扣费,不承诺“只用赠送额度”。是否到账/到期/实扣以平台 Credit grants 和 Usage 为准,不自动充值或更改套餐。官方说明:https://help.openai.com/zh-hans-cn/articles/20001626-api-credits-benefit-for-eligible-chatgpt-subscriptions 。
轻量适配的实现范围与开源参考见 OpenAI桥接说明。
派出后台任务后,派单主会话必须用 CronCreate 挂会话内巡检,计划为 7,37 * * * *,提示词以「【半小时巡检】」开头。已有这条巡检时不重复挂;7 天到期但仍有后台任务时续挂。巡检使用会话内 Cron,不用独立定时任务。
每次触发先检查是否有后台任务在跑:没有就用 CronList 找到这条巡检并 CronDelete;有则在本会话派一个 Luna 巡检子单(--luna --high),brief 放在本机文件 ~/.agent-fleet/patrol-brief.md。巡检检查日志与产物变化,纠正卡住、空转、循环或偏题的任务;判断无望时终止。单个 run 约 2 小时没有新产物,或累计运行约 5 小时时(日志、报告或进度文件仍在增长的按正常推进,不按时长换班),要求执行者写 checkpoint 并结束本轮,再用 fleet-go relaunch 换新 agent,要求读取 checkpoint 接着做。巡检记录追加到当天的 fleet-patrol.md。
巡检结论交回主会话裁定。 巡检单用 run_in_background 派出,完成通知回到派单主会话。巡检只自行处理上面的纠偏、终止和换班。它最终回复的第一段写「需要主会话处理」,列出自己用 fleet 命令解决不了的事,例如缺授权、需要改派执行者或档位、多单争用同一资源、需要用户配合、已终止的单是否重派;每条写明任务名、现象和建议,没有就写「无」。主会话收到通知后必须读取这一段并逐条处理,包括补授权、改派、调整顺序、找用户或重派,不能只看巡检记录。巡检提示里写明本会话负责的任务名,巡检只看这些任务。
CronCreate 示例(可直接复制并按本会话支持的字段调用):
CronCreate(cron="7,37 * * * *", prompt="【半小时巡检】先检查是否有后台任务在跑;没有则用 CronList 找到这条巡检并 CronDelete;有则在本会话按本机 ~/.agent-fleet/patrol-brief.md 派 Luna 巡检子单(--luna --high --on mini,run_in_background),只看本会话负责的任务:<任务名列表>;完成通知回来后,读它的「需要主会话处理」并逐条处理。")
全局规则见 ~/.claude/CLAUDE.md §3.2。
主会话不等用户提醒,自己按时交班,不等手上所有单都结束(用户 2026-11-13)。
何时交班(满足任一条): 本会话已被压缩(compact)过一次;连续派单值守约 4 小时;一个里程碑或一批单验收完;用户提到额度、token 烧得快。
交班提醒定时: 主会话开始派后台单时,和半小时巡检一起挂一条 CronCreate(cron="13 * * * *", prompt="【交班检查】按 agent-fleet「主会话接力」判断是否该交班:满足任一条就立即执行交班步骤;否则不动。")。交班时连同巡检一起删,新会话照样重挂。
交班步骤:
~/.agent-reports/<日期>/session-handoff.md:用户方针与授权原话、在跑/排队的 run 和 runId、会话内定时原文、子代理单和报告路径、已决定不做的事、待拍板的事、新坑。fleet wait 后台命令;fleet-go relaunch --after 排队命令和 caffeinate 这类承载任务的进程不停。<项目>-main-takeover 这类持久定时接班。交班时:有 start_session 就以 use_worktree: true 开一个独立 worktree 的普通会话,不和旧会话共用 checkout。共用 checkout 的侧会话不能 detach 到顶层,归档旧会话会连同仍在运行的新会话和 worktree 一起归档,旧会话只能挂着(2026-11-15 第 11→12 棒)。提示词写「接 <项目> 运维主线程:读交接文件 <路径>,重建会话内定时、改绑持久任务通知、置顶自己并改名「<项目> 运维主线程(第 N 棒)」,再 SendMessage 通知旧会话 <local_ id> 删定时并归档」;没有(定时、巡检等非人工轮次)就用 spawn_task 出一张同样提示词的接班卡片,等用户点开,旧会话期间照常值守。用户说“交接/交班”时立即这样做。notifyOnCompletion 的会话;新主会话(普通会话)接班后 list_scheduled_tasks,对本项目所有 enabled 的和今天跑过的任务逐个 update_scheduled_task(notifyOnCompletion: true);新建持久任务的提示词要求结果写进报告和 .rankup/worklist.md 对应行,通知漏了也能读回。mcp__ccd_session_mgmt__detach_session 把接班会话移到顶层,再用 mcp__ccd_session_mgmt__archive_session 归档自己;若因共用 checkout 被拒绝 detach,就不归档,留到接班会话下一次交班时一起清理(先 ToolSearch 加载),只在最后回复一行说明已归档;不要为了等某个凌晨定时点把旧会话留着,也不问用户要不要归档。交班坑(2026-11-13):
~/b20m1/runner.py),子代理不用在线等,读日志验收即可。派单与巡检经验(2026-11-12~13)
~/.claude/skills/macmini/scripts/mm '<命令>' 在 Mini 执行(mm 不在 PATH,写全路径)。不要以"子代理只能本机跑"为由把任务留在本机。fleet-go relaunch 默认在 Mini 执行;明确指定 --on local --local-reason "理由" 才在本机执行。relaunch 会把 brief.json 记录的 --body 文件重新换进 brief,可能是别的会话 scratchpad 里的旧文件;手改的入口会被盖回,改了入口就新开一单。fleet wait 遇到 ask 只提示并继续等终态。Codex 子线程完成不能当作主任务完成;见 阶段接力与等待。~/.agent-fleet/runs/codex-quota.json 的 usedPercent 超过 FLEET_CODEX_QUOTA_LIMIT,默认 90)。用户说额度够用时,把 FLEET_CODEX_QUOTA_LIMIT 写进两机 agent-fleet .env;闸门在每个排队进程启动时读入,已在排队的单要 stop 后 relaunch 才生效,而且旧进程会挡住同池后面的单(2026-11-14)。relaunch --worktree 不够:先在 brief.md 与 brief.json 的 writes 里都改成自己的 worktree 路径再重派(2026-11-14)。workspace routing discovery failed,巡检单秒失败时主线程自己看 fleet-go status 和进度文件 mtime,不反复重派。统一入口:fleet say <任务> "新指令" 或 fleet-go amend <名字> --say "补充要求"(--restart 只作最后兜底)。
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。 派出后台任务后,确认会话内半小时巡检已挂;规则和 CronCreate 示例见上文「巡检与换班」。
默认在 Mac Mini 执行,路径缺失、同步失败、通道不可用或工具缺失时直接报错,在 Mini 补齐(建 worktree、同步目录)后重派,不自动回退。仅显式 --on local --local-reason "理由" 可在本机执行,理由记录在 brief 偏差和账本;relaunch 同样默认 Mini。Mini 报告用 fleet-go read 查看,--pull 显式拉回。brief 引用的报告输入和正文按现有同步方式传到 Mini。new 和 relaunch --worktree 按 FLEET_MINI_HOME 映射在 Mini 对应仓库创建 worktree。
首次使用前,在派单机设置 FLEET_MINI_HOME(Mini 家目录)和 FLEET_MINI_BIN(Mini 上 fleet 的绝对路径);可选 FLEET_LOCAL_HOME 与 FLEET_MINI_MM。也可在本机 ~/.agent-fleet/mini.json 配置 remote_home、bin、local_home、mm;环境变量优先。未配置或引用路径在 Mini 不存在时直接报错;工作目录不存在时改用 brief 入口仓库,仓库不存在则用 Mini 家目录并说明。显式 --on local --local-reason "理由" 才在本机启动。
brief 引用的文件请写绝对路径;预检只检查绝对文件路径,相对路径和 API 路由不受影响,显式指定 --on mini 时不会回退。
2026-11-15:amend / say 文本里的路径不要以 ~ 开头,派单机会展开成本机家目录,Mini 会报缺少路径;写 Mini 绝对路径。
2026-11-15:relaunch 会用 brief.json 记录的 --body 文件重新替换正文,可能盖回手改的入口;改了入口就新开一单。
2026-11-15:--sol / --luna 只能配 --to gpt;原单是 --to openai 时,换档用 relaunch <名> --to gpt --sol。
派单方写 brief 前先读项目 .rankup/infra/13-dispatch-kit.md 或 .rankup/dispatch.md;项目特有的派单坑写回项目 .rankup,通用的才写进本 Skill。
2026-11-15:只读或复核单只写「仓库:」,不写「可写路径」,也不将共享报告目录作为可写路径,以免与同期任务冲突。
2026-11-15:brief 引用的 /tmp/<名> 等路径必须在 Mini 已存在;先执行 mm 'mkdir -p …'。
2026-11-15:同名 brief 已存在时用 relaunch 或 amend --say,不要重新 new。
2026-11-15:Mini 全局 Skill 可能比 MacBook 旧;派依赖 Skill 脚本的单前核版本,必要时在 Mini 用 npx skills add 同步。
2026-11-15:入口含「未知」或「自己找」时 Terra 检查会拒绝并指出命中片段,需明确入口或使用 --sol。
2026-11-15:只含推送、部署或本地提交的发布推进单无需产生实现提交;续做闸门仍检查明确要求的提交哈希。
2026-11-15:brief 的 PR 合并方式写「按仓库允许的方式」,仓库可能禁止 merge commit。
2026-11-15:MacBook 上可用 fleet wait <完整 runId> 等待 Mini 单完成。
一条 Bash 调用,工具参数 run_in_background:true,命令保持单一前台调用;fleet-go 自身保持前台,完成即通知。正文只写独有内容(背景、要做的事、验收),其余样板自动带上。
# 改代码(允许范围:本地)
fleet-go new fix-card --to gpt --auth local --write /path/to/project --goal "修复卡片布局" <<'BRIEF'
卡片在手机窄屏上会溢出,希望内容能完整读到。可以改卡片和必要的相邻样式,保留其他人的现有改动;共享组件默认样式由主线程另行授权,先完成现有范围内的修复并报告剩余缺口。现有构建通过,窄屏上内容完整并适配视口宽度,就算做完。
BRIEF
# 同仓库独立任务使用独立 worktree
fleet-go new fix-other --to gpt --auth local --write /path/to/project --worktree --goal "修复另一处问题"
# 只读复核(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 --luna --high --auth deploy-prod,readonly-web --goal "部署 <HEAD> 并回读" --body body.md
# 花钱生成(预算可选)
fleet-go new gen-test --to gpt --auth paid,local --goal "..." --body body.md
# 文案
fleet-go new page-copy --to gemini --goal "写 XX 页英文文案,正面表述" --body body.md
review 的只读是 brief 约定:项目文件保持原样,允许联网、运行测试和脚本,只在自己的 mktemp -d 临时目录建删文件;各执行路径不加只读工具名单、沙箱或文件快照失败判定。SDK 使用 bypassPermissions,Codex 使用 danger-full-access,Grok 使用 --always-approve。JEV 只有结构化 API,没有命令执行器。
--to gpt|openai|claude|grok|gemini|jev 必填;GPT 默认 Terra,--sol 选 Sol,--simple 是 Terra 的兼容别名,--luna 选 Luna;--review 默认 Terra,可用 --sol 显式选择 Sol,且不能与 --luna 同用。Luna 与 Gemini 默认 xhigh(Luna 可用 --max,Gemini 可用 --low/--high/--xhigh);Terra/Sol 默认 medium。--low 可降档,--low、--high、--xhigh 与 --max 互斥。Codex 默认不开 fast,必要时显式 --fast。Claude --tier haiku|sonnet|opus,Grok --model/--subagents,Gemini --bulk。其余授权、预算与正文选项沿用。
--deliverables "产物:路径(上限 N KB 或行)" 可多次传入,逐项写入验收段;可省略,lint 不强制要求。
--budget 可选:用户给了预算与重试限制才传入并写进 brief;没给则不写、不设默认值。
需要本地提交时用 --auth local-commit 代替 local:允许在本地分支提交;与 deploy-prod 同传时推送、合入环境分支、流水线发布都已授权(执行者不得因“本块不含推送”停下),单独使用时不推送;验收报告要列提交哈希。可与 readonly-web、paid 组合;与 local 同传时取代 local。只读审查、生产部署仍用各自的授权块。
--make image 叠加图片产物样板,沿用所选执行者:绝对输出目录、逐张编号文件名、尺寸比例、共享风格、纯画面(文字、字母、logo 与水印留空)、受阻时报告已完成部分与缺口、逐文件绝对路径/实际像素/字节数/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,由派用者显式决定执行者;仍有未结束同名任务时拒绝重复派发。改需求就改 --body 文件再 relaunch,新正文自动换进 brief、修订块保留;换不进时报错,不会拿旧 brief 空跑。跨日期重名时把名字换成报错给出的 brief 路径。
本机多模型任务入口:使用 fleet 运行 brief,结束后按实际产物验收。先核对目标模型当前配置、真实 Key 是否存在、工作目录信任边界和任务归属;配置读取用 safe-grep 或经 redact,只看名字、计数与存在状态。
下表是保留的底层入口;新派单主推顶部的 fleet-go new --to ...。
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,使用独立的 TEST 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 限制即可通过(仍须有足够预算)。
使用 streaming-json,cost/turns 为 Grok 自报;保存 stopReason/sessionId/usage。退出码 0 仍可能 cancelled(无头工具批准被取消),非 end_turn 判 fail,无明确最终结论判 suspect。review 使用自动批准避免取消;本机沙箱不生效,只读靠 brief 约定,允许联网、临时脚本和测试,不因文件变化判 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。
Terra 与 Sol 派单前问两句:brief 能否写清具体文件、入口和完成条件?做错能否便宜地重来?两句都是“能”用 Terra,任一句“不能”用 Sol(用户 2026-11-11)。成本、额度、并发或用户点名时可以改派。
fleet haiku|sonnet|opus(订阅附赠的月度 API 额度),需要本应用工具、MCP、Browser pane、ccd_* 或本机登录态时才用 executor-*;用 Agent 工具每次显式传 model。--fast。--to openai(OpenAI API 额度)不用 Sol、不开 fast,偏慢,适合不急的正经编程。失败上报给派用者:verdict 为 fail,结果文件和简报只记录执行者与档位、脱敏原始错误摘要(stderr 末尾、HTTP 状态、结构化错误)、已完成步骤、产物与 dirty 状态。错误分类、后续建议与执行者选择由派用者负责。
下面的顺位表只供派用者自行判断,代码不消费:
派用者决定后,用 fleet-go relaunch <name> --to <产品> [--tier haiku|sonnet|opus] [--simple|--sol|--luna] [--low|--high|--xhigh|--max] [--fast] 沿用 brief、name 与 report 重派。成功任务不产生失败上报。
按顶部五产品速查表派单。Luna 与 Gemini 默认 xhigh(Luna 可用 --max,Gemini 可用 --low/--high 覆盖);Terra/Sol 默认 medium;Codex 默认不开 fast,必要时显式开启。严苛架构或成本收缩、清理速度每秒 1000 行等硬性指标多轮仍达不到时,派 executor-fable 子代理调研方案,再派执行者。
文案遵守 文案语气规范,Gemini 自动注入,brief 给事实清单与允许范围;纯机械改写可用 --no-voice。编码与只读复核见 Codex 编程与 review。范围以本次 brief 的一个目标、授权与验收为准,相关改动可做,无关线索只列出。最终回复约 15 行,长内容写入 REPORT;退出码与实际验收分开记录。
画布文件(.dc.html、css、canvas.json 改动)由 fleet sonnet(难的 fleet opus)写到本地目录;fleet 通道负责本地文件产出,Artifact 上传权限由下述执行者持有。上传由内置 executor-haiku(Agent 工具)用 Artifact 工具按目录逐页发布,便宜且有权限。同一画布的上传一次只派一个 haiku,保证 canvas.json 合并不冲突。画布 brief 带上派单纪律的页面组织和 Design System 规则。
一单只做 brief 指定的一个目标及必要改动,方法由执行者选择;小障碍记入报告「偏差」,先完成授权内可交付部分,再报告授权或必需输入的缺口。完整规则与自动注入的逐字范围句见 行动范围。
简报怎么写:像交代给刚接手的同事,用大白话讲清背景、想要的结果、允许范围、缺口处理和完成条件;按任务需要伸缩,把做法留给执行者。正文补充任务独有的上下文和已知坑,其余复用自动样板,一单只围绕一个目标。完整规则见派单纪律;授权与模板保持一致,本地提交选上面的 local-commit。 配置与环境变量的读取动作统一遵循 密钥输出已知坑,默认使用 safe-grep / redact。
ok 说明进程结果;交付成功还须通过任务验收。空结果、裸 tool-call 控制 token、suspect 或 fail 按实际缺口处理。核对 brief、产物和要求的检查;dirty 和 commits 也可能包含同一工作树里其他人的改动。细节见 README。
启动与跨会话接续、网页 ChatGPT、brief 路径核实及安全边界见 操作细则;brief、报告、复核与总管见派单纪律。
fleet judge state.txt questions.json [--json] 做结构化判断,问题可用 noul、choice 或 score;后两者必须给 criteria。完整格式与示例见 JEV 用法。
包括“清理一下”“清理 N 天/一周之前”“清理日志/报告/截图”。使用本机 fleet 分派 Codex GPT-6.1 Sol、Gemini、Grok 或 JEV 任务,或调用 Kollab 图片/视频/音频/多模态能力时使用;包括用户点名 agent-fleet、Nano Banana、nanobanana、香蕉、便宜模型、多模型并行,用户说“让 Codex 或 GPT-6.1 Sol 做某
---name: agent-fleetdescription: 包括“清理一下”“清理 N 天/一周之前”“清理日志/报告/截图”。使用本机 fleet 分派 Codex GPT-6.1 Sol、Gemini、Grok 或 JEV 任务,或调用 Kollab…---# agent-fleet/skill/SKILL.md개요
包括“清理一下”“清理 N 天/一周之前”“清理日志/报告/截图”。使用本机 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。
FAQ
게시자에게서 agent-fleet/skill/SKILL.md를 다운로드하거나 경로를 복사해 저장소를 엽니다. PlugMCP는 스킬을 목록에 올릴 뿐 파일을 호스팅하지 않습니다.
게시자가 https://github.com/yan-labs/yan-skills에서 관리합니다.
Claude, Cursor, Codex, Grok Build는 게시자의 저장소에서 추가한 SKILL.md를 읽을 수 있습니다. Grok Bot은 채팅에서 스킬의 GitHub 폴더 링크를 보내면 설치합니다.
派单正文写固定字段 动作: 只读 / 改代码 / 本地提交 / 推送 / 部署 / 付费(仅列实际动作,可多选);fleet-go new --action '改代码 / 本地提交' 可自动写入。缺动作行过渡期仅警告。动作决定授权:改代码需 local 或 local-commit;本地提交需 local-commit;推送、部署需 local-commit 和 deploy-prod;付费需 paid。
正文另写 ## 入口,下一行 仓库: /绝对路径;只读只需仓库,其他动作还需 可写路径: /绝对路径。远程访问方式和凭据文件按任务需要自行写明。入口含“未知/自己找”必须显式加 --sol;--no-lint 只豁免样板检查,入口、动作和授权仍须匹配;重派沿用该设置。
先预览再派:fleet-go new ... --dry-run(只打印 brief,命令写 stderr);--no-launch 只写 brief 不派发;fleet-go lint brief.md 检查样板(归类行、REPORT 行、逐字规则句、允许范围小节、密钥字面量)。
Codex app-server 两层续做闸门只针对缺失的硬性产物(文件、报告必需节、要求的提交哈希或读回结果);覆盖未穷尽、补证和低置信度本身不触发续做。JEV 也只判断这些缺项。review 和文档类任务默认不续做;--no-continue 或 FLEET_NO_CONTINUE=1 可关闭,exec 路径同样适用,其他产品不适用。有进展就继续续做,不设次数上限;连续两次无进展停止;amend/steer/relaunch 行为不变。
改方向:用 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 --auth 和 --action 可替换保存的授权与动作;路径冲突时可按提示用 relaunch --after 排队。调整沿用 amend / relaunch 保存的 brief 与任务身份。amend 和 relaunch 显式传 --sol、--simple 或 --luna 会替换并保存旧模型档位;显式传 --low、--high、--xhigh 或 --max 会替换保存的推理档位。同一次命令中的互斥选项仍不能同用;切到 Terra 时若未指定推理档位,会清除 Luna 专用的 xhigh/max。amend 的档位在重启或下次重派生效,运行中插话不会切换当前模型。
看进度:fleet-go status(默认非终态及最近 1 小时,--all 查看全部本地历史;脱离启动的任务带 ⚠;Mini 的单一次 ssh 批量取,取不到时 stderr 提示「Mini 状态未取到:超时/连接失败…」,此时只列本机);仍可用 fleet status --running --json。
账本与打分:每个 run 结束自动往 ~/.agent-fleet/ledger.jsonl 追加一行元数据,Claude 子代理(Agent 工具拉起的,route=claude-sub)由 SubagentStop 钩子同样记账;fleet-go new 可带 --level L1-L4、--type、--for <被复核任务名>,复核结论末尾写 LEDGER: blockers=<n> verdict=<pass|fail|partial>;fleet-go score [--since 日期] 按执行者输出计数。字段、配对、回填见账本与 score。
一个任务一次 Bash 调用;多个独立任务同一条消息里并行发多条 Bash。同一仓库多个写入任务各用 --worktree;同一个 worktree 只有一个写入者。worktree 建在入口「仓库:」上(没有才按 --write 推断,与 cwd 无关),子模块只初始化可写路径所在的那个,默认不拉。合回基础分支并推送后即收尾,清理 worktree 和本地功能分支。合并到环境分支仍在主克隆做。
已有 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.1a、§4.2 提供规则与报告的上下文),调整样板时在这里统一修改。
| 调用托管多模态工具并落盘 |
fleet media models [--source openrouter] [--search text] | 查 Kollab 模型目录 |