Prompt 技巧

# 模糊的 Prompt（不推荐）
> 帮我修一下登录功能

# 具体的 Prompt（推荐）
> 修复 src/auth/login.ts 中的登录函数，当用户输入错误密码时应该返回 401 状态码，
> 但目前返回的是 500。错误发生在第 45 行的 try-catch 块中。

# 提供文件和函数上下文
> 查看 src/utils/date.ts 中的 formatDate 函数，它在处理时区转换时有 bug。
> 当传入 UTC+8 的时间时，输出结果少了 8 小时。

# 提供技术栈上下文
> 这个项目使用 Next.js 14 App Router，我需要在 app/dashboard/page.tsx 中
> 添加一个服务端组件来获取用户数据。请使用项目已有的 src/lib/api.ts 中的
> fetchUser 函数。

> 请按以下步骤重构用户模块：
> 1. 先阅读 src/models/user.ts 和 src/services/userService.ts 的现有代码
> 2. 将 userService.ts 中的数据库查询逻辑提取到新的 src/repositories/userRepo.ts
> 3. 更新 userService.ts，使其调用 userRepo 中的方法
> 4. 确保所有现有的导入路径都更新正确
> 5. 运行 npm test 确认没有破坏现有测试

> 我需要添加一个新的 API 端点 /api/orders，请：
> 1. 在 src/types/order.ts 中定义 Order 接口
> 2. 在 src/repositories/orderRepo.ts 中实现数据库查询
> 3. 在 src/services/orderService.ts 中实现业务逻辑
> 4. 在 src/routes/orders.ts 中定义路由和控制器
> 5. 在 src/routes/index.ts 中注册新路由
> 6. 添加对应的单元测试到 tests/services/orderService.test.ts

> 重构 src/components/Dashboard.tsx 的状态管理逻辑，
> 将 useState 替换为 useReducer。
> 注意：不要修改组件的 JSX 结构和样式，不要改变 props 接口，
> 不要修改 src/components/DashboardHeader.tsx 文件。

# 第一轮：了解现状
> 分析 src/services/ 目录下所有服务文件的代码结构，
> 告诉我哪些地方存在重复的错误处理逻辑。

# 第二轮：制定方案
> 基于你的分析，设计一个统一的错误处理方案。
> 先不要写代码，只告诉我你的设计思路。

# 第三轮：逐步实施
> 方案看起来不错。先实现第一步：创建 src/utils/errorHandler.ts，
> 包含统一的错误处理函数。

# 第四轮：继续推进
> 很好。现在把 src/services/userService.ts 中的错误处理
> 替换为新的 errorHandler。

# 而不是说"这不对，重来"，给出具体反馈：
> 函数逻辑基本正确，但有两个问题需要调整：
> 1. 第 23 行的错误消息应该使用中文
> 2. 缺少对 null 参数的边界检查，请在函数开头添加

> 为 src/models/ 目录下的所有模型文件添加 JSDoc 注释。
> 参考以下风格：
>
> /**
>  * 用户数据模型
>  * @property {string} id - 用户唯一标识
>  * @property {string} email - 用户邮箱地址
>  * @property {Date} createdAt - 创建时间
>  */
> interface User {
>   id: string;
>   email: string;
>   createdAt: Date;
> }

> 创建一个 ProductCard 组件（React + TypeScript）：
> - 接收 props: { product: Product; onAddToCart: (id: string) => void }
> - 使用 Tailwind CSS 样式，响应式布局
> - 包含商品图片、名称、价格、加入购物车按钮
> - 图片使用 next/image 组件并支持 lazy loading
> - 价格格式化为人民币（¥），保留两位小数

> 在 src/routes/users.ts 中添加一个 PATCH /users/:id 端点：
> - 使用 Zod 验证请求体（只允许更新 name 和 email 字段）
> - 验证邮箱格式和唯一性
> - 使用事务更新数据库
> - 返回更新后的用户对象（排除 password 字段）
> - 添加适当的错误处理（404、409、422）

> 编写一个 Python 脚本处理 data/sales.csv：
> - 使用 pandas 读取 CSV 文件
> - 按月份聚合销售额
> - 计算环比增长率
> - 生成折线图保存到 output/monthly_sales.png
> - 将汇总数据导出为 output/summary.xlsx

> 先阅读 src/api/ 目录下的所有文件，理解现有的 API 架构，
> 然后告诉我添加一个新的 /api/notifications 端点需要创建哪些文件、
> 修改哪些文件。确认方案后我们再开始编码。

> 参照 src/services/userService.ts 的代码结构和风格，
> 创建一个新的 src/services/orderService.ts。
> 保持相同的错误处理模式、日志记录方式和命名风格。

> 先为 src/utils/validator.ts 中的 validateEmail 函数编写测试用例，
> 覆盖正常邮箱、无效格式、空值、特殊字符等场景。
> 然后根据测试用例实现该函数，确保所有测试通过。

> 审查 src/auth/middleware.ts 的代码，重点关注：
> 1. 安全漏洞（如 JWT 验证是否严格）
> 2. 错误处理是否完善
> 3. 边界条件是否覆盖
> 4. 是否有性能问题
> 给出具体的改进建议和修改后的代码。

# 不好的 Prompt
> 代码有 bug，帮我修一下

# 问题：Claude 不知道哪个文件、什么 bug、期望什么行为

# 不好的 Prompt
> 请打开 src/utils.ts 文件，找到第 15 行，将 const 改为 let，
> 然后在第 16 行后面添加一个空行，再在第 17 行写 console.log...

# 问题：像这样逐行指令式的 Prompt 不如直接告诉 Claude 你的目标，
# 让它自己决定实现方式

# 不好的 Prompt
> 用最简单的方式实现，要覆盖所有边界条件，
> 代码要尽量短，但要有详细的注释和错误处理

# 问题："最简单"和"覆盖所有边界条件"、"代码尽量短"和"详细注释"是矛盾的

# 不好的 Prompt
> 重构整个项目，添加 TypeScript 类型，升级所有依赖到最新版，
> 添加单元测试，配置 CI/CD，部署到 AWS

# 问题：任务太大太杂，应该拆分为多轮对话逐步完成