Claude Code 检查点回溯与 Git 自动存档最佳实践

在 Claude Code 的配置文件 (~/.claude/settings.json) 中添加如下 Hook：

"hooks":{"Stop":[{"hooks":[{"command":"~/.claude/hooks/commit_per_turn.sh","type":"command"}],"matcher":""}]}

3. 自动化脚本 (commit_per_turn.sh)

创建脚本并赋予执行权限 (chmod +x commit_per_turn.sh)

#!/bin/bash
# --- 配置 ---
BRANCH_NAME="claude"
# ------------

# 1. 确保 Git 仓库存在
if ! git rev-parse --is-inside-work-tree > /dev/null 2>&1; then
    echo "📦 初始化 Git 仓库..."
    git init && git commit --allow-empty -m "Initial commit" > /dev/null 2>&1
fi

# 2. 检查是否有文件变动 (包括未追踪的文件)
if [ -z "$(git status --porcelain)" ]; then
    # 没有文件变动，直接退出，不产生空提交
    exit 0
fi

# 3. 确保在 claude 分支
CURRENT_BRANCH=$(git symbolic-ref --short HEAD 2>/dev/null)
if [ "$CURRENT_BRANCH" != "$BRANCH_NAME" ]; then
    if git show-ref --verify --quiet refs/heads/$BRANCH_NAME; then
        git checkout $BRANCH_NAME > /dev/null 2>&1
    else
        echo "🌱 创建 claude 分支..."
        git checkout -b $BRANCH_NAME > /dev/null 2>&1
    fi
fi

# 4. 添加所有文件
git add .

# 5. 生成概要总结 (关键步骤)
# 获取简短的统计信息，例如：" file1.py | 2 +- \n file2.js | 5 +++++"
# 处理输出变成单行："file1.py (2), file2.js (5)"
SUMMARY=$(git diff --cached --stat --format=oneline | head -n -1 | awk '{print $1}' | paste -sd ", " -)

# 组合最终提交信息
COMMIT_MSG="Claude Update: Modified [${SUMMARY}]"

# 如果信息太长，进行截断
if [ ${#COMMIT_MSG} -gt 150 ]; then
    COMMIT_MSG="${COMMIT_MSG:0:147}..."
fi

# 6. 提交
git commit -m "$COMMIT_MSG" > /dev/null 2>&1
echo "✅ [自动备份] 已提交变更到 $BRANCH_NAME 分支：$COMMIT_MSG"

建议:

关于 .gitignore：由于脚本执行的是 git add .，请务必确保你的项目根目录下有配置良好的 .gitignore 文件，防止 node_modules / 虚拟环境 等临时文件被意外提交