定时提醒工具(免费版)

定时提醒工具（免费版）

概述

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

核心能力

核心功能执行

用input_params参数进行配置.

处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置.

处理: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回参数配置与调用的响应数据,包含状态码、结果和日志.

• 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置.

处理: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回结果处理与输出的响应数据,包含状态码、结果和日志.

• 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：后台定时提醒免费、多格式定时器、番茄钟与基础多计、时器管理、定时提醒工具、面向个人用户与独、立开发者、提供后台定时器与、到时提醒能力、支持多种时间格式、时分秒、自定义提醒文案、番茄钟工作法、多计时器并行与后、台进程管理、定时器在后台运行、完成后触发系统通、Use、when、需要生成营销文案、写作内容、标题优化、内容创作时使用、不适用于纯技术文、档撰写等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.

使用场景

场景一：烹饪定时

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

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

完成后 Agent 响应：

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

场景二：番茄钟工作法

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

# 专注阶段（25 分钟）
js 25m '番茄钟专注时间结束！该休息了。'"
# ...
# 休息阶段（5 分钟，专注结束后启动）

场景三：多任务并行计时

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

快速开始

60 秒上手

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

基础定时器

# 5 分钟定时器
# ...
# 30 秒定时器
# ...
# 1 小时定时器

管理运行中的定时器

# 列出所有运行中的定时器
process action:list
# ...
# 查看特定定时器状态
process action:poll sessionId:XXX
# ...
# 查看定时器日志
process action:log sessionId:XXX
# ...
# 终止定时器
process action:kill sessionId:XXX

响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤.

示例

时间格式速查

番茄钟配置

# 标准番茄钟：25 分钟专注 + 5 分钟休息
js 25m '番茄钟：专注完成！休息 5 分钟。'"
# 专注结束后启动休息
js 5m '番茄钟：休息结束！开始下一轮专注。'"
# ...
# 长休息版：50 分钟专注 + 10 分钟休息
js 50m '深度专注完成！休息 10 分钟。'"
js 10m '长休息结束！继续工作。'"

多计时器场景配置

最佳实践

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

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

# 错误（会被过滤，用户收不到）
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 定时器脚本）

依赖详情

API Key 配置

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

可用性分类

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

错误处理

输出格式

{
  "success": true,
  "data": {
    "result": "定时提醒工具(免费版)处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "timer alert"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}