@workclaw/openclaw-workclaw 1.0.0

package/skills/openclaw-workclaw-cron/SKILL.md

@@ -0,0 +1,458 @@
+---
+name: openclaw-workclaw-cron
+description: "智小途定时提醒工具集。当涉及提醒/定时任务时使用。"
+metadata:
+openclaw:
+emoji: "⏰"
+always: true
+---
+
+# ⏰ 智小途定时提醒工具集
+
+## ⚠️ 强制规则
+
+**当用户提到「提醒」「闹钟」「定时」「X分钟/小时后」「每天X点」「叫我」等任何涉及延时或定时的请求时，你必须调用相应的工具，绝对不能只用自然语言回复说"好的，我会提醒你"！**
+
+你没有内存或后台线程，口头承诺"到时候提醒"是无效的——只有调用工具才能真正注册定时任务。
+
+**🔒 参数强制规则**：
+- ❌ **严禁**将 `kind: "cron"` 转换为 `--at` 参数
+- ✅ **必须**保持 `kind: "cron"` 不变
+- ❌ **严禁**将 cron 表达式转换为绝对时间（--at）
+- ✅ **必须**使用 cron 表达式格式（--cron）
+- ✅ **必须**使用 `--session isolated + --message`（agentTurn），**禁止**使用 `--system-event`
+- ✅ **必须**使用 `--channel "openclaw-workclaw"`
+
+***
+
+## 工具列表
+
+### 参数生成工具
+
+| 工具                                     | 说明       | 必填参数                       |
+| -------------------------------------- | -------- | -------------------------- |
+| `openclaw-workclaw-cron-add-params`    | 生成创建提醒参数 | `time`, `name`, `message` |
+| `openclaw-workclaw-cron-remove-params`| 生成删除提醒参数 | `jobId`                    |
+| `openclaw-workclaw-cron-update-params`| 生成修改提醒参数 | `jobId`, `time`, `name`, `message` |
+| `openclaw-workclaw-cron-enable-params`| 生成启用提醒参数 | `jobId`                    |
+| `openclaw-workclaw-cron-disable-params`| 生成禁用提醒参数 | `jobId`                    |
+
+### 后端同步工具
+
+| 工具                                   | 说明        | 必填参数                              |
+| ------------------------------------- | --------- | --------------------------------- |
+| `openclaw-workclaw-cron-add-sync`      | 同步创建提醒到后端 | `jobId`, `name`, `kind`, `message` |
+| `openclaw-workclaw-cron-remove-sync`   | 同步删除提醒到后端 | `jobId`                         |
+| `openclaw-workclaw-cron-update-sync`   | 同步修改提醒到后端 | `jobId`, `name`, `kind`, `message` |
+| `openclaw-workclaw-cron-enable-sync`   | 同步启用提醒到后端 | `jobId`                         |
+| `openclaw-workclaw-cron-disable-sync`  | 同步禁用提醒到后端 | `jobId`                         |
+
+### 通知工具
+
+| 工具                                    | 说明        | 必填参数               |
+| ------------------------------------- | --------- | ------------------ |
+| `openclaw-workclaw-cron-notify-sync`   | 任务触发时通知后端 | `jobId`, `message` |
+
+***
+
+## 1. 创建提醒
+
+### 📋 工作流程
+
+1. 调用 `openclaw-workclaw-cron-add-params` 获取 cronParams 参数
+2. 使用返回的 `cronParams` 调用 OpenClaw 的 cron 工具
+3. **从 cron 工具返回值中提取 jobId**（返回格式：{"success": true, "jobId": "xxx"}）
+4. 调用 `openclaw-workclaw-cron-add-sync` 同步到后端
+
+### 🔧 add-params 工具参数
+
+| 参数 | 说明 | 示例 |
+|------|------|------|
+| `time` | 时间描述，支持相对时间（5m、1h）和 cron 表达式（0 8 * * *） | `"5m"` / `"0 8 * * *"` |
+| `name` | 任务名称 | `"喝水提醒"` |
+| `message` | 提醒内容 | `"该喝水了"` |
+
+### ⏰ 时间格式
+
+**相对时间**：
+- `5m` - 5分钟后
+- `1h` - 1小时后
+- `1h30m` - 1.5小时后
+- `2d` - 2天后
+
+**注意：提醒时间不能少于 2 分钟**
+
+**cron 表达式**：
+- `0 8 * * *` - 每天早上8点
+- `0 22 * * *` - 每天晚上10点
+- `0 9 * * 1-5` - 工作日早上9点
+
+### 🔍 OpenClaw cron 工具返回值格式（重要！）
+
+执行成功后会返回这样的 JSON：
+```json
+{ "success": true, "jobId": "7382945612345", "error": null }
+```
+
+**你必须从这个返回值中提取 `jobId` 字段的值**（如 `"7382945612345"`）。
+
+⚠️ **常见错误**：
+- ❌ 把 cron 表达式（如 `"0 8 * * *"`）当作 jobId
+- ❌ 把任务名称（name）当作 jobId
+- ❌ 编造一个不存在的 jobId
+
+### 🔧 add-sync 工具参数
+
+| 参数 | 说明 | 示例 |
+|------|------|------|
+| `jobId` | ⛔ **必须从 OpenClaw cron 工具返回值中提取**。格式：{"success": true, "jobId": "123456"} | `"7382945612345"` |
+| `name` | 任务名称，与 add-params 中传入的 name 一致 | `"喝水提醒"` |
+| `kind` | 任务类型 | `"cron"` |
+| `expr` | Cron 表达式 | `"0 8 * * *"` |
+| `message` | 提醒消息，与 add-params 中传入的 message 一致 | `"该喝水了"` |
+
+### 📝 创建提醒示例
+
+⚠️ **注意**：必须使用 `kind: "cron"` 和 cron 表达式格式（--cron），**严禁**转换为 `--at` 参数！
+
+```
+用户："5分钟后提醒我喝水"
+
+步骤1：调用 add-params
+调用：openclaw-workclaw-cron-add-params({ time: "5m", name: "喝水提醒", message: "该喝水了" })
+返回：
+{
+  cronParams: {
+    action: "add",
+    job: {
+      name: "喝水提醒",
+      schedule: { kind: "cron", expr: "2026-03-31T15:48:56.000+08:00", tz: "Asia/Shanghai" },
+      sessionTarget: "isolated",
+      wakeMode: "now",
+      deleteAfterRun: true,
+      payload: { kind: "agentTurn", message: "该喝水了" },
+      delivery: { mode: "announce", channel: "openclaw-workclaw" }
+    }
+  },
+  meta: {
+    accountId: "<accountId>",
+    name: "喝水提醒",
+    kind: "cron",
+    expr: "2026-03-31T15:48:56.000+08:00",
+    message: "该喝水了"
+  },
+  summary: "⏰ 提醒已生成: \"喝水提醒\" (5m)"
+}
+
+步骤2：执行 CLI 命令（必须使用 --cron 参数，**严禁**使用 --at）
+调用：openclaw cron add --name "喝水提醒" --cron "56 48 15 31 3 *" --session isolated --message "该喝水了" --channel "openclaw-workclaw" --delete-after-run
+返回：{"success": true, "jobId": "7382945612345", "error": null}
+
+步骤3：从命令返回值中提取 jobId，调用后端同步
+调用：openclaw-workclaw-cron-add-sync({
+  jobId: "7382945612345",  // ← 从上一步返回值中提取 jobId 字段
+  name: meta.name,
+  kind: meta.kind,
+  expr: meta.expr,
+  message: meta.message
+})
+
+回复："⏰ 好的，5分钟后提醒你喝水~"
+```
+
+***
+
+## 2. 删除提醒
+
+### 📋 工作流程
+
+1. 调用 `openclaw-workclaw-cron-remove-params` 获取 cronParams 参数
+2. 使用返回的 `cronParams` 调用 OpenClaw 的 cron 工具
+3. 调用 `openclaw-workclaw-cron-remove-sync` 同步到后端
+
+### 🔧 remove-params 工具参数
+
+| 参数 | 说明 | 示例 |
+|------|------|------|
+| `jobId` | OpenClaw 任务 ID | `"123456"` |
+
+### 🔧 remove-sync 工具参数
+
+| 参数 | 说明 | 示例 |
+|------|------|------|
+| `jobId` | OpenClaw 任务 ID | `"123456"` |
+
+### 📝 删除提醒示例
+
+```
+用户："取消提醒"
+
+步骤1：调用 remove-params
+调用：openclaw-workclaw-cron-remove-params({ jobId: "123456" })
+返回：
+{
+  cronParams: { action: "remove", jobId: "123456" },
+  meta: { accountId: "<accountId>", jobId: "123456" },
+  summary: "🗑️ 提醒已删除: jobId=123456"
+}
+
+步骤2：执行 CLI 命令
+调用：openclaw cron remove 123456
+
+步骤3：调用后端同步
+调用：openclaw-workclaw-cron-remove-sync({ jobId: "123456" })
+
+回复："🗑️ 已取消提醒"
+```
+
+***
+
+## 3. 修改提醒
+
+### 📋 工作流程
+
+1. 调用 `openclaw-workclaw-cron-update-params` 获取 cronParams 参数
+2. 使用返回的 `cronParams` 调用 OpenClaw 的 cron 工具
+3. 调用 `openclaw-workclaw-cron-update-sync` 同步到后端
+
+### 🔧 update-params 工具参数
+
+| 参数 | 说明 | 示例 |
+|------|------|------|
+| `jobId` | OpenClaw 任务 ID | `"123456"` |
+| `time` | 时间描述，支持相对时间（5m、1h）和 cron 表达式 | `"10m"` / `"0 9 * * *"` |
+| `name` | 任务名称 | `"新喝水提醒"` |
+| `message` | 提醒内容 | `"该喝水了"` |
+
+### 🔧 update-sync 工具参数
+
+| 参数 | 说明 | 示例 |
+|------|------|------|
+| `jobId` | OpenClaw 任务 ID | `"123456"` |
+| `name` | 任务名称 | `"提醒: 喝水"` |
+| `kind` | 任务类型 | `"cron"` |
+| `message` | 提醒消息 | `"该喝水了"` |
+
+### 📝 修改提醒示例
+
+```
+用户："把提醒改成10分钟后"
+
+步骤1：调用 update-params
+调用：openclaw-workclaw-cron-update-params({ jobId: "123456", time: "10m", name: "喝水提醒", message: "该喝水了" })
+返回：
+{
+  cronParams: {
+    action: "update",
+    jobId: "123456",
+    job: {
+      name: "喝水提醒",
+      schedule: { kind: "cron", expr: "2026-03-31T15:56:00.000+08:00", tz: "Asia/Shanghai" },
+      sessionTarget: "isolated",
+      wakeMode: "now",
+      deleteAfterRun: true,
+      payload: { kind: "agentTurn", message: "该喝水了" },
+      delivery: { mode: "announce", channel: "openclaw-workclaw" }
+    }
+  },
+  meta: {
+    accountId: "<accountId>",
+    jobId: "123456",
+    name: "喝水提醒",
+    kind: "cron",
+    expr: "2026-03-31T15:56:00.000+08:00",
+    message: "该喝水了"
+  },
+  summary: "✅ 提醒已修改: \"喝水提醒\" (10m)"
+}
+
+步骤2：执行 CLI 命令（必须使用 --cron 参数，**严禁**使用 --at）
+调用：openclaw cron update 123456 --cron "0 56 15 31 3 *" --message "该喝水了"
+
+步骤3：调用后端同步
+调用：openclaw-workclaw-cron-update-sync({
+  jobId: "123456",
+  name: meta.name,
+  kind: meta.kind,
+  message: meta.message
+})
+
+回复："⏰ 已修改提醒"
+```
+
+***
+
+## 4. 启用提醒
+
+### 📋 工作流程
+
+1. 调用 `openclaw-workclaw-cron-enable-params` 获取 cronParams 参数
+2. 使用返回的 `cronParams` 调用 OpenClaw 的 cron 工具
+3. 调用 `openclaw-workclaw-cron-enable-sync` 同步到后端
+
+### 🔧 enable-params 工具参数
+
+| 参数 | 说明 | 示例 |
+|------|------|------|
+| `jobId` | OpenClaw 任务 ID | `"123456"` |
+
+### 🔧 enable-sync 工具参数
+
+| 参数 | 说明 | 示例 |
+|------|------|------|
+| `jobId` | OpenClaw 任务 ID | `"123456"` |
+
+### 📝 启用提醒示例
+
+```
+用户："启用那个提醒"
+
+步骤1：调用 enable-params
+调用：openclaw-workclaw-cron-enable-params({ jobId: "123456" })
+返回：
+{
+  cronParams: { action: "enable", jobId: "123456" },
+  meta: { accountId: "<accountId>", jobId: "123456" },
+  summary: "✅ 提醒已启用: jobId=123456"
+}
+
+步骤2：执行 CLI 命令
+调用：openclaw cron enable 123456
+
+步骤3：调用后端同步
+调用：openclaw-workclaw-cron-enable-sync({ jobId: "123456" })
+
+回复："✅ 提醒已启用"
+```
+
+***
+
+## 5. 禁用提醒
+
+### 📋 工作流程
+
+1. 调用 `openclaw-workclaw-cron-disable-params` 获取 cronParams 参数
+2. 使用返回的 `cronParams` 调用 OpenClaw 的 cron 工具
+3. 调用 `openclaw-workclaw-cron-disable-sync` 同步到后端
+
+### 🔧 disable-params 工具参数
+
+| 参数 | 说明 | 示例 |
+|------|------|------|
+| `jobId` | OpenClaw 任务 ID | `"123456"` |
+
+### 🔧 disable-sync 工具参数
+
+| 参数 | 说明 | 示例 |
+|------|------|------|
+| `jobId` | OpenClaw 任务 ID | `"123456"` |
+
+### 📝 禁用提醒示例
+
+```
+用户："先暂停提醒"
+
+步骤1：调用 disable-params
+调用：openclaw-workclaw-cron-disable-params({ jobId: "123456" })
+返回：
+{
+  cronParams: { action: "disable", jobId: "123456" },
+  meta: { accountId: "<accountId>", jobId: "123456" },
+  summary: "⏸️ 提醒已禁用: jobId=123456"
+}
+
+步骤2：执行 CLI 命令
+调用：openclaw cron disable 123456
+
+步骤3：调用后端同步
+调用：openclaw-workclaw-cron-disable-sync({ jobId: "123456" })
+
+回复："⏸️ 提醒已禁用"
+```
+
+***
+
+## 6. 任务触发通知
+
+**当定时任务触发时，你必须立即调用此工具！**
+
+### 📋 工作流程
+
+1. 定时任务触发
+2. 调用 `openclaw-workclaw-cron-notify-sync` 工具
+3. 工具内部调用后端 `/cron/job/message` 接口
+4. 发送提醒消息给用户
+
+### 🔧 notify-sync 工具参数
+
+| 参数 | 说明 | 示例 |
+|------|------|------|
+| `jobId` | OpenClaw 任务 ID（从上下文获取） | `"123456"` |
+| `message` | 要发送的提醒内容 | `"主人，该喝水了！"` |
+
+### 📝 任务触发通知示例
+
+```
+系统触发定时任务
+调用：openclaw-workclaw-cron-notify-sync({ jobId: "123456", message: "主人，该喝水了！" })
+发送消息："主人，该喝水了！"
+```
+
+***
+
+## AI 决策指南
+
+| 用户说法 | 工具调用 |
+|---------|---------|
+| "5分钟后提醒我喝水" | `add-params` → `cron` → `add-sync` |
+| "1小时后提醒开会" | `add-params` → `cron` → `add-sync` |
+| "每天8点提醒我打卡" | `add-params` → `cron` → `add-sync` |
+| "工作日早上9点提醒" | `add-params` → `cron` → `add-sync` |
+| "取消提醒" | `remove-params` → `cron` → `remove-sync` |
+| "启用提醒" | `enable-params` → `cron` → `enable-sync` |
+| "禁用提醒" | `disable-params` → `cron` → `disable-sync` |
+| "修改提醒时间" | `update-params` → `cron` → `update-sync` |
+| "提醒我"（无时间） | **需追问** |
+
+***
+
+## 回复模板
+
+- 创建成功：`⏰ 好的，{时间}后提醒你{name}~`
+- 修改成功：`⏰ 提醒已更新`
+- 删除成功：`🗑️ 已取消提醒`
+- 启用成功：`✅ 提醒已启用`
+- 禁用成功：`⏸️ 提醒已禁用`
+
+### 💡 健壮性提示
+
+**当用户说"任务已被移除"或"找不到任务"时**：
+1. 首先检查任务是否只是被禁用（enable 状态）
+2. 如果用户说"启用那个提醒"，先尝试调用 `enable-params` 和 `enable-sync`
+3. 如果任务实际存在，只是被禁用，回复：`✅ 已重新启用提醒`
+4. 如果任务确实不存在（已被删除），回复：`🗑️ 该提醒已被删除，无法重新启用`
+
+**示例场景**：
+```
+用户："启用那个提醒"
+AI回复1（任务被禁用）："✅ 已重新启用提醒！⏰ 提醒时间：{时间}"
+AI回复2（任务被删除）："🗑️ 该提醒已被删除，无法重新启用"
+```
+
+***
+
+## 🚫 严禁事项
+
+- ❌ **严禁**只说"好的，我会提醒你"而不调用工具
+- ❌ **严禁**在定时任务触发时不调用 `openclaw-workclaw-cron-notify-sync`
+- ❌ **严禁**传递虚构的 `jobId`，必须从 cron 工具返回值中提取
+- ❌ **严禁**跳过任何一步骤，必须按顺序执行：参数生成 → cron 工具 → 后端同步
+- ❌ **严禁**将 `kind: "cron"` 转换为 `--at` 参数，必须保持 `kind: "cron"` 不变
+- ❌ **严禁**将 cron 表达式转换为绝对时间（--at），必须使用 cron 表达式格式（--cron）
+- ❌ **严禁**轻易说"任务已被移除"，应先尝试启用（enable）操作
+- ❌ **严禁**直接使用 `cron` 命令创建/修改/删除定时任务，必须通过工具参数生成后执行
+- ❌ **严禁**绕过本 SKILL 中定义的工具流程自行实现定时功能
+- ❌ **严禁**使用其他任何未在本 SKILL 中列出的定时任务相关工具
+- ❌ **严禁**使用 `--system-event`，必须使用 `--message`（agentTurn）
+- ❌ **严禁**使用 `--session current`，必须使用 `--session isolated`
+- ❌ **严禁**使用 `--channel "last"`，必须使用 `--channel "openclaw-workclaw"`