AI 写代码的 Git 用法，和人类完全不一样——checkpoint 策略三原则

# ❌ 旧节奏（为自己设计的）
写代码 30 分钟 → commit "WIP: 用户模块重构"
写代码 30 分钟 → commit "WIP: 继续重构"
让 AI 改 6 个文件 → ...没有 commit，因为"一会儿还要继续"
# 出问题 → 无法回退

# ✅ 新节奏（为 AI 协作设计的）
写代码 30 分钟 → commit "feat: 用户模块基础结构"     # 你自己的 checkpoint
让 AI 改 API 层 → commit "ai: JWT 认证 - API 层"     # AI 的 checkpoint
让 AI 改服务层 → commit "ai: JWT 认证 - 服务层"      # AI 的 checkpoint
让 AI 改测试   → commit "ai: JWT 认证 - 测试更新"    # AI 的 checkpoint
# 任何时候发现 AI 的改动有问题 → git revert <ai-commit>

# commit 命名约定
你自己写的：  "feat: xxx" / "fix: xxx" / "refactor: xxx"
AI 帮你写的： "ai: xxx"  （统一前缀）

# 为什么需要区分？
git log --oneline

abc1234 fix: 修复登录页面样式
def5678 ai: JWT 认证 - 中间件更新
ghi9012 ai: JWT 认证 - 错误处理
jkl3456 feat: 添加用户搜索功能
mno7890 ai: JWT 认证 - 测试修复
pqr1234 refactor: 重构数据库连接池

# 一眼看出：3 个 commit 是 AI 的（可以集体 revert）
#           3 个是你自己的

# 有前缀区分 → 批量操作
git revert def5678 ghi9012 mno7890
# 三个命令，10 秒搞定

# 没有前缀区分 → 手动找
git log --oneline | grep -i "jwt\|认证"  # 可能漏掉
# 手动判断每个 commit 是谁写的 → 容易出错

# ✅ AI 做大改动前的标准流程
git checkout -b ai/refactor-user-module   # 1. 开新分支
# 让 AI 在这个分支上随便改
git checkout master                       # 2. 随时可以切回主分支
# review AI 的改动
git diff master...ai/refactor-user-module # 3. 看所有改动
# 确认没问题
git checkout master
git merge ai/refactor-user-module         # 4. 合并
git branch -d ai/refactor-user-module     # 5. 删除分支

def needs_branch(task):
    if task.files_to_modify > 5:
        return True
    if task.lines_to_change > 300:
        return True
    if task.renames_modules:
        return True
    if task.moves_code_between_files:
        return True
    if "重构" in task.description or "refactor" in task.description:
        return True
    return False

# ===========================================
# AI 协作的 Git 工作流
# ===========================================

# 1. AI 动手前 → commit 你的当前状态
git add -A
git commit -m "checkpoint: AI 修改前的状态"

# 2. 判断改动规模
if task_to_give_to_ai.is_large():
    git checkout -b "ai/$task_name"

# 3. 每次 AI 完成一个独立改动 → commit
# （不是等 AI 做完所有事再 commit）

# AI 改完了 API 层
git add src/api/
git commit -m "ai: $task_name - API 层"

# AI 改完了服务层
git add src/services/
git commit -m "ai: $task_name - 服务层"

# AI 改完了测试
git add tests/
git commit -m "ai: $task_name - 测试更新"

# 4. 验证 → 合并或回退
if ai_changes_are_good():
    git checkout master
    git merge "ai/$task_name"
else:
    # 回退某个具体 AI commit
    git revert <bad-ai-commit>
    # 或者扔掉整个分支
    git checkout master
    git branch -D "ai/$task_name"

# ❌ 无用的 commit message
git commit -m "ai: 更新"

# ✅ 有用的 commit message
git commit -m "ai: JWT 认证重构 - 替换所有 session 逻辑
原因：session 在负载均衡下不稳定
AI 改了什么：src/auth/middleware.py, src/auth/tokens.py
AI 没改什么：数据库 schema、前端 cookie 逻辑
验证方式：跑 test_auth.py 全部通过"