1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | pr-create | GitHub API / SKILL.md |
| 作者/维护者 | Posit PBC(官方 posit-dev/skills 仓库),主要作者 Garrick Aden-Buie(Posit 软件工程师,GitHub 账号自 2013 年活跃至今) |
GitHub API / 作者资料 |
| 来源链接 | https://github.com/posit-dev/skills/tree/main/github/pr-create | — |
| 许可证 | MIT(版权署名 Posit PBC) | GitHub API / LICENSE 文件 |
| GitHub Stars / Forks | 所属仓库 443★ / 35 forks(该数字属整个 posit-dev/skills 合集,不代表本技能个体热度,仅供了解所属仓库规模) | GitHub API |
| 最新版本 | SKILL.md 标注 version 1.4;子目录最近一次实质性提交 2026-05-06 | 仓库提交历史 / SKILL.md |
| 安装方式 | npx skills add 通用 CLI、Claude Code 插件市场、手动克隆复制(见第 9 章) |
仓库 README |
2. 功能介绍与亮点
pr-create 是 Posit 官方 Agent Skills 合集“GitHub”分类下的技能,把“改完代码”到“PR 就绪等待评审”这段流程自动化到底。
核心能力:
- 自动判断当前阶段(未提交 / 待推送 / 已有 PR 待监控)并跳转到对应步骤
- 生成 PR 标题与描述前先展示草稿征求确认,同时询问是否指定审阅人
- 以草稿状态开 PR,持续监控 GitHub Actions CI,失败时自动抓日志定位问题
- 区分“可自动修复的机械性问题”(格式化、确切 lint 报错)与“需用户拍板的问题”,自动修复阶段禁止改动业务逻辑、加依赖或改测试断言
- 用任务清单记录每轮 CI 状态,会话中断后可从断点恢复
- CI 全绿后才取消草稿、按需请求审阅,明确写入“绝不自动合并”
亮点:SKILL.md 专设“Security Boundaries”小节,拒绝执行 CI 日志、报错信息中夹带的指令,承诺不暴露密钥——是主动写明的 Prompt Injection 防线,同类技能中少见。子目录自身有两位 Posit 工程师跨月份(2026-03 至 2026-05)的多次实质提交,并曾被 GitHub Copilot 机器人自动发现并修复一处 README 遗漏,显示有真实维护痕迹。
3. 适用场景
固定分类:工程效率与代码质量
- 已改完代码、希望把“建分支、提交、开 PR、盯 CI、修失败”这段机械收尾工作交给 Agent 处理的 Claude Code 用户
- 项目 CI 检查项较多(lint、构建、类型检查、测试)、经常需要多轮修复才能全绿的仓库
- 团队已有 PR 规范(写在 CLAUDE.md / AGENTS.md 中)、希望 Agent 自动遵循约定生成标题与描述的场景
- 长会话中容易被打断、不想每次都从头梳理 PR 进度的开发者
4. 跨 Agent 兼容性
- Claude Code:原生支持——SKILL.md 明确声明“为 Claude Code 设计”,依赖其原生 TaskCreate / TaskUpdate / TaskList 工具记录多轮 CI 状态与断点续跑
- Codex / OpenClaw / Hermes Agent:均需要适配——第三方安装器 vercel-labs/skills 的“Supported Agents”清单逐一列出这三者(各有独立技能目录),可装入对应目录;但正文中断点续跑的任务清单逻辑绑定 Claude Code 专有工具,迁移后需改写,核心 git/gh 流程本身不受影响
(判断依据为 posit-dev/skills 与 vercel-labs/skills 两份仓库的 README 原文,未为兼容性单独发起搜索)
5. 推荐理由
代码改完到能让人评审的 PR 之间,夹着一段最耗时间又最容易分心的机械工作:建分支、开 PR、盯 CI、修红、再等下一轮。pr-create 把这段流程收敛成可断点续跑的自动化工作流,同时保留两条红线——不自动合并、非机械性问题必须问用户——最终把关权留在人手上。写明的 Prompt Injection 防线,也让它处理不可信 CI 日志时比多数同类技能更让人放心。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 来自 Posit 官方 Skills 合集(443★,数字属合集整体不代表本技能),子目录自身有跨月份的多次真实迭代(非一次性打包发布),且被 Copilot 机器人主动发现并修复过文档缺口,显示真实使用痕迹,但尚无第三方平台独立公开讨论 |
| 可用性 | 9 | SKILL.md 近 500 行,含完整流程、错误处理、会话恢复说明;仅依赖 git 与免费 gh CLI,无付费依赖;近 3 个月内有实质维护提交 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单:
① shell 命令——执行 git、gh 相关命令,范围限定为项目已有配置文件定义好的检查命令
② 联网外发——推送分支与 PR 到 GitHub,任务必要且透明,未见向第三方外发数据
③ API key/凭据——复用用户本机已有的 gh auth 登录会话,不额外索取或存储凭据
④ 可疑指令——未发现;正文专设“Security Boundaries”小节主动防御外部内容注入指令
⑤ 作者/组织信誉——Posit 现任工程师,GitHub 账号活跃十余年、公开仓库 300+
⑥ License——MIT,明确
⑦ 维护时间——最近一次实质性提交在数月前,未见弃置迹象
综合评分:8.0(三项均值)
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与 pr-create 的差异 |
|---|---|---|
| pr-review-toolkit(anthropics/claude-plugins-official) | Anthropic 官方出品,用 6 个子 Agent 对代码/PR 做测试覆盖、错误处理、类型设计、注释质量等维度的深度复核 | 聚焦“PR 前后帮你挑毛病”的复核环节;pr-create 聚焦“把改完的代码机械地送进 CI 全绿的 PR”这一执行环节,两者定位互补而非替代 |
| create-pull-request(cline/cline) | Cline 官方技能,分析提交历史、遵循项目约定生成 PR 标题与描述,用 gh CLI 开 PR | 止步于“把 PR 开出来”;不含 CI 监控、失败自动修复、断点续跑能力,是更轻量的单步骤实现 |
差异化总结:多数同类技能要么停在“开出一个 PR”,要么专注“复核代码质量”,pr-create 把两者之间“盯着 CI 直到全绿”这段最耗人力的中间环节做成了带断点续跑与安全边界的完整闭环。
8. 用户评价
该技能目前在第三方平台尚无针对 pr-create 本身的具名用户评价。
9. 其他补充
同一“GitHub”分类下还有两个姊妹技能:pr-threads-address(处理评审意见并提交修改)与 pr-threads-resolve(批量标记评审对话为已解决),三者共同覆盖 PR 创建到评审收尾的链路。
10. 安装使用方式
- Agent Skills CLI(跨 Agent):
npx skills add posit-dev/skills --skill pr-create --agent claude-code(--agent可换成codex、openclaw、hermes-agent) - Claude Code 插件市场:
/plugin marketplace add posit-dev/skills,再执行/plugin install github@posit-dev-skills(连带装入 pr-threads-address、pr-threads-resolve) - 手动安装:
git clone https://github.com/posit-dev/skills.git后,将github/pr-create目录复制到对应 Agent 的技能目录
安装后注意事项:需已完成 gh auth login;项目需托管在 GitHub 且配置了 GitHub Actions CI,否则 CI 监控环节无法生效。无需重启,用户说“create pr”等指令即自动触发。
11. 注意事项
- 断点续跑、CI 追踪依赖 Claude Code 原生任务工具,装到其他三个 Agent 后需自行验证或改写
- 仅适用于托管在 GitHub、且已配置 GitHub Actions CI 的项目,不支持 GitLab、Bitbucket
- 不会自动合并 PR,未经确认不会创建或推送 PR
- 所属仓库历史较短(约 8 个月),长期维护稳定性有待观察