必须启用linear的github集成才能实现任务与代码变更自动追踪：先在settings→integrations中授权github访问权限；再为issue绑定已存在的github分支；最后通过pr描述或手动链接关联pr，并配置webhook实现双向同步。
要在Linear中直接关联GitHub仓库的分支、提交和PR，实现任务与代码变更的自动追踪，必须启用并正确配置Linear的Git集成。
在Linear中启用GitHub集成
登录Linear → 左下角点击「Settings」→ 选择「Integrations」→ 在「Source control」区域点击「Connect GitHub」→ 使用GitHub账户授权Linear访问你的组织或个人仓库权限。授权后，Linear会自动拉取你有访问权限的所有GitHub仓库列表。
这一步必须完成，否则后续所有分支/PR绑定操作均无法生效。未授权时，Linear界面中不会显示任何仓库选项，且无法创建Git上下文关联。
为Linear Issue绑定GitHub分支
打开任意一个已存在或新建的Linear Issue → 点击右侧栏「Development」→ 点击「Link branch」→ 在弹出框中输入分支名（如 【feat/user-auth-refactor】）→ 选择对应GitHub仓库 → 点击「Link」。
注意：分支名必须已存在于GitHub远程仓库中，Linear不会自动创建分支。若输入不存在的分支名，保存后该链接将显示为灰色且无跳转功能。
成功绑定后，该Issue右侧栏会实时显示该分支的最新提交、CI状态及关联的Pull Request。
自动同步PR到Linear Issue
方法一：通过GitHub PR描述自动关联
在GitHub创建PR时，在PR描述第一行添加格式为 Resolves linear://<issue-id></issue-id> 或 Closes linear://<issue-id></issue-id> 的语句（例如：Resolves linear://lin-1234）。Linear会在1–2分钟内自动识别并将其绑定至对应Issue的「Development」栏。
方法二：手动在PR页面添加Linear链接
进入GitHub PR页面 → 右侧「Linked issues」区域 → 点击「Link issue」→ 输入Linear Issue编号（如 lin-1234）→ 选择匹配项 → 确认。该操作会立即触发Linear端状态更新。
两种方式均要求PR所属仓库已在Linear中完成第一步的GitHub集成授权，否则无法解析linear://链接。
配置Webhook实现双向状态同步
第一步：在Linear中生成Webhook URL
Settings → Integrations → 「Webhooks」→ 点击「New webhook」→ 勾选「Issue updated」、「Issue created」、「Comment created」事件 → 在「URL」字段留空（先不填）→ 点击「Create webhook」→ 复制生成的完整Webhook URL（含密钥参数）。
第二步：在GitHub仓库设置Webhook
GitHub仓库 → Settings → Webhooks → 「Add webhook」→ Paste Linear生成的URL → Content type选「application/json」→ 勾选「Let me select individual events」→ 勾选「Pull requests」、「Branches」、「Statuses」→ 点击「Add webhook」。
第三步：验证连通性
在GitHub上推送一次新提交到已绑定分支 → 观察Linear对应Issue的「Development」栏是否出现新提交记录。若未出现，检查GitHub Webhook的「Recent deliveries」中响应状态码是否为200；若为401，说明Linear端Webhook密钥已失效，需重新生成。
