1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | github-pr-workflow-nousresearch-hermes-agent |
| 项目自述名称 | github-pr-workflow（SKILL.md frontmatter 中的 name 字段） |
| 作者/维护者 | Hermes Agent（Nous Research） |
| 来源链接 | https://github.com/nousresearch/hermes-agent/tree/main/skills/github/github-pr-workflow |
| 许可证 | MIT（SKILL.md frontmatter 与仓库根目录一致声明） |
| GitHub Stars / Forks | 216,605 / 40,618（GitHub API 实测，2026-07-18；数字属于 nousresearch/hermes-agent 这个含 150 余个子技能的合集仓库整体，不代表本技能自身热度） |
| 最新版本 | v1.1.0（SKILL.md frontmatter） |
| 安装方式 | 随 Hermes Agent 默认安装内置；迁移到其他 Agent 需手工复制子目录 |
2. 功能介绍与亮点
把 GitHub PR 全生命周期串成一条可执行流程：分支创建（feat/、fix/ 等命名约定）→ 提交（Conventional Commits）→ 推送开 PR → CI 状态轮询 → 失败自动修复循环（读日志→定位→修复→重推→复检，最多 3 次后转人工）→ 合并（squash/rebase/merge，支持 GraphQL 自动合并）→ 完整端到端示例。
每个环节都先给 gh CLI 用法，再给等价的 git+curl+REST/GraphQL 用法，没装 gh 的机器同样可用。作为 Hermes Agent 默认内置组件随主程序分发，与 github-auth（鉴权）、github-code-review（审查）等技能共用统一认证约定。
3. 适用场景
所属分类：工程效率与代码质量。适合已用 GitHub PR 工作流、希望把建分支到合并的整套流程交给 agent 自动执行的 Claude Code / Hermes Agent 开发者，尤其是需要 agent 在 CI 失败后自主读日志、修复、重推并复检的场景；也适合未装 gh CLI、只能靠原生 git+REST API 完成 PR 操作的环境。
4. 跨 Agent 兼容性
- Hermes Agent：原生支持，默认内置，
/skills或/github-pr-workflow直接调用。 - Claude Code：需适配——SKILL.md 结构与 Claude Code Agent Skills 一致，可复制使用，但凭据读取路径写死指向 Hermes 专属
$HERMES_HOME/.env，需手工调整。 - Codex / OpenClaw：未验证，抓取材料中未见相关适配说明。
5. 推荐理由
同类技能大多只覆盖 PR 生命周期中的一段——要么只生成提交信息，要么只做审查——这个技能把建分支到合并串成一条 agent 可独立执行的完整流程，并设计了「CI 失败→读日志→修复→重推→复检」自动修复循环；gh/curl 双路径在不同环境都能落地。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Hermes Agent（Nous Research）官方出品，作为默认内置技能随主程序分发；母仓库 216,605 星、40,618 fork 系合集仓库整体数据，不代表本技能自身热度，且未找到本技能独立于母项目的第三方讨论 |
| 可用性 | 8 | 随 Hermes Agent 安装即可用，无需额外配置；SKILL.md 长达 367 行，含认证检测、双路径示例、CI 轮询与自动修复循环、合并策略对照表，文档完整度高；子目录近两个月内有维护提交 |
| 安全性 | 8 | 见下方安全检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令及权限范围 | 执行 git/gh/curl 等命令，权限范围明确限定在 GitHub 仓库操作（分支/提交/PR/CI/合并），不涉及无关系统操作 |
| ② 运行时是否联网外发数据 | 仅与 github.com 官方 REST/GraphQL API 通信，未见向其他第三方地址外发数据 |
| ③ API key/凭据存储方式 | 需要 GitHub Token，读取顺序透明（环境变量 → Hermes 专属 .env → ~/.git-credentials），未见明文硬编码或外传行为 |
| ④ 可疑指令/Prompt Injection 迹象 | 抓取到的全文均为正常技术文档，未发现要求执行无关操作、访问无关文件或凭据的可疑指令 |
| ⑤ 作者/组织信誉 | Nous Research，公开可查的 AI 研究机构，仓库公开可审计 |
| ⑥ License | MIT，清晰明确 |
| ⑦ 最近维护时间 | 子目录最近一次提交约 2026 年 6 月中旬，母仓库持续活跃（近日仍有推送） |
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| commit-commands（Anthropic 官方） | 一条命令完成提交/推送/发起 PR | 只覆盖提交到开 PR这一段，不含 CI 监控、失败自动修复与合并 |
| pr-review-toolkit（Anthropic 官方） | 6-agent 深度复核工具包，按测试覆盖/错误处理/类型设计等维度评审 | 面向“PR 创建后的深度评审”，不负责驱动 PR 从建分支到合并的执行过程 |
| autoreview（OpenClaw 官方） | 提交前的结构化审查关卡，双引擎支持并内置修复循环上限防越界 | 定位是拦截可疑改动的审查关卡，而非承担分支/提交/CI/合并的全流程执行 |
| github-code-review（同仓库姊妹技能） | 同样来自 Hermes Agent，专注 PR 审查环节（diff 审阅与行内评论） | 与本技能同源互补：一个管“审查”，一个管“全流程执行”，通常搭配使用而非互相替代 |
8. 用户评价
该技能目前在第三方平台（如 Reddit、Hacker News）尚无具名用户评价，可查证的说明仅来自 Hermes Agent 官方文档站对其功能与用法的介绍。
9. 其他补充
官方文档以英文为主；与仓库内 github-auth、github-code-review、github-issues、github-repo-management 等技能共用统一认证约定，版本号随母仓库同步迭代。
10. 安装使用方式
- Hermes Agent 用户（推荐）：
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash安装主程序后默认内置，/skills查看列表或/github-pr-workflow直接触发。 - 手工移植到其他 Agent（如 Claude Code）：
git clone仓库后复制skills/github/github-pr-workflow到目标技能目录，并确认凭据读取能命中GITHUB_TOKEN环境变量或~/.git-credentials，否则需手工改写。
安装后注意事项：需要一个已配置 GitHub 远程的本地 git 仓库，并完成 GitHub 身份认证（gh 登录或 GITHUB_TOKEN）；无需重启 agent 即可生效。
11. 注意事项
- 该技能是 150 余个子技能的合集仓库中的一个子目录，仓库级 Stars/Forks 不等同于本技能自身热度
- 凭据探测逻辑会读取
~/.git-credentials等本地文件，不完全受信任的环境使用前建议先确认符合自身安全策略 - 自动合并、CI 失败后自动提交推送具备真实写入分支的能力，建议先在非关键仓库或用
--draft验证效果 - 在 Codex、OpenClaw 上的可用性未经验证