let-me-know

⏱️ 长任务实时进度通信规范

规范长任务通信流程的工作指南,通过可配置心跳机制确保用户实时掌握进度,消除等待焦虑,提升交互透明度与信任度。

收藏
10.1k
安装
2k
版本
v0.1.1
CLS 安全性认证2026-05-04
点击查看完整报告 >

使用说明

核心用法

该 Skill 定义了一套标准化的长任务通信协议,适用于任何预计执行时间超过 2-3 分钟的 Agent 任务。其核心工作流程包含三个关键环节:预飞通知(在任务启动前明确告知用户任务内容、预计耗时及通信规则)、心跳更新(通过可配置的时间间隔,默认每 5 分钟发送一次包含实时进展的动态进度报告)以及完结通知(任务成功或失败时立即推送结果摘要)。实现上优先推荐"原地心跳"模式,即在长任务执行线程内通过循环休眠实现进度推送,避免创建额外的定时任务;仅在必须脱离当前执行流时才启用 Cron 心跳,并严格要求在任务结束时清理定时器,防止消息刷屏。

显著优点

首先,极致的透明度设计彻底消除了用户面对"黑盒"长时间等待的焦虑感,通过明确的预期管理和持续的进度同步建立信任。其次,灵活的interval配置允许根据任务特性调整心跳频率(如编译任务可设为 10 分钟,AI 生成任务可设为 2 分钟),兼顾信息时效性与打扰控制。再者,双模式实现策略(原地循环 vs Cron 任务)既保证了简单场景的易用性,又满足了复杂异步流程的需求。此外,文档对异常处理的完整性考虑(失败时立即停止心跳、Cron 清理失败的重试机制)体现了生产环境的健壮性思维。

潜在局限

作为纯文档型 Skill,其本质是一份行为规范而非可执行代码,实际的通知功能(如 message send 的具体实现、Cron 调度能力)完全依赖底层 Agent 平台的支持,存在平台兼容性问题。若 Agent 平台未实现 Cron 管理或消息推送接口,该规范将无法落地。此外,心跳机制本身存在设置悖论:间隔过短会增加系统负载并可能打扰用户,间隔过长则失去"缓解焦虑"的意义,需要使用者具备场景判断经验。对于极长任务(如数小时的模型训练),固定间隔的心跳可能不如里程碑式汇报高效。

适合群体

该 Skill 特别适合构建 AI Agent 的开发者需要编排复杂工作流的技术团队,尤其是涉及代码构建、批量数据处理、AI 内容生成、自动化测试等耗时操作的场景。对于客服型 Agent个人助手类应用,该规范能显著提升用户体验。同时,运维人员项目经理也可借鉴此模式设计人机协作流程,确保长时间运行的后台任务对用户可见、可控。

使用风险

主要风险集中在Cron 心跳的资源管理上:若任务异常退出或网络超时导致 Cron 清理失败,可能产生"孤儿心跳"持续发送无效消息,虽然文档提供了指数退避重试和延迟清理的兜底方案,但仍需监控。其次是平台性能风险,频繁的状态读取(每次心跳前需查询进度日志)可能对 I/O 造成压力。此外,消息过载风险不容忽视,若用户同时触发多个长任务且均采用默认 5 分钟间隔,可能收到过多心跳消息。建议在实际部署时结合具体平台的限速策略和用户的免打扰设置进行适配。

安全解读

核心用法

let-me-know 是一款面向长耗时任务的进度透明化 Skill,解决 AI 助手执行编译、测试、安装等耗时操作时的"黑盒焦虑"问题。

标准工作流:
1. 启动前通知 — 明确告知任务内容、预估时长、心跳间隔(默认5分钟),并承诺完成/失败即时通知

2. 周期心跳更新 — 通过"原地心跳"(推荐)或 cron 定时任务,每 X 分钟推送真实进度(当前阶段、关键指标、下一步)

3. 任务执行 — 运行实际的长时间命令

4. 即时完成通知 — 任务结束后立即发送结果摘要

5. 清理心跳 — 确保无残留定时任务,失败时带指数退避重试

心跳机制亮点:优先推荐"原地心跳"——在同一次 agentTurn 内用 sleep 循环实现,不创建额外 cron,任务结束自然停止,零残留风险。

显著优点

  • 零侵入设计:纯 Markdown 策略,无可执行代码,不污染系统
  • 用户可控:心跳间隔可自定义,支持任务中途修改
  • 防残留机制:详细的 cron 清理逻辑,含重试和兜底 cleanup 方案
  • 真实进度:每次心跳读取最新状态,拒绝模板化重复消息
  • 多平台适配:支持 Discord DM 等场景的 message send 格式

潜在局限

  • 依赖执行环境:需底层支持 sleepcronmessage send 工具
  • 手动适配成本:不同平台的消息 target 格式(如 user:<id>)需调用方配置
  • 无内置容错:若状态文件读取失败,心跳内容可能降级为通用提示
  • license 未声明:当前版本未明确开源协议

适合人群

  • Claude Code / AI Agent 开发者,需为用户任务提供进度可见性
  • DevOps 自动化场景,涉及构建、测试、部署等耗时流水线
  • 需要降低用户等待焦虑的客服/助手类应用

常规风险

  • 极低:纯文档型 Skill,无代码执行、无外部网络、无数据收集
  • 注意:若使用 cron 心跳,需确保 cron remove 的健壮性,避免消息刷屏

let-me-know 内容

手动下载zip · 2.6 kB
SKILL.mdtext/markdown
请选择文件