SuperAPI AI 工具集

laravel-expert

编程与开发

查看项目

更新于 10-15 18:08

技能介绍

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 原生方案而非第三方包;避免不必要的抽象;除非被要求,不引入微服务架构;不假设云基础设施;保持方案务实且贴合实际。

限制

仅在任务明确匹配上述范围时使用此技能。输出不能替代特定环境的验证、测试或专家审查。如果缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。

关于收费、价格、具体平台支持、安装命令等事实,资料中暂未提供。