mcpField
E
eliteforge-git-specification

eliteforge-git-specification

github.com/cloudsenDevelopment37 installs
Repository

About eliteforge-git-specification

EliteForge Git Governance is a skill for Git tasks in projects that explicitly follow 璀璨工坊规范 or eliteforge specification. It applies branch and merge-request gates, prioritizes its scripts, and structures the resulting commands and status reports.

Key features

  1. 01Explicit project-level activation requirement
  2. 02Branch checks before code changes
  3. 03Scenario-based Git task handling
  4. 04Scripts for merge, cleanup, and branch operations
  5. 05Structured compliance and MR reporting

Use cases

  1. 01Checking branch eligibility before editing code
  2. 02Merging or cleaning project branches
  3. 03Preparing commits and merge requests under team rules

Install

Copy the command and run it in a terminal.

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

After installing, type/eliteforge-git-specificationin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with 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

Details

From the project 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。

Comments

Markdown supported