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

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

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"

输入参数

响应格式

{
  "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

依赖说明(补充)

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: 不会，定时任务设计为轻量级，不会占用大量系统资源。

安全须知事项

差异化分析

性能评估

特色分析

异常处置

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

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

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

错误处理机制

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

边界条件处理

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

降级策略

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

场景介绍

适用场景

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

触发条件

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

不适用于

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