Agent Skills
返回列表
Cron 下次跟进

Cron 下次跟进

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f1b049da/kki20266242。

技能介绍

解决什么具体问题

在配置周期性任务或提醒时,开发者常需要确认“下一次到底什么时候执行”。虽然 cron 表达式定义了规则,但它本身不直接输出人类可读的日期。本技能旨在填补这一空白,将 0 9 * * 1-5 这样的 Cron 字符串转换为明确的未来执行时间点,方便在配置页预览、校验合法性或进行工具箱试算。

核心能力与工作流

技能底层依赖 cron-parser,核心流程分为三步:

  • 解析与校验:调用对应大版本的解析 API(CronExpressionParser.parse 或 parseExpression),拦截非法表达式。
  • 计算时间点:提取未来 N 次执行的 Date 对象,默认获取未来 5 次(支持配置,上限建议 50)。
  • 格式化输出:将结果格式化为 YYYY-MM-DD HH:mm 供 UI 展示。

当输入非法时,技能会捕获异常并返回结构化的 { ok:false, error } 对象,避免直接抛出未捕获错误导致页面崩溃。

适用边界与避坑指南

在使用本技能时,需注意以下技术边界:

  • 与 RRULE 严格区分:本技能仅处理标准 Cron 表达式,若需处理 RRULE 规则,请使用专门的 rrule 技能,切勿混用输入框而不标注格式。
  • 时区敏感:默认使用本地时区。如果业务要求固定时区(如 UTC+8),必须在调用时显式传入,并在文案中写明,防止出现“差 8 小时”的提醒事故。
  • 非业务日历:本工具仅计算 Cron 的数学周期,不包含节假日或调休逻辑,如需排除法定假日,需额外接入中国节假日相关技能。

使用场景

  • 在配置定时提醒后台时,需确认“每工作日 9 点”接下来的 5 次触发时间是否合理。
  • 开发任务调度配置表单时,需在用户输入非法 Cron 表达式时给出红字报错提示。
  • 编写自动化工具箱 Demo 时,需试算某个 Cron 规则的下次跟进时间以便展示效果。

适合人员

  • 前端开发工程师,需要在配置表单中实时校验和预览 Cron 表达式的触发时间。
  • 自动化平台开发者,需要在工具箱中提供 Cron 规则解析试算功能以便用户调试。
  • 运维工程师,需要在部署定时任务前核对 Cron 表达式的未来执行时间点。