通过托管 OAuth 安全连接 Linear API，支持 GraphQL 查询与管理 issue、project、team 等研发数据，适合自动化工作流集成。
说明：
## 核心用法
Linear skill 通过 Maton 平台提供托管 OAuth 认证，允许用户以编程方式访问 Linear 的 GraphQL API。核心能力涵盖：
– **Issue 管理**：查询、筛选、搜索、创建、更新任务（支持按 team、state、priority、title 过滤）
– **项目管理**：列举 projects、cycles、labels、workflow states
– **团队协作**：查询 teams、users、comments，支持评论增删
– **多账户支持**：通过 connection ID 区分多个 Linear 工作区
支持 CLI（`maton linear` 命令族）、Python、JavaScript 三种调用方式，所有请求经 `api.maton.ai/linear/graphql` 代理转发，自动注入 OAuth token。
## 显著优点
1. **托管 OAuth 简化认证**：无需自行处理 Linear OAuth 流程，Maton 统一托管 token 刷新与权限管理
2. **GraphQL 完整能力**：暴露 Linear 原生 GraphQL 全部查询与变更能力，无功能阉割
3. **多语言示例丰富**：提供 CLI、Python、JavaScript 完整代码片段，降低接入门槛
4. **细粒度权限控制**：支持按 connection 隔离多账户，write 操作需用户显式确认
5. **自动分页支持**：CLI 内置 `–paginate` 自动处理 Relay 风格游标分页
## 潜在缺点与局限性
– **网络依赖**：必须能访问 `api.maton.ai` 和 `api.linear.app`，无法离线使用
– **GraphQL 学习成本**：需理解 Linear GraphQL schema 才能构建复杂查询
– **OAuth 范围限制**：部分操作（如删除 issue、创建 label/project）可能需额外 scope，需联系 Maton 支持开通
– **代理层延迟**：请求经 Maton 代理转发，相比直连 Linear API 存在额外网络跳数
– **供应商锁定**：深度依赖 Maton 平台，迁移至其他 OAuth 方案需重构认证逻辑
## 适合人群
– 需将 Linear 数据同步至内部 BI/数据仓库的工程师
– 构建自动化工作流（如基于 GitHub PR 自动创建 Linear issue）的 DevOps 团队
– 希望用 Python/Node.js 脚本批量管理任务的项目经理
– 多 Linear 工作区需统一管理的跨团队协作场景
## 常规风险
– **Token 泄露**：`MATON_API_KEY` 作为根凭证需妥善保管，泄露将导致所有托管连接被滥用
– **误操作风险**：GraphQL mutation 可直接删除数据，建议生产环境先测试于 sandbox
– **Rate limit**：Linear API 存在速率限制，高频批量操作需实现退避重试
– **Schema 变更**：Linear GraphQL schema 可能演进，需关注 [Apollo Studio](https://studio.apollographql.com/public/Linear-API) 更新日志
会员专属
