SuperAPI AI 工具集

telegram-draft-for-review

办公与效率

查看项目

更新于 10-16 05:03

技能介绍

用途:为外发 Telegram 消息提供人工在环(HITL)门控。系统告警仍走 swarm/telegram_alerts.py 直接发送;但看起来像本人发言的消息(回复、评论、摘要草稿)必须先经审核。

主要能力:调用方传入草稿负载(draft_text、destination_chat_id、destination_thread_id、drafted_by_role、originating_intent_id)。技能将草稿发到 REVIEW_CHAT_ID,格式含草稿正文与“React 👍 to send · ❌ to revise · ⏳ to delay 24h”。同步返回 {"draft_id": "...", "review_message_id": "...", "status": "pending"},最终状态回调异步发生。状态流转:👍→sent 并调用现有 send_telegram();❌→revise 并通知原角色;⏳→deferred 延长 24h;到期无反应→expired 且不发送。所有状态变更写入 .harness/swarm.jsonl,待处理条目写入 .harness/telegram_drafts.jsonl。

安全绑定:TAO_SWARM_ENABLED=0 时草稿仍可发布到审核聊天,但 sent 不被执行,发送在调用边界被拦截;草稿继承审核聊天 <1 msg/s、<20/min/group 限速,超限则排队;PII 脱敏器(Wave 2)绑定在审核发布与最终发送之前,Wave 1 缺失仅告警不阻断。

使用方式:需配置新环境变量 REVIEW_CHAT_ID,建议使用与现有告警聊天分离的私有 1:1 聊天;首次调用若缺失应提示。测试模式 TAO_DRAFT_REVIEW_TEST=1 下不实际发 Telegram,写入 jsonl 并返回合成 review_message_id,可通过 stdin 接受合成反应验证状态流转。

适用场景:以人名义发出的 Telegram 回复、评论、草稿摘要等。

限制:不适用于系统告警;不处理已有草稿上的反应门控信号;Linear 评论、多收件人门控、Email/Slack 草稿审核均未实现。真实反应监听需扩展 swarm/orchestrator.py,属 Wave 2;端到端实测也在 Wave 2。