版本说明：本文基于 Claude Code 与 OpenCode 的 Git 操作实践撰写，适用于企业级开发团队。

适用对象：中高级开发者、技术负责人。

前置知识：第18篇单服务编码、第21篇代码评审。

测试环境：Git v2.40+、Claude Code v1.x、Node.js v18+（commitlint）。

过时风险提示：Claude Code 和 OpenCode 的配置方式（如 CLAUDE.md、opencode.json）可能随版本更新变化，建议关注官方更新日志。Git 子模块管理在 AI 场景下的最佳实践仍在演进中。

反馈渠道：如发现内容过时或有改进建议，请在技术分享配套仓库提交 Issue。

一、AI生成代码的版本管理挑战

AI 辅助编码带来了一个之前不存在的问题：代码提交的粒度和频率发生了根本性变化。

传统模式下，开发者写完一段代码，想清楚要提交什么，手动输入 commit message。整个过程是人工控制的——提交多少文件、提交频率、message 怎么写，都由人决定。

AI 模式下，AI 可以一次修改大量文件、一次生成多段代码。如果不加管控，会出现一个 PR 修改 50 个文件、commit message 和实际改动不匹配、功能开发和 Bug 修复混在同一个提交等问题。

Microsoft 的 Visual Studio 团队在其 AI commit message 自定义指南中指出，AI 生成的 commit message 默认会参考项目的 git 历史，保持风格一致，但这需要项目本身有规范的 commit 历史作为基础 。Conventional Commits 规范为 AI 生成 commit message 提供了结构化的标准 。

本文从三个维度解决 AI 辅助编码的版本管理问题：分支策略、提交规范、AI 辅助 Git 操作。

二、分支策略与AI协作

Feature 分支工作流

企业级项目推荐使用 Feature 分支工作流。核心规则是：所有开发在独立的 feature 分支上进行，完成后通过 PR 合并回 main 分支。

AI 在这个流程中的角色：

环节	AI 能做什么	人工控制点
创建分支	自动创建并切换到 feature 分支	分支命名规范
日常提交	根据 diff 生成 commit message	提交粒度和频率
创建 PR	根据 commit 历史生成 PR 描述	审查变更范围
合并后	清理已合并的分支	确认合并策略

分支命名规范

让 AI 创建分支时，需要在项目配置中明确命名规范：

分支命名规范：
- 功能开发：feature/模块名-简述（如 feature/coupon-reduction）
- Bug修复：fix/模块名-简述（如 fix/coupon-stock-leak）
- 紧急修复：hotfix/简述（如 hotfix/token-expiry）
- 重构：refactor/模块名-简述（如 refactor/coupon-strategy）

Claude Code 用户可以在 CLAUDE.md 中写上这个规范，AI 创建分支时会自动遵循：

# Git 分支规范
- 分支命名：feature/模块名-简述、fix/模块名-简述、hotfix/简述、refactor/模块名-简述
- 所有开发在独立 feature 分支上进行，完成后通过 PR 合并回 main
- hotfix 分支从 main 直接拉出，修复后合并回 main 和当前 feature 分支
- Feature 分支存活不超过 3 天

OpenCode 用户在 opencode.json 中配置。

Hotfix 分支

线上出现紧急问题时，需要从 main 直接拉出 hotfix 分支。修复后同时合并回 main 和当前的 feature 分支（见上方 SVG 下半部分）。

关键原则： hotfix 分支的修改要尽可能小，只修复问题本身，不做额外的重构或功能添加。在提示词中明确告诉 AI："只修复 [具体问题]，不要做任何额外的改动。"

三、Conventional Commits 提交规范

为什么需要提交规范

AI 生成 commit message 的能力很强，但如果项目没有统一的提交规范，AI 会按照自己的理解生成风格不一致的 message。Commit 历史变成一堆格式各异的描述，后续的 changelog 生成、版本回溯、影响范围分析都无法自动化。

Conventional Commits 是一个轻量级的提交信息规范 。它定义了统一的格式，让 commit 历史可被机器解析。

格式说明

type(scope): description

[optional body]

[optional footer(s)]

各部分说明：

部分	必须	说明