Trello

核心用法

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 账户权限一致，共享连接可能导致非预期数据暴露

核心用法

Trello Skill 通过 Maton 网关代理访问官方 Trello API，用户需先获取 Maton API Key 并完成 OAuth 授权。支持完整的看板生命周期管理：创建/归档看板、添加列表与卡片、分配成员、设置标签颜色、添加评论与检查清单等。所有请求通过 gateway.maton.ai/trello/{path} 转发，自动注入用户 OAuth Token，无需手动处理 Trello 原生认证。

显著优点

1. 零配置 OAuth：Maton 集中管理 Trello OAuth 连接，支持多账户切换，避免密钥泄露风险
2. 完整 API 覆盖：涵盖 Boards、Lists、Cards、Checklists、Labels、Members、Search 七大核心模块
3. 多语言示例：提供 Python/urllib、Python/requests、JavaScript/fetch 三种代码模板，降低接入门槛
4. 连接隔离机制：通过 Maton-Connection 头部可显式指定连接，支持团队多账户场景

潜在局限

• 网关依赖：所有流量需经过 Maton 网关，若网关不可用则服务中断
• 速率限制：Trello 原生限制 10 req/sec，高频操作可能触发 429 错误
• 功能边界：仅封装 REST API，不包含 Trello 的实时 Webhook 功能
• 地域延迟：网关服务器位置可能影响海外用户响应速度

适合人群

• 需要自动化 Trello 工作流的开发团队
• 希望通过代码批量管理看板的项目经理
• 构建内部项目管理工具的技术负责人
• 已有 Maton 账户、追求 OAuth 安全托管的用户

常规风险

1. API Key 泄露：若 MATON_API_KEY 被硬编码或误提交至版本库，可能导致账户被滥用
2. 数据误操作：Delete 操作不可逆，批量脚本需先测试再执行
3. 权限范围：OAuth 授权默认获取全部看板权限，敏感项目需单独配置连接