Linear VCS Bridge (GitHub and Harness Code)
Linear VCS Bridge 是一个用于在 Linear 议题与 Git 托管平台之间实现双向同步的技能,覆盖分支、拉取请求、评审与部署等环节。它通过一个与提供商无关的行为层(VcsProvider 契约)加上针对 GitHub 和 Harness Code 的薄适配器来实现,避免为两个平台各写一套桥接。核心内容包括:区分 Linear、Harness、GitHub 三者的 Webhook 签名方案(Linear-Signature 与 X-Harness-Signature 为裸十六进制,GitHub 的 X-Hub-Signature-256 带 sha256= 前缀),并始终对原始请求体验签;用 extractIssueKeys 严格匹配大写议题键、用 extractClosingKeys 识别 fixes/closes/resolves 等关闭关键词,仅关闭键触发 Done 状态迁移;branchNameForIssue 生成与 Linear 原生“复制 git 分支名”一致的分支名以保留自动关联;通过 DeliveryDeduper 按投递 ID 去重保证幂等;以 reconcile 对账而非重放投递作为恢复路径;并给出 Linear、GitHub、Harness 的速率限制预算。