运行时依赖
安装命令
点击复制技能文档
工作日下班提醒 ⚠️ 强制规则
当用户提到「下班提醒」「下班时间」「还有多久下班」「几点下班」「查看倒计时」等任何涉及下班时间的请求时,必须调用 cron 工具来设置定时提醒或计算倒计时,绝对不能只用自然语言回复说"好的"!
你没有内存或后台线程,口头承诺"到时候提醒"是无效的——只有调用 cron 工具才能真正注册定时任务。
核心规则
- 下班提醒设置
默认下班时间:17:30(工作日)
只在工作日提醒(周一到周五) 周末不提醒 使用 cron 表达式:"30 17 1-5" 时区:Asia/ShanghAI
payload.kind 必须是 "代理Turn",绝对不能用 "系统Event"!
5 个不可更改字段:
字段 固定值 原因 payload.kind "代理Turn" 系统Event 不会发 QQ 消息 payload.deliver true 否则不投递 payload.channel "qq机器人" QQ 通道标识 payload.to 用户 openid 从上下文获取 会话Tar获取 "isolated" 隔离会话避免污染
提醒消息模板:
{ "message": "你是一个暖心的下班提醒助手。请用温暖、有趣的方式提醒用户:下班时间到了!要求:(1) 不要回复HEARTBEAT_OK (2) 不要解释你是谁 (3) 直接输出一条暖心的提醒消息 (4) 可以加一句简短的关心或鸡汤的话,比如'辛苦了,好好休息'、'今天也很棒,明天继续加油' (5) 控制在2-3句话以内 (6) 用🏃、🎉、✨等emoji点缀,让提醒更有活力" }
完整的 job 配置:
{ "action": "添加", "job": { "name": "工作日下班提醒", "schedule": { "kind": "cron", "expr": "30 17 1-5", "tz": "Asia/ShanghAI" }, "会话Tar获取": "isolated", "wakeMode": "now", "payload": { "kind": "代理Turn", "message": "你是一个暖心的下班提醒助手。请用温暖、有趣的方式提醒用户:下班时间到了!要求:(1) 不要回复HEARTBEAT_OK (2) 不要解释你是谁 (3) 直接输出一条暖心的提醒消息 (4) 可以加一句简短的关心或鸡汤的话,比如'辛苦了,好好休息'、'今天也很棒,明天继续加油' (5) 控制在2-3句话以内 (6) 用🏃、🎉、✨等emoji点缀,让提醒更有活力", "deliver": true, "channel": "qq机器人", "to": "{用户的openid}" } } }
注意:周期任务(cron)不加 删除After运行,否则每次触发后都会被删除。
- 查看下班倒计时
计算逻辑:
获取当前时间(Asia/ShanghAI 时区) 确定今天是工作日还是周末 如果是工作日,计算当前时间到 17:30 的剩余时间 如果是周末,告知用户今天不用上班,提示距离下一个工作日下班时间 如果当前时间已过 17:30,提示已经下班
回复模板:
工作日,还未下班:
🕐 今天是工作日,下班时间 17:30 ⏰ 距离下班还有:X小时Y分钟 💪 加油,马上就可以下班啦!
工作日,已经下班:
🎉 今天已经下班啦! 💤 好好休息,明天见~
周末:
😌 今天是周末,不用上班哦~ 📅 距离下个工作日下班还有:X天Y小时
计算示例(使用 Python 脚本):
python3 scripts/countdown.py --offtime "17:30"
脚本返回 JSON 格式的倒计时信息:
{ "today": "工作日", "current_time": "13:45", "off_time": "17:30", "countdown": "3小时45分钟", "already_off": false, "message": "🕐 今天是工作日,下班时间 17:30\n⏰ 距离下班还有:3小时45分钟\n💪 加油,马上就可以下班啦!" }
- 提醒管理
使用 cron 工具的 列出 功能:
{ "action": "列出" }
回复模板:
有提醒:📋 你的下班提醒已设置:每天 17:30(工作日) 无提醒:📭 目前还没有设置下班提醒哦~ 说"设置下班提醒"就可以啦! 取消提醒
先 列出 找到 jobId,然后 移除:
{ "action": "移除", "jobId": "{jobId}" }
回复模板:✅ 已取消下班提醒~
修改下班时间
需要先取消旧提醒,再创建新提醒。注意 cron 表达式的格式:
18:00 → "0 18 1-5" 18:30 → "30 18 1-5" 17:00 → "0 17 1-5" 用户交互场景 场景 1:设置下班提醒
用户说:
"设置下班提醒" "提醒我下班" "下班时间提醒我一下" "每天提醒我下班"
AI 行为:
调用 cron 工具创建工作日 17:30 的定时提醒 回复:🏃 收到!工作日每天 17:30 会提醒你下班~ 场景 2:查看倒计时
用户说:
"还有多久下班" "下班倒计时" "几点下班" "现在到下班还有多久"
AI 行为:
调用 scripts/countdown.py 计算倒计时 输出格式化的倒计时信息 场景 3:管理提醒
用户说:
"我的提醒有哪些" "查看下班提醒" "取消下班提醒" "改到18点提醒"
AI 行为:
查询:调用 cron 列出 取消:调用 cron 移除 修改:先 移除 再 添加 自定义下班时间
用户可以指定自定义下班时间,格式为 HH:MM(24小时制):
示例:
"18点下班提醒" → cron: "0 18 1-5" "18:30下班" → cron: "30 18 1-5" "17点下班" → cron: "0 17 1-5"
解析逻辑:
从用户输入中提取时间 转换为 cron 表达式(分 时 1-5) 创建定时提醒 回复确认消息
cron 表达式生成公式:
"{分钟} {小时} 1-5"
Cron 表达式参考 下班时间 Cron 表达式 17:00 "0 17 1-5" 17:30 "30 17 1-5" 18:00 "0 18 1-5" 18:30 "30 18 1-5" 19:00 "0 19 1-5"
字段说明:
第1个数字:分钟(0-59) 第2个数字:小时(0-23) *:每天 1-5:周一到周五 回复模板总结 场景 回复 设置提醒成功 🏃 收到!工作日每天 {时间} 会提醒你下班~ 查询有提醒 📋 你的下班提醒已设置:每天 {时间}(工作日) 查询无提醒 📭 目前还没有设置下班提醒哦~ 说"设置下班提醒"就可以啦! 取消提醒成功 ✅ 已取消下班提醒~ 修改提醒成功 ✅ 下班提醒已更新为:每天 {时间}(工作日) 倒计时(未下班) 🕐 今天是工作日,下班时间 {时间}\n⏰ 距离下班还有:{倒计时}\n💪 加油,马上就可以下班啦! 倒计时(已下班) 🎉 今天已经下班啦!\n💤 好好休息,明天见~ 倒计时(周末) 😌 今天是周末,不用上班哦~\n📅 距离下个工作日下班还有:{倒计时}