# Task Time

> 管理 cron 定时任务 — 创建/查看/修改/删除每日、单次或重复定时任务，由后台调度器自动执行

- Skill: `kesepain-ke/task-time` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add kesepain-ke/task-time`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kesepain-ke/task-time/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kesepain-ke (https://skillmd.com/u/kesepain-ke)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kesepain-ke/task-time

---


# 定时任务管理 (Task Time)

管理 cron 定时任务系统。cron 是后台调度器，在指定时间自动执行任务。

## 插件路径

`plugins/task_time/`

## 注册工具

| 工具 | 用途 |
|------|------|
| `task_time_create` | 创建定时任务（daily/once/recurring） |
| `task_time_list` | 列出当前用户的所有定时任务 |
| `task_time_update` | 修改定时任务的时间、命令或类型 |
| `task_time_delete` | 删除指定定时任务 |

## 参数

### task_time_create

| 参数 | 类型 | 必需 | 说明 |
|------|------|------|------|
| `type` | string (enum) | 是 | `daily`（每天执行）/ `once`（执行一次）/ `recurring`（重复执行） |
| `time` | string | 是 | 执行时间，`HH:MM` 格式（如 `09:00`） |
| `command` | string | 是 | 任务命令/prompt，cron 执行时发送给 AI 的消息内容 |

### task_time_list

无参数。

### task_time_update

| 参数 | 类型 | 必需 | 说明 |
|------|------|------|------|
| `task_id` | string | 是 | 要修改的任务 ID |
| `time` | string | 否 | 新的执行时间，`HH:MM` 格式 |
| `command` | string | 否 | 新的任务命令/prompt |
| `type` | string (enum) | 否 | 新的任务类型：`daily` / `once` / `recurring` |

### task_time_delete

| 参数 | 类型 | 必需 | 说明 |
|------|------|------|------|
| `task_id` | string | 是 | 要删除的任务 ID |

## 任务类型说明

| 类型 | 说明 | 示例 |
|------|------|------|
| `daily` | 每天在指定时间执行一次 | 每天早上 9:00 发送 AI 日报 |
| `once` | 指定时间执行一次后自动删除 | 下午 3:00 提醒开会 |
| `recurring` | 重复执行，每天在指定时间执行，直到手动删除 | 每小时检查一次服务器状态 |

## 结果说明

- `create`：返回任务 ID 和创建确认
- `list`：返回所有任务列表（含 ID、类型、时间、命令）
- `update`：返回修改确认
- `delete`：返回删除确认
- 失败：返回 `ERROR:` 前缀的错误信息

## 上下文绑定

- 以创建任务时所属的 `users/<name>/` 身份执行
- 享有该用户的完整对话历史和 system prompt 配置
- 遵循该用户的 `config.json` 工具白名单/黑名单
- 任务结果可通过 `qq_send` / `qq_file` 推送到外部消息平台

## 常见规范

- `command` 是发送给 cron 的 prompt，cron 会以用户消息形式注入对话流
- 尽量用简洁明确的中文描述作为 command
- 创建前告知用户任务详情，获得确认后再创建
- `once` 类型执行一次后自动删除，不需手动清理

## 常见处理办法

- **任务未执行**：检查 cron 调度器是否正常运行（CLI/Web 模式均随主进程启动）
- **时间格式错误**：必须为 `HH:MM` 格式（24 小时制），如 `09:00`、`14:30`
- **任务连续失败**：同一任务连续执行失败 3 次后记录错误，不会无限重试

## 常见教训

- `once` 类型执行后自动删除，如需持久提醒用 `daily` 或 `recurring`
- 定时任务的执行结果取决于当时 AI 的响应，不是命令行脚本
- 修改 `type` 可能改变任务的行为周期，谨慎操作