cron-copilot-ops

通过 AI 助手，用自然语言管理 CronCopilot 定时任务 —— 安装升级、创建调度、注册脚本、排查故障，一句话搞定。

本项目遵循 Agent Skills 开放标准，为主流 AI 助手提供对 CronCopilot 的完整操作能力，覆盖任务调度、脚本隔离、依赖编排、监控告警、异常自愈，并内置中国法定假期识别。

---

支持的 AI 产品

AI 产品	厂商	兼容性
Claude Code	Anthropic	✅ 完全支持
Qoder	—	✅ 完全支持
Trae	字节跳动	✅ 完全支持
OpenClaw / QClaw / CoClaw	—	✅ 完全支持
Windsurf	Codeium	✅ 完全支持
GitHub Copilot CLI / VS Code Copilot	GitHub	✅ 完全支持
Cursor	Cursor	⚠️ 部分兼容

---

安装方式

方式一：手动安装（推荐）

第一步：克隆仓库

git clone https://gitee.com/eden2f/skill-cron-copilot-ops.git
cd skill-cron-copilot-ops

第二步：复制 Skill 到对应 AI 产品的 skills 目录

• Claude Code：

  cp -r cron-copilot-ops ~/.claude/skills/

• Qoder：

  cp -r cron-copilot-ops ~/.qoder/skills/

• Trae：

  cp -r cron-copilot-ops ~/.trae/skills/

• OpenClaw / QClaw / CoClaw：

  cp -r cron-copilot-ops ~/.openclaw/skills/

• Windsurf：

  cp -r cron-copilot-ops ~/.codeium/windsurf/skills/

• GitHub Copilot / VS Code：

  cp -r cron-copilot-ops ~/.copilot/skills/

  或

  cp -r cron-copilot-ops ~/.agents/skills/

• Cursor：

  Cursor 使用 Rules 系统而非 Skills，但开启 "Include third-party Plugins, Skills, and other configs" 选项后，可识别 ~/.claude/skills/ 目录中的 Skill。建议先安装到 Claude Code 路径：

  cp -r cron-copilot-ops ~/.claude/skills/

方式二：项目级安装

如果只想在特定项目中使用，可将 Skill 目录复制到项目根目录下对应的 .{product}/skills/ 目录中。例如：

# 在项目根目录
mkdir -p .claude/skills
cp -r /path/to/cron-copilot-ops .claude/skills/

---

使用方式

安装完成后，AI 助手会根据对话上下文自动识别并使用此 Skill，无需额外配置。

也可以通过 /cron-copilot-ops 手动触发（部分产品支持）。

示例对话场景：

• "帮我安装并初始化 CronCopilot"
• "升级 CronCopilot 到最新版本"
• "帮我创建一个每天凌晨 2 点执行的备份定时任务"
• "配置一个仅工作日执行的数据报表任务"
• "查看当前定时任务的执行历史和状态"
• "帮我排查为什么定时任务没有按时执行"

---

Skill 功能覆盖

安装此 Skill 后，AI 助手可通过自然语言引导您完成 CronCopilot 的全生命周期操作，无需手动查阅文档：

CronCopilot 安装与升级

场景	AI 助手可执行的操作
首次安装	引导克隆仓库、pip install、croncopilot init 初始化
生产部署升级	执行 pip install --upgrade 并重启服务
开发模式升级	git pull 拉取最新代码并重启
节假日数据更新	更新 chinesecalendar 依赖包
系统服务部署	配置 systemd (Linux) / launchd (macOS) 开机自启

任务调度管理

场景	AI 助手可执行的操作
创建定时任务	支持 cron 表达式、固定间隔、每日/每周/每月等调度类型
中国法定假期识别	5 种节假日模式：跳过假期、仅工作日、仅假日等
任务依赖编排	配置任务执行顺序（A → B → C 依赖链）
优先级与并发控制	设置任务优先级（1-10）和最大并发实例数
查看任务状态	列出所有任务、查看执行历史和统计
手动触发执行	立即运行指定任务

脚本管理

场景	AI 助手可执行的操作
脚本注册	注册脚本并配置分类、作者、描述等元数据
虚拟环境隔离	为脚本配置独立 Python 虚拟环境，避免依赖冲突
脚本查询	列出已注册脚本、查看详细信息

监控告警与异常自愈

场景	AI 助手可执行的操作
告警配置	配置任务失败告警、连续失败告警、性能阈值告警
邮件通知	配置 SMTP 邮件通知通道
系统资源监控	监控 CPU、内存、磁盘使用率并设置告警阈值
自动重试	配置失败自动重试次数
健康检查	执行系统健康检查，诊断问题
故障排查	诊断任务不执行、脚本失败、守护进程异常退出等常见问题

---

项目结构与 Skill 文件说明

skill-cron-copilot-ops/
├── README.md
├── LICENSE
└── cron-copilot-ops/
    ├── SKILL.md
    └── REFERENCE.md

文件	说明
SKILL.md	核心指令文件，覆盖 CronCopilot 的安装升级、CLI 命令速查、任务调度、脚本管理、告警自愈等关键操作指南
REFERENCE.md	详细参考文档，包含完整的 CLI 参数、配置字段、调度表达式、节假日模式、故障排查指南和使用示例

---

相关项目

• CronCopilot — 定时任务管理系统：GitHub · Gitee
• Agent Skills 标准：https://agentskills.io

---

许可证

本项目基于 MIT License 开源。