用途:在开发会话中把 Linear 与 GitHub 打通,自动同步 issue 与代码提交,减少手动维护。
主要能力:会话启动钩子会检查仓库状态——已关联仓库注入工作区、项目、团队、标签、last_issue、过期分支警告和预取摘要;已退出仓库静默;未注册仓库注入 [LINEAR-SETUP] 引导配置;工作区引用损坏时提示重新配置或退出。提交守卫钩子强制 git commit、git checkout -b/git switch -c、gh pr create 携带 issue ID,否则以 exit 2 阻止;git push 做跨 issue 提交检查并给出提示。创建 issue 时自动应用仓库标签、查重、按关键词推断优先级、询问是否加入当前周期。PR 创建后可自动生成描述并询问是否在 Linear 发进度评论。
使用方式:通过 linear-sync 子代理(前台)执行需要返回数据的查询,如获取 issue 摘要、我的 issue、创建 issue、搜索重复、获取活动周期、关联仓库。简单变更用 Bash 直接调用 linear-api.sh,例如自动分配、加入周期、发评论、改状态。状态文件用 Read/Write 工具更新。含 ! 的 GraphQL 查询需用 printf 单独构造,且 QUERY= 与 bash 命令分行书写,不能使用 && 串联。
适用场景:使用 Linear 管理任务、用 GitHub 托管代码并希望两者自动同步的团队或个人开发流程。
限制:仅对已关联工作区的仓库生效;评论必须每次询问、不自动发布;状态自动变更仅限新建时设为 In Progress;优先级推断需关键词命中并确认;其余细节如具体配置字段、脚本路径由会话启动钩子注入,资料未提供完整清单。