SuperAPI AI 工具集

linear

通用与其它

查看项目

更新于 10-16 08:02

技能介绍

用途:通过 Linear 的 GraphQL API 直接管理问题(issues)、项目(projects)和团队(teams),使用 curl 调用,无需 MCP 服务器、OAuth 流程或额外依赖。

主要能力:查询当前用户、团队、工作流状态、问题、项目、成员、标签;按文本搜索问题,按状态类型、团队、负责人过滤;创建与更新问题(标题、描述、优先级、负责人、截止日期、标签、所属项目);添加评论;创建项目;读取与搜索文档(Documents)。

使用方式:从 Linear 设置 > 账户 > 安全与访问 > 个人 API 密钥获取密钥(https://linear.app/settings/account/security),将 LINEAR_API_KEY 设置到环境变量。端点 https://api.linear.app/graphql(POST),认证头为 Authorization: $LINEAR_API_KEY(API 密钥不加 Bearer 前缀)。基础调用:curl -s -X POST https://api.linear.app/graphql -H "Authorization: $LINEAR_API_KEY" -H "Content-Type: application/json" -d '{"query": "{ viewer { id name } }"}' | python3 -m json.tool。技能还附带零依赖的 Python CLI 脚本 scripts/linear_api.py,提供 whoami、list-teams、get-issue、create-issue、update-status、add-comment、get-document、raw 等子命令,可用 --help 查看参数。

关键细节:问题状态需先查询工作流状态获取 stateId(UUID);优先级 0=无、1=紧急、2=高、3=中、4=低;分页为 Relay 风格游标分页,默认 50、最大 250,用 first: N 限制结果;文档正文在 content 字段(Markdown),ProseMirror JSON 在 contentState;document(id:) 只接受 UUID,按 URL 中的 slugId 查询需用 documents 过滤。

限制:速率限制为每密钥每小时 5000 请求、300 万复杂度点;HTTP 200 仍可能包含 errors 数组,需检查;创建问题时若省略 stateId,默认进入第一个 backlog 状态。官方未提供收费、价格或平台支持信息。