Agent Skills
返回列表
代理定时任务体检

代理定时任务体检

AI Agent 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md 的指南,将 @user_15292d5a/yjkj-agent-cron-audit 安装到你的 AI 助手中。

技能介绍

先解决什么问题

定时跑的 AI Agent 任务最麻烦的不是"跑挂了",而是"看起来没挂"。Job 状态返回成功,日志里没有报错,但下游什么也没发生——输出为空、消息重复发送、或者因为上下文太大每次都在超时边缘徘徊。另一种常见情况是同一个任务被调度了两次,甚至三次,互相覆盖结果。

更隐蔽的是重试循环:失败计数一直在涨,每次重启后短暂恢复然后再次失败,没人注意到。还有一种是调度频率过高,任务间隔短于下游系统消费速度,导致积压和重复触发。

agent-cron-audit 就是用来处理这一类问题的。

它怎么工作

这个技能检查四类输入:调度配置、运行历史、模型选择、任务输出。然后按风险分组输出发现:

  • 静默失败:任务正常结束但没有产生有用的下游动作
  • 重复调度:两个以上的活跃 schedule 实际在跑同一个任务
  • 重试循环:反复失败、重启、回退但始终没有恢复
  • 调度过频:间隔短于任务本身或下游消费者能承受的范围
  • 过时自动化:schedule 还活跃,但上游信号或下游接收方已经失效
  • 模型选择风险:模型过强、过弱、或上下文过重,不适合这个循环任务
  • 上下文膨胀:每次循环都拖入过大的上下文、旧历史或完整日志

输出固定六个部分:最优先修复项、Top 5 发现、原始证据(已脱敏)、可复制的验证提示词、暂不建议的操作、相关技能指针。每个发现都带置信度标签(High / Medium / Low),并且在给出任何建议之前先展示证据。

适用边界

只读是核心约束。 这个技能不会编辑、禁用、删除、重启或自动修复任何任务。所有建议都停留在"建议"层面,实际修改需要人工验证后自行执行。

它不做账单计算,不把 token 数量换算成具体金额,不提供仪表盘或导出功能,也不上传日志或调用外部 LLM。如果你要排查的是已知任务的 token 浪费,应该用 waste-audit;如果是部署后的成本/模型变更风险,应该用 agent-cost-eval-kit。

所有检查在本地完成,密钥、API token、聊天 ID、服务器路径都会在证据中被脱敏处理。

使用场景

  • 任务返回成功但下游无动作:逐条核对输出和证据,确认是否静默失败
  • 同一任务有两个活跃调度:比对执行记录,检查是否重复运行
  • 间隔明显短于下游消费周期:确认是否触发过频,并给出证据
  • 重启后失败数继续上升:回放运行历史,定位是否陷入重试循环

适合人员

  • 维护定时 AI 代理的工程师:排查失败不报错且无输出的任务
  • 自动化运营负责人:在改动前核对重复或过频调度的证据
  • 共享 Agent 平台的管理员:对定时任务做只读体检,避免误操作
  • 负责可靠性的工程师:检查重试循环、过时自动化与模型使用是否合适