channel_message — CLI для отправки сообщений через мессенджеры

--- name: channel_message description: Use this skill to proactively send a one-way message to a user/session/channel, usually only when the user explicitly asks to send to a channel/session or when proactive notification is needed. First query sessions with copaw chats list, then push with copaw channels send. | 当需要主动向用户/会话/频道单向推送消息时使用，通常仅在用户明确要求发往某个 channel / 会话，或需要主动通知时使用；先用 copaw chats list 查 session，再用 copaw channels send 推送 metadata: { "builtin_skill_version": "1.0", "copaw": { "emoji": "📤" } } --- # Channel Message（频道消息推送） ## 什么时候用 通常只有在**用户明确要求向某个 channel / 会话发送消息**，或你需要**主动推送通知**（如任务完成、提醒、告警）时，使用本 skill。 这是**单向发送**，**不会返回回复**。 ### 应该使用 - 用户明确要求发往某个 channel / 会话 - 任务完成后主动通知用户 - 定时提醒、告警、状态更新 - 将异步结果推送回某个已有会话 - 用户明确要求"处理完后通知我" ### 不应使用 - 如果只是当前会话中的正常回复，**不要使用 `copaw channels send`** - 需要和用户进行双向对话并立即等待回复 - 还不知道目标 session 是哪个 - 想当然猜测 `target-user` 或 `target-session` ## 决策规则 1. **通常只有在用户明确要求发往某个 channel / 会话，或需要主动通知时才使用** 2. **发送前必须先查 session** 3. **不要猜 `target-user` 和 `target-session`** 4. **如果查到多个 session，优先使用最近活跃的** 5. **`channel send` 是单向推送，不会返回用户回复** --- ## 最常用命令 ### 1) 先查询可用 sessions ```bash copaw chats list --agent-id <your_agent> --channel <channel> ``` 也可以按用户筛选： ```bash copaw chats list --agent-id <your_agent> --user-id <user_id> ``` ### 2) 发送消息 ```bash copaw channels send --agent-id <your_agent> --channel <channel> --target-user <user_id> --target-session <session_id> --text "..." ``` --- ## 最小工作流 ``` 1. 判断：是否为用户明确要求发送，或是否需要主动通知 2. copaw chats list 查询目标 session 3. 从结果中获取 user_id 和 session_id 4. 若有多个 session，优先选最近活跃的 5. copaw channels send 发送消息 6. 结束（无回复） ``` --- ## 关键规则 ### 必填参数 `copaw channels send` 必须同时提供： - `--agent-id` - `--channel` - `--target-user` - `--target-session` - `--text` ### 必须先查询 发送前先执行： ```bash copaw chats list --agent-id <your_agent> --channel <channel> ``` 从结果中获取： - `user_id` → `--target-user` - `session_id` → `--target-session` 如果有多个候选 session，优先选择 `updated_at` 最近的会话。 ### 单向推送 `copaw channels send` 只负责发送，不等待回复。 --- ## 简短示例 ### 用户明确要求发往某个 channel ```bash copaw chats list --agent-id notify_bot --channel feishu copaw channels send --agent-id notify_bot --channel feishu --target-user manager_id --target-session manager_session --text "周报已生成，请查收" ``` ### 任务完成通知 ```bash copaw chats list --agent-id task_bot --channel console copaw channels send --agent-id task_bot --channel console --target-user alice --target-session alice_console_001 --text "✅ 任务已完成" ``` ### 异步结果回推 ```bash copaw chats list --agent-id analyst_bot --user-id alice copaw channels send --agent-id analyst_bot --channel console --target-user alice --target-session alice_console_001 --text "数据分析已完成，结果已保存到 report.pdf" ``` --- ## 常见错误 ### 错误 1：把正常回复当成 channel send 如果你正在当前会话里直接回复用户，不要使用 `copaw channels send`。 ### 错误 2：没查 session 就直接发 不要猜 `target-user` 或 `target-session`，先执行： ```bash copaw chats list --agent-id <your_agent> --channel <channel> ``` ### 错误 3：缺少必填参数 `--agent-id`、`--channel`、`--target-user`、`--target-session`、`--text` 五个都必填。 ### 错误 4：以为 send 会拿到回复 不会。它只是推送消息。 ### 错误 5：用户有多个 session 时随便选一个 应优先选择最近活跃的 session。 --- ## 可选命令 ### 查看所有会话 ```bash copaw chats list --agent-id <your_agent> ``` ### 查看某个用户的会话 ```bash copaw chats list --agent-id <your_agent> --user-id <user_id> ``` ### 查看可用频道 ```bash copaw channels list --agent-id <your_agent> ``` --- ## 与 Agent Chat 的区别 - **copaw agents chat**：发给其他 agent，双向，有回复 - **copaw channels send**：发给用户/会话/频道，单向，无回复 **选择原则**： - 要找其他 agent 协作 → `copaw agents chat` - 要主动给用户推送消息 → `copaw channels send` --- ## 完整参数说明 ### copaw chats list **必填参数**： - `--agent-id`：Agent ID **可选参数**： - `--channel`：按频道筛选 - `--user-id`：按用户筛选 - `--base-url`：覆盖API地址 ### copaw channels send **必填参数**（5个）： - `--agent-id`：发送方agent ID - `--channel`：目标频道（console/dingtalk/feishu/discord/imessage/qq/...） - `--target-user`：目标用户ID（从 `copaw chats list` 获取） - `--target-session`：目标会话ID（从 `copaw chats list` 获取） - `--text`：消息内容 **可选参数**： - `--base-url`：覆盖API地址 --- ## 帮助信息 随时使用 `-h` 查看详细帮助： ```bash copaw channels -h copaw channels send -h copaw chats -h copaw chats list -h ```