{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}

Github Pr Workflow

GitHub PR 生命周期：分支、提交、开启、CI、合并。

Skill 元数据


来源	内置（默认安装）
路径	`skills/github/github-pr-workflow`
版本	`1.1.0`
作者	Hermes Agent
许可证	MIT
平台	linux, macos, windows
标签	`GitHub`, `Pull-Requests`, `CI/CD`, `Git`, `Automation`, `Merge`
相关 skill	`github-auth`, `github-code-review`

参考：完整 SKILL.md

信息

以下是 Hermes 在触发此 skill 时加载的完整 skill 定义。这是 agent 在 skill 激活时所看到的指令内容。

GitHub Pull Request 工作流

管理 PR 生命周期的完整指南。每个章节优先展示 gh 方式，再给出适用于无 gh 环境的 git + curl 备用方案。

前提条件

已通过 GitHub 认证（参见 github-auth skill）

位于含有 GitHub 远程仓库的 git 仓库中

快速认证检测

从 Git 远程地址提取 Owner/Repo

许多 curl 命令需要 owner/repo。从 git 远程地址中提取：

1. 创建分支

此部分为纯 git 操作——两种方式完全相同：

分支命名规范：

feat/description — 新功能

fix/description — 缺陷修复

refactor/description — 代码重构

docs/description — 文档

ci/description — CI/CD 变更

2. 提交变更

使用 agent 的文件工具（write_file、patch）进行修改，然后提交：

提交信息格式（Conventional Commits）：

type(scope): short description

Longer explanation if needed. Wrap at 72 characters.

类型：feat、fix、refactor、docs、test、ci、chore、perf

3. 推送分支并创建 PR

推送分支（两种方式相同）

创建 PR

使用 gh：

选项：--draft、--reviewer user1,user2、--label "enhancement"、--base develop

使用 git + curl：

响应 JSON 中包含 PR 的 number——请保存以供后续命令使用。

若要创建草稿 PR，在 JSON body 中添加 "draft": true。

4. 监控 CI 状态

检查 CI 状态

使用 gh：

使用 git + curl：

轮询直至完成（git + curl）

5. 自动修复 CI 失败

当 CI 失败时，进行诊断并修复。此循环适用于两种认证方式。

第一步：获取失败详情

使用 gh：

使用 git + curl：

第二步：修复并推送

定位问题后，使用文件工具（patch、write_file）进行修复：

第三步：验证

使用第 4 节中的命令重新检查 CI 状态。

自动修复循环模式

当被要求自动修复 CI 时，遵循以下循环：

检查 CI 状态 → 识别失败项

读取失败日志 → 理解错误原因

使用 read_file + patch/write_file → 修复代码

git add . && git commit -m "fix: ..." && git push

等待 CI → 重新检查状态

若仍失败则重复（最多 3 次，之后询问用户）

6. 合并

使用 gh：

使用 git + curl：

合并方式："merge"（合并提交）、"squash"、"rebase"

启用自动合并（curl）

7. 完整工作流示例

常用 PR 命令参考

操作	gh	git + curl
列出我的 PR	`gh pr list --author @me`	`curl -s -H "Authorization: token $GITHUB_TOKEN" "https://api.github.com/repos/$OWNER/$REPO/pulls?state=open"`
查看 PR diff	`gh pr diff`	`git diff main...HEAD`（本地）或 `curl -H "Accept: application/vnd.github.diff" ...`
添加评论	`gh pr comment N --body "..."`	`curl -X POST .../issues/N/comments -d '{"body":"..."}'`
请求审查	`gh pr edit N --add-reviewer user`	`curl -X POST .../pulls/N/requested_reviewers -d '{"reviewers":["user"]}'`
关闭 PR	`gh pr close N`	`curl -X PATCH .../pulls/N -d '{"state":"closed"}'`
检出他人的 PR	`gh pr checkout N`	`git fetch origin pull/N/head:pr-N && git checkout pr-N`

"Github Pr Workflow — GitHub PR 生命周期：分支、提交、开启、CI、合并"

Github Pr Workflow#

Skill 元数据#

参考：完整 SKILL.md#

GitHub Pull Request 工作流#

前提条件#

快速认证检测#

从 Git 远程地址提取 Owner/Repo#

1. 创建分支#

2. 提交变更#

3. 推送分支并创建 PR#

推送分支（两种方式相同）#

创建 PR#

4. 监控 CI 状态#

检查 CI 状态#

轮询直至完成（git + curl）#

5. 自动修复 CI 失败#

第一步：获取失败详情#

第二步：修复并推送#

第三步：验证#

自动修复循环模式#

6. 合并#

启用自动合并（curl）#

7. 完整工作流示例#

常用 PR 命令参考#

Github Pr Workflow

Skill 元数据

参考：完整 SKILL.md

GitHub Pull Request 工作流

前提条件

快速认证检测

从 Git 远程地址提取 Owner/Repo

1. 创建分支

2. 提交变更

3. 推送分支并创建 PR

推送分支（两种方式相同）

创建 PR

4. 监控 CI 状态

检查 CI 状态

轮询直至完成（git + curl）

5. 自动修复 CI 失败

第一步：获取失败详情

第二步：修复并推送

第三步：验证

自动修复循环模式

6. 合并

启用自动合并（curl）

7. 完整工作流示例

常用 PR 命令参考