用途:在队友机器或云端一键部署/更新 agentloop FLEET,用同一份目录覆盖多个仓库,生成本地(crontab)和/或云端(claude routines)调度。配置由脚本生成,不手写。
主要能力:交互式提问(AskUserQuestion 为核心,禁止无人值守运行,被 deny-interactive-unattended 钩子拒绝时应停止并说明需要人工在场);本地由确定性安装器 fleet/setup.ts 生成/对账 deployment.json 与 repos.json,并维护 # agentloop-fleet: 的 crontab 标记块;云端通过 RemoteTrigger 工具按(仓库×技能)创建/更新 routine。安装器幂等,保留手工添加的 skillEnv/env。
使用方式:先做只读事实收集(插件根目录、runner 默认值、系统类型、现有 crontab 块、repos.json、本地克隆、env 文件),再提问 runner、repos+skills、where(Local/Cloud/Both)、cadence+model。本地先 dry-run 再 --apply:bun "$PLUGIN/fleet/setup.ts" --runner <runner> --repos "<slug=skill,skill@cadence;…>" --checkout-base-dir <base> --env-file ~/.agentloop-fleet/env --model <model> --local,确认后加 --local --apply。envFile 由安装器写入(mode 600,从本机 gh 会话派生 GH_TOKEN),绝不覆盖已有文件;若提示需要 CLAUDE_CODE_OAUTH_TOKEN,需人工运行 claude setup-token。云端按规范名 <repo-name> <skill> hourly 创建或更新 routine,cron 最小间隔 1 小时且分钟需错开。
适用场景:多仓库的 issue-sweep、pr-sweep 等定时巡检;本地可做云端沙箱做不到的原生能力(如 Xcode、gradle),可用 promptDir 做范围门控。
限制与注意:被覆盖仓库须先经过 /agentloop:repo-setup;本地验证必须等真实 cron 触发,手动运行是假阳性;macOS 上 cron 读不到钥匙串,需 setup-token 或 launchd;本地 PR 因 GitHub 禁止自审停在待人工合并;安装后 skipped-locked 与信任警告属预期现象;未知云端 routine 无法删除,需人工处理;不要 crontab -r。其余细节暂未提供。