# Git Flow Manager

> 管理暂存策略、拆分提交、检查变更边界、维护提交顺序、生成变更记录和预判冲突时使用。适合多步交付而不只是单次 commit message 生成。用户提到 staging、split commits、git flow、changelog、release prep、冲突预警时都应触发。

- Skill: `caomeiyouren/git-flow-manager` (Agent Skill)
- Install (CLI): `npx skillmds@latest add caomeiyouren/git-flow-manager`
- Raw SKILL.md: https://api.skillmd.com/api/skills/caomeiyouren/git-flow-manager/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: caomeiyouren (https://skillmd.com/u/caomeiyouren)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/caomeiyouren/git-flow-manager

---


# Git Flow Manager

铁律：不要把一串无关改动塞进同一次提交，也不要在没有质量门结果时安排提交流程。

## 工作流

- [ ] Step 1: 划分变更批次 ⚠️ REQUIRED
	- [ ] 1.1 按功能、测试、文档、配置变更拆分提交单元。
	- [ ] 1.2 标记用户已有改动与当前任务改动，避免误暂存。
- [ ] Step 2: 安排提交流程
	- [ ] 2.1 明确哪些提交必须先于其他提交进入仓库。
	- [ ] 2.2 如果只是生成提交消息，交给 conventional-committer 执行。
- [ ] Step 3: 锁文件冲突处理 ⚠️ CRITICAL
	- [ ] 3.1 **绝对不要 `git pull --rebase`**：`pnpm-lock.yaml` 冲突时 rebase 100% 失败，手动解决成本极高。
	- [ ] 3.2 远程有新提交时，使用三步替代策略：
	  ```
	  git fetch origin
	  git reset --soft origin/master    # 保留改动到暂存区
	  pnpm install --no-frozen-lockfile  # 重新生成干净的锁文件
	  git add -A && git commit
	  ```
	- [ ] 3.3 此策略适用于锁文件冲突场景，目标是避免手动 merge lockfile 的误操作风险。
- [ ] Step 4: 风险检查
	- [ ] 4.1 先确认 quality-guardian 已完成必要检查。
	- [ ] 4.2 识别可能引起冲突的共享文件和长生命周期分支风险。
- [ ] Step 5: 变更记录 (conditional)
	- [ ] 5.1 需要 changelog 或 release note 时，按提交批次汇总。
	- [ ] 5.2 说明哪些更改适合单独提交，哪些适合压缩。

## 反模式

- 为了省事把功能、测试、格式化和重命名全部混在一起。
- 不区分用户已有改动和当前任务改动。
- 提交顺序没有解释，后续无法稳定 cherry-pick 或回滚。
- 遇到 `pnpm-lock.yaml` 冲突时使用 `git pull --rebase`，导致冲突无法解决。
- 试图手动编辑 lockfile 解决冲突，引入不可预知的依赖损坏。

## 交付前检查

- [ ] 已按功能边界拆分提交计划。
- [ ] 已识别无关改动和潜在冲突点。
- [ ] 质量门状态清晰。
- [ ] 如需提交消息，已明确交给 conventional-committer。