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。