git-workflow-and-versioning

技能简介

本技能用于规范 Git 工作流实践，帮助你在提交代码、管理分支、解决冲突或发布版本时遵循统一且高效的流程。它强调“主干开发 + 短生命周期分支 + 原子化提交”，让代码变更始终可审查、可回滚，尤其适合 AI Agent 高速生成代码的场景。

使用场景

• 进行任何代码更改时，确保提交信息清晰、提交粒度合理
• 创建功能分支、修复分支，或需要组织多条并行工作流时
• 解决合并冲突、拆分大型变更时
• 发布版本、选择语义化版本号递增、打标签或编写变更日志时

使用方法

本技能为规范和最佳实践指南，无需安装。核心操作建议如下：

1. 主干开发（推荐）：保持 main 始终可部署，使用 1-3 天内合并的短生命周期分支。
2. 提交规范：
   • 提交要小且原子化（每次只做一件事）
   • 消息格式：<type>: <简短描述>，并在正文说明“为什么”而非“是什么”
   • 常用 type：feat（新功能）、fix（修复）、refactor（重构）、test（测试）、docs（文档）、chore（工具/依赖/配置）
3. 分支命名：
   • feature/<描述>、fix/<描述>、chore/<描述>、refactor/<描述>
4. 并行工作：使用 Git Worktree 让多个 Agent 同时工作：

git worktree add ../project-feature-a feature/task-creation
git worktree add ../project-feature-b feature/user-settings
# 完成后合并并清理
git worktree remove ../project-feature-a

5. 单次变更规模：每个 commit/PR 约 100 行；超过 1000 行需拆分。

注意事项

• 长生命周期分支是“隐藏成本”，应尽量用功能开关（feature flags）替代。
• 重构与功能开发务必分开提交，避免混合变更。
• 合并后及时删除分支。