前言¶
團隊在 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 。
