前言¶
团队在 Trello 上排期、跟需求时，常见做法是切到浏览器查板子、拖卡片，或自己写脚本调 API。若希望对话式 Agent 能按你的意图列出看板、建卡、挪列、留言，需要一份把 Trello 官方 REST 约定和鉴权写清楚的 Skill，而不是让模型凭记忆拼 URL。下面介绍 SkillHub 社区技能 @user_b69d30ec/11111（上架名称 11111，包内 SKILL.md 的 name 为 trello），它把环境变量、curl 示例和限流说明收在一处，便于在 Cursor 等客户端里启用后按步骤操作。
这是什么¶
11111 在 SkillHub 上的简介为：Manage Trello boards, lists, and cards via the Trello REST API.（通过 Trello REST API 管理看板、列表与卡片。）
- 坐标：
@user_b69d30ec/11111 - 版本：1.0.0
- 分类：business-ops
- 来源：community（发布者
user_b69d30ec） - 标签：
requires_api_key=true（实际还需 Trello Token，见下文 Setup）
技能正文说明可在 Agent（文中以 Clawdbot 语境描述）侧直接管理 Trello；实现方式是让 Agent 按文档使用 curl 调用 https://api.trello.com/1/...，并用 jq 整理 JSON 输出。官方 API 文档入口在 SKILL 元数据中指向：https://developer.atlassian.com/cloud/trello/rest/
核心功能¶
以下能力均来自该 Skill 自带的 SKILL.md，对应 Trello REST API 的常见读写：
- 列出当前用户的看板（
GET /1/members/me/boards） - 列出某看板下的列表（
GET /1/boards/{boardId}/lists） - 列出某列表下的卡片（
GET /1/lists/{listId}/cards） - 创建卡片（
POST /1/cards，需idList、name、desc等） - 将卡片移动到另一列表（
PUT /1/cards/{cardId}，更新idList） - 给卡片添加评论（
POST /1/cards/{cardId}/actions/comments） - 归档卡片（
PUT /1/cards/{cardId}，设置closed=true）
文档还给出按看板名筛选、拉取看板下全部卡片等组合示例，并注明 Board / List / Card 的 ID 可从 Trello URL 或通过上述列表命令获得。
安装与启用¶
安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时可按 SkillHub 安装文档执行完整安装（示例为官方推荐命令）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本技能¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被客户端加载。官方页面给出的安装提示为：参考 https://skillhub.cn/install/skillhub.md ，安装 @user_b69d30ec/11111。
命令形式如下（将 <skills 目录> 换成你环境对应路径）：
skillhub install @user_b69d30ec/11111 --dir <skills 目录>
常用客户端 skills 目录（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装后按你所用客户端要求重启或刷新技能列表（SkillHub 文档提示部分环境需重启后才会识别新目录下的技能）。
配置 Trello 鉴权与依赖¶
Skill 元数据要求本机具备 jq，并设置环境变量 TRELLO_API_KEY、TRELLO_TOKEN。Setup 步骤为：
- 在 https://trello.com/app-key 获取 API Key
- 在同一页面通过 Token 链接生成 Token
- 导出环境变量：
export TRELLO_API_KEY="your-api-key"
export TRELLO_TOKEN="your-token"
密钥与 Token 对账号具备文档所述的完整访问能力，应仅放在本机或受控密钥管理中，不要写入仓库或对话日志。
典型用法¶
下面示例均摘自 Skill 正文，占位符需替换为真实的 boardId、listId、cardId。每一步都是在用 key/token 查询或变更 Trello 资源。
列出看板（名称与 id）：
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=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}"
在 Agent 对话中，你可以用自然语言描述目标（例如「列出名称包含 Work 的看板」「在某某列表新建一张卡」），由已加载该 Skill 的模型按上述模式构造请求；复杂筛选可沿用文档中的 jq 示例，例如按看板名 contains("Work") 过滤。
适用场景与注意¶
适合谁
- 日常用 Trello 做任务/项目看板，希望在 IDE 或 CLI Agent 里查板、改卡，而不反复打开网页。
- 已能接受 Trello 云 API 鉴权（Key + Token），并愿意在本地配置
jq与环境变量。
限制与注意
- 技能不封装独立 SDK，依赖
curl+ REST；网络需能访问api.trello.com。 - 文档写明限流：每个 API Key 每 10 秒 300 次请求；每个 Token 每 10 秒 100 次；
/1/members相关端点每 900 秒 100 次。批量同步或轮询时需控制频率。 - SkillHub 页面统计（以抓取资料为准）：评分 100000，下载 1302；安装后请以你本机
SKILL.md与 Trello 官方文档为准做联调。
结尾¶
11111（@user_b69d30ec/11111）把 Trello 看板、列表、卡片的常用 REST 操作和鉴权步骤写进标准 Skill 格式，适合作为 business-ops 类技能，让 Agent 在明确命令模板下管理 Trello，而不是临时编造接口。安装与优先源说明见 https://skillhub.cn/install/skillhub.md ；技能详情页见 https://www.skillhub.cn/skills/user_b69d30ec/11111 ，API 入口页为 https://api.skillhub.cn/user_b69d30ec/11111 。
