# Reminder Skill

> 创建、查询、修改或删除提醒任务。 Use when this capability is needed.

- Skill: `tomevault-io/reminder-skill` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/reminder-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/reminder-skill/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/reminder-skill

---


# reminder-skill

这个技能用于管理 **当前对话** 的提醒任务（创建 / 查询 / 修改 / 删除）。  
你需要为未来的某一时刻设置提示词（prompt），届时你将会收到该提示词并按要求完成任务。  
请根据用户消息中的 `<time>` 来确定“当前时间”。

**重要约束：**

- `runAt` 必须是 `"YYYY-MM-DD HH:mm:ss"` 格式。

- 在删除或修改前，**先 list 再确认**，避免误操作。

- 提示词（prompt）需要描述清楚用户在何时创建了任务，在任务触发时应你该做什么。这不是给用户的回复，而是指导你在未来任务触发时的行为，即你对未来的自己说的话。

---

## Action 说明

### 1) 创建提醒（create）

创建提醒前先 list，确认是否已有相同提醒。  
如果不存在 → 创建。  
如果存在 → 走 update。

**一次性提醒：**

```json
{
  "action": "create",
  "type": "once",
  "runAt": "2026-01-31 08:50:00",
  "prompt": "[2026-01-30 09:00:00]时用户说：“明天记得提醒我上午9点要开会。”我需要在[2026-01-31 08:50:00]左右提醒用户以免用户错过会议。现在已经到预定时间了，需要立刻提醒用户。"
}
```

**周期提醒：**

```json
{
  "action": "create",
  "type": "every",
  "runAt": "2026-01-31 22:00:00",
  "interval": "0 22 * * *",
  "prompt": "[2026-01-30 23:00:00]时用户说：“从明天开始，每晚10点提醒我睡觉。”现在已经到预定时间了，需要立刻提醒用户。"
}
```

```json
{
  "action": "create",
  "type": "every",
  "runAt": "2026-01-30 23:00:20",
  "interval": "0 22 * * *",
  "prompt": "[2026-01-30 23:00:00]时用户说：“接下来每20秒给我发送一条消息。”现在已经到预定时间了，需要向用户发送消息，可以根据记忆内容选择话题。"
}
```

---

### 2) 查询提醒（list）

用于列出当前所有提醒任务。  
返回结果包含 `jobId`、`runAt`、`interval`、`prompt`。

```json
{
  "action": "list"
}
```

---

### 3) 修改提醒（update）

先通过 list 拿到目标提醒的 `id`，再修改。  
必须提供 `type`，并与任务类型一致：

- `once` 对应一次性任务
- `every` 对应周期任务  
  可以更新 `runAt` / `interval` / `prompt` 任意一个或多个。

```json
{
  "action": "update",
  "type": "once",
  "jobId": "JOB_ID_HERE",
  "runAt": "2026-01-31 09:50:00",
  "prompt": "[2026-01-30 09:00:00]时用户说：“明天记得提醒我上午9点要开会”，[2026-01-30 10:00:00]时用户又说：“明天到会议改到10点了。”我需要在[2026-01-31 09:50:00]左右提醒用户以免用户错过会议。现在已经到预定时间了，需要立刻提醒用户。"
}
```

周期任务要改周期时：

```json
{
  "action": "update",
  "type": "every",
  "jobId": "JOB_ID_HERE",
  "interval": "0 23 * * *",
  "prompt": "[2026-01-30 23:00:00]时用户说：“从明天开始，每晚10点提醒我睡觉。”[2026-01-30 23:30:00]时用户说：“算了，还是提醒我11点睡觉吧。”现在已经到预定时间了，需要立刻提醒用户。"
}
```

---

### 4) 删除提醒（delete）

先 list，再删除指定 `id`：

```json
{
  "action": "delete",
  "jobId": "JOB_ID_HERE"
}
```

---

## 参数要点

- `runAt` 必须是 `"YYYY-MM-DD HH:mm:ss"` 格式。
- `interval` 可以是毫秒数或 cron 字符串。
- `prompt` 是提醒触发时模型要用的提示词（不是直接发给用户的文本）。

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/emafanclub) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->