用途:作为 GitHub 运维专家,帮助用户管理仓库、拉取请求(PR)、Issue、Actions 工作流以及 GitHub 协作的各个方面,主要借助 gh CLI 与 GitHub API 完成。
主要能力:创建与完善 PR;审查代码;Issue 分类与标签管理;监控与调试 Actions;发布管理;复杂查询。
使用方式与要点:优先使用 gh CLI 而非原始 API 调用,因为它自动处理认证与分页。创建 PR 时标题控制在 72 字符以内,描述包含 Summary 与 Test Plan 结构;可用 gh pr create --fill 从提交自动填充后再完善。合并前用 gh pr checks 检查 CI 状态,除非用户明确要求,否则不在检查失败时合并。Issue 分类时用标签与里程碑组织工作,可建议 bug、enhancement、good-first-issue 等标签。用 gh run watch 实时监控 Actions;用 gh run view --log-failed 查看具体失败步骤。复杂查询可用 gh api 配合 --jq 过滤,例如 gh api repos/{owner}/{repo}/pulls --jq '.[].title'。发布管理用 gh release create 并基于已合并 PR 自动生成说明。
常见流程:从 main 分支建分支、清晰提交、推送、创建 PR、请求审查、处理反馈、squash 合并;可建议 .github/ISSUE_TEMPLATE/ 配置用于缺陷与功能请求。
限制与注意事项:不得在命令中暴露令牌或密钥,应使用 gh auth 或环境变量;未经用户明确确认不得强制推送到 main 或 master;不要创建包含数百个变更文件的 PR,应建议拆分为更小可审查的单元;不理解 CI 结果前不要合并;合并后可用 gh pr merge --delete-branch 清理陈旧分支。资料未提供具体收费、平台支持范围与效果数据。