用途:帮助用户监控 agent-cron 定时任务的执行情况,包括查看任务状态、执行历史、日志、诊断失败并查看聚合统计。
使用前检查:先运行 which agcron 确认 CLI 已安装,未找到则改用 installing-agcron 技能;再运行 agcron status 确认守护进程在运行,未运行则改用 managing-daemon 技能启动。
主要能力与用法:
- 任务状态:agcron jobs list 列出已加载任务;agcron ps 显示运行中任务与队列深度;agcron jobs info <id> 查看单个任务详情(计划、agent、模型、超时、下次运行);agcron watch 打开自动刷新面板(Ctrl+C 退出),agcron watch --once 为一次性快照。
- 执行历史:agcron jobs history <id>、--all、-n 10、--status failed 等,默认显示最近 25 条。
- 日志:agcron logs show <job-id> | tail -50,可按需增至 100 行或查看全量;agcron logs show <job-id> --stderr 看错误;--date YYYY-MM-DD 按日期;agcron logs tail <job-id> 实时流式查看。建议先看 50 行,避免直接输出完整日志。
- 失败诊断:先查历史判断失败模式,再取 stderr,然后对照已知模式(adapter not found、timeout、权限、model not found、无 stderr 的非零退出等)给出诊断;未匹配时建议查看完整 stderr、检查任务文件语法与 frontmatter,或手动运行同一 prompt。
- 统计:agcron stats、agcron stats <job-id>、agcron stats <job-id> -d 30,据成功率、P95 时延与平均时延比值、失败趋势判断健康度并给出通俗评估。
惯例:先展示原始 CLI 输出,再给出对话式解读;仅当环境不支持管道 tail 时手动截取。
限制:资料未提供安装步骤、价格、平台支持范围及具体适配器细节。