git-master

Git 精通——全面掌握 Git

涵盖从基础到高级操作的 Git 综合技能，并为破坏性命令和平台特定工作流提供强制安全防护措施。

关键准则

Windows 文件路径要求

在 Windows 上使用 Edit 或 Write 工具时，文件路径必须使用反斜杠（\），而非正斜杠（/）：

• 错误：D:/repos/project/file.tsx
• 正确：D:\repos\project\file.tsx

适用于：Edit/Write 的 file_path 参数及所有文件操作。

文档编写准则

除非用户明确要求，否则绝不创建新的文档文件。优先更新现有的 README.md 文件。文档应简洁、直接且专业。

简而言之：安全第一

执行任何破坏性操作之前：

# ALWAYS check status first
git status
git log --oneline -10

# For risky operations, create a safety branch
git branch backup-$(date +%Y%m%d-%H%M%S)

# Remember: git reflog is your safety net (90 days default)
git reflog

确认用户偏好（开始任何 Git 任务时务必询问）：

“您希望我：

1. 自动创建合适的提交
2. 仅暂存更改（由您手动提交）
3. 仅提供指导（不执行自动操作）”

在整个会话中遵循用户的选择。

何时使用此技能

任何 Git 命令或操作都应启用此技能，包括：

• 初始化、克隆和配置仓库
• 分支管理和策略
• 提交工作流和最佳实践
• 合并策略和冲突解决
• 变基操作（交互式和非交互式）
• 重写历史（filter-repo、reset、revert）
• 恢复操作（reflog、fsck）
• 危险操作（强制推送、硬重置）
• 平台特定工作流（GitHub、Azure DevOps、Bitbucket、GitLab）
• 高级功能（子模块、工作树、钩子）
• 性能优化、大型文件（LFS）
• 跨平台兼容性（Windows/Linux/macOS）

关键信号： 用户提到 Git、GitHub、GitLab、Bitbucket、Azure DevOps、版本控制、commit/push/pull/merge/rebase、分支管理、历史修改或恢复场景。

核心原则

1. 破坏性操作的安全防护

执行任何破坏性操作（reset --hard、强制推送、filter-repo 等）之前：

1. 始终明确提醒用户
2. 清楚说明风险
3. 请求确认
4. 建议先创建备份分支
5. 提供恢复说明

完整的安全协议和确认脚本请参阅 references/dangerous-operations.md。

2. 提交创建策略

开始任何 Git 任务时，务必询问用户偏好（自动创建提交 / 仅暂存 / 仅提供指导）。在整个过程中遵循用户的选择。

3. 平台意识

不同平台和托管服务商的 Git 行为各不相同：

• Windows（Git Bash/PowerShell）： 行尾（core.autocrlf）、路径分隔符、大小写敏感性、Windows Credential Manager
• Linux/macOS： 大小写敏感的文件系统、SSH 密钥管理、权限
• 托管平台： GitHub（PR、Actions、gh CLI）、Azure DevOps（PR、Pipelines、策略）、Bitbucket（PR、Pipelines、Jira）、GitLab（MR、CI/CD）

托管平台特定命令请参阅 references/platform-workflows.md；Windows/Linux/macOS 处理方式请参阅 references/cross-platform.md。

参考索引

此 SKILL.md 是一个精简的协调器。详细的命令目录和操作流程位于 references/ 中：

参考文件	内容
references/basic-operations.md	初始化、克隆、配置、基本工作流、分支、远程仓库、获取/拉取/推送（非破坏性）
references/merging-rebasing.md	合并策略、冲突解决、变基（交互式/onto/autosquash）、挑选提交
references/advanced-commands.md	储藏（包括 Git 2.51+ 导入/导出）、还原提交、引用日志、二分查找、清理、工作树、子模块、标签
references/dangerous-operations.md	重置（hard/soft/mixed）、强制推送、filter-repo、修改已推送的提交、安全协议
references/platform-workflows.md	GitHub、Azure DevOps、Bitbucket、GitLab CLI 和 CI/CD 模板
references/performance-large-files.md	垃圾回收、重新打包、文件系统检查、LFS、浅克隆、大文件查找
references/hooks-and-security.md	客户端/服务端钩子、凭据管理、SSH、GPG、机密信息防护、约定式提交
references/troubleshooting-recovery.md	常见问题、恢复场景、紧急命令
references/cross-platform.md	行尾、大小写敏感性、Git Bash/MINGW 路径转换、Shell 检测

快速命令索引

任务	参考文件
git init、git clone、git add、git commit、git log、git diff	basic-operations
git branch、git switch、git remote、git fetch、git pull、git push	basic-operations
git merge、冲突标记、git rebase -i、git cherry-pick	merging-rebasing
git stash、git revert、git reflog、git bisect、git clean、git worktree、git submodule、git tag	advanced-commands
git reset --hard、git push --force[-with-lease]、git filter-repo、修改已推送的提交	dangerous-operations
gh pr、az repos pr、bb pr、glab mr、CI/CD YAML	platform-workflows
git gc、git repack、git lfs、浅克隆	performance-large-files
.git/hooks/*、约定式提交、SSH/GPG/机密信息	hooks-and-security
分离的 HEAD、恢复分支/文件/提交、仓库损坏	troubleshooting-recovery
core.autocrlf、core.ignorecase、MSYS_NO_PATHCONV、cygpath、$MSYSTEM	cross-platform

成功标准

使用此技能的 Git 工作流应当：

1. 始终询问用户偏好自动提交还是手动提交
2. 始终在执行破坏性操作前发出警告
3. 始终在执行高风险操作前创建备份分支
4. 始终说明恢复步骤
5. 为项目采用合适的分支策略
6. 编写有意义的提交消息
7. 保持提交历史整洁且线性
8. 绝不提交机密信息或大型二进制文件
9. 提交前测试代码
10. 知道如何从任何错误中恢复

结束语

结合参考文件和安全防护措施，此技能提供了安全有效地处理任何 Git 操作所需的知识。执行某类命令前，务必加载相应的参考文件。