用途:高效操作 GitHub 仓库、工作流与 PR,覆盖 Actions 优化、PR 规范、仓库维护和团队协作模式。默认输出仅返回结果、阻塞项与必要证据,省略前言、过程叙述、重复背景、置信度与后续提议;除必需产物或 schema 外,最多五条要点。
主要能力:以 PR 为审查单元,所有变更走 PR,禁止直接推送到 main;把工作流当作代码审查;强制分支保护,main 要求 PR、评审、检查通过、分支最新;优先使用 gh CLI 而非网页界面,以便脚本化、可复现、更快。包含 PR 规范清单(标题说明做什么和为什么、描述关联 issue/工单并附 UI 截图、分支与 main 同步、请求评审前检查为绿、显式指派评审人、PR 控制在约 250 行内以便 20 分钟内审完)与 Actions 优化手段(缓存、矩阵策略、可复用工作流)。
使用方式:先验证版本,命令为 gh --version 和 act --version(本地 Actions 运行器,可选),并查阅 GitHub CLI 与 Actions runner 发布版本。常用命令包括 gh pr create --title "feat: add OAuth2 login" --body-file .github/PULL_REQUEST_TEMPLATE.md、gh pr checks --watch --fail-fast、gh pr checkout 123、gh pr view 123 --comments、gh pr merge --squash --delete-branch、gh pr review 123 --approve --body "LGTM"。缓存示例使用 actions/cache@v4,key 为 ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }};矩阵示例含 fail-fast: false 与 node: [20, 22]。
限制与注意:需避免常见反模式,如使用废弃的 actions/checkout@v2(应改 actions/checkout@v4)、set-output(改用 GITHUB_OUTPUT)、save-state/set-env(改用 GITHUB_STATE/GITHUB_ENV)、任务无 timeout(应设 timeout-minutes: 10)、不加小心地使用 pull_request_target(不可信代码用 pull_request)、硬编码密钥(改用 GitHub Secrets + environments)、permissions: write-all(应显式声明)。验证清单要求工作流通过 actionlint 或 yamllint、uses 固定到主版本或 SHA、显式 permissions、无明文密钥、任务有超时、重复逻辑用可复用工作流、分支保护强制必需检查。官方资源包括 GitHub Actions 文档、GitHub CLI 手册、Actions 安全加固与可复用工作流文档。其他细节暂未提供。