用途:按 <type>/<short-english-description> 规范创建 Git 分支,用户明确指定的名称优先。触发语包括“创建分支”“新建 branch”“切个分支”等。
主要能力:分支类型含 feature(新功能)、fix(修 bug)、hotfix(线上紧急修复)、refactor(重构)、chore(构建/CI/依赖)、docs(文档)。推断名称使用英文 kebab-case,最多 5 个词,总长(含 type/)不超过 50 字符。
工作流程:先运行 git status 和 git branch --show-current,确认当前分支与是否有未提交改动。基线优先用户指定分支或 commit,否则默认当前 HEAD 并告知。分支名来源:用户给定描述时推断 type 和 description;无描述但有未提交改动时,运行 git diff 和 git diff --cached 分析改动推断;信息不足则询问用户。
创建方式:基线为当前 HEAD 时执行 git switch -c <branch-name>,git checkout -b <branch-name> 等价可用。指定其他基线时用 git switch -c <branch-name> <base>。用户给定名称时须通过 git check-ref-format --branch <name> 校验且不能覆盖已有分支。由 agent 推断名称时展示基线和建议名并请求一次确认,已有明确确认则继续。
限制与注意事项:保留已暂存改动、未暂存改动、未跟踪文件和现有 stash;不因工作区有改动就执行 stash/stash pop,也不额外执行 stash push --include-untracked。其他基线可能改变带未提交改动的工作区时先检查影响,不自动 stash、强制切换、覆盖文件或改写历史。Git 操作进行中或名称冲突时只询问具体缺口。本任务不自动 commit 或 push,创建后核对当前分支、HEAD 与 Git 状态。