Trello Skill 用于通过 Trello REST API 管理 Trello 的看板、列表和卡片，可直接在 Clawdbot 中操作。
用途 该技能面向需要以命令行方式管理 Trello 内容的场景，覆盖看板、列表、卡片三个层级的查询与操作。
主要能力
- 列出看板
- 列出某个看板中的列表
- 列出某个列表中的卡片
- 创建卡片
- 将卡片移动到另一个列表
- 给卡片添加评论
- 归档卡片
使用方式
- 获取 API Key：访问 https://trello.com/app-key
- 生成 token：在该页面点击 “Token” 链接
- 设置环境变量： export TRELLO_API_KEY="your-api-key" export TRELLO_TOKEN="your-token"
- 所有命令均使用 curl 调用 Trello REST API。
示例命令： 列出看板 curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id}'
列出看板中的列表 curl -s "https://api.trello.com/1/boards/{boardId}/lists?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id}'
列出列表中的卡片 curl -s "https://api.trello.com/1/lists/{listId}/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id, desc}'
创建卡片
curl -s -X POST "https://api.trello.com/1/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN"
-d "idList={listId}"
-d "name=Card Title"
-d "desc=Card description"
移动卡片到另一个列表
curl -s -X PUT "https://api.trello.com/1/cards/{cardId}?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN"
-d "idList={newListId}"
给卡片添加评论
curl -s -X POST "https://api.trello.com/1/cards/{cardId}/actions/comments?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN"
-d "text=Your comment here"
归档卡片
curl -s -X PUT "https://api.trello.com/1/cards/{cardId}?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN"
-d "closed=true"
更多示例： 获取所有看板 curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN&fields=name,id" | jq
按名称查找特定看板 curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | select(.name | contains("Work"))'
获取看板上的所有卡片 curl -s "https://api.trello.com/1/boards/{boardId}/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, list: .idList}'
注意事项
- 看板、列表、卡片 ID 可在 Trello URL 中找到，或通过列表命令获取。
- API Key 和 Token 提供对 Trello 账号的完整访问权限，请务必保密。
- 速率限制：每个 API Key 每 10 秒 300 次请求；每个 token 每 10 秒 100 次请求；/1/members 端点限制为每 900 秒 100 次请求。