文档设置 PR 自动化

让 Project 状态跟随 PR 进展。

配置独立、可选的自动化连接,让关联 PR 更新 Issue 在匹配的个人 Project 中的状态。

完成两项授权#

进入设置 → GitHub → PR 自动化 → 设置自动化。安装 GitHub App,允许它访问所选仓库;再授权独立的 OAuth App 使用 project offline_access。桌面登录与自动化授权分别管理。

选择映射模板#

选择个人 Project,映射其状态字段与 In Progress、Done 选项。GitHub App 当前获准访问的所有仓库都会纳入处理。自动化按字段名与状态名匹配包含该 Issue 的所有兼容个人 Projects;并不只更新模板 Project。

为 Ready PR 选择移至 In review或保持在 In Progress。前一种策略会在匹配 Project 缺少该状态且首次需要时,添加橙色 In review 选项。

理解状态规则#

  1. 存在打开的关闭关联 Draft PR:保持 In Progress。
  2. 没有打开的 Draft,但存在打开的关闭关联 Ready PR:执行选定的评审策略。
  3. 至少有一个关闭关联 PR,且全部已合并:移至 Done。

处理前会等待至少三秒再读取当前状态,此外还有队列和网络耗时。建议关闭与这些规则重叠的 GitHub Project 内置状态工作流,避免同时修改状态。

暂停或断开#

在设置中暂停、恢复、重新授权或删除自动化连接。删除停止后续处理,但不撤销已有 Project 状态变化。要同时撤销 GitHub 访问,还需撤销对应 OAuth 授权并卸载 GitHub App。

Authorized OAuth Apps · Installed GitHub Apps