核心用法
Trello 技能通过 Maton 网关代理，为用户提供托管式 OAuth 认证与完整 Trello REST API 访问能力。用户只需配置 MATON_API_KEY 环境变量，即可通过标准 HTTP 请求操作看板（Board）、列表（List）、卡片（Card）、成员（Member）、标签（Label）及检查清单（Checklist）等资源。
认证流程：在 ctrl.maton.ai 创建 Trello 连接后，通过返回的 OAuth URL 完成授权，后续请求自动注入令牌。支持多连接管理，可通过 Maton-Connection 头部指定特定连接。
典型操作场景：
- 看板管理：创建、更新、删除看板，配置权限级别
- 任务流转：卡片跨列表移动、批量迁移、归档与恢复
- 协作增强：成员分配、评论添加、标签分类、截止日期设置
- 自动化集成：结合搜索 API 构建工作流触发器
显著优点
1. 零配置 OAuth：无需自行处理 Trello 的 OAuth 1.0a 复杂流程，Maton 托管令牌刷新与存储
2. 原生 API 兼容：网关直接透传 Trello API，支持完整功能集（含检查项状态更新、附件管理等高级特性）
3. 多语言示例：提供 Bash/cURL、Python、JavaScript 完整代码片段，降低接入门槛
4. 连接隔离：支持多 Trello 账户（如工作/个人）并行管理，通过 Header 灵活切换
5. 错误透明：状态码与 Trello 原生一致（400/401/404/429），便于调试
潜在局限
- 速率限制：10 req/sec 每账户，高频场景需客户端缓存或队列缓冲
- 网关依赖：服务可用性绑定于 Maton 网关（gateway.maton.ai），非直连 Trello
- ID 管理：Trello 使用 24 位不透明 ID，跨环境迁移需额外映射层
- Webhook 缺失：文档未涵盖实时事件订阅，需轮询实现状态同步
适合人群
- 需要自动化 Trello 工作流的开发团队（CI/CD 看板同步、缺陷自动分配）
- 构建项目管理仪表板的 SaaS 集成商
- 希望避免 OAuth 维护成本的个体开发者
常规风险
- 令牌泄露：
MATON_API_KEY需妥善保管，避免硬编码提交至版本控制 - 误操作覆盖：PUT/DELETE 请求无二次确认，批量脚本需前置备份逻辑
- 时区歧义：日期字段为 ISO 8601 格式，需确保客户端与服务端时区一致
- 权限扩散：OAuth 授权范围与 Trello 账户权限一致，共享连接可能导致非预期数据暴露