pr-create 是一个面向 GitHub 的 PR 创建技能,服务于「创建、打开或提交 PR」这一明确需求。
用途:当用户要求创建、打开或提交 GitHub 拉取请求时,该技能通过 gh CLI 完成整个流程,并按固定步骤组织操作,减少遗漏。
主要能力与流程:
- 获取 PR 描述。优先检查 .local/pr-body.md:若存在则重新读取,并核对其内容是否与当前分支改动一致(如描述中引用的文件、功能或 issue 是否与当前 diff 相符);若已过时或与当前改动无关,则提醒用户并询问是否重新生成。若用户在对话中已生成过 PR 描述,则直接使用。否则回退到 pr-writer 技能生成标题与正文。
- 预检。检查仓库根目录或 docs/ 下的 CONTRIBUTING.md,以及 .github/PULL_REQUEST_TEMPLATE.md,扫描其中建议在开 PR 前执行的步骤,例如运行 linter 或格式化工具(如 npm run lint、cargo fmt)、运行测试(如 npm test、pytest)、构建项目、更新文档或变更日志。若发现此类步骤,会列出并询问用户希望执行哪些,只运行用户批准的步骤;若某步骤失败,会展示输出并询问如何处理后再继续。若两个文件都不存在或不含可执行的预 PR 步骤,则跳过。另可使用 pre-push 技能在开 PR 前运行本地等价于 CI 合并门禁的检查(lint、格式化、类型检查、与改动相关区域的测试),命令为 bash .agents/skills/pre-push/run-checks.sh。
- 推送分支(如需要)。检查当前分支是否有上游跟踪分支且所有提交已推送;若否,则在创建 PR 前推送。若推送失败,展示错误并停止。
- 创建 PR。确保最终 PR 正文写入 .local/pr-body.md(必要时创建 .local/ 目录),覆盖此前草稿,然后执行:gh pr create --title "<title>" --body-file .local/pr-body.md --draft。默认使用 --draft,仅当用户明确要求非草稿 PR 时才省略。不要传 --repo,让 gh 从 git remote 推断上游,使 PR 指向正确的上游仓库。
规则:若 gh 未认证或命令失败,展示错误并停止。
适用场景:需要在 GitHub 上规范提交 PR 的开发工作流,尤其是希望统一描述生成、预检、推送与草稿创建流程的团队或个人。
限制:依赖 gh CLI 且需已认证;依赖 pr-writer 与 pre-push 等关联技能(资料提及但未提供其细节);预检步骤取决于仓库中是否存在 CONTRIBUTING.md 与 PR 模板;具体收费、支持平台等未提供。