SuperAPI AI 工具集

linear-install-auth

编程与开发

查看项目

更新于 10-15 23:27

技能介绍

用途:在目标仓库中安装并固定 Linear 官方 TypeScript SDK(@linear/sdk),并按运行模式选择与配置认证方式,最后用只读查询验证访问是否可用。

主要能力:区分三种认证模式——个人 API 密钥(Authorization: <API_KEY>,SDK 中为 apiKey)、OAuth 令牌(Authorization: Bearer <ACCESS_TOKEN>,SDK 中为 accessToken)、以及启用时的客户端凭证授权,用于无人值守自动化。资料指出 OAuth 适合供他人使用的应用,个人密钥仅用于所有者自控脚本。

使用方式:先检查运行时、Node 版本、manifest、lockfile、现有客户端构造与密钥提供方;再按场景选择认证模式;固定兼容的 SDK 版本范围并提交解析后的 lockfile,避免 CI 中静默使用无上限的最新版;凭据从服务端密钥管理器注入,只记录变量名不记录值;执行只读的 viewer/team 验证,同时检查传输状态与 GraphQL 错误。资料提到 npm 报告版本 95.0.0,要求 Node.js >=18.x(2026-09-11)。

适用场景:仓库接入 Linear、修正认证配置、为所有者脚本或用户委托应用配置访问。

限制与边界:未经责任所有者明确批准,不得创建、泄露、轮换或撤销凭据,不得授权 OAuth 应用、更改作用域或团队访问、变更工作区数据、配置 webhook、导入导出数据、更改角色或 SCIM、传输诊断信息或执行其他生产变更;诊断默认保持只读。Node 低于 18 需先按仓库运行时策略升级;401 时检查令牌类型、头部形式、注入与撤销状态;OAuth 重定向不匹配须使用精确注册的回调,不得加通配符;密钥被提交需撤销或轮换并审计访问。其他细节暂未提供。