用途：按项目既有规范管理 Git 分支生命周期，包括创建、切换、重命名、清理分支，以及补齐缺失的长期分支。不替代质量检查、平台保护或部署验收。
主要能力：先发现仓库并读取已生效规则，记录 HEAD 与未提交修改；创建时用 git check-ref-format --branch 与项目角色 pattern 双重校验，拒绝 @{-n} 动态语法；查询 refs/heads 与 OID 确认创建来源；切换前保护 dirty 状态并查询 worktree list 避免争抢；重命名保持原角色、不覆盖已有分支；清理前检查目标是否完全包含源分支、合入方向与占用，不强制删除未合入历史。
使用方式：Git 可用且项目目录明确。只读观察与预览可直接执行；初始化、创建/切换、提交、推送、集成、清理、安装 Hook 等写操作按用户已有授权范围执行。可运行只读脚本：python3 /mnt/skills/user/git-branch/scripts/inspect_repository.py /absolute/project（Python 3.11+ 标准库，只读不初始化）。GitFlow 插件可用时调用其实际路径命令，不得把未安装的 CLI 当作已存在。
适用场景：需要遵循项目分支命名与流转规则、核对创建来源、避免 worktree 冲突、安全清理已合入分支时。
限制：无 Git、无规范、detached、浅历史或来源未知时需明确报告；规则缺失或漂移时停止相关写操作并标记 unverified；不自动安装 Git，不泄露凭据或上传工作树；空历史不预创建虚假长期 refs；输出需区分事实、规则来源、建议、授权与未验证项。