Claude Code 全栈自动化实战

# 启动 Claude Code（在项目根目录）
$ cd ~/projects/nextsaas
$ claude
 
# 进入交互模式
> 帮我分析这个项目的架构，列出主要模块和依赖关系
 
Claude Code:
  [读取 package.json]
  [读取 app/ 目录结构]
  [读取 lib/ 目录结构]
  [读取 tsconfig.json]
 
  "项目架构分析：
   - Next.js 15 App Router + React 19
   - 数据层：Drizzle ORM + PostgreSQL
   - 认证：Clerk（多租户）
   ..."

# 单次执行，不进入交互模式
$ claude -p "给 users 表添加 timezone 字段，更新 schema 和所有相关查询"
 
# 从文件读取任务
$ claude -p "$(cat tasks/add-notification-system.md)"
 
# 管道输入
$ cat error.log | claude -p "分析这个错误日志，找出根因"

# 继续上一个会话
$ claude --continue
 
# 恢复特定会话
$ claude --resume
 
# 列出历史会话
$ claude sessions list

> 实现完整的团队邀请功能：
  1. 管理员输入邮箱发送邀请
  2. 系统发送邀请邮件（用 Resend）
  3. 受邀者点击链接注册并加入团队
  4. 邀请 24 小时过期
  5. 不能重复邀请同一邮箱
  
  请参考 CLAUDE.md 中的项目约定。

> 将项目从 Pages Router 迁移到 App Router：
  
  1. 分析 pages/ 目录下所有路由
  2. 在 app/ 下创建等效路由
  3. 将 getServerSideProps 改为 Server Component 直接获取数据
  4. 将 getStaticProps 改为 generateStaticParams
  5. 将 useRouter 的 query 改为 useSearchParams
  6. 迁移 _app.tsx 的全局布局到 app/layout.tsx
  7. 迁移 _document.tsx 的 HTML 结构到 app/layout.tsx
  8. 迁移完成后删除 pages/ 目录
  9. 运行测试确认功能正常

> 给所有 Server Actions 添加输入验证
 
Claude Code:
  [修改 lib/actions/project.ts]
  [运行 pnpm build]
  
  ❌ Error: Type 'z.infer<typeof schema>' is not assignable to...
  
  [分析错误]
  [修改类型定义]
  [再次运行 pnpm build]
  
  ✅ Build successful
  
  [继续修改下一个文件...]

# 终端 1：实现后端逻辑
$ claude
> 实现通知系统的数据模型和 Server Actions
 
# 终端 2：实现前端组件（不依赖后端）
$ claude
> 基于这个接口定义，实现通知 UI 组件：
  - getNotifications(): Promise<Notification[]>
  - markAsRead(id: string): Promise<void>
  - getUnreadCount(): Promise<number>
  （后端同事正在实现，你先用 mock 数据）

# 在当前会话中启动后台任务
> /background 给 lib/actions/ 下所有文件添加 JSDoc 注释，不要修改任何逻辑
 
# 继续主任务
> 现在帮我实现搜索功能...
 
# 后台任务完成后会通知你

<!-- tasks/sprint-23.md -->
# Sprint 23 Tasks
 
## Task 1: 用户搜索
- 添加全文搜索索引（pg_trgm）
- 实现搜索 API
- 创建搜索 UI 组件
 
## Task 2: 通知系统
- 数据模型
- 触发器
- UI 组件
 
## Task 3: 导出功能
- CSV 导出 Server Action
- 导出按钮组件

$ claude -p "$(cat tasks/sprint-23.md)" --dangerously-skip-permissions

> 给 lib/actions/ 目录下所有 Server Actions 生成单元测试。
  
  要求：
  - 使用 Vitest
  - 测试文件放在 __tests__/ 目录
  - mock 数据库层（db.select, db.insert 等）
  - mock auth 层（getSession, requirePermission）
  - 每个 action 测试：正常流程、权限不足、输入无效、数据不存在
  - 运行 pnpm test 确认全部通过

> 运行 pnpm test，修复所有失败的测试。
  
  规则：
  - 先分析失败原因
  - 如果是测试代码的问题，修复测试
  - 如果是源代码的 bug，修复源代码
  - 不要删除或跳过测试
  - 修复后重新运行确认

> 给登录流程编写 Playwright E2E 测试：
  
  场景：
  1. 访问 /login → 看到登录表单
  2. 输入错误密码 → 显示错误提示
  3. 输入正确凭据 → 跳转到 /dashboard
  4. 刷新 /dashboard → 仍然保持登录状态
  5. 点击退出 → 跳转到 /login
  
  测试文件：e2e/auth.spec.ts
  运行：pnpm test:e2e

# 实现功能后自动提交
> 实现通知系统，完成后帮我 commit。
  commit message 使用 conventional commits 格式。
 
Claude Code:
  [完成所有代码修改]
  [运行 pnpm build 确认无误]
  [运行 pnpm test 确认通过]
  
  git add lib/db/schema.ts lib/actions/notification.ts ...
  git commit -m "feat(notifications): implement in-app notification system
  
  - Add notifications table schema
  - Add CRUD Server Actions
  - Add notification triggers for member/task/file events
  - Add NotificationBell and NotificationPanel components
  - Add unit tests for notification actions"

> 创建 PR 提交到 main 分支：
  
  - 确保当前分支所有修改已提交
  - PR 标题从 commit 历史生成
  - PR 描述包含：修改概述、测试情况、截图说明
  - 关联 Issue #42

# 审查当前分支相对 main 的改动
> 审查我的代码修改，重点检查：
  1. 安全问题（SQL 注入、XSS、权限绕过）
  2. 性能问题（N+1 查询、缺少索引、不必要的重渲染）
  3. 是否符合 CLAUDE.md 中的编码规范
  4. 边界情况处理
  
  输出格式：
  | 文件:行号 | 严重等级 | 问题描述 | 建议修复 |

> 我要给这个 SaaS 添加实时协作功能（类似 Google Docs）。
 
  请先深度分析：
  1. 技术方案对比（WebSocket vs CRDT vs OT）
  2. 在 Next.js + Vercel 上的可行性
  3. 数据一致性保证
  4. 离线支持策略
  5. 具体的实现计划
 
  不要写代码，先给出分析报告。

<!-- .claude/commands/new-feature.md -->
When implementing a new feature:
1. Read CLAUDE.md for project conventions
2. Design the database schema first (add to lib/db/schema.ts)
3. Generate migration: pnpm db:generate
4. Create Server Actions in lib/actions/
5. Create UI components
6. Write tests
7. Run pnpm build && pnpm test
8. Commit with conventional commit format
 
Reference files:
- Schema: lib/db/schema.ts
- Action pattern: lib/actions/project.ts
- Component pattern: components/create-project-form.tsx

> /new-feature 实现团队级别的文件存储功能，每个团队有独立的存储空间

# 1. 使用 --model 选择合适的模型
$ claude --model sonnet  # 日常任务用 Sonnet（便宜）
$ claude --model opus    # 复杂架构决策用 Opus（贵但强）
 
# 2. 精确的 CLAUDE.md 减少试错
#    AI 对项目越了解，一次性做对的概率越高
 
# 3. 拆分大任务
#    "一步实现完整通知系统" → 成本高，易出错
#    分 5 步实现 → 每步更便宜，总体可能更省
 
# 4. 用 --continue 复用会话
#    新会话需要重新读取所有文件，浪费 token
#    继续会话复用已有上下文