用途
trello-ops 用于通过 Trello REST API 以编程方式管理 Trello 看板(boards)、列表(lists)和卡片(cards)。根据其描述,它适用于任务管理、项目跟踪和看板自动化。
主要能力
该技能提供以下 API 方法:
listBoards()- 获取所有看板getLists(boardId)- 获取某个看板中的列表getCards(listId)- 获取某个列表中的卡片createCard({idList, name, desc, idLabels})- 创建卡片moveCard(cardId, idList, pos)- 将卡片移动到列表addComment(cardId, text)- 为卡片添加评论archiveCard(cardId)- 归档卡片getCardsByLabel(labelName)- 查找带有指定标签的卡片getCard(cardId)- 获取卡片详情
使用方式
设置
- 从 https://trello.com/app-key 获取 API key。
- 通过该页面上的链接生成 token。
- 将其设置为 GitHub secrets:
AGENT_LLM_TRELLO_API_KEY和AGENT_LLM_TRELLO_TOKEN。
调用示例
const trello = require('./index.js');
// List all boards
const boards = await trello.listBoards();
// Create a card
const card = await trello.createCard({
idList: 'list-id-here',
name: 'Task Title',
desc: 'Task description'
});
// Move a card to another list
await trello.moveCard(cardId, newListId);
// Add comment to card
await trello.addComment(cardId, 'Progress update...');
// Search cards by label
const cards = await trello.getCardsByLabel('bug');
适用场景
- 任务管理:通过代码创建、移动、归档卡片,维护任务状态。
- 项目跟踪:列出看板、列表和卡片,按标签检索卡片,获取卡片详情。
- 看板自动化:在自动化流程中调用上述方法,实现 Trello 看板操作的程序化执行。
限制
- 速率限制:每个 API key 每 10 秒 300 次请求;每个 token 每 10 秒 100 次请求。
- 需要有效的 Trello API key 和 token,并正确配置为 GitHub secrets。
- 该技能以 Node.js 模块形式使用(
require('./index.js'))。 - 关于收费、价格、支持平台、具体效果等更多信息,资料中暂未提供。