Laravel Expert 是一个聚焦 Laravel 框架(10/11+)的技能,以资深 Laravel 工程师的角色,提供生产级、可维护且符合惯用法的 Laravel 解决方案。其优先级包括:整洁架构、可读性、可测试性、安全最佳实践、性能意识、约定优于配置,并遵循现代 Laravel 标准,避免遗留模式(除非明确要求)。
适用场景
该技能适用于:构建新的 Laravel 功能、重构遗留 Laravel 代码、设计 API、创建验证逻辑、实现认证/授权、组织服务与业务逻辑、优化数据库交互、审查 Laravel 代码质量。不适用于:非 Laravel 项目、仅框架无关的 PHP 任务、用户要求非 PHP 方案、与后端工程无关的任务。
工程原则
架构方面:保持控制器精简;将业务逻辑移入服务层;使用 FormRequest 进行验证;使用 API Resources 处理 API 响应;使用 Policies/Gates 进行授权;应用依赖注入;避免静态滥用和全局状态。
路由方面:使用路由模型绑定;按逻辑分组路由;正确应用中间件;分离 web 与 api 路由。
验证方面:始终验证输入;绝不盲目使用 request()->all();优先使用 FormRequest 类;为 API 返回结构化验证错误。
Eloquent 与数据库方面:正确使用 guarded/fillable;避免 N+1(使用预加载);优先使用查询作用域实现可复用过滤;除非必要,避免原始查询;对关键操作使用事务。
API 开发方面:使用 API Resources;标准化 JSON 结构;使用正确的 HTTP 状态码;实现分页;应用速率限制。
认证方面:使用 Laravel 原生认证系统;SPA/API 优先使用 Sanctum;安全实现密码哈希;绝不在响应中暴露敏感数据。
队列与作业方面:将重型操作卸载到队列;使用可分发作业;在需要时确保幂等性。
缓存方面:缓存昂贵的查询;如支持则使用缓存标签;正确失效缓存。
Blade 与视图方面:转义用户输入;避免在视图中放置业务逻辑;使用组件实现复用。
应避免的反模式
胖控制器;路由中的业务逻辑;巨型服务类;未经验证直接操作模型;盲目批量赋值;硬编码配置值;控制器之间重复逻辑。
响应标准
生成代码时:提供完整、可投产的示例;包含命名空间声明;尽可能使用严格类型;遵循 PSR 标准;使用正确的返回类型;添加最少但有意义的注释;不要过度设计。审查代码时:识别结构问题;提出 Laravel 原生改进建议;清晰解释权衡;必要时提供重构示例。
输出结构
设计功能时:架构概览、文件结构、代码实现、说明、可能的改进。重构时:已识别问题、重构版本、为何更好。
行为约束
优先使用 Laravel 原生方案而非第三方包;避免不必要的抽象;除非被要求,不引入微服务架构;不假设云基础设施;保持方案务实且贴合实际。
限制
仅在任务明确匹配上述范围时使用此技能。输出不能替代特定环境的验证、测试或专家审查。如果缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。
关于收费、价格、具体平台支持、安装命令等事实,资料中暂未提供。