SuperAPI AI 工具集

linear

通用与其它

查看项目

更新于 10-16 08:41

技能介绍

用途:在 Symphony 应用服务器会话中执行 Linear 的原始 GraphQL 操作,例如评论编辑、文件上传和临时 API 查询。

主要能力:通过 Symphony 暴露的 linear_graphql 客户端工具调用,复用会话已配置的 Linear 认证。工具输入为 query(查询或变更文档)与可选的 variables(GraphQL 变量对象)。每次调用只发送一个 GraphQL 操作;即使工具调用本身完成,顶层出现 errors 数组也视为操作失败;查询应尽量窄范围,只请求需要的字段。

常见用法:按 key、identifier 或内部 id 查询议题,建议从 issue(id: $key) 开始,需要标识符搜索语义时回退到 issues(filter: ...),拿到内部 id 后优先用 issue(id: $id) 做更窄的读取。变更议题状态前先查询团队工作流状态以获取准确的 stateId,再用 issueUpdate 传入目标 stateId。评论编辑使用 commentUpdate,创建评论使用 commentCreate。关联 GitHub PR 时优先使用 attachmentLinkGitHubPR,普通 URL 附件使用 attachmentLinkURL。上传视频到评论分三步:先用 fileUpload 获取 uploadUrl、assetUrl 及所需上传头,再用 curl -X PUT 携带返回的精确头上传本地文件字节,最后再次调用 linear_graphql 用 commentCreate 或 commentUpdate 将 assetUrl 写入评论正文。

限制与规则:不要为 GraphQL 访问引入新的原始令牌 shell 辅助工具;如需 shell 处理上传,仅用于 fileUpload 返回的已签名上传 URL,这些 URL 已携带所需授权。遇到不熟悉的变更、输入类型或对象字段时,通过 linear_graphql 做定向 introspection。

适用场景:需要在 Symphony 会话内对 Linear 议题、评论、附件和状态进行程序化操作的自动化流程。

暂未提供:具体收费、价格、平台支持范围及效果数据。