用途: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 仓库时会停止并报告。