# skill-cron-copilot-ops

**Repository Path**: eden2f/skill-cron-copilot-ops

## Basic Information

- **Project Name**: skill-cron-copilot-ops
- **Description**: 通过 AI 助手，用自然语言管理 CronCopilot 定时任务 —— 创建调度、注册脚本、排查故障，一句话搞定。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://www.yuque.com/eden2f
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-04-25
- **Last Updated**: 2026-05-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: cron, devops, task-scheduler, Agent-Skill, ai-assistant

## README

# cron-copilot-ops

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-Compatible-brightgreen)](https://agentskills.io)

> 通过 AI 助手，用自然语言管理 [CronCopilot](https://gitee.com/eden2f/cron-copilot) 定时任务 —— 安装升级、创建调度、注册脚本、排查故障，一句话搞定。

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

---

## 支持的 AI 产品

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

---

## 安装方式

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

**第一步：克隆仓库**

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

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

- **Claude Code**：

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

- **Qoder**：

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

- **Trae**：

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

- **OpenClaw / QClaw / CoClaw**：

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

- **Windsurf**：

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

- **GitHub Copilot / VS Code**：

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

  或

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

- **Cursor**：

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

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

### 方式二：项目级安装

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

```bash
# 在项目根目录
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](https://github.com/eden2f/cron-copilot) · [Gitee](https://gitee.com/eden2f/cron-copilot)
- **Agent Skills 标准**：[https://agentskills.io](https://agentskills.io)

---

## 许可证

本项目基于 [MIT License](LICENSE) 开源。