第 07 集：Claude Code 终端 Agent

# 安装
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

# 登录（需要 Anthropic 账号）
claude login

claude "任务描述"

claude

claude "分析 src/modules/user/user.service.ts，找出所有潜在问题"

claude "分析 src/modules/user/user.service.ts，检查以下问题：
1. 安全性问题（密码处理、SQL 注入风险、权限缺失）
2. 错误处理缺失（没有捕获的异常、没有校验的参数）
3. 类型安全问题（any 类型、类型断言滥用）
4. 业务逻辑问题（软删除、事务处理）
用列表格式输出，每个问题注明行号和危害"

claude "分析 src/ 目录下所有文件，找出代码质量最差的三个文件，说明原因"

claude "读取 order-prd.md，根据里面的需求在项目里创建 OrderModule"

claude "读取项目根目录的 order-prd.md，根据需求：
1. 修改 prisma/schema.prisma，加入 Order model
2. 在 src/modules/order/ 下创建完整的 OrderModule
3. 在 src/app.module.ts 里注册 OrderModule
4. 告诉我需要我手动执行哪些命令（prisma migrate 等）"

claude "重构 src/modules/user/user.service.ts：
1. 把所有 any 类型替换成正确的 TypeScript 类型
2. 把 remove 方法从硬删除改成软删除（update deletedAt）
3. 所有 public 方法加 JSDoc 注释
修改完后给我展示修改了哪些内容"

claude "扫描 src/ 目录下所有 .ts 文件，把所有的 console.log 替换成 NestJS Logger 的对应方法：
- console.log → this.logger.log
- console.error → this.logger.error
- console.warn → this.logger.warn
对于每个文件，确保先在构造函数里注入 Logger"

claude "为 src/modules/user/user.service.ts 生成单元测试，
重点覆盖 create 和 findAll 方法的正常流程和异常场景，
生成完之后直接运行测试，告诉我结果"

claude "运行 npm test，把所有失败的测试用例修复，修复后重新运行确认全绿"

claude --version
claude login   # 如果没有登录过

cd agent-demo

// 在 UserService 里加入这个有问题的方法
async searchUsers(keyword: any) {
  // 问题1：any 类型
  // 问题2：没有过滤软删除
  // 问题3：没有错误处理
  return await this.prisma.user.findMany({
    where: {
      username: { contains: keyword }
    }
  });
}

# 订单模块需求

## 字段
- id: 自增主键
- orderNo: 订单号，唯一，格式 ORD + 时间戳
- userId: 关联用户 ID（外键）
- totalAmount: 订单总金额（Decimal，精度 10，小数 2 位）
- status: 枚举 PENDING | PAID | SHIPPED | COMPLETED | CANCELLED，默认 PENDING
- remark: 备注，可为空
- createdAt、updatedAt

## 接口
- POST /api/orders：创建订单
- GET /api/orders：获取列表（分页）
- GET /api/orders/:id：获取详情
- PATCH /api/orders/:id/status：更新状态
- DELETE /api/orders/:id：取消订单（只有 PENDING 状态可以取消）

cd agent-demo
claude

分析 src/modules/user/user.service.ts 这个文件，按照以下维度找出问题：
1. 安全性问题
2. 错误处理缺失
3. 类型安全问题（any 类型）
4. 业务逻辑问题

用列表格式输出，每个问题说明：所在行、问题描述、危害、修复建议

读取项目根目录的 order-prd.md，根据需求：
1. 修改 prisma/schema.prisma，加入 Order model 和 OrderStatus enum
2. 在 src/modules/order/ 目录下创建完整的 OrderModule，包含 DTO、Service、Controller、Module 文件
3. 在 app.module.ts 里注册 OrderModule
4. 完成后告诉我需要手动执行哪些命令

npx prisma migrate dev --name add-order-module
npx prisma generate

ls src/modules/order/
# 期望看到：
# order.controller.ts
# order.service.ts
# order.module.ts
# dto/
#   create-order.dto.ts
#   update-order-status.dto.ts
#   find-orders.dto.ts

根据刚才 analyze 发现的问题，重构 src/modules/user/user.service.ts：
1. searchUsers 方法的 keyword 参数从 any 改为 string 类型
2. searchUsers 方法加上 where: { deletedAt: null } 过滤软删除
3. 所有没有 JSDoc 注释的 public 方法加上注释

修改完之后显示 diff，说明每处修改的原因

npx tsc --noEmit

为 src/modules/order/order.service.ts 生成单元测试文件。

要求：
- 测试文件路径：src/modules/order/order.service.spec.ts
- 使用 Jest，Mock PrismaService
- 重点测试：
  1. create：正常创建订单，orderNo 格式是 ORD + 时间戳
  2. cancel：正常取消 PENDING 订单
  3. cancel：尝试取消非 PENDING 状态的订单，应抛出 BadRequestException
- 测试描述用中文

生成完成后，运行测试命令：npm test -- order.service.spec.ts --verbose
把测试结果告诉我

有测试失败了，错误信息是：[Claude Code 输出的错误信息]
帮我修复，修复后重新运行测试

npm test -- order.service.spec.ts --verbose

这是一个 NestJS + Prisma + PostgreSQL 的电商后端项目，
使用 TypeScript strict 模式，
Prisma Schema 在 prisma/schema.prisma，
业务模块在 src/modules/ 下，
请先大致了解一下项目结构，然后我会给你具体任务

# 项目说明

## 技术栈
- NestJS 10 + Prisma + PostgreSQL
- TypeScript strict 模式

## 重要约定
- 不要使用 any 类型
- 软删除用 deletedAt 字段
- 所有接口返回 ResponseDto 格式
- 数据库操作涉及多表时必须用事务

## 常用命令
- 启动：npm run start:dev
- 测试：npm test
- 编译检查：npx tsc --noEmit
- Migration：npx prisma migrate dev --name 描述

# TypeScript 类型检查
npx tsc --noEmit

# 运行所有测试
npm test

# 启动项目，确认没有运行时报错
npm run start:dev

npm install -g @anthropic-ai/claude-code

export ANTHROPIC_API_KEY="sk-ant-..."

# 或者写进 ~/.zshrc / ~/.bashrc 永久生效
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc

claude --version

cd my-project
claude

> 分析一下这个项目的整体结构，告诉我哪些地方代码质量有问题

claude "帮我查一下 src/modules/user/user.service.ts 里有没有 N+1 查询问题"

cat src/modules/user/user.service.ts | claude "分析这段代码的问题"

npm test 2>&1 | claude "解释这些测试失败的原因，给出修复建议"

> 扫描整个 src 目录，告诉我：
  1. 有哪些模块
  2. 模块间的依赖关系
  3. 有没有循环依赖的风险

> 读取 src/modules/user/user.service.ts，指出：
  - 潜在的 bug
  - 性能问题
  - 安全隐患
  - 不符合 NestJS 最佳实践的写法

> 看一下最近 10 次提交，总结这段时间主要改了哪些东西，
  有没有频繁改动同一个文件的情况（可能说明设计有问题）

> 在 src/modules/ 下创建 order 模块，参考 user 模块的结构，
  包含 controller、service、module、dto 文件。
  Order 的字段：id、userId、totalAmount、status（PENDING/PAID/CANCELLED）、
  createdAt、updatedAt。
  使用 Prisma，遵循项目的代码规范。

> 帮我生成 Docker Compose 配置，包含：
  - app 服务（Node.js 20，挂载当前目录）
  - postgres 服务（PostgreSQL 16，数据持久化）
  - 两个服务在同一个网络里
  - 读取 .env 文件的配置

> 帮我写 GitHub Actions 的 CI 配置：
  - 触发条件：push 到 main 或 PR
  - 步骤：安装依赖 → 运行 lint → 运行单元测试 → 构建
  - Node.js 版本：20
  - 缓存 node_modules

> 扫描 src/modules/ 下所有文件，
  找出所有用了 pageNum 作为分页参数名的地方，
  统一改成 page（保持和接口规范一致）

> 读取 src/modules/user/user.service.ts 和
  src/modules/product/product.service.ts，
  我发现两个文件里的分页查询逻辑几乎一样。
  帮我提取成一个公共的 paginate 工具函数放在
  src/common/utils/paginate.ts，然后在两个 service 里调用它。

> 扫描 src/ 下所有文件，把用了 Promise.then().catch() 链式写法的
  地方改成 async/await + try/catch，逐文件处理

npm test 2>&1 | claude "分析这些测试失败原因，哪些是代码 bug，哪些是测试写错了"

> 为 src/modules/user/user.service.ts 的所有方法生成单元测试，
  写到 src/modules/user/user.service.spec.ts，
  写完后运行 npm test 验证测试能通过

# CLAUDE.md — 项目 AI 操作指南

## 项目概述
NestJS + Prisma + PostgreSQL 的用户管理系统后端。

## 启动命令
```bash
npm run start:dev    # 开发模式
npm run build        # 构建
npm test             # 单元测试
npm run test:e2e     # E2E 测试
npx prisma studio    # 数据库管理界面
```text

## 代码规范
+ 遵循 .cursorrules 的所有约定
+ 禁止修改 prisma/migrations/ 下的文件
+ 禁止直接修改 dist/ 目录

## 重要文件
+ src/common/constants/error-code.ts：所有业务错误码定义
+ src/common/filters/all-exceptions.filter.ts：全局异常处理
+ prisma/schema.prisma：数据模型

## 数据库操作
+ 修改 schema 后必须执行：npx prisma migrate dev
+ 不要直接修改数据库，所有变更通过 migration

## 禁止操作
+ 禁止删除 .env 文件
+ 禁止在 src/ 外创建业务代码文件
+ 禁止修改 package.json 中已有的脚本

```plain
---

### 6. 与 Shell 工作流集成

Claude Code 可以和常用的 shell 命令组合，形成自动化工作流。

#### 配合 git：

```bash
# 生成 commit message
git diff --staged | claude "根据这个 diff，生成一个符合 Conventional Commits 格式的 commit message"

# 分析某次提交的影响
git show abc123 | claude "分析这次提交做了什么，有没有潜在问题"

npm run lint 2>&1 | claude "解释这些 lint 错误，给出批量修复方案"

tail -100 logs/app.log | claude "分析最近的日志，有没有异常或值得关注的错误模式"

# 1. 查看本次改动
git diff main...HEAD | claude "
  审查这次改动：
  1. 有没有明显的 bug 或逻辑错误？
  2. 有没有安全隐患（SQL 注入、未校验输入、密码明文等）？
  3. 有没有遗漏错误处理？
  4. 命名是否清晰？
  5. 有没有可以改进的地方？
  给出具体的文件名和行数。
"