强制进度检查点。当龙虾助手在执行任务时超过60秒没有完成,必须立即向用户发送进度反馈,说明:任务是否正常运行、当前执行到哪个步骤、预计还要多久。用于防止用户对长时间运行任务的不确定感。 触发场景:搜索/爬虫、文件批量处理、多步骤写作、调用外部API 核心格式: 📋 进度更新(已运行约N秒) ✅ 当前状态:正在做什么 📍 进度:执行到哪个步骤 ⏱ 预计还需:估算时间 [继续执行...]

强制进度检查点。当龙虾助手在执行任务时超过60秒没有完成,必须立即向用户发送进度反馈,说明:任务是否正常运行、当前执行到哪个步骤、预计还要多久。用于防止用户对长时间运行任务的不确定感。

Audits

Pass

Install

openclaw skills install long-task-checkin

Long Task Check-in

核心规则

当任务执行时间超过60秒时,必须立即向用户发送进度反馈,再继续工作。

这是最高优先级规则。即使任务只差最后一步,也要先发进度再完成。

触发判断

需要主动检查-in的任务类型:

  • 搜索、爬虫、数据抓取(预计超过30秒)
  • 文件批量处理(超过5个文件)
  • 多步骤写作/创作任务
  • 调用外部API且响应不确定
  • 任何预计运行时间不确定的任务

不需要检查-in:

  • 简单问答(5秒内能回复的)
  • 单次文件读写
  • 即时返回结果的工具调用

消息格式(严格遵守)

📋 进度更新(已运行约{N}秒)

✅ 当前状态:{正在做什么}
📍 进度:{执行到哪个步骤了}
⏱ 预计还需:{估算时间}

[继续执行...]

格式要求:

  • 第一行必须有emoji和运行时间
  • ✅ 当前状态:要用通俗语言,说明正在做什么,不是代码层面的"tool call"
  • 📍 进度:必须量化(例:3/10个平台、第2步、共5步)
  • ⏱ 预计还需:给一个模糊估算即可("约30秒"、"几分钟")
  • 最后一行写"继续执行..."表示任务还在进行

各类任务示例

搜索类

📋 进度更新(已运行约75秒)

✅ 当前状态:正在搜索各平台新能源汽车热点
📍 进度:已完成抖音、小红ishi、微博,共3/8个平台
⏱ 预计还需:约1分钟

[继续搜索剩余平台...]

写作类

📋 进度更新(已运行约90秒)

✅ 当前状态:正在撰写短视频脚本
📍 进度:已完成开头和干货部分,正在写结尾
⏱ 预计还需:约1分钟

[继续完成结尾和开场白设计...]

文件处理类

📋 进度更新(已运行约60秒)

✅ 当前状态:正在处理30个文档的格式转换
📍 进度:已完成12/30个文件
⏱ 预计还需:约2分钟

[继续处理剩余文件...]

遇到问题时的反馈

📋 进度更新(已运行约65秒)

✅ 当前状态:搜索热点信息
📍 进度:已完成5/8个平台,第6个平台遇到限流
⏱ 预计还需:等待限流恢复,约1-2分钟

[等待限流恢复后继续...]```

## 注意事项

1. **不要等完成才汇报**——即使只完成一小步,也要说出进度
2. **语言通俗易懂**——说"正在搜索"而不是"正在调用搜索工具"
3. **主动说明问题**——遇到限流、错误等也要及时反馈,不要假装没事
4. **时间估算保守**——宁可多说一点时间,不要预估太乐观
5. **发送后再继续**——发完进度消息再继续执行任务,不要同时进行