Timer Alert Tool Free

SKILL.md

---
name: "timer-alert-tool-free"
description: "后台定时提醒免费版：多格式定时器、完成通知、番茄钟与基础多计时器管理。"
license: Proprietary
allowed-tools: read exec
compatibility: "Requires LLM with tool-use capability"
metadata:
  displayName: "定时提醒工具(免费版)"
  version: "1.0.0"
  summary: "后台定时提醒免费版：多格式定时器、完成通知、番茄钟与基础多计时器管理。"
  tags:
    - "沟通协作"
    - "定时提醒"
    - "通知"
    - "效率工具"
    - "番茄钟"
  source: "SkillHub"
  converted_at: "2026-07-22T17:58:36"
---

# 定时提醒工具（免费版）

## 概述

本工具提供后台定时器与到时提醒能力，让 AI Agent 能够设置倒计时并在完成时收到系统通知。定时器在后台运行，不阻塞当前会话，完成后触发系统通知并由 Agent 响应用户。免费版聚焦"能定时"——覆盖 6 种时间格式、自定义文案、番茄钟与多计时器并行；循环定时、模板库与升级提醒等高级能力留给专业版。

## 核心能力

| 能力 | 说明 | 免费版 |
|------|------|--------|
| 基础定时 | 秒/分/时倒计时 | 是 |
| 时间格式 | 6 种格式支持 | 是 |
| 自定义文案 | 到时提醒消息 | 是 |
| 番茄钟 | 25分钟专注+5分钟休息 | 是 |
| 多计时器 | 并行运行多个定时器 | 是 |
| 进程管理 | 列表/轮询/日志/终止 | 是 |
| 完成通知 | 系统通知+Agent响应 | 是 |
| 循环定时 | 间隔重复提醒 | 否（专业版） |
| 模板库 | 预设提醒模板 | 否（专业版） |
| 升级提醒 | 多级提醒策略 | 否（专业版） |
| 定时任务 | 指定时间点触发 | 否（专业版） |
| 监控面板 | 实时计时器状态 | 否（专业版） |

### 核心功能执行
用`input_params`参数进行配置。

**输入**: 用户提供核心功能执行所需的指令和必要参数。
**处理**: 按照skill规范执行核心功能执行操作,遵循单一意图原则。
**输出**: 返回核心功能执行的执行结果,包含操作状态和输出数据。
- 执行此能力时使用`input_params`参数,支持创建/查询/导出操作

### 参数配置与调用
用`config_options`参数进行配置。

**输入**: 用户提供参数配置与调用所需的指令和必要参数。
**处理**: 按照skill规范执行参数配置与调用操作,遵循单一意图原则。
**输出**: 返回参数配置与调用的执行结果,包含操作状态和输出数据。
- 执行此能力时使用`config_options`参数,支持修改/重置/导入操作

### 结果处理与输出
用`output_format`参数进行配置。

**输入**: 用户提供结果处理与输出所需的指令和必要参数。
**处理**: 按照skill规范执行结果处理与输出操作,遵循单一意图原则。
**输出**: 返回结果处理与输出的执行结果,包含操作状态和输出数据。
- 执行此能力时使用`output_format`参数,支持导出/保存/转换操作
**能力覆盖范围**：本skill的核心能力覆盖以下场景关键词：后台定时提醒免费、多格式定时器、番茄钟与基础多计、时器管理、定时提醒工具、面向个人用户与独、立开发者、提供后台定时器与、到时提醒能力、支持多种时间格式、时分秒、自定义提醒文案、番茄钟工作法、多计时器并行与后、台进程管理、定时器在后台运行、完成后触发系统通、Use、when、需要生成营销文案、写作内容、标题优化、内容创作时使用、不适用于纯技术文、档撰写等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

## 使用场景

### 场景一：烹饪定时

用户说"帮我设一个 12 分钟的定时器，提醒我意大利面好了"。Agent 在后台启动 12 分钟定时器，到时后通知用户。

```bash
bash background:true command:"node {baseDir}/timer.js 12m '意大利面好了！'"
```

完成后 Agent 响应：

```text
⏰ 定时提醒！12 分钟计时已到：意大利面好了！
```

### 场景二：番茄钟工作法

用户说"帮我启动番茄钟工作法"。Agent 先后启动 25 分钟专注定时器与 5 分钟休息定时器，交替提醒。

```bash
# 专注阶段（25 分钟）
bash background:true command:"node {baseDir}/timer.js 25m '番茄钟专注时间结束！该休息了。'"

# 休息阶段（5 分钟，专注结束后启动）
bash background:true command:"node {baseDir}/timer.js 5m '休息结束！回到工作。'"
```

### 场景三：多任务并行计时

用户说"帮我同时设三个定时器：茶 5 分钟、鸡蛋 10 分钟、会议 30 分钟"。Agent 并行启动三个后台定时器。

```bash
bash background:true command:"node {baseDir}/timer.js 5m '茶泡好了'"
bash background:true command:"node {baseDir}/timer.js 10m '鸡蛋煮好了'"
bash background:true command:"node {baseDir}/timer.js 30m '会议马上开始'"
```

## 快速开始

### 60 秒上手

1. 确定倒计时时长与提醒文案
2. 使用 `bash background:true` 启动后台定时器
3. 定时器完成后收到系统通知
4. Agent 以正确格式响应提醒用户

### 基础定时器

```bash
# 5 分钟定时器
bash background:true command:"node {baseDir}/timer.js 5m '时间到了！'"

# 30 秒定时器
bash background:true command:"node {baseDir}/timer.js 30s '快速提醒'"

# 1 小时定时器
bash background:true command:"node {baseDir}/timer.js 1h '一小时已到'"
```

### 管理运行中的定时器

```bash
# 列出所有运行中的定时器
process action:list

# 查看特定定时器状态
process action:poll sessionId:XXX

# 查看定时器日志
process action:log sessionId:XXX

# 终止定时器
process action:kill sessionId:XXX
```

**结果处理**: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。


## 示例

### 时间格式速查

| 格式 | 描述 | 示例 | 等效时长 |
|------|------|------|---------|
| `Ns` | N 秒 | `30s`、`90s` | 30 秒、90 秒 |
| `Nm` | N 分钟 | `5m`、`15m` | 5 分、15 分 |
| `Nh` | N 小时 | `1h`、`2h` | 1 小时、2 小时 |
| `N` | N 分钟（默认） | `5` | 5 分钟 |
| `MM:SS` | 分:秒 | `5:30` | 5 分 30 秒 |
| `HH:MM:SS` | 时:分:秒 | `1:30:00` | 1 小时 30 分 |

### 番茄钟配置

```bash
# 标准番茄钟：25 分钟专注 + 5 分钟休息
bash background:true command:"node {baseDir}/timer.js 25m '番茄钟：专注完成！休息 5 分钟。'"
# 专注结束后启动休息
bash background:true command:"node {baseDir}/timer.js 5m '番茄钟：休息结束！开始下一轮专注。'"

# 长休息版：50 分钟专注 + 10 分钟休息
bash background:true command:"node {baseDir}/timer.js 50m '深度专注完成！休息 10 分钟。'"
bash background:true command:"node {baseDir}/timer.js 10m '长休息结束！继续工作。'"
```

### 多计时器场景配置

| 场景 | 计时器 1 | 计时器 2 | 计时器 3 |
|------|---------|---------|---------|
| 烹饪 | 茶 5m | 鸡蛋 10m | 汤 30m |
| 会议 | 议程A 15m | 议程B 20m | 总结 5m |
| 运动 | 热身 5m | 训练 30m | 拉伸 10m |
| 学习 | 阅读 25m | 练习 15m | 复习 10m |

## 最佳实践

### 1. 完成通知格式（关键）

定时器完成后收到 `System:` 消息。**响应必须直接以提醒开头**，不能以 `HEARTBEAT_OK` 开头——以 `HEARTBEAT_OK` 开头且少于 300 字符的响应会被自动过滤，用户收不到提醒。

```text
# 错误（会被过滤，用户收不到）
HEARTBEAT_OK
⏰ 定时器完成了！

# 正确（用户能收到）
⏰ 定时提醒！你的 12 分钟计时已到：意大利面好了！
```

### 2. 后台运行

定时器必须使用 `background:true` 在后台运行，否则会阻塞当前会话。后台定时器有独立 sessionId，完成后退出码为 0。

### 3. 多计时器管理

并行运行多个定时器时，用 `process action:list` 查看所有 sessionId。每个定时器独立计时，完成时分别通知。建议为每个定时器设置有区分度的提醒文案。

### 4. 番茄钟循环

标准番茄钟为 25 分钟专注 + 5 分钟休息。每 4 个番茄钟后安排一次长休息（15-30 分钟）。专注定时器结束后立即启动休息定时器，保持节奏。

### 5. 提醒文案要具体

提醒文案应包含足够信息让用户立即理解。避免模糊的"时间到了"——写明是什么任务的定时器完成了。

### 6. 及时清理已完成定时器

已完成的定时器会自动退出（码 0）。手动终止的定时器退出码 130。定期用 `process action:list` 检查，避免残留进程。

### 7. 提醒文案包含上下文

好的提醒文案应包含：计时器用途 + 剩余状态 + 后续动作。例如"Pasta 定时完成！请关火滤水，准备酱汁"比"时间到了"更有帮助。

### 8. 长时间定时器分段

超过 1 小时的定时器建议分段设置中间检查点。例如 3 小时工作拆为 3 个 1 小时定时器，每个检查点评估进度并决定是否调整计划。

## 常见问题

### Q1：定时器完成后用户没收到通知？
A：检查 Agent 响应格式——不能以 `HEARTBEAT_OK` 开头。响应应直接以提醒内容开头，如 `⏰ 定时提醒！...`。`HEARTBEAT_OK` 开头且少于 300 字符的响应会被自动过滤。

### Q2：定时器没有在后台运行？
A：必须使用 `bash background:true` 启动。如果省略 `background:true`，定时器会阻塞当前会话直到完成。

### Q3：如何取消正在运行的定时器？
A：先用 `process action:list` 找到 sessionId，再执行 `process action:kill sessionId:XXX`。被终止的定时器退出码为 130。

### Q4：多个定时器同时完成怎么处理？
A：每个定时器完成后分别触发独立的系统通知。Agent 按通知到达顺序依次响应，每个响应独立处理。

### Q5：定时器精度如何？
A：短定时器（< 1 分钟）每秒记录进度，长定时器每 10 秒记录。精度在 ±1 秒内。macOS 完成时会播放声音提示（需 `afplay` 可用）。

### Q6：如何查看定时器运行日志？
A：`process action:log sessionId:XXX` 查看特定定时器的进度日志，包含每秒/每 10 秒的计时记录。

### 已知限制
A：免费版不支持循环定时（间隔重复提醒）、提醒模板库、多级升级提醒、指定时间点触发与实时监控面板。这些能力在专业版提供。

## 免费版限制

本免费版限制以下高级功能：
- 循环定时（间隔重复提醒，如每 30 分钟提醒一次喝水）
- 提醒模板库（预设场景快速启动）
- 多级升级提醒（首次→重复→紧急三级策略）
- 指定时间点触发（如每天 14:00 提醒）
- 实时监控面板（所有定时器状态可视化）
- 定时器链（前一个完成后自动启动下一个）
- 跨会话持久化（重启后恢复定时器状态）
- 通知渠道扩展（邮件/Webhook/推送）

解锁全部功能请使用专业版：`timer-alert-tool-pro`

## 依赖说明

### 运行环境
- **Agent 平台**：支持 SKILL.md 且具备后台进程执行能力的 AI Agent
- **操作系统**：Windows / macOS / Linux
- **Node.js**：16+（运行 timer.js 定时器脚本）

### 依赖详情
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|:-------|:-----|:---------|:---------|
| LLM API | API | 必需 | 由 Agent 内置 LLM 提供 |
| Node.js 16+ | 运行时 | 必需 | 运行 timer.js 脚本 |
| afplay | CLI 工具 | 可选 | macOS 自带，完成时播放声音 |
| 声卡/扬声器 | 硬件 | 可选 | 播放声音提示 |

### API Key 配置
- **无需额外 API Key**：本工具基于本地 Node.js 脚本运行，不调用外部 API
- **禁止**：在 SKILL.md 或脚本中硬编码任何凭证
- **安全建议**：定时器在本地后台运行，提醒内容不应包含敏感信息

### 可用性分类
- **分类**：MD+EXEC（纯 Markdown 指令，需要 exec 命令行执行能力启动后台定时器）
- **说明**：基于 Markdown 的 AI Skill，通过自然语言指令驱动 Agent 执行任务
- **模型路由建议**：免费版使用低成本模型（如 GPT-4o-mini / Claude Haiku）即可完成定时器管理与通知响应

## 错误处理


| 错误场景 | 原因 | 处理方式 |
|---------|------|---------|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案 |