trello-automation

Trello Automation 通过 Composio 的 Rube MCP 集成，实现对 Trello 看板管理、卡片创建和团队工作流的自动化。

用途

该技能用于以编程方式操作 Trello，包括创建卡片、管理列表、分配成员、搜索卡片、添加评论与附件等，适合需要自动化 Trello 任务管理的场景。

主要能力

• 创建卡片：在指定列表上创建卡片，可添加清单及清单项。
• 管理看板与列表：列出用户看板、获取看板详情、列表、成员、标签。
• 移动卡片：通过更新卡片的 idList 将卡片移动到其他列表。
• 分配成员：将看板成员添加到卡片。
• 搜索与过滤卡片：使用查询字符串搜索卡片，支持 board:、list:、label:、is:open/archived 等操作符。
• 添加评论与附件：在卡片上发布评论，附加文件或 URL。

使用方式

前置条件

• Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）。
• 通过 RUBE_MANAGE_CONNECTIONS 激活 Trello 连接，工具包为 trello。
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具架构。

设置

1. 获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥，只需添加端点即可。
2. 确认 RUBE_SEARCH_TOOLS 有响应，验证 Rube MCP 可用。
3. 调用 RUBE_MANAGE_CONNECTIONS，工具包为 trello。
4. 如果连接未激活，按照返回的认证链接完成 Trello 认证。
5. 确认连接状态显示为 ACTIVE 后再运行任何工作流。

核心工作流

1. 在看板上创建卡片：先列出看板找到目标看板 ID，再获取看板列表找到目标列表 ID，然后创建卡片，可选添加清单及清单项。
2. 管理看板与列表：列出所有看板、获取看板详情、列表、成员、标签。
3. 在列表间移动卡片：搜索卡片，获取目标列表 ID，更新卡片的 idList。
4. 为卡片分配成员：获取看板成员 ID，将成员添加到卡片。
5. 搜索与过滤卡片：使用查询字符串搜索，设置 modelTypes 为 'cards'。
6. 添加评论与附件：发布评论，附加文件或 URL。

常见模式

• ID 解析：始终将显示名称解析为 ID 后再操作。看板名称→看板 ID，列表名称→列表 ID，卡片名称→卡片 ID，成员名称→成员 ID。
• 分页：大多数列表端点返回所有项目。对于有 1000+ 卡片的看板，使用 limit 和 before 参数。
• 速率限制：每令牌每 10 秒 300 次请求。使用 TRELLO_GET_BATCH 进行批量读取。

适用场景

• 需要自动化 Trello 卡片创建、移动、分配等重复性任务。
• 跨看板搜索和过滤卡片。
• 为卡片添加评论或附件以补充上下文。

限制

• 几乎所有工具需要 ID 而非显示名称，必须先解析名称到 ID。
• 看板 ID 必须是 24 字符十六进制或 8 字符 shortLink，URL 别名如 'my-board' 无效。
• 搜索索引有延迟，新建或更新的卡片可能不会立即出现。
• 响应数据常嵌套（data.data 或 data.details[]），需防御性解析。
• 速率限制为每令牌每 10 秒 300 次请求。
• 评论不支持文件附件，需单独使用附件工具。
• 附件删除不可逆。
• 更新卡片成员会替换整个成员列表，追加需使用添加成员工具。
• 成员必须具有看板权限。
• 清单项每次 API 调用只能添加一个，大型清单可能触发速率限制。
• 移动卡片不会更新在新列表中的位置，如需排序需设置 pos。
• 搜索返回部分匹配，更新前需验证卡片名称。
• 搜索查询使用分词，常见词可能被忽略。
• ISO 8601 时间戳带尾部 'Z' 必须按带时区解析。
• 部分运行返回的看板在 response.data.details[] 下，不要假设是扁平顶层数组。
• 列表可能嵌套在 results[0].response.data.details 下，需防御性解析。

快速参考

任务	工具 Slug	关键参数
列出用户看板	TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER	idMember='me', filter='open'
获取看板详情	TRELLO_GET_BOARDS_BY_ID_BOARD	idBoard (24 字符十六进制)
列出看板列表	TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD	idBoard
创建卡片	TRELLO_ADD_CARDS	idList, name, desc, pos, due
更新卡片	TRELLO_UPDATE_CARDS_BY_ID_CARD	idCard, idList (移动时)
搜索卡片	TRELLO_GET_SEARCH	query, modelTypes='cards'
添加清单	TRELLO_ADD_CARDS_CHECKLISTS_BY_ID_CARD	idCard, name
添加评论	TRELLO_ADD_CARDS_ACTIONS_COMMENTS_BY_ID_CARD	idCard, text
分配成员	TRELLO_ADD_CARDS_ID_MEMBERS_BY_ID_CARD	idCard, value (成员 ID)
附加文件/URL	TRELLO_ADD_CARDS_ATTACHMENTS_BY_ID_CARD	idCard, url 或 file
获取看板成员	TRELLO_GET_BOARDS_MEMBERS_BY_ID_BOARD	idBoard
批量读取	TRELLO_GET_BATCH	urls (逗号分隔路径)