用途:create-pr 用于完成安全的 Pull Request 创建流程,把分支管理、提交、推送和 PR 创建合并为一次操作。资料强调,只有在用户明确说出“raise a PR”“create a PR”“draft PR”“open a PR”“create pull request”时才应调用该技能,这也是唯一允许在未经用户批准的情况下自动提交的场景。
主要能力:校验或创建带 mriley/ 前缀的分支;通过 safe-commit 自动提交全部改动并执行安全、质量与测试检查;推送到远程仓库;生成经过校验的 PR 描述并创建 PR;最后返回 PR URL。默认创建草稿 PR,除非用户明确要求 final 或 ready。
使用方式:技能内部依次调用 check-history 了解分支、改动、提交与基线状态,必要时调用 manage-branch 创建分支,调用 safe-commit 自动提交,再推送并调用 pr-description-writer 生成描述,最后用 gh pr create 创建 PR。若分支已有提交且工作区干净,则跳过提交,直接分析全部提交并生成覆盖性描述。
适用场景:需要按统一流程创建 PR 的仓库协作场景,尤其是希望避免手动执行 git push 与 gh pr create、并希望自动执行提交前检查的情况。
限制:资料明确禁止手动运行 git push && gh pr create、通过 GitHub UI 手动创建 PR、未调用 safe-commit 就提交推送,以及对非指定措辞创建 PR。常见错误包括未安装或未认证 gh CLI、没有可提交的提交、提交前检查失败、推送失败;对应处理包括执行 gh auth login、先提交改动、修复问题后重试、以及 git pull --rebase origin 等。PR 描述不应包含 AI 署名。详细工作流、标题生成与错误处理需查阅技能目录下的参考文档。