Trello看板管理

技能简介

该技能通过Trello REST API直接操作看板、列表和卡片，支持在命令行环境中完成项目管理的常见操作。

业务背景

该技能让业务人员直接在命令行环境中管理Trello看板，无需打开网页即可完成看板浏览、列表查看和卡片创建等高频操作。特别适合需要快速响应、批量处理或集成到自动化脚本中的项目管理场景，提升敏捷团队的执行效率。

落地案例：运营团队每日需同步多平台任务状态：通过配置环境变量后，执行单行命令即可拉取所有看板清单，筛选出当日待办列表并导出卡片详情；遇到紧急需求时，直接在终端创建新卡片并指派负责人，整个过程无需离开开发环境或打开Trello界面，显著缩短操作路径。

能做什么

• 查看个人名下的所有看板及其ID
• 获取指定看板内的列表结构
• 列出列表中的全部卡片及描述信息
• 创建新卡片并设置标题与内容
• 将卡片移动到其他列表
• 为卡片添加评论
• 归档已完成或废弃的卡片

使用说明

前置准备（安装与配置）

1. 确保系统已安装 curl 和 jq 工具
2. 访问 https://trello.com/app-key 获取API Key
3. 在同一页面点击”Token”链接生成访问令牌
4. 设置环境变量：

   export TRELLO_API_KEY="your-api-key"
   export TRELLO_TOKEN="your-token"

常用操作示例

查看所有看板：

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 -X POST "https://api.trello.com/1/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
  -d "idList={listId}" \
  -d "name=卡片标题" \
  -d "desc=卡片描述"

移动卡片：

curl -s -X PUT "https://api.trello.com/1/cards/{cardId}?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
  -d "idList={newListId}"

归档卡片：

curl -s -X PUT "https://api.trello.com/1/cards/{cardId}?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
  -d "closed=true"

输入与输出

见下方输入与输出表格。

风险提示

• API Key和Token具有账户完全访问权限，需妥善保管，避免硬编码在公开代码库中
• 存在速率限制：每API Key每10秒300次请求；每Token每10秒100次请求；成员相关接口每900秒100次请求
• 频繁调用可能导致临时封禁，建议在批量操作时加入延时
• Board/List/Card ID需从URL或列表命令中获取，手动输入时注意核对

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/chaunceyliu/test1/SKILL.md
来源类型：GitHub仓库