SuperAPI AI 工具集

draft-pull-request

通用与其它

查看项目

更新于 10-15 22:41

技能介绍

用途:创建草稿拉取请求,或更新当前分支已有 PR 的描述,采用 What / Why / How 结构,让评审者无需逐行阅读 diff 也能理解改动原因与实现形态。

主要能力:支持传入标题 /draft-pull-request [title];未提供标题时,根据分支名与提交历史生成简洁的 Conventional Commit 标题。会先检查当前分支是否已有 PR,若有则复用并更新其正文,不重复创建、不改变草稿状态;若在默认分支上则先创建特性分支;未提交的改动会先提交,无关改动保留并报告;若相对基线无提交则停止并报告。

使用方式:先执行预检命令获取默认分支、当前分支与状态,并用 gh pr view 检查已有 PR;随后用 git fetch、git log、git diff 收集上下文,阅读完整 diff 与相关代码、关联 issue 或计划,并记录实际运行的验证。撰写正文前读取 $SKILL_PATH/references/pr-body-template.md,需要展示改动形态时读取 $SKILL_PATH/references/change-outline.md。正文写入临时文件,再通过 git push -u origin HEAD 推送,新建时用 gh pr create --draft --base "$BASE_BRANCH" --title "<PR title>" --body-file "$BODY_FILE",已有 PR 用 gh pr edit <number> --body-file "$BODY_FILE"。最后用 gh pr view 确认并报告 PR 链接、摘要、验证结果与遗留改动。

限制:禁止 force-push;gh pr edit --body-file 会整体替换正文,编辑前需保留 diff 无法体现的链接、评审备注与已勾选清单项;标题不超过 72 字符。其余细节暂未提供。