Cron表达式助手
这个skill帮助用户创建、验证和展示cron表达式。它提供交互式cron表达式创建、语法验证、以及展示最近10个符合cron表达式的时间点。
核心功能
- 创建cron表达式 - 通过交互式问答帮助用户构建cron表达式
- 验证cron语法 - 检查cron表达式的语法正确性
- 展示执行时间 - 显示cron表达式最近10次执行时间
- 解释cron表达式 - 用自然语言解释cron表达式的含义
使用方法
1. 创建cron表达式
使用交互式问答模式创建cron表达式：
python scripts/create_cron.py --interactive
或者直接指定参数：
python scripts/create_cron.py --minute "*/5" --hour "9-17" --day "*" --month "*" --weekday "1-5"
2. 验证和展示cron表达式
验证cron表达式并展示最近10次执行时间：
python scripts/show_cron.py "*/5 9-17 * * 1-5"
指定显示数量：
python scripts/show_cron.py "0 0 * * *" --count 20
3. 解释cron表达式
用自然语言解释cron表达式的含义：
python scripts/explain_cron.py "0 0 * * 0"
查看所有示例：
python scripts/explain_cron.py --examples
4. 在OpenClaw中直接使用
你也可以在OpenClaw会话中直接运行这些命令：
exec python scripts/create_cron.py --interactive
exec python scripts/show_cron.py "0 9 * * 1-5"
exec python scripts/explain_cron.py "*/5 * * * *"
Cron表达式格式
标准cron表达式包含5个字段，用空格分隔：
分钟 小时 日 月 星期
字段取值范围：
- 分钟：0-59
- 小时：0-23
- 日：1-31
- 月：1-12 或 JAN-DEC
- 星期：0-6 或 SUN-SAT（0和7都表示周日）
特殊字符：
*- 任何值,- 值列表分隔符（例如：1,3,5）-- 范围（例如：1-5）/- 步长（例如：*/5每5个单位）?- 仅在日和星期字段使用，表示"无特定值"
示例
- 每天午夜执行：
0 0 * * * - 工作日每5分钟执行：
*/5 9-17 * * 1-5 - 每月1号上午9点执行：
0 9 1 * * - 每周日午夜执行：
0 0 * * 0
脚本说明
create_cron.py
交互式创建cron表达式。通过问答方式收集每个字段的值，生成完整的cron表达式。
show_cron.py
验证cron表达式并展示最近10次执行时间。如果表达式无效，会显示错误信息。
explain_cron.py
用自然语言解释cron表达式的含义，帮助用户理解表达式的执行计划。
注意事项
- 日和星期字段有冲突时，cron解析器通常只使用其中一个
- 月份名称（JAN-DEC）和星期名称（SUN-SAT）不区分大小写
- 使用
?字符可以避免日和星期字段的冲突 - 时区基于系统时区，展示的时间会转换为用户本地时间
常见用例
- 设置定时任务
- 验证cron表达式语法
- 理解现有cron表达式的执行计划
- 调试定时任务调度问题