仅在用户明确要求一次性使用 GitHub CLI(gh)完成暂存、提交、推送并打开 GitHub Pull Request 时使用。
先决条件 : 需要 GitHub CLI gh. . . 请检查 gh - version. 如果缺少, 请请用户安装 gh 并停止
功能概述
先决条件 : 需要 GitHub CLI gh. . . 请检查 gh - version. 如果缺少, 请请用户安装 gh 并停止是一项面向实际任务的技能,主要用于请要求认证 gh 会话;Run gh 认证状态。
核心要点
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
- 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。
- 该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。
使用与执行
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
结果检查与注意事项
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
前置条件
- 需安装 GitHub CLI
gh。运行gh --version检查是否已安装。若未安装,请提示用户先安装gh,然后中止后续操作。 - 需确保
gh已完成身份认证。运行gh auth status进行检查。若未认证,请提示用户先执行gh auth login(并再次运行gh auth status确认),再继续后续步骤。
命名规范
- 分支名:从 main/master/default 分支出发时,使用格式
pe/{description}。 - 提交信息:采用约定式提交(Conventional Commits)语法,例如
fix: handle missing config。 - PR 标题:同样采用约定式提交语法,用于概括整个 diff 的变更内容,例如
fix: handle missing config。
工作流
- 若当前位于 main/master/default 分支,则创建新分支:
git checkout -b "pe/{description}"; - 否则,保留在当前分支上。
- 确认工作区状态后,暂存全部变更:
git status -sb,然后执行git add -A。 - 使用简洁的约定式提交消息完成提交:
git commit -m "{type}: {description}"。 - 如尚未运行过检查,请执行检查流程。若因缺少依赖项或工具导致检查失败,请先安装所需依赖,再重新运行一次检查。
- 推送分支并设置上游跟踪:
git push -u origin $(git branch --show-current)。 - 若因工作流认证错误导致
git push失败,请先从 master 拉取最新变更(git pull origin master),再重试推送。 - 创建 PR 并编辑其标题与正文,使其准确反映变更描述及差异内容:
GH_PROMPT_DISABLED=1 GIT_TERMINAL_PROMPT=0 gh pr create --draft --fill --head $(git branch --show-current)。 - 将 PR 描述内容写入临时文件(例如
pr-body.md),使用真实换行符(即不转义为\n),以避免 Markdown 解析异常;可采用类似cat > pr-body.md << EOF ... EOF的方式生成文件,再通过gh pr edit --body-file pr-body.md等方式注入内容(原文中“run pr-body.md”应理解为执行相关命令将该文件内容设为 PR 描述)。 - PR 描述(Markdown 格式)须以详尽的自然语言撰写,涵盖以下要点:问题现象、对用户造成的具体影响、根本原因、修复方案,以及用于验证修复效果的测试或检查手段。
热门AI工具
相关专题
Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。
0
2026.10.28
Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。
0
2026.10.28
Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章,帮助读者理解各文件夹的用途与引用方式。
0
2026.10.28
本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。
0
2026.10.22
本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。
0
2026.10.22
本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。
0
2026.10.22
本专题介绍Gradle Java项目构建方法,涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查,帮助你理解各阶段的任务关系,逐步完成项目构建。
0
2026.10.22
本专题汇总PHP常见时间戳漏洞,包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等,并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案,帮助开发者快速排查和加固时间相关代码。
0
2026.10.22
本专题聚焦Golangci-lint YAML配置文件,讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置,便于团队统一检查标准。
0
2026.10.22
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.6万人学习
共6课时 | 54.7万人学习
最新文章