用途:farm-out 用于把委派型智能体工作全部改由 CLIProxyAPI 包装器执行,替代内置 Agent 工具、子代理、Workflow 工具以及会话内智能体团队。委派在独立进程中运行,本会话保留自己的认证、Remote Control 和连接器,工作跑在代理模型上。
主要能力:提供 scripts/farm.sh(单任务或扇出)、scripts/farm.sh --workflow <绝对脚本> --args <文件> --out <文件>、scripts/farm-team.sh(命名队友互相通信、返回一个结果)。持久/远程智能体由 agent-spawn 技能负责,本技能不涉及。
使用方式:只有 --tasks 一种任务模式,且始终接收 JSON 数组,每行含 prompt(必填)、kind(或 provider/model)、expect、label、agent。行并行执行;省略 agent 表示该行需要编排。任务文件建议用 jq 生成。示例:S=~/.claude/skills/workflows/skills/farm-out/scripts;jq -n '[{prompt:"…", expect:"/repo/out.md", label:"count", kind:"script", agent:"ds"}]' > /tmp/t.json;bash $S/farm.sh --tasks /tmp/t.json --cwd /repo。workflow 模式必须提供 --out,路径需为绝对路径。长任务不要前台运行,应 setsid nohup 分离后等待产物。--provider claude|codex|gemini 在 --tasks 上可选,在 --workflow 上必填,farm-team.sh 默认 claude。
路由与预算:每行按 kind(script、judgement、review、bulk)经 scripts/lib/route.ts 从 routing.json 选择提供方与固定模型;既无 kind 也无 provider/model 的行会被拒绝(退出码 2)。预算默认 FARM_TASK_BUDGET=4000000、FARM_SESSION_BUDGET=20000000、FARM_TASK_ESTIMATE=750000、FARM_MAX_TURNS=250。
限制与注意:返回结果不等于证据,必须给任务可检查产物并传 --expect,缺失产物或子进程遗留后台任务时运行器以非零退出;不要转发未经验证的委派摘要。每个委派提示自动附加反模拟条款。每个会话只设一个 watcher,不要用 Monitor 或 until 循环唤醒。修改运行器、调试 429 或手写代理调用前应先读 reference.md。大量文件的逐文档抽取应使用 gemini-batch,而非 --tasks 扇出。