mcpField
E
eliteforge-git-specification

eliteforge-git-specification

github.com/cloudsen开发37 次安装
代码仓库

关于 eliteforge-git-specification

EliteForge Git Governance 是面向明确遵循 璀璨工坊规范 或 eliteforge specification 项目的 Git 技能。它执行分支与合并请求门禁、优先使用脚本，并按固定结构汇报命令与检查结果。

主要功能

  1. 01需项目明确声明后启用
  2. 02代码修改前检查分支门禁
  3. 03按场景处理 Git 任务
  4. 04提供合并、清理和分支操作脚本
  5. 05结构化汇报合规与合并请求信息

适用场景

  1. 01编辑代码前检查分支是否合规
  2. 02合并或清理项目分支
  3. 03按团队规范准备提交与合并请求

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cloudsen/eliteforge-skills --skill eliteforge-git-specification

安装后在 Claude Code 中输入/eliteforge-git-specification确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
git-governance-reference.md
scripts/
auto_merge
check_merge
delete_local_branches
delete_merged_branches
git_change_summary.sh
rename_git_branch
user_code.sh

详细介绍

来自项目 README

EliteForge Git Governance

触发门槛

仅当用户明确说明当前项目遵守 璀璨工坊规范 或 eliteforge specification 时，才使用本技能。若用户未做出该项目级声明，不要启用本技能；按通用能力处理。

目标

在 Git 操作任务中，优先调用内置脚本完成标准化操作；无法脚本化时再输出原生命令。始终保证分支策略、提交规范和 MR 门禁与团队规则一致。 任何“需要修改代码”的任务，必须先满足分支门禁，再允许编辑文件。

执行原则

  1. 分支前置门禁（必做）
    先执行分支检查，分支命名错误、未通过本地质量门禁时禁止改代码、禁止提交。

  2. 识别场景
    先判断是 正常迭代、热修、分支整理、提交/MR 合规 还是 统计分析。

  3. 定位脚本目录（必做）
    不要假设当前仓库存在 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; }

  1. 优先脚本
    若脚本已覆盖对应能力，优先调用脚本，不重复手写长命令流。

  2. 严格门禁
    始终检查分支前置条件、是否需要 squash、MR/pipeline 状态与发布路径。

  3. 结构化输出
    输出内容固定为：结论、分支门禁检查、命令序列、风险与门禁、提交/MR 文案。

  4. 需要严格执行workflow

脚本映射（优先使用）

  1. 自动拉取与合并版本分支
    bash "$ELITEFORGE_GIT_SCRIPTS/auto_merge" [--ff-only | --merge | --rebase]
    适用：在 qa/<version> 或 release/<version> 分支上，批量合并对应 feature/<version>/、bugfix/<version>/ 变更。

  2. 检查指定版本分支合并状态
    bash "$ELITEFORGE_GIT_SCRIPTS/check_merge" <version> <branch>
    适用：核对 feature/<version> 和 bugfix/<version> 是否已合入目标分支（如 release 或 qa）。

  3. 清理本地分支
    bash "$ELITEFORGE_GIT_SCRIPTS/delete_local_branches"
    适用：删除除 master/main 外的本地分支。

  4. 清理已合并远程分支
    bash "$ELITEFORGE_GIT_SCRIPTS/delete_merged_branches" <version>
    适用：在 release/<version> 上识别并删除已合并 feature/<version> 分支。
    注意：该脚本包含交互确认。

  5. 重命名分支
    bash "$ELITEFORGE_GIT_SCRIPTS/rename_git_branch" <old-branch> <new-branch>
    适用：本地分支重命名并同步远程。

  6. 生成变更摘要
    bash "$ELITEFORGE_GIT_SCRIPTS/git_change_summary.sh"
    适用：输出相对 master..HEAD 的变更摘要（排除 style/build/test）。

  7. 统计作者代码量
    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。

评论

支持 Markdown