GitHub PR Workflow

• 您有本地更改准备上线，希望在一个流程中完成创建分支、暂存提交并以结构化描述开启 PR。
• 您需要监控某个开放 PR 上的 CI 检查运行情况，并希望在不盯着 GitHub UI 的情况下自动呈现失败日志。
• 您希望实现自动修复循环：检测失败的 lint 或测试检查，应用修复，推送，并持续轮询直到所有检查变为绿色。
• 您已准备好合并，并希望应用特定策略（squash、rebase 或 merge commit），并在合并后删除源分支。

• 您没有在以 GitHub 作为远程仓库的 git 仓库中工作——此技能自始至终都基于该设置。
• 您没有经过身份验证的 gh CLI 或可用的 GitHub PAT；缺少其中之一，API 调用将会失败。
• 您需要管理 GitLab、Bitbucket 或其他非 GitHub 远程仓库——此技能仅适用于 GitHub。

自动创建一个采用规范命名 slug 的功能分支，并使用生成的提交信息暂存您的更改。无需手动编写提交信息，即可保持提交历史整洁有序。

将分支推送到远程仓库，并使用内置的描述模板（references/pr-template.md）开启拉取请求。支持在同一步骤中请求审阅者、分配标签以及关联议题。

通过 scripts/watch_ci.sh 轮询 GitHub 检查运行状态，并将任何失败检查的日志直接输出到您的会话中。无需再点击 Actions 界面来查找错误。

当某项检查失败时，该技能可以自动应用修复、推送新提交并重新轮询检查状态——如此循环，直到所有必要的检查全部通过。在处理代码风格检查或格式化错误时，省去了反复手动推送的麻烦。

支持压缩合并（squash merge）、变基合并（rebase merge）和标准合并提交。合并完成后，自动删除源分支，保持远程仓库整洁。

当 gh CLI 已通过身份验证时，优先使用其作为主要驱动工具。若 gh 不可用，则由 references/api-fallback.md 及基于 curl 的脚本接管，使用 $GITHUB_TOKEN 对 GitHub REST API 执行所有操作。

一位开发者有本地更改并提出请求："创建一个名为 'Add rate limiting to /api/search' 、目标分支为 main 的 PR。" 该技能会自动创建分支、暂存提交、推送代码并附带描述信息开启 PR——无需手动执行任何 git 命令。

在提交 PR 后，开发者发出指令："监控 PR 检查，如果 lint 失败，自动修复并重新推送。" 该技能会轮询检查运行状态，检测到 lint 失败后自动应用修复、推送代码，并持续重新检查，直到所有测试套件通过并变为绿色。

当审查获得批准后，开发者发起请求："将 PR #142 进行压缩合并并删除分支。" 该技能将在一次操作中执行压缩合并并删除远程分支。

一位开发者询问："帮我审查我的分支——哪些检查未通过，还有哪些审阅者尚未批准？" 该技能通过 GitHub API 获取当前 CI 状态以及待处理的审阅者批准情况。