前言¶
写代码绕不开 Git。常见的麻烦不是”不会用”，而是记不全：git restore --staged 和 git reset HEAD 哪个是取消暂存、git reset --soft 和 --hard 差别在哪、分支合并冲突后该跑哪几条命令。自己整理一份笔记费时间，网上的教程又各自为政，版本一变命令就过时。
Git Essentials 把版本控制、分支、协作这三块最常用的命令和工作流集中成一份参考，直接交给 Agent 调用。下面介绍这个 Skill。
这是什么¶
Git Essentials 是一个基于 SKILL.md 格式的 Skill，定位是 Git 关键命令和工作流的速查表，覆盖版本控制、分支与协作三个主题。
发布者是 arnarsson，来源 clawhub，上游仓库 https://clawhub.ai/arnarsson/git-essentials，版本 1.0.0，许可证 MIT-0。SkillHub 上的分类是 dev-programming，标签 requires_api_key=false，说明不需要额外配置 API Key 就能使用。
它解决的问题是：让 Agent 在需要执行 Git 操作时有一份完整、可核对的命令清单，而不是凭记忆生成可能出错的命令。
核心内容¶
SKILL.md 按操作类型分了若干节，每节是一段可直接复制的 bash 代码块。已核实的章节如下：
- Initial Setup：
git config --global user.name/user.email、git init、git clone（含自定义目录名）。 - Basic Workflow：
git status、git add（含-A）、git commit（含-am、--amend）。 - Viewing changes：
git diff、--staged、单文件、两提交之间对比。 - Branching & Merging：
git branch、git checkout/git switch、-b/-c、删除与重命名分支，git merge（含--no-ff、--abort）与冲突文件列表。 - Remote Operations：
git remote -v、add / set-url / remove，git fetch、git pull、pull --rebase、git push、push -u、--force-with-lease。 - History & Logs：
git log的常用变体（--oneline、--graph --oneline --all、-5、--author、--since/--until、单文件历史），git log --grep、git log -S、git blame、git bisect start/bad/good。 - Undoing Changes：工作区
git restore、暂存区git restore --staged/git reset HEAD，提交层面git reset --soft HEAD~1、--hard、git revert。 - Stashing：
git stash、save、list、apply、pop、apply stash@{2}、drop、clear。 - Rebasing：
git rebase main、-i HEAD~3、--continue、--skip、--abort。 - Tags：轻量标签、注解标签、指定提交打标签、
push origin v1.0.0、push --tags、删除标签。 - Advanced Operations：
git cherry-pick（含-n）、git submodule（add / init / update /clone --recursive）、git clean（-n/-f/-fd/-fdx）。
另外还有 Common Workflows（feature 分支、hotfix、同步 fork）、Useful Aliases（写入 ~/.gitconfig）、Tips（提交规范、.gitignore、不要对共享分支强推等）和 Common Issues（撤销误提交、找回删除的分支、修改提交信息、解决合并冲突），末尾附 Git 官方文档和 Pro Git 等参考链接。
安装与启用¶
SkillHub 页面没有给出安装命令，以下来自上游 ClawHub 页面显示的安装方式：
openclaw skills install @arnarsson/git-essentials
安装后，Skill 会被挂载到 Agent 的技能目录中，在对话里直接引用即可。@arnarsson/git-essentials 是坐标，对应 SkillHub 上的 @clawhub_arnarsson/git-essentials。
官方地址：https://api.skillhub.cn/zcwl/git-essentials
上游页面：https://clawhub.ai/arnarsson/git-essentials
说明：ClawHub 页面同时提供 CLI 安装（npx skills）和 Prompt 两种使用入口，具体取哪一栏取决于你的 Agent 客户端。资料中没有 Cursor、Codex CLI、Claude Code 各自的安装差异说明，这里不做推测。
典型用法¶
Feature 分支工作流，来自官方资料：
git checkout -b feature/new-feature
git add .
git commit -m "Add new feature"
git push -u origin feature/new-feature
# Create PR, then after merge:
git checkout main
git pull
git branch -d feature/new-feature
热修复分支，同样来自官方资料：
git checkout main
git pull
git checkout -b hotfix/critical-bug
git commit -am "Fix critical bug"
git push -u origin hotfix/critical-bug
git checkout main && git pull
同步 fork：
git remote add upstream https://github.com/original/repo.git
git fetch upstream
git checkout main
git merge upstream/main
git push origin main
日常遇到问题时的恢复路径也在资料里有：撤销误提交用 git reset --soft HEAD~1；找回被删掉的分支用 git reflog 配合 git checkout -b branch-name <commit-hash>；改错提交信息用 git commit --amend -m "Correct message"。
如果想精简命令，可以把官方提供的 alias 段追加到 ~/.gitconfig：
[alias]
st = status
co = checkout
br = branch
ci = commit
unstage = reset HEAD --
last = log -1 HEAD
visual = log --graph --oneline --all
amend = commit --amend --no-edit
适用场景与注意¶
适合需要频繁做分支、合并、回退操作，又不想每次翻文档的人和 Agent。命令覆盖了单机操作到多人协作（remote、submodule、force-with-lease），作为速查表够用。
需要注意几点：
- 它是参考清单，不含交互式教学。命令的正确性取决于你的仓库状态，执行前先
git status确认。 - 资料里明确提示不要对共享分支使用 force push。个人分支可以用
--force-with-lease，不要用--force。 git reset --hard、git clean -fdx、git push --force属于不可逆或高风险操作，Agent 执行前应先确认。- SKILL.md 中保留了
git checkout和git restore两种写法，并注明了新旧差异，可按 Git 版本选择。 - 版本 1.0.0 的更新时间较早（上游页面显示为 5 个月前），Git 命令本身变化慢，但新特性不会在这里出现，遇到
git switch、git restore之外的命令需要另行查文档。
结尾¶
Git Essentials 的价值不在于教新东西，而在于把分散的 Git 命令收进一份结构化清单，Agent 调用时能给出完整命令而不是凭印象拼。如果你需要的是版本控制、分支、协作这条链路上的稳定参考，可以从下面的地址安装。
官方地址：https://api.skillhub.cn/zcwl/git-essentials
上游仓库：https://clawhub.ai/arnarsson/git-essentials
