什么是Linear
这个工具面向已经在 Linear 中管理研发事项、项目与团队协作的开发者或自动化系统，核心作用是通过 Maton 提供的网关访问 Linear API，并把 OAuth 授权过程托管起来。调用方不需要自己处理直接对接 Linear 的认证细节，只需携带有效的 Maton API 密钥，以 POST 方式请求固定的 GraphQL 端点，就能查询当前用户、组织、团队、议题、项目、周期、标签、评论等对象，也可以执行创建或更新议题、添加评论这类常见操作。
从接口形态看，它并不是一套额外定义的新业务模型，而是围绕 Linear 原生 GraphQL 能力做了一层统一入口。开发者可以直接使用 GraphQL 查询字段和变更操作，例如列出团队、按标识符读取某个议题、按状态或标题过滤议题、使用全文搜索查找任务，再把返回结果接入脚本、内部工具或工作流系统。对已经熟悉 Linear 数据结构的人来说，这种方式的好处是上手路径短，查询灵活度也比较高。
另一个比较实用的点在于连接管理。证据显示，Linear 的 OAuth 连接可以通过控制接口创建、查看、列出和删除；如果一个账号下存在多个 Linear 连接，还能通过请求头显式指定要使用的连接，否则系统会默认选用最早的活跃连接。这意味着它不仅适合个人脚本调用，也适合需要区分不同工作区、不同身份或不同环境的集成场景。不过，使用前提也很明确：需要网络访问，以及可用的 Maton API 密钥；若要接入其他第三方应用，则应改用 api-gateway 技能，而不是把这里当作通用连接器。
核心功能特点
- 通过托管 OAuth 连接接入 Linear，调用时由网关自动注入授权信息，减少自行处理认证流程的负担。
- 统一使用 GraphQL 端点访问 Linear，可查询和管理议题、项目、团队、周期、标签、评论、用户与工作流状态等对象。
- 支持按议题 ID 或类似 MTN-527 这样的标识符读取任务，也支持按状态、标题条件过滤及全文搜索。
- 可直接执行常见写操作，包括创建议题、更新议题字段以及为议题新增评论，适合自动化处理日常协作事项。
- 提供连接管理能力，可列出、创建、查看和删除 OAuth 连接，并在多连接场景下通过 Maton-Connection 请求头指定具体连接。
- 支持基于游标的分页返回，便于分批拉取大量议题或其他列表数据，并结合 pageInfo 继续翻页。
适用场景
如果团队已经把 Linear 当作日常研发协作中心，这个工具最直接的用途就是把“查任务、改任务、补评论、读项目状态”这类动作接入脚本或服务。比如内部机器人可以定期读取某个团队当前进行中的议题，生成简报；也可以根据外部系统的事件自动创建新议题，或者在某个议题下写入处理进展。由于接口支持团队、项目、周期、标签和工作流状态等信息，很多原本需要人工切换页面完成的整理工作，都可以迁移到程序化流程里。
它也适合做面向运营或管理层的轻量数据提取。GraphQL 查询允许开发者按需取字段，不必为了一个简单看板拉取整套冗余数据。结合议题过滤、全文搜索和分页能力，可以按标题关键词检索 bug、按状态类型筛选进行中事项，或者持续拉取分页结果做统计与归档。对于要做日报、周报、阶段进度汇总的团队，这种方式比纯手工查阅更稳定，也更容易纳入既有的数据管道。
在多工作区或多身份并存的环境里，它的连接管理能力也有现实价值。一个系统可以保留多个活跃的 Linear 连接，并在请求时显式指定具体连接，从而把不同团队、客户环境或业务线的数据隔离开来。这种设计更适合中台工具、自动化平台或需要代多个组织运行的服务。不过，使用时也要注意边界：所有请求都依赖有效的 Maton API 密钥；若缺少 Linear 连接会返回错误，而某些更高权限的变更操作还可能受到 OAuth scope 限制，因此它更适合在权限边界清晰、流程相对固定的开发和协作场景中使用。