SuperAPI AI 工具集

linear

编程与开发

查看项目

更新于 10-16 06:23

技能介绍

用途:通过 Linear 的 GraphQL API 管理议题,适合在用户询问 Linear 议题、工单或项目管理,或需要分类、调整优先级、更新状态、搜索与评论议题时使用。

主要能力:按状态列出议题(如 Triage、In Progress、Backlog);按负责人列出议题;获取议题详情;更新议题优先级(0=无,1=紧急,2=高,3=中,4=低);更新议题状态;添加评论;搜索议题。所有命令输出 JSON,便于解析,可用 jq 过滤。

使用方式:需设置环境变量 LINEAR_API_KEY,可从 Linear 设置 > API > Personal API keys 获取。常用命令示例: 列出议题:npx tsx scripts/linear.ts list --state "Triage" 按负责人列出:npx tsx scripts/linear.ts list --assignee "cameron" 获取详情:npx tsx scripts/linear.ts get <issue-id> 更新优先级:npx tsx scripts/linear.ts update <issue-id> --priority 2 更新状态:npx tsx scripts/linear.ts update <issue-id> --state "In Progress" 添加评论:npx tsx scripts/linear.ts comment <issue-id> "Your comment here" 搜索议题:npx tsx scripts/linear.ts search "search query"

分类工作流:先列出 Triage 议题,逐个审查并决定优先级,更新优先级并移动到合适状态,必要时添加评论补充上下文。

限制与注意:Linear 使用 GraphQL 嵌套过滤,状态过滤需精确格式 state: { name: { eq: "State Name" } };负责人过滤大小写不敏感,使用 containsIgnoreCase;更新状态前需先获取状态 ID,仅用状态名无法在 mutation 中生效。API 同时接受 UUID 风格 ID 和可读标识符(如 ENG-123),但部分端点偏好其中一种。优先级为数字 0-4,不是字符串。存在速率限制,批量更新时建议分批操作。