前置条件

• 需安装 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 格式）须以详尽的自然语言撰写，涵盖以下要点：问题现象、对用户造成的具体影响、根本原因、修复方案，以及用于验证修复效果的测试或检查手段。