核心用法
Slack skill 是 Maton 平台提供的托管式 Slack API 集成方案，采用 OAuth 2.0 授权机制，用户无需自行管理复杂的 Slack App 配置和令牌刷新流程。通过统一的网关地址 https://gateway.maton.ai/slack/{method}，开发者可以调用完整的 Slack Web API，包括消息发送（chat.postMessage）、频道管理（conversations.list/info）、用户查询（users.list/info）、消息搜索（search.messages）、文件上传（files.upload）以及线程回复等核心功能。
使用前需在 Maton 控制台创建连接并完成 OAuth 授权，获取 connection_id 后，所有请求仅需携带 Maton API Key（Authorization: Bearer $MATON_API_KEY），网关会自动注入对应的 Slack OAuth Token。支持多连接管理，可通过 Maton-Connection 头指定特定工作区。
显著优点
1. 零配置 OAuth：免去自建 Slack App、配置重定向 URL、处理令牌过期等繁琐流程
2. 统一认证层：单一 Maton API Key 管理多个 Slack 工作区连接，降低密钥泄露风险
3. 完整 API 覆盖：支持 Block Kit 富文本、线程消息、表情反应、文件上传等高级特性
4. 多语言示例：提供 JavaScript、Python 等主流语言的现成代码片段
5. 连接可视化管理：通过 ctrl.maton.ai 面板可查看连接状态、创建/删除授权
潜在缺点与局限性
- 平台依赖性：完全绑定 Maton 网关，若服务中断将直接影响 Slack 集成
- 速率限制：默认 10 req/sec 的账户级限流，高并发场景需自行控制频率
- 权限边界：实际可调用范围受 OAuth 授权时用户勾选权限限制，无法突破 Slack 原生权限体系
- 调试透明度有限：4xx/5xx 错误为 Slack API 透传，部分场景下错误信息不够详细
适合人群
- 需要快速集成 Slack 但不愿维护 OAuth 流程的中小团队
- 已在 Maton 生态中使用其他技能（如 Notion、GitHub）的用户
- 构建内部工具、CI/CD 通知机器人、运营自动化工作流的开发者
常规风险
- 令牌泄露：Maton API Key 一旦泄露，攻击者可访问所有关联的 Slack 连接
- 数据隐私：消息内容、文件上传均经过 Maton 网关，需评估数据合规要求
- 授权范围过大：OAuth 授权时若勾选过多权限，可能导致最小权限原则被破坏
- 连接失效：Slack 工作区管理员撤销应用授权后，连接将失效，需监控
status状态