用途：通过 Linear 的单一 GraphQL 端点（POST https://api.linear.app/graphql，无 REST API）读取与管理议题、项目、周期、团队、评论和标签。所有读取为 query，所有写入为 mutation。
主要能力：查询当前身份与指派给本人的议题；搜索议题；按标识符（如 ENG-123）或 UUID 获取单个议题；列出并按团队、状态、指派人、标签、关键字过滤议题；创建与更新议题；添加评论；发现团队、工作流状态、标签与成员 UUID；查询项目与团队当前周期；查看工作区近期活动。
使用方式：认证由运行时注入凭据，无需自行创建或刷新令牌；Linear 要求在 Authorization 头中直接放凭据值，不加 Bearer 前缀。资料提供 linear_gql 辅助函数封装 curl 与 jq 调用，并附有 scripts/linear_issues.sh 脚本，支持 --team、--state、--state-type、--assignee、--label、--query、--limit、--page-size、--json 等参数。GraphQL 多数错误仍返回 HTTP 200，需检查响应中的 .errors；列表字段使用游标分页（pageInfo.endCursor、hasNextPage），务必限制循环页数。更新议题状态需先取得该团队的工作流状态 UUID。
限制：连接类字段没有 totalCount，需分页计数或读取 issueCount 等聚合字段；searchIssues 等搜索负载例外。速率限制方面，API key 为每小时 5000 请求与 3000000 复杂度点数，单次查询不超过 10000 点，超限返回 HTTP 400 且 errors[].extensions.code 为 RATELIMITED，可按 X-RateLimit-Requests-Reset 的毫秒时间戳等待重试。401 通常表示该工作区未配置凭据。mutation 即便 HTTP 与 errors 正常也可能 success 为 false，需检查该布尔值。