Trello 技能

直接通过 Clawdbot 管理 Trello 看板、列表和卡片。

配置

1. 获取您的 API 密钥：https://trello.com/app-key
2. 生成 Token（点击该页面上的 “Token” 链接）
3. 设置环境变量：

   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"

注意事项

• 看板 ID / 列表 ID / 卡片 ID 可在 Trello URL 中找到，也可通过上述 list 命令获取
• API 密钥与 Token 对您的 Trello 账户具有完全访问权限，请务必保密！
• 速率限制：每个 API 密钥每 10 秒最多 300 次请求；每个 Token 每 10 秒最多 100 次请求；/1/members 类端点每 900 秒最多 100 次请求

示例

# 获取所有看板
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}'