laravel-11-12-app-guidelines

本技能为在 Laravel 11 与 12 生态系统中工作的开发者与 AI 代理提供了一个全面的操作框架。其设计目的是确保在各种专案配置中保持一致性，范围涵盖从仅提供 API 的后端到利用 Inertia.js、Livewire 与 Tailwind CSS v4 等现代前端工具的复杂全栈应用程序。此技能指示代理程式优先参考专案文档（特别是 AGENTS.md），并利用智能栈检测来调整 Docker/Sail 或原生环境的指令。

• 自动检测 composer.json、package.json 与容器配置，以防止指令错误。

• 强制执行严格的 Laravel 11/12 结构惯例，包含 bootstrap 目录下的路由、中间件与服务提供者管理。

• 整合 Laravel Boost MCP 工具，用于进阶文档搜索、Artisan 指令检查与数据库调试。

• 推广最佳实践，例如使用 Form Request 进行验证、使用 Eloquent 关联取代原生查询，以及维护干净的迁移档。

• 支持包含 Inertia + React、Vue 与 Blade 在内的多种前端架构，并强调状态管理与资源处理的特定模式。

• 透过 PHPUnit 与 Pint 在完成功能实现或错误修复前进行自动化代码质量检查。

• 务必先检查 AGENTS.md 中的专案特定指引，以确保符合现有的专案模式。

• 在执行写入操作前，使用 Laravel Boost MCP 工具（search-docs、list-routes、tinker）收集情境信息。

• 使用 Tailwind v4 时，严格遵循说明中提供的基于主题的工具类模式。

• 在执行最小化、情境相关的单元或功能测试后，务必提供执行完整测试套件的选项。

• 在仅提供 API 的专案中，应避免对前端内容做出假设，以维持关注点分离。