laravel:effective-context

有效上下文

为 AI 助手提供合适的上下文，以生成准确、相关的代码。缺少上下文会导致解决方案千篇一律，无法满足项目需求。

应包含的内容

文件和结构

• 引用具体文件：app/Models/User.php、routes/api.php
• 提及相关目录：“在 app/Services/Payment 中工作”
• 在结构重要时分享项目结构：“使用仓储模式，接口位于 app/Contracts”

当前状态

• 展示你要修改或扩展的现有代码
• 描述哪些内容有效、哪些无效
• 包含相关配置：.env 设置、config/ 值

Laravel 上下文

• 版本：“Laravel 12.x”或“Laravel 13.x”
• 依赖项：提及 Sanctum、Horizon、Telescope 等软件包
• 使用的模式：“使用 Form Requests”“使用 Horizon 处理作业”“使用 API 资源”
• 运行方式：说明使用 Sail 还是主机命令

单体仓库项目

• 指明具体应用：“在 apps/api 中工作”还是“在 apps/admin 中工作”
• 在相关时提及共享软件包：“使用共享的 packages/common”

描述问题

错误

BAD: "Getting an error with users"

GOOD: "Getting error when creating user:
  Illuminate\Database\QueryException: SQLSTATE[23000]: 
  Integrity constraint violation: 1062 Duplicate entry
  
  In UserController@store, line 45:
  $user = User::create($request->validated());
  
  Using Laravel 13.x with MySQL 8.0"

堆栈跟踪

提供完整的堆栈跟踪，尤其是：

• 异常类和错误消息
• 文件路径和行号
• 导致错误的方法调用链

复现步骤

1. POST to /api/users with email that exists
2. Validation passes (should catch this)
3. Database throws constraint violation

模糊与具体示例

模糊

“为用户表单添加验证”

具体

“为 UserStoreRequest 添加验证：

• Email 在 users 表中必须唯一
• Password 至少 12 个字符，且必须包含大写字母和数字
• Name 为必填项，最多 255 个字符
• Phone 字段为可选项，且必须符合 E.164 格式”

模糊

“需要处理支付”

具体

“实现 Stripe 支付处理：

• 创建包含 charge() 方法的 PaymentService
• 在 payments 表中存储支付记录（user_id、amount、stripe_id、status）
• 将 ProcessPaymentJob 分发到队列
• 处理 payment.succeeded 的 webhook
• 使用 Laravel 13.x 和 Cashier”

快速检查清单

发送提示词之前，请确认：

• 提及 Laravel 版本和相关软件包
• 包含文件路径或目录上下文
• 提供错误消息和堆栈跟踪（如需调试）
• 指明验证规则、关系或业务逻辑
• 说明是否使用 Sail 或主机命令
• 指明具体应用（如使用单体仓库）

上下文越充分，结果越好。如有疑问，请尽量提供更多信息。