用途:在 Linear 中读取和管理软件问题、工单、项目及规划数据,适合查看迭代(sprint)与周期(cycle)、识别工单滚存和发布情况等场景。
使用方式:使用已安装的 linear CLI。先运行 linear status 检查连接状态;若返回 not_connected,则运行 linear authorize-url,并只把返回的 connect_url 分享给用户。OAuth 通过 authd 使用动态客户端注册(Dynamic Client Registration)与 PKCE,不涉及共享客户端密钥,也不得在聊天中索要凭据。
权限:首次连接只申请只读权限。在执行写入前,或写入因缺少权限失败后,运行 linear status --for-command <permission>。对 Linear 的 save_* 工具,当参数不含 id 时使用对应的 *.create 权限,含 id 时使用对应的 *.manage 权限。若状态返回 scope_status: not_granted,需原样复制 scope_add_url,单独一行以 Additional Linear access 形式发出,等待用户同意后重试一次。OAuth 访问不替代 Hatch 审批,也不得自行构造 scope URL 或在聊天中索要令牌。
工具调用:运行 linear list-tools 查看实时提供的工具目录与 schema,再用 linear call-tool --name <tool> --arguments-json '<json-object>' 调用。list-tools 只暴露已审查的 Linear 工具,并包含各工具的 hatch_permission、hatch_action、hatch_permission_label。只读授权期间 Linear 会隐藏写入工具,这不代表不支持写入;此时 list-tools 会将 manifest 派生的 additional_access 条目与提供方工具分开返回。用户请求这类能力时,按上述链接格式分享对应 scope_add_url,等待同意后重新运行 linear list-tools 获取实时写入工具 schema。未审查或新出现的工具不可用。读取权限遵循用户的连接器设置,变更需对应的细粒度审批。写入失败或超时不要自动重试,因为副作用可能已经完成。