Claude Code Git协作全流程实战：从智能Commit到AI审查

# 验证所有工具
claude --version
git --version
gh --version
node --version

# 验证Git身份配置
git config user.name
git config user.email

# 验证GitHub认证状态
gh auth status

# 进入你的项目目录
cd your-project

# 启动Claude Code交互模式
claude

> 查看当前Git状态

> 有哪些文件被修改了

> 显示最近的5条commit

> 请帮我提交当前的修改

feat: add user authentication with JWT tokens

- Implement login/logout endpoints
- Add token validation middleware
- Create user model with password hashing
- Add unit tests for auth flows

Co-Authored-By: Claude <[email protected]>

> 只提交 src/auth.ts 和 tests/auth.test.ts 的修改

> 按照conventional commits格式提交，scope是auth

## Git Commit规范

- 使用Conventional Commits格式
- commit message用中文描述
- 每条commit只做一件事
- 不要自动添加版本号前缀
- 提交前必须运行测试确保通过
- 不要提交 .env、credentials等敏感文件

# 1. 修改一些文件（示例：添加一个新函数）
echo "export function validateEmail(email: string): boolean {
  return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
}" >> src/validators.ts

# 2. 启动Claude Code
claude

# 3. 在Claude Code中执行
> 提交新添加的邮箱验证函数

[Claude Code执行]
1. 运行 git status → 发现 src/validators.ts 被修改
2. 运行 git diff src/validators.ts → 分析变更内容
3. 运行 git log --oneline -5 → 了解commit风格
4. 生成commit message:
   "feat: add email validation utility function"
5. 运行 git add src/validators.ts
6. 运行 git commit -m "feat: add email validation utility function
   ..."
7. 运行 git status → 确认工作区干净

> 创建一个新分支 feature/user-profile，从main分支切出

1. git status → 检查是否有未提交的变更
2. 如果有未提交变更 → 提示你是否先stash或commit
3. git checkout main → 切回主分支
4. git pull → 拉取最新代码
5. git checkout -b feature/user-profile → 创建并切换到新分支

> 我要修复登录页面的样式bug，帮我创建合适的分支

> 把 feature/user-profile 合并到 main

1. git checkout main
2. git pull origin main
3. git merge feature/user-profile
4. 如果有冲突 → 进入冲突解决模式（见第七步）
5. git push origin main

> 请帮我把当前分支的改动创建一个PR到main分支

1. git status → 确认所有变更已提交
2. git push -u origin feature/user-profile → 推送到远程
3. git log main..HEAD → 分析所有commit
4. git diff main...HEAD → 分析完整代码变更
5. 生成PR标题和描述
6. gh pr create → 创建Pull Request

## 标题
feat: Add user profile page with avatar upload

## 正文
### Summary
- Add user profile page component with responsive layout
- Implement avatar upload with image preview
- Add profile editing form with validation
- Include unit tests for all new components

### Test Plan
- [ ] Verify profile page renders correctly on mobile/desktop
- [ ] Test avatar upload with various image formats
- [ ] Validate form submission with valid/invalid inputs
- [ ] Run full test suite: `npm test`

🤖 Generated with [Claude Code](https://claude.com/claude-code)

> 创建一个PR，标题用英文，正文用中文，
> 重点关注这次的性能优化改动

## PR规范

- PR标题用英文，不超过70个字符
- PR正文包含Summary、Changes、Test Plan三个部分
- 自动关联相关的GitHub Issue
- 审查者默认指定 @team-lead

# 在项目根目录安装插件
claude install-plugin code-review

# 创建插件配置
mkdir -p .claude/plugins
cat > .claude/plugins/code-review.json << 'EOF'
{
  "name": "code-review",
  "version": "1.0.0",
  "triggers": ["pull_request"]
}
EOF

graph TB
    subgraph "Code Review Plugin"
        PR[Pull Request] --> Orchestrator[审查编排器]
        Orchestrator --> A1[Agent 1: 正确性审查]
        Orchestrator --> A2[Agent 2: 安全性审查]
        Orchestrator --> A3[Agent 3: 代码风格审查]
        Orchestrator --> A4[Agent 4: 测试覆盖审查]
        Orchestrator --> A5[Agent 5: 性能审查]
        A1 --> Merge[汇总审查结果]
        A2 --> Merge
        A3 --> Merge
        A4 --> Merge
        A5 --> Merge
        Merge --> Comments[行内评论 + 总体评价]
    end

> 审查我当前分支相对于main的所有变更

## Code Review Report

### Summary
发现 3 个问题（1 个高优先级，2 个低优先级）

### 🔴 高优先级

**src/auth/login.ts:42**
> 检测到潜在的SQL注入风险。`userId` 参数直接拼接到SQL查询中，
> 建议使用参数化查询：
> ```typescript
> // 修改前
> db.query(`SELECT * FROM users WHERE id = '${userId}'`)
> // 修改后
> db.query('SELECT * FROM users WHERE id = $1', [userId])
> ```

### 🟡 低优先级

**src/utils/validator.ts:15**
> `validateEmail` 函数的正则表达式不支持国际域名（IDN），
> 考虑使用更全面的验证方案或第三方库如 `validator.js`。

**tests/auth.test.ts:88**
> 测试缺少对并发登录场景的覆盖，建议补充边界条件测试。

> 审查 src/auth.ts，重点关注安全问题

> 第42行的SQL注入，帮我修复它

> 修复后重新运行相关测试

name: Claude Code Review

on:
  pull_request:
    types: [opened, synchronize]
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  claude-review:
    if: |
      github.event_name == 'pull_request' ||
      contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
      issues: write

    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          max_turns: 5

# 在仓库中添加Anthropic API密钥
gh secret set ANTHROPIC_API_KEY
# 粘贴你的API Key后按回车

@claude 请审查这个PR的代码变更

@claude 这个文件有安全漏洞吗？
@claude 帮我补充缺失的单元测试
@claude 解释一下这个函数的逻辑
@claude 重构这段代码使其更可读

# .github/workflows/claude-advanced.yml
name: Claude Advanced Review

on:
  pull_request:
    types: [opened, synchronize]

jobs:
  claude-review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write

    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          claude_args: |
            --append-system-prompt "你是代码审查专家。重点关注安全性、性能和可维护性。用中文回复。"
          max_turns: 8

name: Claude CI Fix

on:
  workflow_run:
    workflows: ["CI"]
    types: [completed]
    # 当CI失败时触发

jobs:
  auto-fix:
    if: ${{ github.event.workflow_run.conclusion == 'failure' }}
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write

    steps:
      - uses: actions/checkout@v4

      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          claude_args: |
            CI失败了，请分析失败日志并自动修复问题。
            修复后创建一个新的commit。

> 帮我解决当前的合并冲突

> 解决冲突，优先保留我们的改动（ours）

> 解决冲突，尽量合并两边的逻辑，不要丢弃任何一方的功能

# 1. 创建冲突场景
git checkout -b feature/a
echo "const version = '1.0.0';" > config.js
git add config.js && git commit -m "set version to 1.0.0"

git checkout main
echo "const version = '2.0.0';" > config.js
git add config.js && git commit -m "bump version to 2.0.0"

git merge feature/a  # 产生冲突！

# 2. 启动Claude Code解决冲突
claude
> 解决config.js的合并冲突，保留更高的版本号

1. 读取 config.js 冲突内容：
   <<<<<<< HEAD
   const version = '2.0.0';
   =======
   const version = '1.0.0';
   >>>>>>> feature/a

2. 分析意图：HEAD版本是2.0.0，feature/a是1.0.0
3. 用户要求保留更高版本号
4. 解决方案：保留 2.0.0
5. 生成合并后内容：const version = '2.0.0';
6. 等待用户确认后 git add config.js

> src/api.ts 有冲突，两边都修改了 handleRequest 函数，
> 请合并两边的改动——一方添加了认证逻辑，
> 另一方添加了错误处理，两个功能都需要保留

cd task-manager-app
claude

> 我要添加任务优先级功能，支持高/中/低三个级别，
> 请创建合适的Git分支

Claude Code:
我将创建分支 feature/task-priority。

[执行]
git checkout main
git pull origin main
git checkout -b feature/task-priority

> 添加任务优先级功能。需要：
> 1. 在Task模型中添加priority字段（枚举：high/medium/low）
> 2. 添加设置和获取优先级的API端点
> 3. 在前端显示优先级标签（红色/黄色/绿色）
> 4. 编写单元测试

> 审查一下所有改动，看看有没有问题

Claude Code:
审查发现 2 个问题：
1. [低] priority默认值建议设为'medium'而非'low'
2. [建议] 建议添加priority变更的审计日志

> 修复第一个问题，提交所有改动

Claude Code:
[执行 git add, git commit]
commit feat: add task priority feature with high/medium/low levels

> 创建PR到main分支

Claude Code:
[执行 git push -u origin feature/task-priority]
[执行 gh pr create]

Created PR #42: feat: Add task priority feature
https://github.com/your-org/task-manager-app/pull/42

sequenceDiagram
    participant Dev as 开发者
    participant CC as Claude Code
    participant GH as GitHub
    participant GA as GitHub Actions
    participant Review as AI审查

    Dev->>CC: 创建功能分支
    CC->>GH: git push
    Dev->>CC: 创建PR
    CC->>GH: gh pr create
    GH->>GA: PR opened 事件触发
    GA->>Review: 启动AI代码审查
    Review->>GH: 发布审查评论
    Dev->>GH: @claude 补充测试
    GH->>GA: 评论事件触发
    GA->>Review: Claude生成测试代码
    Review->>GH: 推送测试commit
    Dev->>GH: 合并PR

> PR #42 的审查意见说需要在API端点添加参数校验，
> 请修复并推送

Claude Code:
[修改 src/api/tasks.ts 添加参数校验]
[git commit -m "fix: add priority validation to API endpoint"]
[git push origin feature/task-priority]

> PR #42 已经通过了所有审查和CI，请合并到main

Claude Code:
确认以下操作：
- 合并 PR #42 (feature/task-priority → main)
- 使用 squash merge 保持主分支历史整洁

是否继续？[Y/n]

[确认后执行]
gh pr merge 42 --squash --delete-branch

graph TB
    subgraph "本地开发环境"
        A[自然语言指令] --> B[Claude Code]
        B --> C{Git操作类型}
        C -->|提交| D[智能Commit Message]
        C -->|分支| E[分支管理]
        C -->|审查| F[本地Code Review]
        C -->|冲突| G[合并冲突解决]
    end

    subgraph "GitHub远程协作"
        D --> H[git push]
        E --> H
        H --> I[Pull Request]
        I --> J[claude-code-action]
        J --> K[多Agent并行审查]
        K --> L[行内评论]
        L --> M{审查结果}
        M -->|通过| N[合并到Main]
        M -->|需修改| O["@claude 自动修复"]
        O --> I
    end

    subgraph "CI/CD集成"
        N --> P[CI Pipeline]
        P -->|失败| Q[Claude自动修复]
        Q --> R[修复Commit]
        R --> P
        P -->|通过| S[部署完成]
    end

    style B fill:#FF6B35,color:#fff
    style J fill:#7B68EE,color:#fff
    style K fill:#4ECDC4,color:#fff
    style S fill:#2ECC71,color:#fff

# 检查当前权限模式
claude config list

# 方法1：使用--allowedTools允许特定操作
claude --allowedTools "Bash(git:*),Bash(gh:*)"

# 方法2：在.claude/settings.json中永久配置
# 允许Git和GitHub CLI命令
{
  "permissions": {
    "allow": [
      "Bash(git:*)",
      "Bash(gh:*)"
    ]
  }
}

## Commit规范
- 格式：`<type>(<scope>): <subject>`
- type只能是：feat, fix, docs, style, refactor, test, chore
- subject不超过50个字符
- body每行不超过72个字符
- 不使用emoji
- 不添加Co-Authored-By行

# 重新认证
gh auth login
# 选择 GitHub.com → HTTPS → 浏览器登录

# 验证
gh auth status

# 如果token过期
gh auth refresh -h github.com -s repo,workflow

# 限制审查的文件范围和Agent轮次
- uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    max_turns: 3
    # 只审查特定目录的变更
    claude_args: |
      只审查 src/ 目录下的代码变更。
      忽略自动生成的文件和第三方库。

> 我这次的修改包含三个独立功能：
> 1. 用户登录优化
> 2. 数据导出功能
> 3. UI样式调整
> 
> 请拆分成三个独立的commit

> 读取 GitHub Issue #15 的内容，创建分支并实现功能，
> 完成后创建PR并关联这个Issue

> 审查最近10条commit的message质量，
> 看看有没有不符合规范的

> 帮我整理最近5条commit：
> - 把第3条和第4条合并
> - 第2条的消息修改为"fix: correct date formatting"
> - 按时间重新排序

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash(git commit*)",
        "command": "npm run lint && npm test",
        "description": "提交前运行lint和测试"
      }
    ]
  }
}

第1小时：环境验证 + 智能Commit + 分支管理
第2小时：PR创建 + Code Review实操
第3小时：GitHub Actions配置 + 合并冲突练习
第4小时：综合实战（模拟完整开发周期）