SuperAPI AI 工具集

push-pr

通用与其它

查看项目

更新于 10-15 22:11

技能介绍

用途:在用户想要创建拉取请求或提交代码评审时,完成从提交推送到 PR 创建/更新的完整流程,并根据改动规模与范围自动判断是否拆分为多个堆叠 PR。

主要能力:预检工作区状态、当前分支、未推送提交与差异统计;在 main/master 且有未推送提交时自动创建功能分支,分支命名取自主要提交的 conventional type 与 scope,总长不超过 45 字符;当 diff 超过约 400 行或提交跨越 3 个以上不同 scope/type 时,建议按 scope/type 聚类拆分为堆叠 PR,每层 PR 以上一层分支为基线;通过 gh CLI 创建或更新 PR,新 PR 默认 opened,更新默认 draft,也支持 status 参数 1=opened、2=draft、3=ready;base 分支默认 main,可自定义。

使用方式:以 $ARGUMENTS 灵活解析 status 与 base-branch;预检注入 git status --porcelain、git rev-parse --abbrev-ref HEAD、git rev-list @{u}..HEAD --count 等命令结果;执行 git fetch origin 同步远端;必要时先调用 commit 技能提交;分支流程使用 git checkout -b、git branch -f main origin/main、git push -u origin;PR 正文由 python3 ${CLAUDE_PLUGIN_ROOT}/skills/push-pr/scripts/format-pr-body.py --base "origin/$BASE" 生成,再用 gh pr create 创建,或 gh pr comment 追加新提交说明。

适用场景:需要推送本地提交并生成干净 PR 的日常开发;改动较大或跨多个模块时,希望拆分为便于评审的堆叠 PR。

限制:不添加 AI 署名或 "Generated with Claude Code",不加 emoji,也不修改 git user.name/user.email;无远端时提示 git remote add origin <url> 并停止,无 gh CLI 时报告要求并停止;分支落后远端需先 pull/rebase,冲突则停止报告;无提交可推送时报告并停止;cherry-pick 冲突时停止,报告分支、失败提交 SHA 与冲突文件,建议 git cherry-pick --abort 后手动解决再重跑。资料未提供收费、价格与具体平台支持范围。