用途：在修改代码或凭据前先对 Linear 集成失败进行分类，因为 Linear 可能在 HTTP 200 下返回 GraphQL 错误，也可能在 HTTP 400 下返回限流错误。
主要能力：检查 GraphQL errors 数组（响应可能同时含部分数据与错误）；通过 extensions.code: RATELIMITED 识别限流，而非假定 HTTP 429；读取 SDK 解析出的 LinearError 详情（query、variables、status、data、raw error 及各错误 path/type）；区分认证、授权、输入、未找到、复杂度、端点预算与服务健康等失败类型。
使用方式：先用 Read、Glob、Grep 检查代码、配置与证据，WebFetch 仅用于 Linear 官方文档和包元数据。捕获操作名、HTTP 状态、GraphQL 错误码/路径、SDK 版本及脱敏后的限流响应头。用相同认证模式的最小只读查询复现，勿粘贴令牌或完整客户变量。限流时按重置元数据降低请求或复杂度。认证方面，个人 API key 用 Authorization: <API_KEY>，OAuth 令牌用 Authorization: Bearer <ACCESS_TOKEN>，凭据存于服务端密钥管理器。
适用场景：集成返回部分数据、认证失败、限流、未知 schema 字段等情况下的只读诊断与受限修复。
限制与边界：未经责任人明确批准，不得创建、泄露、轮换或撤销凭据，不得授权 OAuth 应用、更改作用域或团队访问、变更工作区数据、配置 webhook、导入导出数据、更改角色/SCIM/审计流、传输诊断信息或更改付费权益。除非要求实现，诊断保持只读。forbidden 时应核对团队可见性与确切 OAuth 作用域，不得默认扩大访问。未知 schema 字段应先检查 introspection、SDK 版本与弃用通知再改代码。输出需包含范围、认证模式（不含凭据值）、检查文件与契约、操作名、证据、验证结果、脱敏字段、剩余风险、责任人与批准状态。