mcpField
G
git-hero

git-hero

github.com/bsene开发7179 次安装1 天前更新
代码仓库

关于 git-hero

git-hero 是面向开发者的 Git 指导技能,涵盖问题解答、工作流、故障恢复和提交规范,并按需提供参考资料。

主要功能

  1. 01按情境解答 Git 问题
  2. 02指导安全恢复操作
  3. 03采用 Conventional Commits
  4. 04倡导原子化提交
  5. 05将专题问题转交专用技能

适用场景

  1. 01选择合并或变基工作流
  2. 02排查丢失或不确定的更改
  3. 03编写规范的提交信息

安装

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

$npx skills add https://github.com/bsene/skills --skill git-hero

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

包含的文件

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

gitlab-dag/references/
dry-patterns-and-examples.md
needs-keyword.md
parallel-and-matrix.md
gitlab-dag/resources/
gitlab-dag-advanced.md
gitmoji/references/
gitmoji-catalog.md
references/
commands.md
commit.md
concepts.md
config-recipes.md
conventional-commits.md
gitlab-flow.md
scenarios.md
workflow-decisions.md

详细介绍

Git Hero

全面掌握 Git——最佳实践、专家问答、gitmoji 和 CI/CD 流水线。

回答 Git 问题

根据用户使用的语言和经验水平调整回答。对于概念性问题,先解释是什么以及为什么,再给出具体命令;如果有助于说明历史记录,就使用提交图。 对于工作流问题,说明建议做法、权衡之处和命令顺序。简单的命令问题应简短回答;只有在问题需要时才查阅参考资料。

对于恢复操作,在建议修正命令之前,先使用 git status 进行诊断,并在需要时使用 git reflog。优先选择最安全的修复方式;推荐破坏性命令之前,先说明数据丢失或重写历史的风险。不要默认通过重写共享历史来修复问题。

路由到专门技能

  • 提交表情符号 / Gitmoji → gitmoji。普通的 Conventional Commits 无需表情符号。
  • GitLab 流水线、DAG、needs:、并行矩阵 → gitlab-dag。

提交规范

格式

每条提交消息都遵循 Conventional Commits,可选择添加 gitmoji 前缀:

<emoji> <type>(<scope>): <imperative description>

规则:

  • 仅限单行——不写正文、不加页脚、不留空行
  • 使用祈使语气——使用 “add feature”,而不是 “added feature” 或 “adds feature”
  • 描述使用小写——冒号后不大写
  • 末尾不加句号
  • 作用域可选,但对于多模块仓库,建议填写
  • 不添加 Co-Authored-By: Claude 页脚——无论工具默认设置如何,都不要追加

示例: feat(auth): add OAuth2 login with Google

原子化提交

每次提交只包含一个逻辑变更。每次提交都应:

  • 能独立编译并通过测试
  • 可以撤销,且不会产生副作用
  • 提交消息能完整描述变更

**气味测试:**如果提交消息中需要用到 “and”,就拆分提交。

按需阅读

阅读时机文件
根据发布影响选择提交类型、处理破坏性变更(! / BREAKING CHANGE)、选择作用域、验证 commitlintConventional Commits
配置 Git(别名、GPG 签名、推送安全、强制推送、reflog、现代语法、rerere)配置方案
选择工作流、合并与变基的取舍、分支命名约定、分支生命周期工作流决策
环境 / 发布分支、GitLab Flow、功能开关、cherry-pick 回移植或 CI 流水线快速改进GitLab Flow 和流水线
理解 HEAD、分支、区域、远程仓库、对象,或合并与变基的取舍Git 概念
查询命令标志、检查、工作树、子模块或重写历史命令速查表
理解快照、提交对象、哈希或 add/commit 生命周期提交内部机制
撤销、修改、移动提交、解决冲突或使用 stash常见场景

基准测试

这些历史结果早于 Git Guru 合并;合并后的技能尚未重新运行。场景 ID 保持不变,以保留运行溯源信息。

场景:.benchmarks/scenarios/git-hero-001-atomic-commits.md · 运行时间:2026-09-04 · 日志:.benchmarks/runs/2026-09-04/git-hero-001-atomic-commits.json

模型不使用使用差值
claude-opus-4-8100%100%+0%
claude-sonnet-4-6100%100%+0%
claude-haiku-4-5100%100%+0%

中性(运行时间:2026-09-04)。所有模型在使用和不使用时均为 100%——在此场景中,原子提交指导已达到上限;路由器的价值在于分流,而非更改代码。按照 .agents/skills/skill-optimizer/rules/release-gates.md 设置门槛。

Git 问题(原名 Git Guru)

场景:.benchmarks/scenarios/git-guru-001-merge-vs-rebase.md · 运行时间:2026-08-31 · 日志:.benchmarks/runs/2026-08-31/git-guru-001-merge-vs-rebase.json

模型不使用使用差值
claude-opus-4-883%83%+0%
claude-sonnet-4-683%100%+17%
claude-haiku-4-583%83%+0%

有条件通过(运行时间:2026-08-31)。Sonnet 提升 17%;opus/haiku 不变。合并与变基的判断标准大多属于默认行为。按照 .agents/skills/skill-optimizer/rules/release-gates.md 设置门槛。

评论

支持 Markdown