任务状态技能

快速开始

手动状态更新

python scripts/send_status.py "开始数据获取..." "progress" "step1"
python scripts/send_status.py "处理完成" "success" "final"
python scripts/send_status.py "错误：缺少API密钥" "error" "auth"

自动定期监控（每5秒）

# 开始监控一个长时间运行的任务
python scripts/monitor_task.py start "我的长任务" "processing"

# 监控程序将每5秒发送"仍在处理中..."的更新
# 当任务完成时，报告最终状态
python scripts/monitor_task.py stop "我的长任务" "success" "成功完成！"

状态类型

• progress: 进行中的工作（显示🔄或->）
• success: 任务完成（显示✅或OK）
• error: 任务失败（显示❌或!）
• warning: 有问题但继续执行（显示⚠️或?）

定期监控

该monitor_task.py脚本提供自动更新：

启动监控

python scripts/monitor_task.py start "<任务名称>" "<状态类型>" [--interval <秒数>]

• 每5秒自动发送"仍在处理中..."的更新
• 在后台运行直至停止
• 可使用不同的时间间隔进行自定义

停止监控

python scripts/monitor_task.py stop "<任务名称>" "<最终状态>" "<最终消息>"

示例：长文件处理

# 开始监控
python scripts/monitor_task.py start "视频处理" "progress"

# ... 这里进行长时间的处理 ...

# 以最终状态停止
python scripts/monitor_task.py stop "视频处理" "success" "处理完成！"

手动更新（快速状态）

用于无需监控的单一状态更新：

python scripts/send_status.py "仍在获取数据..." "progress" "fetch"
python scripts/send_status.py "处理记录：250/1000" "progress" "process"
python scripts/send_status.py "完成！3个文件已就绪" "success" "final"
python scripts/send_status.py "错误：连接超时" "error" "api"

何时使用每种方法

在以下情况使用手动更新：

• 任务时间短（30秒以内）
• 您想控制何时发送更新
• 任务具有离散的、有意义的里程碑

在以下情况下使用定期监控：

• 任务运行时间较长（超过1分钟）
• 您希望每5秒获得一次稳定的“心跳”更新
• 任务有长时间的无响应工作期
• 您希望向用户确认工作仍在进行中

消息指南

状态消息保持在140个字符以内。示例：

• 进度："正在获取数据..." 或 "处理记录中：250/1000"
• 成功："完成！3个文件已就绪" 或 "任务成功完成"
• 错误："错误：连接超时" 或 "失败：缺少API密钥"
• 警告："尽管超时，仍继续执行" 或 "部分成功：5/10个文件"

高级用法

带附加详情

python scripts/send_status.py "正在上传..." "progress" "upload" --details "文件：report.pdf (2.4MB)"

不同间隔

python scripts/monitor_task.py start "data_sync" "progress" --interval 10

在Python脚本中导入

from send_status import send_status

def long_task():
    send_status("开始...", "progress", "step1")
    # ... 工作
    send_status("步骤完成", "success", "step1")

使用Clawdbot Cron实现自动化

对于计划任务，使用Clawdbot的cron功能：

# 在脚本或会话中
from cron import add

# 每5秒检查一次状态
job = {
    "text": "检查状态更新",
    "interval": "5s",
    "enabled": True
}
add(job)

这样即使您没有主动监控，也能获得状态更新。

安装

要使用此技能，请将task-status文件夹复制到您的Clawdbot技能目录：

C:\Users\Luffy\AppData\Roaming\npm\node_modules\clawdbot\skills\task-status

或将其添加到您的工作区，并从AGENTS.md或TOOLS.md中引用。

安装完成后，该技能将在任何需要定期状态更新的任务中可用。