Schedule

支持编程定时或一次性任务，用户定义任务内容，技能负责按设定时间执行，提高任务自动化和管理效率。

核心功能: 本技能提供中文交互等能力。

核心功能: 本技能提供化工作流场景等能力。

专业版增值服务

能力	免费版	付费版
基础功能	支持	支持
复杂工作流可视化编排	不支持	支持
条件分支与异常重试	不支持	支持
定时触发与事件驱动	不支持	支持
执行日志与审计追踪	不支持	支持
分布式任务调度与负载均衡	不支持	支持

能力矩阵

• Program recurring or one-time tasks
• User defines what to do, skill handles when

零基础入门

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

典型场景

场景	输入	输出
定时任务编程	任务描述和执行时间	cron表达式和调度配置
一次性任务	任务内容和触发时间	定时器设置和执行确认
任务管理	任务ID和操作类型	任务列表和状态更新

不适用于：需要分布式任务调度的企业级工作流引擎

使用指南

1. 确认运行环境满足依赖说明中的要求
2. 根据适用场景选择合适的使用方式
3. 执行操作并检查输出结果
4. 如遇错误，参考错误处理章节

输入定义

参数名	类型	必填	说明
task_desc	string	是	任务描述和执行内容
schedule_type	string	否	调度类型, 可选: cron/once/interval, 默认: cron

结果格式

json

{
  "success": true,
  "data": {
    "overall_grade": "A",
    "total_score": 92,
    "max_score": 100,
    "summary": "处理完成",
    "details": [
      {
        "item": "代码风格",
        "status": "pass",
        "score": 95,
        "comment": "符合规范"
      },
      {
        "item": "安全合规",
        "status": "warn",
        "score": 80,
        "comment": "符合规范"
      }
    ],
    "improvements": [
      {
        "priority": "high",
        "suggestion": "建议优化",
        "expected_gain": "+5分"
      },
      {
        "priority": "medium",
        "suggestion": "建议优化",
        "expected_gain": "+3分"
      }
    ]
  },
  "error": null
}

依赖与配置

运行环境

• 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配置方式:

bash

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

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

故障恢复

错误场景	原因	处理方式
LLM响应超时或无响应	网络延迟或模型负载过高	请求重试；确认Agent平台LLM服务正常
输入内容格式不正确	用户输入不符合skill预期格式	检查输入是否符合skill使用说明中的格式要求，参考示例章节
执行结果与预期不符	指令描述不够明确或上下文不足	提供更详细的指令描述，补充必要的上下文信息
命令执行失败	运行环境不满足要求或权限不足	确认运行环境符合依赖说明中的要求；检查命令权限设置

创新亮点

效率提升量化分析

操作步骤	手动耗时	自动化耗时	时间节约	准确率提升
定时任务设置	1小时	5分钟	55分钟	10%
一次性任务执行	30分钟	3分钟	27分钟	5%
进度跟踪更新	2小时	20分钟	1小时40分钟	8%
团队协作通知	1小时	10分钟	50分钟	7%
自动化报告生成	4小时	30分钟	3小时30分钟	12%

差异化对比

对比维度	本技能	手动操作	Python脚本	专业软件
易用性	高	低	中	高
可视化	高	低	低	高
功能丰富度	高	低	中	高
成本	低	中	中	高
扩展性	高	低	中	高

核心痛点解决

痛点	描述	影响范围	解决方案	量化效果
任务重复性高	重复性任务占用大量时间，效率低下	效率低下，资源浪费	自动化调度，减少人工操作	时间节约20%
任务执行时间不固定	任务执行时间不固定，难以管理	任务管理混乱，进度难以跟踪	定时任务调度，确保任务按时执行	准确率提升15%
任务依赖关系复杂	任务之间存在复杂的依赖关系，难以管理	任务执行出错，影响整体进度	条件分支与异常重试，确保任务正确执行	准确率提升10%

常见问题FAQ

Q1: 如何设置定时任务？

A: 在AI Agent对话中调用本技能，提供任务描述和执行时间参数，即可设置定时任务。

Q2: 一次性任务如何触发？

A: 在AI Agent对话中调用本技能，提供任务内容和触发时间参数，即可触发一次性任务。

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

A: 在AI Agent对话中调用本技能，提供任务ID和操作类型参数，即可查看任务执行日志。

Q4: 如何处理任务执行异常？

A: 在AI Agent对话中调用本技能，提供任务ID和操作类型参数，并设置异常重试次数，即可处理任务执行异常。

Q5: 如何在分布式系统中使用调度技能？

A: 调度技能支持分布式任务调度与负载均衡，可在分布式系统中使用，以实现高效的任务执行。

问题处理指引

错误现象	可能原因	诊断步骤	解决方案
定时任务未执行	网络延迟或模型负载过高	检查网络连接，确认LLM服务正常	请求重试，确认Agent平台LLM服务正常
一次性任务执行失败	运行环境不满足要求或权限不足	确认运行环境符合依赖说明中的要求，检查命令权限设置	确认运行环境符合依赖说明中的要求，检查命令权限设置
任务执行结果与预期不符	指令描述不够明确或上下文不足	提供更详细的指令描述，补充必要的上下文信息	提供更详细的指令描述，补充必要的上下文信息
执行日志缺失	日志文件未正确配置或损坏	检查日志文件配置，确认文件未损坏	重新配置日志文件，确保文件可访问

安全原则

1. 确保API Key安全，避免泄露到版本控制系统。
2. 定时任务设置应避免执行高危操作，如系统重启、文件删除等。
3. 一次性任务执行时间应合理设置，避免长时间占用系统资源。
4. 任务执行日志应定期备份，防止数据丢失。
5. 调度技能应避免在公共网络环境下使用，防止数据泄露。

安全风险防范

风险项	等级	防护措施	验证方法
API密钥泄露	高	通过环境变量配置，禁止硬编码	定期检查代码和配置文件
命令执行风险	高	仅执行白名单命令，避免拼接用户输入	使用沙箱环境测试
网络通信安全	中	使用HTTPS协议，验证SSL证书	定期检查证书有效期
敏感数据暴露	高	输出结果中不包含密钥、令牌等敏感信息	日志脱敏审查
未授权访问	中	限制访问权限，实施认证机制	定期审计访问日志

功能属性

• 自动化执行: 编程定时或一次性任务,用户定做什么技能管何时。Program recurring or one-time tasks。U
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果

异常处理指引

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

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

调度通用排查步骤

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