功能说明: 本技能涵盖 中文交互 等核心能力。

功能说明: 本技能涵盖 化工作流场景 等核心能力。

SkillHub Cron Setup

专业版专属特性

能力	免费版	付费版
基础功能	支持	支持
SkillHub Cron Setup内置定时任务调度	不支持	支持
SkillHub Cron Setup用于创建	不支持	支持
复杂工作流可视化编排	不支持	支持
条件分支与异常重试	不支持	支持
定时触发与事件驱动	不支持	支持

操作步骤

1. 创建一次性提醒（主会话）

skill-platform cron add \
  --name "提醒事项" \
  --at "20m" \
  --session main \
  --system-event "20 分钟后检查日历" \
  --wake now \
  --delete-after-run

2. 创建周期性任务（独立会话）

skill-platform cron add \
  --name "晨间简报" \
  --cron "0 7 * * *" \
  --tz "Asia/Shanghai" \
  --session isolated \
  --message "总结昨晚的邮件和日历事件" \
  --announce \
  --channel telegram \
  --to "+8613800138000"

3. 创建带模型覆盖的深度任务

skill-platform cron add \
  --name "周报分析" \
  --cron "0 9 * * 1" \
  --tz "Asia/Shanghai" \
  --session isolated \
  --message "分析本周项目进展" \
  --model "opus" \
  --thinking high \
  --announce \
  --channel whatsapp \
  --to "+8613800138000"

输入参数

参数名	类型	必填	说明
content	string	否	cron-scheduler-setup处理的内容输入
mode	string	否	处理模式, 可选: json/text/markdown,
max_retries	integer	否	单步最大重试次数, 默认: 2
skip_steps	array	否	跳过的步骤编号(用于断点续传), 默认: []

响应格式

{
  "success": true,
  "data": {
    "final_result": {
      "setup_result": "setup_result_value",
      "setup_metadata": "setup_metadata_value",
      "setup_status": "setup_status_value"
    },
    "execution_log": [
      {
        "step": 1,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 1200,
        "output_summary": "按流程执行"
      },
      {
        "step": 2,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 3500,
        "output_summary": "按流程执行"
      },
      {
        "step": 3,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 2100,
        "output_summary": "按流程执行"
      },
      {
        "step": 4,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 800,
        "output_summary": "按流程执行"
      }
    ],
    "total_duration_ms": 7600,
    "gates_passed": 3,
    "gates_total": 3
  },
  "error": null
}

中间产物模板参考: assets/cron-scheduler-setup_template

运行环境

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux

依赖说明(补充)

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

可用性分类

• 分类: MD+execute()
• 说明: 基于Markdown的AI Skill,

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

常见问题FAQ

Q1: 如何设置任务的执行时间？

A: 使用 Cron 表达式指定任务执行的时间，例如 "0 7 * * *" 表示每天早上7点执行。

Q2: 如果任务执行失败，应该如何处理？

A: 检查任务定义是否正确，确认cron服务运行正常，并查看执行日志以确定失败原因。

Q3: 可以将任务结果发送到特定的聊天频道吗？

A: 可以，通过配置 --channel 参数，可以将任务结果发送到指定的聊天频道。

Q4: 如何查看任务的执行日志？

A: 任务执行日志存储在 $HOME/.jsonl 文件中。

Q5: 定时任务是否会占用大量系统资源？

A: 不会，定时任务设计为轻量级，不会占用大量系统资源。

安全须知事项

风险项	等级	防护措施	验证方法
访问控制	高	限制访问权限	检查用户权限
日志泄露	中	加密日志文件	检查日志加密
配置错误	中	定期审查配置	审查配置文件
权限提升	高	限制执行权限	检查执行权限
网络攻击	高	使用防火墙	检查防火墙规则

差异化分析

场景	效率提升	差异化对比
自动化邮件发送	50%时间节省	相比手动发送，自动化减少了操作时间
数据统计	30%时间节省	自动化统计取代手动收集，提高了效率
聊天机器人更新	40%时间节省	自动更新脚本减少手动干预
工作流程管理	20%时间节省	集成任务调度，简化流程管理
跨部门协作	15%时间节省	自动任务触发，促进跨部门协同

性能评估

操作场景	手动耗时	自动化耗时	效率提升
文件解析与提取	5-10分钟/个	<5秒/个	60-120x
批量文件处理(100个)	8-16小时	<5分钟	96-192x
API调用与响应解析	2-3分钟/次	<1秒/次	120-180x
多接口数据聚合	15-30分钟	<10秒	90-180x
命令执行与结果收集	3-5分钟/次	<2秒/次	90-150x
重复任务批量执行	因任务而异	线性缩减	5-50x
错误排查与修复	10-30分钟	<30秒	20-60x

特色分析

对比维度	定时调度器设置	传统手动方式	通用脚本工具
自动化程度	全流程自动	完全手动	部分自动
错误处理	内置错误恢复	依赖人工经验	基本try-catch
可复用性	参数化配置	一次性脚本	模板化
安全合规	内置安全检查	无安全保障	无安全保障
适用场景	SkillHub Gateway 内置定时任务调度器。用于创建一次性提醒、周期性	通用场景	通用场景

异常处置

针对定时调度器设置使用中可能遇到的常见问题,提供以下排查方案:

错误类型	原因分析	解决方案
API认证失败(401)	API密钥错误或过期	检查密钥配置,重新生成token
接口限流(429)	请求频率超出限制	降低调用频率,启用重试退避策略
响应超时(504)	网络延迟或服务端负载过高	增加超时阈值,检查网络连接
文件不存在	路径错误或文件未创建	检查路径拼写,确认文件已生成
文件格式不支持	扩展名不在支持列表中	转换为支持的格式后重试
权限不足	当前用户无读写权限	检查文件权限,以管理员身份运行
命令执行失败	参数错误或环境依赖缺失	检查命令语法,确认依赖已安装
进程超时	命令执行时间过长	增加超时设置,优化命令参数
网络连接失败	DNS解析失败或防火墙拦截	检查网络配置,确认代理设置

定时调度器设置通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块

错误处理机制

本技能内置完整的错误处理(error handling)流程，确保任务执行过程中的异常情况得到妥善处理。

边界条件处理

• 空输入: 当输入参数为空时，返回提示信息要求用户补充必要参数
• 超长输入: 对超出长度限制的输入进行截断处理
• 边界值: 对极端参数值进行范围校验

降级策略

• 当外部依赖不可用时，使用默认值降级处理，保证基本功能可用
• 网络请求失败时自动重试(retry)，采用指数退避(backoff)策略
• 断线时自动重连(reconnect)，最多重试3次

场景介绍

适用场景

• 定时任务调度与周期性任务管理
• 服务器定时巡检与自动化运维
• 数据定时同步与备份

触发条件

当用户需要设置定时任务、周期性执行某个操作或配置cron表达式时，自动触发本技能。

不适用于

• 实时交互式任务(limitation)
• 需要人工确认的审批流程