Task Status 技能用于在聊天中为长时间运行的任务发送简短状态描述,帮助执行多步操作时持续反馈进度。
主要能力:
- 手动状态更新:通过 send_status.py 脚本发送单条状态消息,可指定消息内容、状态类型和步骤标识,还可附加详细信息。
- 自动周期监控:通过 monitor_task.py 脚本启动后台监控,每隔一定时间(默认 5 秒)自动发送“仍在进行”的更新,直到手动停止并报告最终状态。
- 状态类型:progress(进行中)、success(完成)、error(失败)、warning(有问题但继续)。
使用方式: 手动更新示例: python scripts/send_status.py "Starting data fetch..." "progress" "step1" python scripts/send_status.py "Processing complete" "success" "final" python scripts/send_status.py "Error: Missing API key" "error" "auth"
自动监控示例: 启动监控:python scripts/monitor_task.py start "My Long Task" "processing" 停止并报告最终状态:python scripts/monitor_task.py stop "My Long Task" "success" "Completed successfully!" 可自定义间隔:python scripts/monitor_task.py start "data_sync" "progress" --interval 10
附加详情:python scripts/send_status.py "Uploading..." "progress" "upload" --details "File: report.pdf (2.4MB)"
在 Python 脚本中导入使用: from send_status import send_status
def long_task(): send_status("Starting...", "progress", "step1") # ... work send_status("Step complete", "success", "step1")
结合 Clawdbot Cron 自动化: 在脚本或会话中使用 cron 功能添加定时任务,例如每 5 秒检查状态更新: from cron import add job = { "text": "Check status update", "interval": "5s", "enabled": True } add(job)
适用场景:
- 短任务(少于 30 秒)或希望自行控制更新时机、任务有离散里程碑时,建议使用手动更新。
- 长任务(超过 1 分钟)、需要持续心跳更新、任务有长时间安静工作期、希望向用户确认工作仍在进行时,建议使用周期监控。
限制与注意:
- 状态消息建议控制在 140 字符以内。
- 安装方式:将 task-status 文件夹复制到 Clawdbot 技能目录(如 C:\Users\Luffy\AppData\Roaming\npm\node_modules\clawdbot\skills\task-status),或添加到工作区并在 AGENTS.md 或 TOOLS.md 中引用。
- 其他限制暂未提供。