SuperAPI AI 工具集

arc-git-pr-check

部署与运维

查看项目

更新于 10-15 19:56

技能介绍

用途:运行一次安全、幂等的发布卫生检查,依次完成按需提交、按需推送、缺失时创建 PR,并按 --ship 模式发布。

主要能力:--ship auto(默认)启用 squash 自动合并后停止,在必需检查通过时合并;若仓库不允许自动合并则失败,应改用 merge。--ship merge 立即 squash 合并 PR,若检查或分支保护阻止则失败。--ship pr 在创建 PR 后停止并保持开启,适合由其他智能体评审、评论并迭代后再合并的流程。--update-main 仅与 --ship merge 搭配:GitHub 确认 PR 合并后,拉取并快进配置的默认分支,然后仅移除当前干净的关联 worktree 及其本地功能分支;遇到脏的默认 worktree、脏的当前 worktree、主/无关 worktree 或非快进更新时拒绝执行,无关 worktree 不受影响。

安全保护:提交前若处于默认分支且有本地改动,会 stash 已跟踪与未跟踪改动,创建名为 <type>/v<next-semver>-<slug> 的功能分支,再在新分支上 pop stash;若 pop 冲突则停止并需手动解决。--staged-only 在默认分支上拒绝运行,需先创建功能分支。

用法:运行 run.sh,可选标志包括 --type feat --summary "add intake parser"、--base develop、--ship pr --title "feat: add intake parser" --body-file /tmp/pr-body.md、--staged-only --ship merge、--ship merge --update-main、--dry-run。--update-main 使用检测到的默认分支(或 --base 指定的分支),要求该分支在单独的干净 worktree 中检出,并在从 origin 拉取后使用 git merge --ff-only;清理前会绑定当前功能分支顶端与 PR base/head,要求确认的 PR 合并提交,并验证该提交存在于拉取的默认分支中;auto、pr、dry-run 模式不做清理,且绝不删除其他 worktree 或强制删除分支。

提交约定:遵循 Conventional Commits,类型包括 feat、fix、chore、docs、test、refactor、perf、ci;若需要提交但未提供 --type 或 --summary,脚本会提示输入。

测试:可用 bash arc-git-pr-check/tests/test-update-main.sh 运行针对性回归覆盖。

限制:资料未提供安装方式、平台支持范围、收费与价格信息。