用途:在带有 .claude/routines/catalog.json 的仓库中运行 /agentloop:setup-routines,经一次问答即可为该仓库声明的例程完成云端与本地调度配置的对账。该技能只负责仓库自身声明的例程(生产者、QA 扫描、夜间部署、GC 任务等),不负责通用的 issue/pr-sweep 循环。
主要能力:通过 RemoteTrigger 工具按规范名称创建或更新云端例程(含按 runner 错峰的分钟偏移、按触发器设置 git 源、由仓库模板渲染 prompt);可选建立持久本地 cron 任务,使用独立 worktree 或独立克隆,并通过系统 crontab 的标记块管理;对已存在项按规范名称原地更新,未知例程列出交由人工处理(API 无删除);如 catalog 声明 presenceRegister 则执行登记;打印环境前置条件(setup script、Network Access、环境变量)。
使用方式:先收集事实(git config user.name、whoami、uname、现有 crontab 标记块、读取 catalog.json,缺失则停止),加载工具并列出触发器,区分规范命中与遗留项;随后用一次 AskUserQuestion 询问 runner、例程、本地任务形式与模型,全部有默认值;再执行云端 create/update、渲染模板占位符({{RUNNER}}、{{MIN}}、vars),最后输出单条报告。{{MIN}} 由 cksum(runner)%13 的偏移加 minBase 计算。
限制:交互式技能,禁止无人值守运行,被 deny-interactive-unattended 钩子拒绝即应停止;不可静默套用默认值。云端 cron 最小间隔为 1 小时,*/30 会被拒绝,分钟必须错峰。更新为整个 job_config 替换,需完整提交(含原 environment_id 与 events[].data.uuid),不得触碰 mcp_connections。本地写入仅限标记块,禁止 crontab -r。环境类的 setup script、Network Access、环境变量没有 API,只能打印供人工粘贴。触发器级插件字段目前仅通过校验、尚未在服务端持久化。本地循环不合并 PR,受保护分支会停在“PR ready”。无 catalog 时不得臆造例程。其他平台细节、收费与具体可用范围暂未提供。