SuperAPI AI 工具集

gitkkal-branch

编程与开发

查看项目

更新于 10-21 05:09

技能介绍

用途:Gitkkal Branch 用于为一次代码改动创建语义清晰的 Git 分支名,并完成分支创建与切换。它适合在开始新功能、修复问题、重构、补充文档或测试等工作前使用。

主要能力:

  • 接受一段可选的自由文本描述作为提示,不要求命名参数。
  • 在没有提供描述时,运行 git status --short、git diff 和 git diff --cached,根据实际差异内容推断变更意图;若没有改动,则向用户询问简短描述。
  • 从 feat、fix、refactor、docs、test、style、chore、perf、ci 中选择分支类型。
  • 生成仅含小写字母、数字和连字符的 kebab-case 分支名,长度不超过 50 字符;遇到非英文输入会要求提供英文描述。
  • 支持 type/description 与 description-only 两种命名格式,并允许用户确认或自定义覆盖。
  • 确认后执行 git checkout -b <branch_name>,并通过 git rev-parse --abbrev-ref HEAD 验证当前分支。

使用方式:以 /gitkkal:branch 或 $gitkkal-branch 触发,也可用普通语言提出请求。仓库根目录若存在 .gitkkal/config.json 会加载其中的 language 与 branchPattern 设置;缺失时默认 language=en、branchPattern=type/description。交互提问优先使用宿主环境提供的交互式问题或选择工具,否则回退到普通聊天。

适用场景:需要把代码变更意图转化为统一分支命名时;团队已约定分支命名规范时;希望减少手动起名和重命名成本时。

限制:分支名仅限 ASCII kebab-case;分支已存在时建议安全替代名而非覆盖;工作目录不是 Git 仓库时会停止并报告。