SuperAPI AI 工具集

create-pr

通用与其它

查看项目

更新于 10-16 06:20

技能介绍

用途:把已经写好并提交的改动转成一个评审者可直接处理的草稿 PR。它只负责开 PR,评审、合并、把草稿标记为可评审都由人来决定。

主要能力:先读取 /writing-for-humans 技能,再按 PR 需要补充内容。正文固定四段:这个改动解决什么问题、如何解决(含被否决的替代方案)、合并后会发生什么、注意事项。任何一段若评审者能从 diff 自行看出就删掉,只有第一段必须保留。标题会进入 squash 合并提交,因此按 git log 的用途来写。若存在工单,在正文底部用 Closes owner/repo#123 关联,按 ID 引用而非贴链接;没有工单就不写这行,也不要为此新建工单。

使用方式:先确认当前不在默认分支且工作区干净、改动已提交;否则说明并停止。然后阅读改动:git diff <base>...HEAD 和 git log <base>..HEAD,确保正文每句话都能追溯到读过的行。起草标题、四段正文、额外段落和工单行,再经 /writing-for-humans 清理。最后推送分支并执行 gh pr create --draft --base <base> --title "<title>" --body "<body>",返回链接并说明这是等待对方标记为可评审的草稿。标签在 PR 创建后用 gh pr edit <n> --add-label ... 添加,且只用仓库已有标签。

适用场景与限制:默认走 GitHub 的 gh CLI;先检查 git remote -v,GitLab 用 glab,草稿标志为 glab mr create --draft。仓库若有 .github/pull_request_template.md,以模板为准,不适用的段落删除而非填充。一个 PR 只做一件事,重构和修复不要混在一起。不要凭想象写 diff 里没有的内容。