Appearance
Everything Claude Code 的 git-workflow Skill 是团队协作与 AI 编程助手深度集成的 Git 流程专家，涵盖分支策略、Commit 规范、Merge vs Rebase 决策、冲突解决、PR 工作流和发布管理等全流程。通过自动化提示、规范模板和冲突预防，帮助开发者（无论新手还是资深）在 AI 辅助开发环境下高效、安全地管理代码版本与协作，极大降低因流程混乱或历史污染导致的协作风险。
Everything Claude Code Git Workflow Skill：分支策略、Commit 规范、Merge vs Rebase 与冲突解决
在 AI 编程助手（如 Claude Code、Codex、Cursor 等）驱动的现代开发流程中，团队协作和代码版本管理的复杂性并未消失，反而因多 Agent 并行、自动化 PR、批量变更等需求进一步提升。Everything Claude Code 的 git-workflow Skill 正是为此而设计：它将行业最佳的 Git 工作流经验沉淀为可自动触发、可自定义的 Skill，贯穿代码分支、提交、合并、冲突处理、发布与回滚等全周期，极大提升 AI 协作开发的可控性和工程质量。
1. 这个 Skill 解决了什么问题？
没有 Skill 时的困扰：
- 分支命名混乱，导致合并、回滚困难
- Commit 信息杂乱，无法追溯变更原因或定位问题
- Merge 和 Rebase 混用，历史污染或丢失协作成果
- 冲突频发且难以预防，团队成员踩坑不断
- PR 描述不规范，代码审查效率低
- 发布流程无标准，回滚和版本追踪困难
有了 git-workflow Skill 后：
- 自动推荐并执行适合团队的分支策略（如 GitHub Flow、Trunk-Based、GitFlow）
- 统一 Commit 格式，支持 Conventional Commits，便于自动生成 Changelog
- 合并/变基场景自动判断，防止误操作破坏历史
- 冲突预警、分支短期化建议，减少冲突概率
- PR 标题与描述模板自动填充，提升审查效率
- 发布、标签、回滚流程标准化，支持语义化版本
- 可与 Hooks 自动化体系、Code Reviewer Agent 等深度协作
2. 典型触发场景（When to Activate）
- 新项目初始化或团队协作模式调整
- 需要统一分支/命名/提交规范时
- 代码合并、变基、冲突处理前后
- 发布新版本、打 Tag、生成 Changelog
- 新成员 Onboarding 或外部贡献者协作
- 大型重构、批量 PR、AI 自动生成代码时
3. 实战使用流程（Step by Step）
Step 1：选择并应用分支策略
Skill 会根据项目规模、协作模式和发布频率，自动推荐适合的分支模型：
- GitHub Flow（推荐多数团队）：主分支
main始终可部署，功能分支从main派生，PR 审查后合并并立即部署。 - Trunk-Based Development：所有人直接在
main或极短期分支开发，配合 Feature Flag，适合高频发布。 - GitFlow：主分支
main只存生产代码，develop为集成分支，适合有明确发布周期的企业项目。
Skill 输出示例：
markdown
推荐采用 GitHub Flow：
- 主分支 main 受保护，所有功能从 main 派生 feature/xxx
- PR 审查通过后合并并自动部署
- 禁止直接推送 main，强制走 PR 流程Step 2：规范 Commit 信息
Skill 自动生成或校验 Conventional Commits 格式，确保每次提交都可追溯且易于自动化处理。
Commit 模板示例：
plaintext
feat(auth): 支持 OAuth2 登录
实现企业用户 SSO，兼容原有本地登录。
Closes #123Skill 可自动检查提交信息，提示类型、范围、描述是否合规。
Step 3：合并（Merge）与变基（Rebase）决策
Skill 会根据分支状态和协作需求，智能建议何时用 Merge、何时用 Rebase，并防止危险操作。
- Merge：用于多人协作的功能分支合并到主干，保留历史。
- Rebase：用于本地、单人开发的分支同步主干，保持线性历史。
Skill 输出示例：
markdown
检测到 feature/user-auth 已推送远程，建议使用 Merge 合并到 main，避免历史污染。
如需同步 main 到本地分支，可安全使用 Rebase。Step 4：Pull Request 工作流自动化
Skill 自动生成 PR 标题和描述模板，集成代码审查清单，确保每个 PR 都易于评审和追踪。
PR 模板示例：
markdown
feat(auth): 支持企业 SSO 登录
## What
实现企业用户单点登录功能。
## Why
提升大客户接入体验，减少重复注册。
## How
引入 OAuth2 客户端，兼容原有认证流程。
## Checklist
- [x] 单元测试覆盖
- [x] 文档已更新
- [x] 相关 issue 已关联
Closes #123Step 5：冲突预警与解决
Skill 提供冲突检测、预防建议和分步解决指导：
- 自动检测潜在冲突文件
- 推荐分支短期化、频繁 Rebase、团队沟通等预防措施
- 冲突发生时，输出分步解决方案（手动、工具、选择 ours/theirs 等）
Skill 输出示例：
bash
检测到 src/auth/login.ts 存在冲突
1. 打开文件，查找 <<<<<<<、=======、>>>>>>> 标记
2. 编辑并保留正确内容，删除冲突标记
3. git add src/auth/login.ts
4. git commitStep 6：发布与版本管理
Skill 支持语义化版本（Semantic Versioning），自动生成 Tag、Changelog，并规范发布流程。
Tag 示例：
bash
git tag -a v1.2.0 -m "Release v1.2.0
Features:
- 新增用户认证
Fixes:
- 修复登录重定向问题
Breaking Changes:
- 无
"
git push origin v1.2.0Step 7：分支与历史管理
Skill 自动建议分支命名规范、定期清理无用分支、stash 工作流等，保持仓库整洁。
分支命名示例：
- feature/user-authentication
- fix/login-bug
- hotfix/critical-patch
- release/1.2.0
分支清理命令：
bash
git branch --merged main | grep -v "^\*\|main" | xargs -n 1 git branch -d4. 典型输出示例
- 自动生成规范 Commit/PR 信息
- 检测并阻止危险的 Rebase 操作
- 冲突出现时输出分步解决方案
- 发布时自动生成 Tag 和 Changelog
- 分支命名、清理、stash 操作建议
5. 常见配套 Agent & Skill 协作
- Code Reviewer Agent：自动审查 PR 质量、历史规范性
- Hooks 自动化体系：Pre-commit/Pre-push 自动触发 Lint、测试、Secrets 检查
- CK Skill：跨会话追踪 Git 活动，持久化每项目历史
- Verification Loop Skill：端到端验证每次合并和发布的完整性
更多 ECC 组件集成方式可参考 Everything Claude Code 完全指南。
FAQ
Q: git-workflow Skill 会自动修改我的分支历史吗？
A: 不会。Skill 只会输出建议和命令模板，实际操作需开发者确认执行，避免误改历史。
Q: 如何与团队现有的 Git 流程兼容？
A: Skill 支持自定义分支策略和命名规则，可按团队实际约定调整输出，兼容 GitHub Flow、GitFlow、Trunk-Based 等多种模式。
Q: 冲突处理时 Skill 能自动合并吗？
A: Skill 会详细指导冲突定位和解决步骤，但不会自动修改文件内容，确保每次合并都由开发者最终确认。