用途:通过 Linear 的 GraphQL API 进行问题跟踪操作,包括查询与修改数据。所有请求发送至 GraphQL 端点,查询用于读取、mutation 用于修改。
主要能力:列出工作区团队;按团队列出问题;按标识符(如 ENG-123)获取问题;按状态等条件搜索问题;创建问题(可设置优先级与标签);更新问题;变更问题状态;列出工作流状态;为问题添加评论;列出项目;获取当前认证用户;列出团队标签。优先级取值为 0 无、1 紧急、2 高、3 中、4 低。
使用方式:需先设置 LINEAR_TOKEN 环境变量,Authorization 头使用该令牌。通常将请求体写入 /tmp/linear_request.json,再用 curl 以 POST 发送并配合 jq 提取结果。端点:https://api.linear.app/graphql。
查找 ID:可在 Linear 应用中按 Cmd/Ctrl + K 打开命令菜单,输入 "Copy model UUID" 选择实体复制其 ID;也可用上述查询列出实体并提取 ID。多数查询支持使用 UUID 或可读标识符。
排障:请求失败时可运行 zero doctor check-connector --env-name LINEAR_TOKEN 或 zero doctor check-connector --url https://api.linear.app/graphql --method POST。
限制与注意:生产环境建议使用 GraphQL 变量而非字符串插值;分页使用 first、after、last、before;GraphQL 即使出错也返回 200,需检查 errors 数组;遇到限流应实现退避;可批量合并多个查询。