SuperAPI AI 工具集

laravel-expert

编程与开发

查看项目

更新于 11-13 05:59

技能介绍

用途 Laravel Expert 是一个工作流技能,适用于需要以资深 Laravel 工程师角色处理生产级、可维护、符合 Laravel 惯例的开发任务。触发场景包括:构建新的 Laravel 功能、重构遗留 Laravel 代码、设计 API、编写验证逻辑、实现认证与授权、组织服务层与业务逻辑。

主要能力与工程原则 资料给出的实践准则涵盖多个方面:架构上保持控制器精简,把业务逻辑移入 Services,用 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 与视图上转义用户输入、不在视图中放业务逻辑、用组件复用。

使用方式 技能按工作流执行:先确认用户目标、范围以及该技能是否仍是合适的路由;在加载上游支持文件前先阅读概览与来源文件(metadata.json、ORIGIN.md);只加载会实质影响当前结果的引用、示例、提示词或脚本;执行上游工作流时在工作笔记中保持来源与边界清晰;对照上游预期与可指出的证据验证结果;任务超出该工作流重心时交接给相关技能;合并或关闭前记录使用了什么、改了什么、审阅者还需验证什么。资料示例包括直接调用 @laravel-expert 处理任务、基于 metadata.json 与 ORIGIN.md 做来源审阅、先缩小加载的支持文件范围、以及构建审阅者包。

输出标准 生成代码时:提供完整、可用于生产的示例,包含命名空间声明,尽可能使用严格类型,遵循 PSR 标准,使用正确的返回类型,添加精简但有意义的注释,不过度设计。审阅代码时:指出结构问题、建议 Laravel 原生改进、清楚解释权衡、必要时提供重构示例。设计功能时按“架构概述—文件结构—代码实现—说明—可能的改进”输出;重构时按“识别的问题—重构版本—为何更好”输出。

适用场景与限制 适合 Laravel 框架(10/11+)的通用开发任务。行为约束包括:优先 Laravel 原生方案而非第三方包,避免不必要的抽象,未被要求时不引入微服务架构,不假设云基础设施,保持方案务实。资料明确限制:仅在任务清晰匹配上述范围时使用;输出不能替代针对具体环境的验证、测试或专家审阅;缺少必要输入、权限、安全边界或成功标准时应停下并请求澄清。资料未提供收费标准、价格或平台兼容性等信息。