Native Linear

核心用法

Linear skill 提供命令行方式直接调用 Linear GraphQL API (api.linear.app/graphql)，实现项目管理的自动化操作。核心功能包括：

任务管理：列出我的待办(my-issues)、团队任务(issues --team)、搜索(search)、获取详情(issue)、创建(create)与更新(update)任务，支持按状态、优先级筛选

项目与迭代：查询团队项目列表(projects)、迭代周期状态(cycles)、工作流状态(states)

优先级体系：0(无)/1(紧急)/2(高)/3(正常)/4(低)

显著优点

• 官方直连：调用 api.linear.app 官方端点，无第三方代理，数据不经过中间服务器
• 功能完整：覆盖 Linear 核心工作流——从个人任务查询到团队协作的项目-迭代管理
• 脚本化友好：Python3 命令行接口，易于集成到 CI/CD 或自动化脚本

局限性与风险

• 认证单一：仅支持 API Key 认证，需妥善保管 LINEAR_API_KEY
• 权限边界：API Key 继承创建者的 Linear 账号权限，无法做更细粒度控制
• 无沙箱机制：直接操作生产数据，创建/更新操作不可逆
• 依赖环境：需要本地 Python3 环境与脚本文件

适合人群

产品经理、Tech Lead、开发者——需批量查询任务状态、自动化创建 Bug/Feature 请求、集成到开发工作流的团队

常规风险

API Key 泄露可能导致工作区数据被读取或篡改；建议配置最小权限 Key 并定期轮换

核心用法

Linear Skill 通过 Python 标准库直连 Linear GraphQL API（api.linear.app），无需任何第三方代理或依赖包。用户配置 LINEAR_API_KEY 环境变量后，即可通过命令行工具完成完整的敏捷项目管理操作：查询个人待办事项（my-issues）、按团队筛选任务状态（issues --team）、创建带优先级的新任务（create --priority）、更新任务进度（update --state），以及管理项目（projects）和迭代周期（cycles）。搜索功能支持关键词模糊匹配，支持按状态、团队、优先级等多维度过滤，覆盖日常研发工作流的核心场景。

显著优点

零依赖架构：仅依赖 Python 3 标准库（urllib、json），完全规避 npm/pip 供应链攻击风险，部署环境仅需 402 行单文件脚本。

直连官方 API：绕过第三方服务中转，直接调用 Linear 原生 GraphQL 端点，数据不经过额外服务器，隐私可控性高。

功能覆盖完整：从个人任务清单到团队级项目管理，从创建到状态流转，覆盖 Linear 核心能力的 80% 以上高频操作。

权限最小化：仅需只读或标准成员级 API Key，无需管理员权限即可执行绝大多数操作，符合企业安全基线。

潜在缺点与局限性

无官方背书：由个人开发者 codeninja23 维护（T3 来源），非 Linear 官方 SDK，功能更新可能滞后于 Linear API 演进，存在兼容性风险。

许可证模糊：声明"可商用"但未指定 MIT/Apache 等具体开源协议，企业法务审查可能存在合规障碍。

功能边界清晰：不支持高级权限管理、自定义工作流配置、附件上传等进阶功能，复杂场景需回归 Linear Web 界面。

错误处理基础：当前实现以功能可用性优先，输入校验和错误提示信息较为简单，异常场景下的调试体验有待提升。

适合的目标群体

• 中小型研发团队：已采用 Linear 作为主力项目管理工具，需要快速命令行入口提升操作效率的工程师和 Tech Lead
• 自动化集成场景：希望在 CI/CD 流水线、内部脚本中嵌入 Linear 状态查询或任务创建的个人开发者
• 隐私敏感用户：拒绝第三方数据中转，坚持直连官方 API 的数据主权意识较强的组织

使用风险

API 密钥泄露风险：LINEAR_API_KEY 以环境变量形式存储，若系统配置不当可能被其他进程读取，建议配合密钥管理服务使用。

个人维护者风险：单一维护者模式，若开发者停止更新，长期可能面临 API 版本不兼容问题，建议关注 GitHub 仓库活跃度。

GraphQL 查询复杂度：自定义搜索或批量操作可能触发 Linear API 的复杂度限制，极端场景下可能遭遇速率限制。

无缓存机制：每次查询均实时请求 API，高频使用场景可能触及 Linear 免费/付费套餐的调用配额，建议控制查询频率。