Let Me Know

核心用法

let-me-know 是一项任务执行增强技能，专为解决 AI 助手执行长耗时任务时的"黑箱焦虑"问题而设计。其工作流程分为五个阶段：

1. 预飞通知（Pre-flight）：任务启动前发送明确预告，说明任务内容、预估时长，并承诺"完成/失败即时通知 + 可配置心跳间隔"
2. 定时心跳（Heartbeat）：默认每 5 分钟发送一次进度更新，内容基于实时状态（最新步骤、关键指标、下一步），非模板重复
3. 任务执行：实际运行耗时命令（安装、构建、测试等）
4. 即时完结：任务完成后立即发送结果摘要
5. 心跳清理：自动移除定时任务，避免消息骚扰

用户可动态调整心跳间隔（如"改为 2 分钟"），系统会在下次心跳时确认更新。

显著优点

• 消除等待焦虑：透明的进度反馈大幅降低用户对"助手是否卡住"的担忧
• 可控性强：间隔可配置，适应不同场景（编译 10 分钟 vs 模型训练 2 小时）
• 状态实时性：每次心跳读取最新日志，避免"僵尸进度条"问题
• 故障响应快：失败时立即停止心跳并告警，避免无效信息轰炸

潜在局限

• 依赖外部状态源：需能读取进度日志或状态文件，否则心跳内容可能空洞
• 消息频率下限：默认 5 分钟可能仍显频繁，极长任务（数小时）建议用户调大间隔
• 网关脆弱性：cron 清理失败时需重启网关，存在极短暂的消息泄露风险
• Discord 耦合：示例严重依赖 Discord DM 格式，其他平台需适配

适合人群

• 频繁执行 CI/CD、依赖安装、模型训练、大数据处理等长耗时任务的用户
• 对助手响应透明度有要求的场景（客户服务、自动化运维）
• 需要"人机协作"而非"后台静默执行"的工作流

常规风险

• 信息过载风险：若用户忘记调大间隔，长时间任务可能导致消息疲劳
• 状态误判风险：依赖外部日志的实时性，若日志写入延迟，心跳可能报告过期状态
• 权限风险：commands.restart 涉及网关重启，需确保调用环境具备相应权限

Let Me Know 是一款专注于长任务通信管理的 Agent Skill，旨在解决 AI 助手执行耗时操作时的用户知情权问题。当任务预计超过 2-3 分钟时，该 Skill 会强制要求发送预飞通知，明确告知任务内容、预估耗时及心跳机制；随后以默认定 5 分钟（可自定义）的间隔推送实时进度更新，确保用户掌握最新执行状态；任务完成或失败后立即发送结果通知，并自动清理心跳定时器。

核心用法遵循五步工作流：预飞消息确认 → 启动可配置间隔的心跳定时器（通过 cron add 实现）→ 执行实际任务 → 即时完成通知 → 停止心跳避免消息骚扰。消息模板强调动态内容填充，每次心跳必须读取最新状态文件或日志，呈现真实进展而非重复模板。

显著优点体现在三方面：一是彻底消除"黑盒执行"焦虑，用户无需猜测 AI 是否卡死或仍在运行；二是高度灵活的配置能力，支持用户按需调整心跳频率甚至中途修改；三是极致的架构简洁性，作为纯 Markdown 指令文档，无任何可执行代码、外部依赖或网络调用，天然免疫代码注入与供应链攻击。

潜在局限包括：功能完全依赖宿主平台的 cron 与消息发送能力，若平台未实现对应工具则 Skill 失效；心跳内容质量受限于任务本身的日志输出规范，无结构化日志时难以生成有意义的进度描述；以及当前仅支持单向通知，不支持用户通过回复消息中断或调速任务。

适合人群为频繁使用 AI 执行代码构建、数据迁移、批量生成、复杂分析等长耗时任务的开发者、运维工程师及研究人员，尤其适用于远程异步协作场景。

常规风险提示：尽管 Skill 本身零风险，但实际运行依赖的底层 cron 调度可能因网关超时导致心跳未清理，需配置 commands.restart 权限以应对极端情况；此外，过于频繁的心跳设置（如低于 1 分钟）可能产生消息轰炸，建议根据任务特性合理配置间隔。