SuperAPI AI 工具集

blocklet-branch

通用与其它

查看项目

更新于 10-16 05:00

技能介绍

用途:统一管理 Git 分支,覆盖分支检测、创建、切换与状态检查,供开发环境搭建与提交 PR 等流程引用。

主要能力: 一、主迭代分支检测。通过 gh pr list 获取最近 10 个已合并 PR 的 baseRefName 统计得出主迭代分支,输出 MAIN_BRANCH 与检测理由,不硬编码 main/master。 二、命名约定检测。分析最近 10 个已合并 PR 的 headRefName 前缀(feat/fix/chore/refactor/docs/test/style/perf 等)与分隔符风格(/ 或 -)。 三、未提交变更处理。切换前用 git status --porcelain 检查,通过 AskUserQuestion 让用户选择 stash、提交、丢弃或取消;对应命令如 git stash push -m "Auto stash before branch switch"、git add -A && git commit、git checkout . && git clean -fd。 四、分支切换。先 git fetch origin,再 git checkout $MAIN_BRANCH 并 git pull;切换指定分支时校验本地或远程是否存在,远程则用 git checkout -b $TARGET_BRANCH origin/$TARGET_BRANCH。 五、创建工作组分支。须基于最新主迭代分支,先生成命名建议(可按 TASK_TYPE、描述、issue 号拼接)并让用户确认,再 git checkout -b。 六、状态检查。判断是否在主迭代分支、命名是否符合约定、与远程是否同步(not_pushed、synced、diverged)。

使用方式:依赖 git 与 gh CLI,必要时用 jq 解析 PR 数据;SKILL.md 位于 blocklet-branch/SKILL.md。被 blocklet-dev-setup 与 blocklet-pr 引用,引用方式为“Refer to blocklet-branch skill for branch operations.”。

适用场景:开发环境初始化、提交 PR、切换任务。

限制与错误处理:gh 未认证或网络问题会导致无法获取 PR 历史,需运行 gh auth status 检查;存在冲突的未提交变更时切换会失败,须先处理;分支名已存在会导致创建失败;仓库无已合并 PR 时无法检测主迭代分支,回退到 gh repo view --json defaultBranchRef。其他如收费、平台与安装步骤暂未提供。