核心用法
Slack Skill 是 Maton 平台提供的官方 Slack API 代理服务，采用托管 OAuth 2.0 认证机制，用户无需自行维护 access token。核心能力覆盖四大场景：
1. 消息操作：发送/更新/删除消息、回复线程、定时调度、获取永久链接，支持纯文本与 Block Kit 富媒体格式。
2. 频道管理：列出公开/私有频道、创建/归档/重命名频道、设置主题与用途、邀请/移除成员、标记已读。
3. 用户与社交功能：查询用户列表、获取在线状态、邮件反查、添加反应与收藏、置顶消息、管理书签。
4. 文件与搜索：上传/删除文件、获取上传 URL、按频道或类型筛选文件列表、搜索消息与文件元数据。
调用方式灵活：CLI（maton slack 命令族）、直接 HTTP API（https://api.maton.ai/slack/{method}）或 Python/Node.js 代码示例。多连接场景下可通过 --connection 或 Maton-Connection 头指定目标工作区。
显著优点
- 零配置 OAuth：浏览器一键授权，token 自动轮转，免去自建 Slack App 与权限申请的繁琐流程。
- 完整 API 映射：覆盖 Slack Web API 绝大部分读写端点，包括较新的 Bookmarks、Scheduled Messages 等特性。
- 多语言示例：文档提供 Bash、Python、JavaScript 可直接运行的代码片段，降低接入门槛。
- 精细化权限：支持多连接隔离，便于跨组织或测试/生产环境切换。
潜在缺点与局限
- 速率限制：平台级限速 10 req/s/账户，高并发场景需本地队列缓冲；底层 Slack API 的 Tier 限制同样生效。
- 搜索局限：
search.files仅匹配文件名与标题，不索引文件内容；新文件存在索引延迟。 - 依赖第三方代理：所有请求经过 Maton 中转，若 Maton 服务不可用则链路中断，且存在数据隐私合规考量。
- scope 扩展受限：若需额外 OAuth scope，必须联系 Maton 支持人工开通，无法自助配置。
适合人群
- 需要快速集成 Slack 通知能力的 DevOps/SRE 团队；
- 希望自动化频道生命周期管理的社区运营者；
- 构建内部工具或 CI/CD 流水线通知的开发者；
- 无服务器后台、不愿维护 OAuth 刷新逻辑的轻量级用户。
常规风险
- 凭据泄露：
MATON_API_KEY一旦泄露，攻击者可访问所有已授权 Slack 工作区，需严格遵循最小权限原则并定期轮换。 - 误操作风险：
channel delete、kick、archive等破坏性操作不可逆，文档强调写操作需用户二次确认。 - 数据驻留：消息内容经 Maton 服务器代理转发，敏感行业需评估数据跨境与存储合规性。
- Token 过期：长期运行的自动化任务需监控连接状态，及时处理
invalid_auth或token_revoked异常。