SuperAPI AI 工具集

linear

通用与其它

查看项目

更新于 10-16 03:05

技能介绍

用途:在 Symphony app-server 会话中执行原始 Linear GraphQL 操作,适合评论编辑、评论创建、议题查询、状态迁移和附件上传等流程。

主要能力:通过 linear_graphql 客户端工具每次调用发送一个 GraphQL 操作(query 或 mutation),工具输入为 query 和可选 variables。顶层 errors 数组即视为操作失败。支持按 key、identifier 或内部 id 查询议题;可用 __type 内省发现未知 mutation、input 类型与字段;可用 commentUpdate、commentCreate 编辑或新建评论;用 issueUpdate 配合 stateId 迁移状态;用 attachmentLinkGitHubPR 关联 GitHub PR,或用 attachmentLinkURL 添加普通链接;用 fileUpload 获取 uploadUrl、assetUrl 与上传头,再经 curl -X PUT 上传文件字节,最后在评论正文中引用 assetUrl。

使用方式:调用 linear_graphql 时只请求所需字段,保持 query/mutation 范围最小。议题查询按已掌握信息递进:有票据 key(如 MT-686)先试 issue(id: $key);需要标识符搜索语义时改用 issues(filter: ...);拿到内部 id 后优先用 issue(id: $id) 做窄范围读取。状态迁移前先查询团队工作流状态以取得准确 stateId,不要在 mutation 中硬编码状态名。关联 GitHub PR 时优先用附件专用 mutation。

限制:每次调用只发送一个 GraphQL 操作;顶层 errors 数组表示操作失败,即使工具调用本身已完成。不引入新的原始令牌 shell 辅助工具访问 GraphQL;shell 仅可用于 fileUpload 返回的签名上传 URL,其自身已携带授权。不要输出或硬编码未知字段。

适用场景:需要在 Symphony 会话内直接读写 Linear 数据,例如自动更新评论、上传视频或文件到评论、检索议题详情、调整议题状态、关联 PR 链接等。资料未提供该技能的价格、收费方式、平台支持范围及更多配置细节,暂未提供。