task-status

📡 长任务实时心跳通知专家

🥥30总安装量 6评分人数 3
100% 的用户推荐

Clawdbot 官方任务状态通知技能,通过 Telegram 实时推送长任务进度,解决异步操作中的用户等待焦虑问题。

B

存在边界风险,建议在隔离环境中验证

  • 来自可信组织或认证账号,需要结合权限范围判断
  • ✅ 无恶意代码或后门,功能透明单一,仅发送状态消息
  • ✅ 敏感数据保护良好,Token 通过环境变量管理,无硬编码密钥
  • ✅ 命令执行安全,subprocess 使用列表传参,无注入风险
  • ⚠️ 存在裸 `except::` 捕获,可能吞掉关键异常信息
  • ⚠️ 硬编码 Windows 用户路径和 clawdbot 安装路径,跨平台兼容性受限
  • ⚠️ 状态文件无锁机制,并发场景存在竞态条件风险

使用说明

核心用法

task-status 是专为 Clawdbot 生态设计的任务状态通知技能,解决 AI Agent 执行长耗时操作时用户"黑盒等待"的痛点。它提供两种工作模式:手动状态更新适合 30 秒内的短任务,通过 send_status.py 在关键里程碑推送消息;自动周期监控则针对超过 1 分钟的长任务,,monitor_task.py 以默认 5 秒间隔发送"心跳"更新,直至任务完成。状态类型涵盖 progress(进行中)、success(成功)、error(失败)、warning(警告)四种,每种配有标准化 emoji 标识,消息长度限制 140 字符确保简洁可读。

显著优点

该技能的最大优势在于零侵入集成——无需修改原有业务代码,通过命令行或 Python 导入即可嵌入任何工作流。自动监控模式彻底解放开发者,避免在复杂任务中手动埋点的繁琐。与 Clawdbot 生态深度整合,支持通过 WebSocket 网关或 CLI 双通道发送,且可对接 cron 实现无人值守任务的定时状态检查。消息模板标准化降低了多 Agent 协作时的沟通成本,用户侧获得类 Slack/Discord 的实时进度体验。

潜在缺点与局限性

功能单一性是把双刃剑:它仅支持 Telegram 单通道输出,无法对接企业微信、钉钉等国内常用平台。硬编码路径问题突出——Windows 用户路径 C:/Users/Luffy 和 clawdbot 安装路径写死在代码中,跨平台部署需手动修改。状态文件 .task_status_state.json 缺乏文件锁机制,高频并发场景下可能出现竞态条件。此外,5 秒默认间隔对极短任务过于频繁,而自定义间隔又需额外参数记忆成本。

适合的目标群体

  • Clawdbot 重度用户:已部署该框架的自动化工作流开发者
  • 数据管道工程师:需要监控 ETL、模型训练等小时级任务的进度
  • DevOps 运维人员:CI/CD 流水线中需要实时反馈的部署场景
  • AI Agent 开发者:构建多步骤智能体时提升用户体验的刚需工具

使用风险

1. 依赖项风险:强依赖本地 Clawdbot 网关(默认 127.0.0.1:18789),若网关未启动则所有状态发送失败且无降级方案
2. 网络耦合:Telegram Bot API 在国内访问不稳定,可能导致消息丢失或延迟

3. 资源泄漏:自动监控以独立线程运行,异常退出时可能遗留僵尸进程

4. 信息泄露:状态消息虽经长度限制,但 task_name 和 details 参数可能意外包含敏感路径或业务数据

task-status 内容

文件夹图标references文件夹
文件夹图标scripts文件夹
手动下载zip · 14.9 kB
usage.mdtext/markdown
请选择文件