用途:在 Linear SDK 版本升级和 GraphQL 字段弃用时,规划并执行集成迁移。核心思路是依据已安装与目标 SDK 的实际差异、实时 schema 和 changelog 推导迁移方案,而非假定每次版本变更都重复历史上的 1.x 到 2.x 重命名。
主要能力:记录当前 Node、SDK、lockfile、生成类型、GraphQL 操作与弃用字段用法;读取目标包元数据、仓库变更、schema/类型差异及 Linear API changelog(带 [API] 前缀的条目);分类编译期重命名、行为变更、认证/数据影响及仅运行时风险;在受限分支升级并修复适配层;执行静态检查、单元/夹具测试、GraphQL 契约测试及经批准的只读工作区探测;分阶段发布并给出回滚、监控阈值与 schema 对账证据。
必要用法:使用 Read、Glob、Grep 检查代码与证据,WebFetch 仅用于官方 Linear 文档和包元数据,Write/Edit 仅用于已请求的实现。认证方面,个人 API key 用 Authorization: <API_KEY>,OAuth token 用 Authorization: Bearer <ACCESS_TOKEN>,凭据存服务端密钥管理器。
限制与边界:不得创建、泄露、轮换或吊销凭据,不得授权 OAuth 应用、变更范围或团队权限,不得变更工作区数据、配置 webhook、导入导出数据或执行生产变更,除非责任人明确批准。诊断保持只读。若无发布证据,不得凭版本号猜测迁移步骤;Node 不兼容时先升级运行时或选受支持 SDK;实时探测不一致时停止发布。资料未提供具体价格与更多实现细节。