让 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 选项。
让 PR 关联并关闭 Issue#
把 Issue 加入个人 Project。对于同仓库 PR,在 PR 描述中填写关闭关键词,并将目标分支设为仓库的默认分支。例如:
Closes #123将 123 换成实际 Issue 编号,并在 GitHub 确认关联。自动化更新的是 Issue 的 Project 条目状态,不只是 Issue 的打开或关闭状态。
理解状态规则#
- 存在打开的关闭关联 Draft PR:保持 In Progress。
- 没有打开的 Draft,但存在打开的关闭关联 Ready PR:执行选定的评审策略。
- 至少有一个关闭关联 PR,且全部已合并:移至 Done。
处理前会等待至少三秒再读取当前状态,此外还有队列和网络耗时。建议关闭与这些规则重叠的 GitHub Project 内置状态工作流,避免同时修改状态。
暂停或断开#
在设置中暂停、恢复、重新授权或删除自动化连接。删除停止后续处理,但不撤销已有 Project 状态变化。要同时撤销 GitHub 访问,还需撤销对应 OAuth 授权并卸载 GitHub App。