agent-scheduler

name	agent-scheduler
description	智能体自动触发调度（三省六部治理框架）：cron 定时触发、事件驱动触发、消息匹配触发。当需要配置子智能体的自动执行计划时使用此技能。
tools	["spawn_agent","cron"]
metadata	{"category":"operations","emoji":"⏰","tree_id":"subagents/spawn_agent","tree_group":"subagents","min_tier":"task_write","intent_priority":15,"intent_keywords":{"zh":["智能体定时","智能体调度","定时触发","事件驱动","消息匹配","周期执行","自动运行","cron表达式","智能体自动化","触发器"],"en":["agent scheduler","scheduled execution","event trigger","cron trigger","message match","automatic dispatch"]},"scene_hint":"配置智能体自动触发用此→普通定时任务用scheduled-tasks→人工立刻触发一次用sessions"}

智能体自动触发调度技能

三种触发类型

1. Cron 定时触发

在蓝图 YAML 中定义 cron 表达式，系统自动创建定时任务。

triggers:
  - type: cron
    schedule: "0 9 * * 1"     # 每周一 09:00
    task: "生成本周竞品分析报告"

触发链路:

cron 到时 → RunIsolatedAgentSession → 智能体调用 spawn_agent → 蓝图实例化

零改动 cron 系统 — 使用 agentTurn Kind 让隔离会话自动调用 spawn_agent 工具。

2. 事件驱动触发

订阅 InterAgentBus 上的特定主题，收到匹配事件时自动启动。

triggers:
  - type: event
    source: "task.completed"    # 订阅主题

适用: 上游智能体完成后自动触发下游智能体。

3. 消息匹配触发

用户消息中包含特定关键词时自动匹配并启动对应蓝图。

triggers:
  - type: message_match
    pattern: "竞品分析"          # 匹配模式

适用: 用户快捷触发（"帮我做竞品分析" → 自动启动竞品分析蓝图）。

常用 Cron 表达式

表达式	含义
0 9 * * *	每天 09:00
0 9 * * 1	每周一 09:00
0 */2 * * *	每 2 小时
0 9 1 * *	每月 1 日 09:00
0 18 * * 5	每周五 18:00

管理操作

注册触发器

来源保存时自动注册所有触发器:

RegisterSourceTriggers(source) → AgentScheduler

注销触发器

来源删除时自动注销:

UnregisterAgentTriggers(sourceID) → AgentScheduler

查看定时任务

crabclaw cron list                   # 查看全部 cron (含蓝图触发的)

蓝图触发的 cron job ID 格式: blueprint:{blueprintID}:{triggerIndex}

与 cron 技能的关系

功能	cron 技能	agent-scheduler 技能
手动创建 cron	✅	❌
蓝图自动 cron	❌	✅
event 触发	❌	✅
message_match	❌	✅
cron 列表/管理	✅	通过 cron 技能