Clawdbot 官方任务状态通知技能，通过 Telegram 实时推送长任务进度，解决异步操作中的用户等待焦虑问题。
说明：
## 核心用法
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 参数可能意外包含敏感路径或业务数据
