SuperAPI AI 工具集

linear-graphql-skill

编程与开发

查看项目

更新于 10-16 08:48

技能介绍

用途:该技能用于通过 uxc 运行 Linear GraphQL API 操作,适用于需要查询或创建议题、管理项目与团队等任务。使用前需复用 uxc 技能的发现、模式检查、认证生命周期和错误恢复指引。

主要能力:提供查询操作 query/issues(列出和筛选议题)、query/issue(获取单个议题)、query/teams(列出团队)、query/team(获取单个团队)、query/projects(列出项目)、query/workflowStates(列出工作流状态);写操作 mutation/issueCreate(创建议题)、mutation/issueUpdate(更新议题)、mutation/issueArchive(归档议题)、mutation/commentCreate(添加评论)。

前提条件:uxc 已安装并位于 PATH 中;可访问 https://api.linear.app/graphql;具备 Linear API 密钥或 OAuth 凭据。

认证:方式一为个人 API Key,从 https://linear.app/settings/api 获取,用 uxc auth credential set 设置自定义 Authorization 头,注意 API Key 不接受 Bearer 前缀,格式为 Authorization: lin_api_XXX;方式二为 OAuth 2.0,先在 Linear 创建 OAuth 应用,用 uxc auth oauth start 与 uxc auth oauth complete 完成登录。之后需用 uxc auth binding add 绑定端点。

使用方式:默认使用固定链接命令 linear-graphql-cli,先确认其存在,缺失时用 uxc link linear-graphql-cli https://api.linear.app/graphql 创建。用 -h 发现操作,用 query/issues '{"first":10}' 等执行查询,写操作需写权限。建议保持 JSON 输出信封,先解析 ok、kind、data、error 字段,优先读操作再写操作,写操作前确认用户意图。

限制:需要网络访问与有效凭据;写操作需相应权限;凭据变更后可能需要重启 uxc daemon;命令冲突时应停止并询问维护者,不要动态改名。