skills/caomeiyouren/momei/git-flow-manager

git-flow-manager

SKILL.md

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)

  1. Worktree 优先: 处理不同维度的任务(如开发 vs 测试)时,应优先检查并使用对应的 Git Worktree(如 ../momei-dev, ../momei-test)。
  2. 原子操作: 在执行推送 (push) 前,必须确保本地代码已与远程分支同步 (pull --rebase)。
  3. 环境清理: 任务完成后,及时使用 git worktree remove 移除临时工作树,并执行 git worktree prune 清理残留元数据。
  4. 上下文保护: 当需要处理紧急任务、修复 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 随后根据需要 rmgit worktree remove 对应目录。

Weekly Installs
12
GitHub Stars
6
First Seen
Feb 28, 2026
Installed on
cline12
github-copilot12
codex12
kimi-cli12
gemini-cli12
cursor12