用途:提供 GitHub Actions、PR 自动化与部署工作流的通用模式,适合在搭建 CI、修复损坏的流水线、自动化 PR 检查、监控 PR 状态与重试不稳定 CI、配置多环境(dev/staging/prod)部署时参考。
主要能力:文档给出基础 CI 工作流与 PR Check 工作流的 YAML 示例,覆盖 checkout、测试、lint、build,并用 needs 控制任务依赖;还给出 PR Babysitting 模式,包括用 gh pr checks <number> 查看 CI 状态、识别失败类型(flaky test、lint error、build failure)、本地修复后推送、用 gh run rerun <run-id> --failed 重跑失败任务、解决合并冲突时 rebase 到目标分支、用 gh pr merge <number> --auto --squash 开启自动合并;另附部署前检查清单(CI 通过、无冲突、数据库迁移已审阅、目标环境变量已设置、有回滚方案)。
使用方式:按需引用其中的 YAML 模板,注意缓存依赖以节省时间,needs 建立顺序依赖,密钥名大小写敏感,checkout 使用 v4(v3 基于已弃用的 Node 16)。
限制与规则:每个 PR 必须先通过 CI 再合并;除仅文档变更外不要跳过 CI([skip ci]);工作流总时长控制在 10 分钟内;多版本测试用 matrix 构建;密钥存放在 GitHub Secrets,绝不写入代码。flaky 测试应调查而非仅重试,同一测试重跑超过两次应修复(常见原因:竞态条件、依赖时间的断言、共享测试状态)。CI 审查期间强制推送会重置检查套件,应等 CI 完成再推送。
具体模板文件 workflows.md 与更多细节:暂未提供。