用途:这是 Trello MCP Server 的配套使用技能,属于调用任何 Trello MCP 工具(trelloRead*、trelloWrite*、trelloSearch)前必须加载的前置说明,用于规范参数格式与调用方式。
主要能力与规则:
- 先识别当前用户:调用 trelloReadMember 的 get_me 获取已认证用户资料,含 prefs.timezone。处理相对时间(如“明天下午1点”)前先解析时区并转换为 UTC。
- ARI id 格式:所有 id 类型参数(cardId、boardId、listId、workspaceId、checklistId、itemId、labelId、plannerCalendarId、providerAccountId)都是 ARI,不是原始 Trello 对象 id。多数为工作区范围,形如 ari:cloud:trello::<entity>/workspace/<workspaceObjectId>/<entityObjectId>;action、member、planner calendar 无 workspace 段,第三方账号使用 ari:third-party:<provider>::account/<providerAccountId>。必须先用读工具取得 ARI,不可自行构造或猜测;写工具拒绝 Trello URL 或短链。仅 trelloReadBoard(get) 接受看板 URL、trelloReadCard(get) 接受卡片 URL。
- 日期一律为 UTC ISO 8601,如 2026-06-01T17:00:00.000Z。卡片与 Inbox 用 get_me 的 prefs.timezone,Planner 事件用 trelloReadPlanner(get) 的 primaryCalendar.timezone;未给时间默认本地 09:00。
- Inbox 不是看板,须用 trelloReadInbox/trelloWriteInbox;新建 Inbox 卡片不接受 pos,总在顶部。
- 有序创建:需要固定顺序时,为 pos 设置互不相同的连续整数(1、2、3…),作用域按父级划分,可并行创建。
- 分页:列表类读工具使用游标分页,hasNextPage/hasMore 为真时继续翻页。
- 嵌套字段为预览:listsHasMore、labelsHasMore、checklistsHasMore、commentsHasMore 为 true 表示被截断,需用对应 action 完整获取;卡片自身标签或成员无专用 action,预览即为上限。
限制:资料未提供安装命令、收费、平台支持等细节,暂未提供。