SuperAPI AI 工具集

linear

通用与其它

查看项目

更新于 10-16 02:32

技能介绍

用途:直接调用 Linear 的 GraphQL API,管理问题(issue)、项目、团队、工作流状态、评论和文档,适合在终端或脚本中自动化 Linear 操作。

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

使用方式:从 Linear 设置获取个人 API 密钥,设置环境变量 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:python3 scripts/linear_api.py whoami、list-teams、get-issue ENG-42、get-document 38359beef67c、raw 'query { viewer { name } }' 等子命令。

限制:速率限制为每密钥每小时 5000 请求、300 万复杂度点;分页默认 50、最大 250;HTTP 200 仍可能含 errors 数组需检查;文档按 slugId 查询需过滤集合,document(id:) 只接受 UUID;正文 Markdown 在 content 字段,ProseMirror JSON 在 contentState。API 调用应使用终端 curl,而非网页提取或浏览器。