核心用法
Trello Skill 通过 Maton 的 API 网关 gateway.maton.ai 代理访问 Trello REST API，采用双重认证机制：用户需先从 maton.ai 获取 MATON_API_KEY，再通过 ctrl.maton.ai 完成 Trello OAuth 授权建立连接。所有请求需在 HTTP Header 中携带 Authorization: Bearer $MATON_API_KEY，多账户场景可指定 Maton-Connection 头部选择特定连接。
该 Skill 完整覆盖 Trello 核心实体操作：
- 看板（Boards）：创建、更新、删除、归档，支持权限配置（private/public）
- 列表（Lists）：在看板内创建任务流，支持归档和卡片批量迁移
- 卡片（Cards）：完整的 CRUD 操作，支持截止日期、成员分配、标签关联、评论添加、附件管理
- 检查清单（Checklists）：任务拆解与子项完成状态追踪
- 标签（Labels）：10 色分类系统，支持动态创建与关联
- 搜索（Search）：跨实体全文检索，支持模型类型过滤
显著优点
1. 零凭证管理负担：OAuth 令牌由 Maton 托管，无需开发者处理 Trello API Key/Token 的存储与轮换
2. 原生 API 语义保留：网关仅做路径代理（/trello/{native-api-path}），请求体、查询参数与 Trello 官方 API 1:1 兼容，降低迁移成本
3. 多账户灵活切换：通过 Maton-Connection 头部可在同一环境中操作多个 Trello 工作区
4. 开发友好：提供 Python、JavaScript、Bash 多语言示例，错误码透传便于调试
潜在缺点与局限性
1. 依赖第三方网关：所有流量需经过 maton.ai 基础设施，若其服务中断则完全不可用；文档提示需关注网络连通性
2. 速率限制不可控：Trello 侧限制为 10 req/sec/账户，网关层可能叠加额外限流，高并发场景需自行实现退避重试
3. 功能边界：不支持 Trello 的 Power-Ups 扩展、自定义字段（Custom Fields）插件化操作、以及 Webhook 订阅管理，仅覆盖核心 REST 资源
4. 数据驻留不透明：OAuth 令牌与 API 流量经过 Maton 服务器，企业合规场景需评估数据主权与审计要求
适合人群
- 敏捷团队开发者：需快速集成看板功能到内部工具或 CI/CD 流水线
- 自动化运维人员：通过脚本批量管理项目看板、同步任务状态
- 中小团队技术负责人：寻求免运维 OAuth 方案，避免自建认证服务
- AI Agent 构建者：为 LLM 工具链提供结构化任务管理能力
常规风险
- 密钥泄露：
MATON_API_KEY作为全局凭证，若硬编码或日志泄露可能导致所有托管连接被滥用 - 误操作不可逆：Delete 操作直接映射 Trello API，无回收站机制，批量删除看板或卡片将永久丢失数据
- OAuth 会话过期：连接可能因 Trello 侧授权撤销或长时间未使用进入非 ACTIVE 状态，需监控
status字段并引导用户重新授权 - 隐私合规：卡片内容、成员信息可能包含 PII，通过第三方网关传输需确认数据处理协议（DPA）覆盖范围