长任务通知助手

技能简介

在执行耗时超过2-3分钟的任务前主动告知用户，并在执行期间按固定间隔发送实时进度更新，任务结束或失败时立即推送结果。

能做什么

• 任务启动前发送预估时间与通知策略说明
• 按5分钟默认间隔（可配置）发送动态进度心跳
• 实时读取任务状态，推送当前步骤与关键指标
• 任务完成或失败时立即通知并清理心跳机制
• 支持原地循环心跳与cron调度两种实现方式

使用说明

1. 前置检查：确认任务预计耗时超过2-3分钟，准备预飞消息内容
2. 发送预飞消息：告知任务内容、预估时间、心跳间隔及修改方式
3. 选择心跳模式：
   • 推荐：同agentTurn内原地循环（sleep→读进度→message send）
   • 备选：cron add创建心跳job（需设置payload.deliver=false，记录heartbeatJobId）
4. 执行任务：运行实际命令
5. 推送结果：任务结束后立即发送完成/失败摘要
6. 清理心跳：原地模式自动结束；cron模式需remove job（失败时重试2次，仍失败则创建延迟cleanup cron）

安装指令：无需额外安装，直接调用即可。

输入与输出

见下方输入与输出表格。

风险提示

• 未发送预飞消息直接启动长任务会导致用户不知情
• cron心跳若未正确清理可能持续刷屏
• 心跳消息使用模板而非实时数据会降低信息价值
• cron remove因网关超时失败时需执行重试与兜底清理
• 同名心跳job重复创建会造成消息冗余，需先list再remove去重

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/fogyoy/let-me-know/SKILL.md
来源类型：GitHub仓库