EliteForge Git Governance
触发门槛
仅当用户明确说明当前项目遵守 璀璨工坊规范 或 eliteforge specification 时，才使用本技能。若用户未做出该项目级声明，不要启用本技能；按通用能力处理。
目标
在 Git 操作任务中，优先调用内置脚本完成标准化操作；无法脚本化时再输出原生命令。始终保证分支策略、提交规范和 MR 门禁与团队规则一致。 任何“需要修改代码”的任务，必须先满足分支门禁，再允许编辑文件。
执行原则
- 分支前置门禁（必做） 先执行分支检查，分支命名错误、未通过本地质量门禁时禁止改代码、禁止提交。
- 识别场景 先判断是
正常迭代、热修、分支整理、提交/MR 合规还是统计分析。 - 定位脚本目录（必做） 不要假设当前仓库存在
scripts/。先定位 skill 自身目录下的脚本，再调用。
ELITEFORGE_GIT_SCRIPTS=""
for root in "$PWD" "${SKILLS_HOME:-}" "$HOME"; do
[ -n "$root" ] || continue
found="$(find "$root" -type d -path '*/eliteforge-git-specification/scripts' 2>/dev/null | head -n 1)"
if [ -n "$found" ]; then
ELITEFORGE_GIT_SCRIPTS="$found"
break
fi
done
[ -n "$ELITEFORGE_GIT_SCRIPTS" ] || { echo "Cannot locate eliteforge-git-specification/scripts." >&2; exit 1; }- 优先脚本 若脚本已覆盖对应能力，优先调用脚本，不重复手写长命令流。
- 严格门禁 始终检查分支前置条件、是否需要 squash、MR/pipeline 状态与发布路径。
- 结构化输出 输出内容固定为：
结论、分支门禁检查、命令序列、风险与门禁、提交/MR 文案。 - 需要严格执行workflow
脚本映射（优先使用）
- 自动拉取与合并版本分支
bash "$ELITEFORGE_GIT_SCRIPTS/auto_merge" [--ff-only | --merge | --rebase]适用：在qa/<version>或release/<version>分支上，批量合并对应feature/<version>/、bugfix/<version>/变更。 - 检查指定版本分支合并状态
bash "$ELITEFORGE_GIT_SCRIPTS/check_merge" <version> <branch>适用：核对feature/<version>和bugfix/<version>是否已合入目标分支（如release或qa）。 - 清理本地分支
bash "$ELITEFORGE_GIT_SCRIPTS/delete_local_branches"适用：删除除master/main外的本地分支。 - 清理已合并远程分支
bash "$ELITEFORGE_GIT_SCRIPTS/delete_merged_branches" <version>适用：在release/<version>上识别并删除已合并feature/<version>分支。 注意：该脚本包含交互确认。 - 重命名分支
bash "$ELITEFORGE_GIT_SCRIPTS/rename_git_branch" <old-branch> <new-branch>适用：本地分支重命名并同步远程。 - 生成变更摘要
bash "$ELITEFORGE_GIT_SCRIPTS/git_change_summary.sh"适用：输出相对master..HEAD的变更摘要（排除style/build/test）。 - 统计作者代码量
bash "$ELITEFORGE_GIT_SCRIPTS/user_code.sh" <base_dir> '<author1|author2|...>' <YYYY-MM-DD>适用：按作者与起始日期统计多个仓库的增删改行数。
强制约束
- 一个需求一个feature分支
- 任何代码改动前，先确认已在合规开发分支；禁止在
master/main/nightly/qa/release直接开发。 feature提测到qa 使用合并请求；联调自行合并到nightly`。feature合入release前先 squash 为单提交。release合回master使用git merge --ff-only。hotfix仅用于现场阻塞问题。- 提交格式：
<type>(<scope>): <subject>。 - 最终 MR 前必须 squash；MR title 与 squash 后提交一致。
- 使用
.gitlab/merge_request_templates/default.md并完成自检。
参考资料
- 需要完整规范、示例、workflow时读取
references/git-governance-reference.md。