Slack 协作助手(生成即用·Slack 频道)
> 触发词:Slack、频道、发消息、线程、Slack 通知、workspace、消息汇总
> 适用场景:把构建失败通知发到 #alerts 等(详见下文)
> 连接与鉴权:Slack 官方提供 Web API 与官方 MCP(slack-mcp),使用 Bot Token 鉴权。
一、核心用途
把 Slack 的协作动作标准化:发消息到指定频道、读线程、搜历史、上传文件、做每日汇总。通过 Slack 官方 MCP/API 执行。
二、适用场景
- 把构建失败通知发到 #alerts
- 读某个线程的上下文摘要
- 搜近一周关于 X 的讨论
- 上传一份报告到频道
- 汇总今日各频道重点消息
三、连接与鉴权(R-去个人化:凭证一律走环境变量,绝不写死 Key/appid/token)
- 接入路径:Slack 官方提供 Web API 与官方 MCP(slack-mcp),使用 Bot Token 鉴权。
- 所需凭证(环境变量占位):
SLACK_BOT_TOKEN:Slack Bot User OAuth Token(xoxb- 开头)SLACK_TEAM_ID:团队 ID,用于 MCP 区分 workspace- 免 Key 说明:否,需在 Slack App 配置 Bot Token(免费创建 App)。
- 国内可达性:Slack 为海外 SaaS,需正常网络出口;Bot 仅能访问被授权的频道。
四、执行流程
- 接收意图与必要参数(如账号、地址、偏好、查询条件)。
- 校验参数完整性,缺失则询问或以默认偏好补全(不自行臆造未知信息)。
- 调用官方 MCP/API(通过 mcporter 或对应客户端工具)执行对应动作。
- 解析返回,格式化输出(订单号/链接/状态/费用/来源等)。
- 涉及支付、下单、删除、改写等敏感动作 → 展示预览并二次确认后执行;异常时 fail-open 不崩溃。
五、输入 / 输出
- 输入:自然语言指令 + 必要参数(账号、地址、偏好、时间等)。
- 输出:结构化结果(订单号、支付链接、状态、费用、来源 URL 等)+ 下一步建议。
六、异常处理(三级)
- 一级(可恢复):参数缺失 → 询问补全后重试。
- 二级(需确认):支付/下单/删除/改写 → 展示预览,用户确认后执行。
- 三级(终止):Key 无效 / 无权限 / 服务不可达 → 报错并给出申请与排查指引,fail-open 不崩。
七、反模式(禁止)
- 禁止写死任何个人 Key / Token / appid / corpid / mch_id(R-去个人化)。
- 禁止未确认就自动支付、下单、删除或改写远端资源。
- 禁止编造平台不支持的能力、精确的 URL 或数值(R-TEST T3)。
- 禁止越权读取他人账号数据。
八、FAQ
Q:会读所有频道的消息吗?
A:只能读 Bot 被邀请且有权限的频道;禁止越权访问私有频道。
Q:能发线程回复吗?
A:能,可指定 thread_ts 在 threaded 下回复。
九、领域参考
- 详见
references/connect.md:官方端点、申请步骤、MCP 客户端配置样例与最小权限提示。