什么是 Cron Doctor？

Cron Doctor 是专为 Openclaw Skills 设计的专业诊断实用程序，旨在处理计划任务管理的复杂性。它充当开发者与系统 crontab 之间的智能层，提供对各种操作系统中执行日志和环境配置的深度可见性。通过将此工具集成到您的 Openclaw Skills 工作流中，您可以自动识别那些通常在成为关键基础设施问题之前被忽视的静默故障。它提供了一种结构化的错误分类方法，确保开发者减少抓取日志的时间，将更多时间用于构建功能。

下载入口:https://github.com/openclaw/skills/tree/main/skills/suryast/cron-doctor

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Cron Doctor 应用场景

• 识别高可用服务器环境中的静默 cron 故障。
• 调试交互式和非交互式 shell 之间差异导致的权限和路径问题。
• 监控关键数据管道计划和自动备份脚本。
• 使用 Openclaw Skills 为 DevOps 审计跟踪生成标准化的健康报告。
• 在系统更新或配置更改后快速分类多个作业故障。

1. 代理扫描用户和系统级 crontab，以盘点当前所有计划任务。
2. 从系统特定位置获取最近的执行日志，例如 Linux 上的 /var/log/syslog 或 macOS 上的 log show。
3. 解析日志以识别特定的错误模式，如退出代码、权限拒绝或超时。
4. 根据作业的功能和影响，为每个故障分配优先级：关键、高、中或低。
5. 生成 Markdown 格式的健康报告并保存到工作区，供利益相关者查看。
6. 该工具针对每个识别出的问题提供可操作的修复建议，例如路径调整或权限更改。

Cron Doctor 配置指南

要部署 Cron Doctor，请确保您的环境支持 Openclaw Skills，并为代理提供读取日志和 crontab 所需的系统权限。您可以使用以下命令验证本地 cron 环境：

# 检查 cron 守护进程是否处于活动状态
systemctl status cron # Linux
launchctl list | grep cron # macOS

# 列出当前 crontab 条目
crontab -l

技能激活后，您可以通过要求代理诊断您的 cron 作业来触发健康检查。

Cron Doctor 数据架构与分类体系

该技能生成结构化的诊断数据并将报告保存到本地文件系统。这允许 Openclaw Skills 维护系统健康状况的历史记录。

name: cron-doctor
version: 1.1.0
author: Polycat
tags: [cron, monitoring, diagnosis]
license: MIT
platform: universal
description: >
  Diagnose and triage cron job failures. Checks job states, identifies error
  patterns, prioritizes by criticality, generates health reports. Triggers on: cron
  failures, job health check, scheduled task errors, cron diagnosis, job not running,
  backup failed.

Compatible with Claude Code, Codex CLI, Cursor, Windsurf, and any SKILL.md-compatible agent.

Cron Doctor

Diagnose and triage cron job failures.

Usage

When asked to check cron health or diagnose failures:

1. List All Jobs

# List user's crontab
crontab -l

# List system crontabs
sudo cat /etc/crontab
ls -la /etc/cron.d/

2. Check Recent Execution

# Check cron logs (location varies by system)
# Debian/Ubuntu:
grep CRON /var/log/syslog | tail -50

# RHEL/CentOS:
tail -50 /var/log/cron

# macOS:
log show --predicate 'process == "cron"' --last 1h

# Check for specific job output
grep "your_job_name" /var/log/syslog | tail -20

3. Identify Problems

Error patterns to watch:

• "command not found" — Missing executable or PATH issue
• "Permission denied" — File/directory permissions wrong
• "No such file or directory" — Script path incorrect
• "timeout" — Job took too long
• "ECONNREFUSED" — Network/service down
• "rate limit" — API throttling
• Missing output — Job may not be running at all

4. Triage Priority

5. Generate Report

Write to ~/workspace/reports/cron-health-YYYY-MM-DD.md:

# Cron Health Report - [DATE]

## Summary
- ? Healthy: X jobs
- ?? Warning: X jobs  
- ? Failed: X jobs

## Failed Jobs

### [Job Name]
- **Error:** [message]
- **Last Success:** [date]
- **Priority:** [level]
- **Fix:** [suggested action]

## Recommendations
1. [Action item]
2. [Action item]

6. Common Fixes

7. Debugging Tips

# Test cron environment (cron has minimal PATH)
env -i /bin/sh -c 'echo $PATH'

# Verify script runs manually
/path/to/your/script.sh

# Check if cron daemon is running
systemctl status cron   # Linux
launchctl list | grep cron  # macOS

Escalation

If 3+ critical jobs failed, alert the user immediately.

Verification Gates

Before claiming diagnosis complete:

• All failed jobs listed — none skipped or ignored
• Priority assigned — based on impact, not just recency
• Fix suggested — actionable next step for each failure
• Report written — to ~/workspace/reports/cron-health-YYYY-MM-DD.md
• Critical failures escalated — 3+ critical = alert user