AI编程Prompt模板

# 一个结构完整的 Prompt 示例
 
## 角色
你是一位精通 Python 后端开发的工程师，熟悉 FastAPI 和 SQLAlchemy。
 
## 任务
实现一个用户注册接口，包含邮箱验证和密码加密。
 
## 上下文
- 框架：FastAPI + SQLAlchemy 2.0
- 数据库：PostgreSQL
- 已有模型：User 表包含 id, email, hashed_password, created_at 字段
- 认证方案：JWT，access token 有效期 30 分钟
 
## 要求
1. 密码使用 bcrypt 加密，不要使用明文或简单 hash
2. 邮箱重复时返回 409 状态码，附带明确错误信息
3. 输入校验使用 Pydantic v2
4. 不要引入 Celery 或其他异步任务队列，邮件发送用同步 mock
 
## 输出格式
- 输出完整的 router 文件代码
- 包含 Pydantic schema 定义
- 函数级别添加 docstring，说明参数和返回值
- 错误处理使用统一的 HTTPException

## 任务
实现一个倒计时 Hook：useCountdown
 
## 上下文
- 项目使用 React 18 + TypeScript
- 状态管理使用 useState + useEffect，不引入外部库
- 需要兼容 SSR（Next.js 环境）
 
## 功能要求
1. 接收目标时间戳（number）作为参数
2. 返回 { days, hours, minutes, seconds } 对象
3. 倒计时归零后自动停止定时器
4. 组件卸载时清理定时器
 
## 边界处理
- 目标时间已过期时，返回全零对象
- 传入非法值（NaN、负数）时，返回 null 并在 console.warn 输出提示
 
## 输出格式
- 单个 TypeScript 文件
- 导出 Hook 函数和返回类型接口
- 附带 2-3 个使用示例

## 任务
审查以下 TypeScript 代码，重点关注三个方面：
1. 类型安全性——是否存在 any 逃逸或类型断言滥用
2. 错误处理——异步操作是否有未捕获的异常
3. 性能——是否有不必要的重渲染或内存泄漏风险
 
## 代码
[粘贴代码]
 
## 输出格式
按严重程度分级输出：
- 🔴 必须修复（会导致运行时错误或数据问题）
- 🟡 建议优化（影响可维护性或性能）
- 🟢 可选改进（代码风格或更优雅写法）
 
每个问题指出具体行号、问题描述、修复建议。

## 任务
排查一个生产环境中的内存泄漏问题。
 
## 现象描述
- Node.js 服务运行 48 小时后内存从 200MB 增长到 1.8GB
- 重启后内存恢复正常，但再次运行后缓慢增长
- 没有明显的 OOM crash，但接近 Node.js 默认堆上限时响应变慢
 
## 环境信息
- Node.js 20.x
- Express + Prisma + PostgreSQL
- 使用了连接池（max: 10）
 
## 已排查
- Prisma 连接池配置正常，空闲连接回收逻辑已确认
- 没有全局变量持续累积数据
- 日志中未发现异常请求模式
 
## 怀疑方向
- 事件监听器未清理
- 闭包引用导致对象无法回收
- 某个中间件每次请求创建新对象
 
## 请求
1. 分析可能的泄漏点，给出排查优先级
2. 为每个怀疑方向提供具体的检测代码或诊断命令
3. 给出修复方案的代码示例

## 任务
重构以下函数，目标是提升可读性和可测试性。
 
## 当前问题
- 单个函数超过 80 行，混合了数据校验、业务计算和日志记录
- 多个 if-else 分支难以覆盖测试用例
- 依赖全局配置对象，无法独立测试
 
## 重构约束
- 保持对外接口不变（函数签名、返回值结构）
- 不引入新的外部依赖
- 重构后每个子函数行数不超过 30 行
 
## 当前代码
[粘贴代码]
 
## 输出格式
1. 先给出重构方案的简要说明（拆分为哪些函数，各自的职责）
2. 输出重构后的完整代码
3. 标注每个拆分决策的理由

## 任务
实现一个版本号比较函数
 
## 示例
输入: compareVersion("1.01", "1.1")
输出: 0  (两个版本号相等，忽略前导零)
 
输入: compareVersion("1.0.1", "1")
输出: 1  (第一个版本号更大，缺失的修订号视为 0)
 
输入: compareVersion("0.1", "1.0")
输出: -1  (第一个版本号更小)

# 第一轮：确认方案
我需要实现一个文件上传功能，支持断点续传。
请先给出技术方案选型和架构设计，不要写代码。
 
# 第二轮：核心逻辑
方案确认。现在实现分片上传的核心逻辑，使用 Node.js + Busboy。
输入：文件流 + 分片大小
输出：每个分片的写入路径和校验 hash
 
# 第三轮：边界处理
在上面的基础上，补充以下边界处理：
1. 磁盘空间不足时的回滚逻辑
2. 并发上传同名文件的冲突处理
3. 分片校验失败时的重试机制
 
# 第四轮：集成和测试
将上面的代码整合为一个完整的 UploadService 类。
包含单元测试，覆盖正常上传、断点续传、分片校验失败三个场景。

## 任务
实现一个搜索输入框组件，带防抖和搜索建议下拉
 
## 上下文
- React 18 + TypeScript + Tailwind CSS
- 搜索 API 端点：GET /api/search?q=keyword
- 防抖间隔 300ms
 
## 要求
1. 输入时显示 loading 状态
2. 下拉建议最多显示 5 条，超出显示「查看更多」
3. 键盘导航支持（上下箭头选择，回车确认，Esc 关闭）
4. 点击外部区域关闭下拉
5. 组件需要在移动端和桌面端都有良好的交互体验
 
## 输出
- 一个 SearchInput.tsx 文件
- Props 接口定义（包含 onChange、onSelect 回调）
- 不引入第三方 UI 库

## 任务
实现订单创建接口，扣减库存并生成订单记录
 
## 上下文
- NestJS + TypeORM + MySQL
- 库存表 products.stock 使用乐观锁（version 字段）
- 订单状态：pending → paid → shipped → completed
 
## 要求
1. 使用数据库事务保证库存扣减和订单创建的一致性
2. 库存不足时返回 400，附带具体商品名称
3. 乐观锁冲突时自动重试一次，再次失败返回 503
4. 接口需要幂等——相同 idempotency-key 不重复创建订单

## 角色
你是 React 前端工程师，精通 Headless UI 模式。
 
## 任务
实现一个数据表格组件，支持列排序和多选筛选。
 
## 上下文
- Next.js 16 App Router + TypeScript
- 数据从 Server Component 获取，客户端只做排序和筛选
- 样式使用 Tailwind CSS
- 表格数据量在 50-200 行之间，不需要虚拟滚动
 
## 数据结构
interface OrderItem {
  id: string
  productName: string
  amount: number
  status: 'pending' | 'paid' | 'shipped'
  createdAt: string  // ISO 8601
}
 
## 交互要求
1. 列头点击切换排序：无排序 → 升序 → 降序 → 无排序
2. 筛选区域支持 status 多选（checkbox）
3. 排序和筛选条件通过 URL searchParams 持久化，支持分享链接
4. 筛选结果为空时显示「无匹配数据」的空状态
 
## 输出格式
- 拆分为三个组件：DataTable（容器）、SortableHeader（列头）、StatusFilter（筛选）
- 排序和筛选逻辑用自定义 Hook 封装
- 不使用任何 UI 组件库

## 任务
排查一个生产环境的 TypeError。
 
## 错误信息
TypeError: Cannot read properties of undefined (reading 'map')
    at OrderList.render (OrderList.tsx:47)
    at processTicksAndExitCallbacks (node:internal/...)
 
## 复现条件
- 仅在新用户首次访问时出现
- 刷新页面后恢复正常
- 只影响 /orders 路由
 
## 相关代码
[粘贴 OrderList.tsx 的代码]
 
## 已排查
- API 返回的 orders 字段在新用户场景下为 null（不是空数组）
- 代码中直接调用 response.data.orders.map()，未做 null 检查
 
## 请求
1. 修复空值问题
2. 检查是否有其他类似的不安全访问
3. 给出防御性编码建议，避免同类问题再次出现