用途:该技能用于引导用户以交互方式设计并创建一个定时后台自动化。定时自动化的本质是一个后台 sidecar("builtin": "schedule"),按 cron 计划运行,每次运行都会通过 agentapi new-conversation 启动一段全新的智能体对话。技能明确限定:仅用于定时(cron)自动化,不要用它创建 UI sidecar、持续运行的通用命令或守护进程 sidecar,或对话内计时器。
主要能力:技能通过多轮问答收集创建自动化所需的信息。Turn 1 询问计划频率(Hourly、Daily、Weekly 或自定义 cron);Turn 2 根据频率确认具体时间或星期,例如每日几点、每周哪几天及几点,或每小时是否指定分钟偏移;Turn 3 以开放式文本询问任务内容,并帮助将其改写为自包含的提示词;Turn 4 写入 sidecar.json;Turn 5 可选地立即试运行。如果用户在初始请求中已经提供了某些信息,则跳过已答问题。
使用方式:配置文件写入 <configDir>/sidecars/<sidecar-id>/sidecar.json,其中 <configDir> 通常是 ~/.gemini/config,<sidecar-id> 是由任务派生的短横线命名唯一标识。字段包括 builtin、args、restart_policy(定时任务必须为 "always")、display_name、description、agent_permissions 等。cron 表达式为标准五段式,并加上 CRON_TZ=<IANA 时区> 前缀,按用户本地时间运行;时区需为 IANA 名称,不能用缩写或偏移量。args[0] 必须是完整 cron 字符串,本地脚本参数要用绝对路径,提示词前必须加 "--"。写入文件前需先告知用户正在创建哪个自动化,并在完成后告知 display_name 与 sidecar-id,让用户到 Automations 仪表板中手动启用;技能强调不得自行启用或修改 user_config.json。
权限与试运行:技能警告不得臆造工具或权限。只能授予环境中确实存在的 MCP 服务器或已确认存在的命令前缀;禁止使用 command()、read_file()、write_file()、mcp()、read_url(*) 等宽泛通配符。若用户同意试运行,技能会在当前对话中实际执行任务一次,查找相关技能或 MCP 工具,运行实际命令,然后按试运行中真实用到的权限精确更新 agent_permissions,如 command(gh pr list)、read_file(绝对路径)、write_file(绝对路径)、mcp(服务器/工具)、read_url(域名) 或 workspace_uris,并在必要时根据试运行结果完善提示词。
适用场景:需要按固定时间或周期在后台自动执行任务的场景,例如汇总未读邮件、检查开放的拉取请求并列出失败的 CI 检查等。
限制:每次运行都是无记忆的全新对话,因此提示词必须自包含;配置不得放在临时 CitC 工作区中;需用户在仪表板手动启用;环境缺失的工具或认证需在启用前说明。