"帮我写一个用户登录接口，用 JWT，要包含验证码，还要有密码加密..."

# 用户登录 API 生成模板

## 上下文
- 框架：[FastAPI/Express/Hyperf]
- 数据库：[MySQL/PostgreSQL]
- 认证方式：JWT

## 功能要求
1. 接收用户名/邮箱和密码
2. 验证码校验（Redis 存储）
3. 密码 bcrypt 验证
4. 生成 JWT Token（过期时间 7 天）
5. 返回用户信息和 Token

## 非功能要求
- 接口限流：每分钟 5 次
- 日志记录：记录登录失败原因
- 错误码规范：参考 [链接]

# 项目规范
技术栈: Hyperf 3.1 + MySQL 8.0 + Redis 7.0
代码风格: PSR-12
API规范: RESTful，统一返回格式 {code, message, data}

# 数据库规范
表名: 蛇形命名，复数
字段: 必须有 created_at, updated_at
主键: bigIncrements('id')

# 禁止行为
- 不允许使用 ORM 的 lazy loading
- 不允许在 Controller 中直接写 SQL
- 不允许跳过参数验证

# 常用代码模式
Repository 模式: App\Repository\{Model}Repository
Service 层: App\Service\{Model}Service

name: new-api
description: 创建完整的 CRUD API 接口
steps:
  1. 创建 Migration（包含 up 和 down）
  2. 创建 Model（包含 fillable 和 casts）
  3. 创建 Repository（包含基础 CRUD）
  4. 创建 Service（包含业务逻辑）
  5. 创建 Controller（包含路由注解）
  6. 创建 Request（包含验证规则）
  7. 创建 Resource（包含数据转换）

/knowledge/
├── architecture/          # 架构决策记录
│   └── 2026-09-08-选择Hyperf作为后端框架.md
├── patterns/              # 代码模式
│   ├── repository-pattern.md
│   └── dto-pattern.md
├── decisions/             # 技术决策
│   └── why-not-use-laravel.md
└── errors/                # 踩坑记录
    ├── amqp-reconnect.md
    └── jwt-refresh-token.md

❌ 错误方式：
"帮我写一个完整的电商系统，包含用户、商品、订单、支付..."

✅ 正确方式（分阶段）：
阶段1："设计用户模块的数据模型"
阶段2："实现用户注册和登录接口"
阶段3："给登录接口加上验证码和限流"
阶段4："实现 JWT 刷新机制"

"实现用户注册接口。参考 UserController.php 的风格。
要求：手机号必须是中国大陆号码格式。错误时返回 422。
不允许：批量插入、跳过验证。"

# prompt-standards.yaml
结构:
  1. 上下文描述 (Context)
  2. 具体任务 (Task)
  3. 约束条件 (Constraints)
  4. 输出格式 (Output Format)
  5. 参考示例 (Examples)

禁止:
  - "大致"、"可能"、"尝试"等模糊词汇
  - 一次性列出超过 5 个独立功能
  - 在 prompt 中包含敏感信息

最佳实践:
  - 每个 prompt 聚焦一个明确目标
  - 使用 Checklist 格式列出需求
  - 生成后先 review 再集成

/templates/
├── api/                      # API 接口模板
│   ├── crud-controller.md
│   └── list-request.md
├── database/                 # 数据库模板
│   ├── migration.md
│   └── seeder.md
├── hyperf/                   # 框架特定模板
│   ├── repository.md
│   └── service.md
└── validation/               # 验证规则模板
    ├── create-user.md
    └── update-user.md