Agent skill · writing content · affaan-m
git-workflow
Git工作流模式，包括分支策略、提交约定、合并与变基、冲突解决以及适用于各种规模团队的协作开发最佳实践。
Why this skill is useful
Provides specific branching strategies and commit message formats that enhance collaborative development practices not commonly known to AI.
What it needs
About 7k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
What this skill does
Git 工作流模式 Git 版本控制、分支策略与协作开发的最佳实践。 何时启用 为新项目设置 Git 工作流 决定分支策略（GitFlow、主干开发、GitHub Flow） 编写提交信息和 PR 描述 解决合并冲突 管理发布和版本标签 让新团队成员熟悉 Git 实践 分支策略 GitHub Flow（简单，推荐大多数场景使用） 最适合持续部署以及中小型团队。 规则： main 始终可部署 从 main 创建功能分支 准备就绪后发起 Pull Request 审核通过且 CI 通过后，合并到 main 合并后立即部署 主干开发（高速度团队） 最适合具备强大 CI/CD 和功能开关的团队。 规则： 所有人直接提交到 main 或使用极短生命周期的分支 功能开关隐藏未完成的工作 合并前必须通过 CI 每天多次部署 GitFlow（复杂，基于发布周期） 适合计划性发布和企业级项目。 规则： main 仅包含生产就绪代码 develop 是集成分支 功能分支从 develop 创建，合并回 develop 发布分支从 develop 创建，合并到 main 和 develop 热修复分支从 main 创建，合并到 main 和 develop 何时使用哪种策略 策略 团队规模 发布频率 最佳适用场景 ---------- ----------- ----------------- ---------- GitHub Flow 任意 持续 SaaS、Web 应用、初创公司 主干开发 5 人以上有经验 每天多次 高速度团队、功能开关 GitFlow 10 人以上 计划性 企业、受监管行业 提交信息 常规提交格式 类型 类型 用途 示例 ------ --------- --------- feat 新功能 feat(auth): add OAuth2 login fix 错误修复 fix(api): handle null response in user endpoint docs 文档 docs(readme): update installation instructions style 格式调整，无代码变更 style: fix indentation in login component refactor 代码重构 refactor(db): extract connection pool to module test 添加/更新测试 test(auth): add unit tests for token validation chore 维护任务 chore(deps): update dependencies perf 性能改进 perf(query): add index to users table ci CI/CD 变更 ci: add PostgreSQL service to test workflow revert 回滚之前的提交 revert: revert "feat(auth): add OAuth2 login" 好与坏的示例 提交信息模板 在仓库根目录创建 .gitmessage： 启用方式：git config commit.template .gitmessage 合并 vs 变基 合并（保留历史） 适用场景： 将功能分支合并到 main 希望保留完整历史 多人共同开发该分支 分支已推送，其他人可能基于它开展工作 变基（线性历史） 适用场景： 用最新的 main 更新本地功能分支 希望获得线性、干净的历史 分支仅存在于本地（未推送） 只有你一个人在该分支上工作 变基工作流 何时不应变基 Pull Request 工作流 PR 标题格式 PR 描述模板 代码审查清单 审查者： \[ ] 代码是否解决了所述问题？ \[ ] 是否处理了所有边界情况？ \[ ] 代码是否可读且易于维护？ \[ ] 是否有足够的测试？ \[ ] 是否存在安全问题？ \[ ] 提交历史是否干净（必要时已压缩）？ 作者： \[ ] 在请求审查前已完成自我审查 \[ ] CI 通过（测试、lint、类型检查） \[ ] PR 大小合理（理想情况下 <500 行） \[ ] 与单个功能/修复相关 \[ ] 描述清晰解释了变更内容 冲突解决 识别冲突 解决冲突 冲突预防策略 分支管理 命名规范 分支清理 暂存工作流 发布管理 语义化版本 创建发布 变更日志生成 Git 配置 基本配置 实用别名 Gitignore 模式 常见工作流 开始新功能 用新变更更新 PR 同步 Fork 与上游 撤销错误操作 Git 钩子 预提交钩子 预推送钩子 反模式 快速参考 任务 命令 ------ --------- 创建分支 git checkou …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/git-workflow--074aa0