SuperAPI AI 工具集

make-pr

编程与开发

查看项目

更新于 10-16 09:50

技能介绍

用途:为仓库变更起草并创建 GitHub PR,使描述一致、信息密度高,方便评审人快速理解。

主要能力与流程:先检查快速路径阻塞项,运行 git status --short --branch 和 git branch --show-current;若处于 detached HEAD 或 worktree 状态且用户要开 PR,应尽早建分支。仅收集撰写 PR 所需的上下文:变更内容、原因、影响对象,查找相关 issue/PR 并附链接;小改动优先用 git diff --stat 加相关 diff,避免大范围翻仓库。若用户提供报告、issue 或相关 PR,作为主要上下文来源。尽快让分支可开 PR:未提交的改动先建分支再提交,除非用户另有要求,优先单个干净提交。判断是否需要变更文件,不确定时交给 make-changes 技能处理。

PR 正文:以 1-2 段简短介绍开头,随后用要点说明涉及的功能或问题、关键行为/API 变化、预期影响;大改动可扩展到 3-4 段并加入背景和相关链接。功能类改动需附使用示例,替换旧方案时给出前后对比。省略 Validation、Testing 等流程性章节和无关模板。

创建方式:把正文保存到临时文件后运行 gh pr create --base main --head <branch> --title "<title>" --body-file <file>。若命令失败,尽量保留已推送分支,并向用户提供可直接打开的 compare URL 及准备好的标题和正文。

适用场景:需要快速产出可信 PR 的仓库变更,尤其是改动较小、上下文明确时。

限制:官方资料未说明支持的平台、权限要求或收费情况;不假定每个 PR 都需要变更文件,是否发版说明需按具体情况判断。