1
2
3
4
5
6
7

# 你以为你会看到这样的 diff
$ git diff main
# 修改了 1 个文件，5 行

# 实际上看到的是
$ git diff main
# 修改了 23 个文件，342 行增加，180 行删除

1
2
3
4
5
6
7
8

# 不要在 main 上直接跑
# ❌ 错误做法
git checkout main
claude  # 直接开干

# ✅ 正确做法：为每个任务创建独立分支
git checkout -b claude/fix-login-bug
claude  # 在隔离环境中工作

1
2
3
4

claude/feature-用户认证
claude/fix-登录bug
claude/refactor-数据库层
claude/experiment-新缓存方案

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 创建多个工作目录
git worktree add ../project-feature-a claude/feature-a
git worktree add ../project-feature-b claude/feature-b
git worktree add ../project-fix-c claude/fix-c

# 现在你的目录结构是
~/projects/
├── my-project/          # 主目录（main 分支）
├── project-feature-a/   # Claude 在这里做 feature-a
├── project-feature-b/   # Claude 在这里做 feature-b
└── project-fix-c/       # Claude 在这里修 bug-c

1
2
3
4
5
6
7
8

# 终端 1
cd ~/projects/project-feature-a && claude

# 终端 2
cd ~/projects/project-feature-b && claude

# 终端 3
cd ~/projects/project-fix-c && claude

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# ❌ 太臃肿的 CLAUDE.md
这个项目是一个 SaaS 平台，创建于 2023 年，使用了 Next.js、
TypeScript、PostgreSQL、Redis、Stripe... （后面还有 3000 字）

# ✅ 精炼有效的 CLAUDE.md
## 当前任务约束
- 只修改 src/auth/ 目录下的文件
- 不要动 database/migrations/
- 新功能必须有对应测试

## 架构关键点
- 认证走 JWT（不是 Session）
- 数据库操作必须通过 src/services/ 层
- 禁止直接调用 prisma client

1
2
3

# 在 Claude Code 交互中
/compact   # 压缩历史，保留关键信息
/clear     # 完全清除，重新开始

1
2
3
4
5

# 第二天继续昨天的任务
claude --resume

# Claude 会恢复上次对话的上下文
# 配合 git 分支，无缝继续工作

1
2
3

# 看到 Jira ticket，第一件事不是写代码
# 而是建分支
git checkout -b claude/JIRA-1234-user-profile-api

1
2
3
4
5
6
7

我需要实现用户 Profile API，要求：
1. GET /api/user/profile - 返回当前用户信息
2. PUT /api/user/profile - 更新用户信息（姓名、头像 URL）
3. 必须有请求校验和错误处理
4. 参考现有的 /api/user/settings 实现风格

请先给我一个实现计划，我确认后再执行。

1
2
3
4
5
6
7

# 查看 AI 做了什么
git diff main

# 重点检查
# - 有没有改它不该改的文件？
# - 逻辑是否正确？
# - 有没有引入安全隐患？

1
2
3
4
5
6

# 在 AI 分支上跑测试
npm test

# 只有测试全绿，才考虑合并
git checkout main
git merge claude/JIRA-1234-user-profile-api

1
2
3

# 任务完成后，清理 worktree
git worktree remove ../project-feature-a
git branch -d claude/JIRA-1234-user-profile-api

1
2
3
4
5

## AI 分支命名规范
- claude/feat-xxx   # 新功能
- claude/fix-xxx    # Bug 修复
- claude/refactor-xxx  # 重构
- claude/exp-xxx    # 实验性（随时可丢弃）

1
2
3
4
5
6
7
8
9

<!-- .github/PULL_REQUEST_TEMPLATE/claude.md -->
## AI 生成说明
- [ ] 我已 Review 所有修改的文件
- [ ] 测试已通过
- [ ] 没有引入安全问题
- [ ] 逻辑符合业务需求

## Claude 使用的提示词
（粘贴你给 Claude 的原始需求）

1
2
3
4

# 在仓库根目录维护团队共用的 CLAUDE.md
# 每个人不用重新给 AI 解释项目架构
git add CLAUDE.md
git commit -m "chore: 更新 Claude Code 团队工作指南"