SuperAPI AI 工具集

branch-creator

编程与开发

查看项目

更新于 10-30 17:20

技能介绍

用途 Branch Creator 用于创建一个本地 Git 分支,并为其生成简短、易读的名称。两种前缀分别对应不同的紧急程度:feat/<slug> 用于常规功能工作,hotfix/<slug> 用于紧急修复或影响生产的修复。适用于用户要求创建本地分支或建议分支名的场景。

主要能力 该技能会先判断用户意图:如果用户只是询问命名,就只给出建议;如果用户明确要求创建分支,就在同一轮操作中完成创建。它根据任务紧急程度选择前缀,未说明紧急程度时默认使用 feat/ 并说明该假设。slug 使用小写英文单词和连字符,长度 1–3 个词,优先 2 个词,尽量控制在 16 个字符以内,上限为 20 个字符。生成的名称会复用请求或对话中已经出现的项目词汇,并去掉 add、update、fix 等无意义填充词;如果用户提供了确切分支名,则原样保留。

使用方式 常见流程是:先运行一次 git status --short --branch 检查仓库状态和当前分支;如果是命名请求,就简短回复推荐的分支名、创建命令和一句理由;如果是创建请求,则执行 git check-ref-format --branch <branch-name> && git switch -c <branch-name> 创建并切换到新分支。如果工作区有未提交改动,会说明这些改动已随分支带过来。该技能不执行提交、推送、创建 PR/MR、重命名或删除分支等操作。

适用场景 适用于功能开发前的建分支、紧急修复建 hotfix 分支、为任务起一个简短分支名等。不适用于提交、推送、开 PR/MR、收尾分支、重命名或删除已有分支,以及复杂发布分支策略设计。

限制 该技能不推送、不提交、不 rebase、不合并、不删除分支;默认不检查远端同名分支,除非用户明确询问远端。如果用户提供的名称被 git check-ref-format 拒绝,会报告结果并请用户更换,不会静默改名。