Git Flow Manager Skill (Git 工作流管理技能)

能力 (Capabilities)

• 多分支并行管理: 熟练操作 master (发布/管理开发), dev (并行开发/Fix/Docs) 和 test (测试/质量检查) 分支。

• 工作空间维护: 深度集成 git worktree 管理多个物理工作目录；使用 git stash 暂存未完成的代码。

• 同步协作: 拉取、推送与变基 (git pull , git push , git rebase , git fetch )。

• 合并与冲突: 处理代码合并 (git merge ) 并辅助解决冲突。

• 历史审查: 使用 git log , git show , git diff 审查变更历史。

指令 (Instructions)

• Worktree 优先: 处理不同维度的任务（如开发 vs 测试）时，应优先检查并使用对应的 Git Worktree（如 ../momei-dev , ../momei-test ）。

• 原子操作: 在执行推送 (push ) 前，必须确保本地代码已与远程分支同步 (pull --rebase )。

• 环境清理: 任务完成后，及时使用 git worktree remove 移除临时工作树，并执行 git worktree prune 清理残留元数据。

• 上下文保护: 当需要处理紧急任务、修复 Bug 或检查 PR 时，若对应 Worktree 不可用，优先使用 git worktree add 创建新现场。

规范 (Conventions)

• 分支角色: 遵循 Git 工作流规范 定义的分支职责：

• master : 发布、合并。项目管理员可直接进行功能开发。

• dev : 并行开发、PR 合并审查、新需求探索、问题修复（Fix）及文档维护。

• test : 自动化测试编写、集成测试、代码质量检查与修复。

• 工作树路径: 统一使用 ../momei-[branch] 格式的同级目录。

• 清理规范: 定期清理不再需要的工作树，保持开发环境整洁。

• 暂存管理: 切换分支或工作树前，确保当前改动已提交或 stash 。

• 安全性: 严禁在 master 分支执行可能会破坏稳定性的非原子化修改。禁止在未授权时执行 force push 。

• 格式规范: 提交信息应遵循 Conventional Commits 规范，确保清晰的变更记录。

• 提交语言：提交信息应该使用用户的语言习惯，并参考 git log 输出的历史记录格式，保持一致性。

• 协作流程: 在进行 PR 合并前，确保所有相关工作树已同步最新代码，并通过必要的测试验证。

使用示例 (Usage Example)

输入: "我需要去 dev 分支开发新功能。" 动作: 检查 ../momei-dev 目录，若不存在则执行 git worktree add ../momei-dev dev ，随后在对应目录工作。

输入: "清理所有没用的工作树。" 动作: 执行 git worktree prune 随后根据需要 rm 或 git worktree remove 对应目录。