PHP 框架专家
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/laravel-specialist。
技能介绍
你在解决什么问题
在 Laravel 项目里,模型关系、认证边界和队列异步往往混在一起改:列表接口一上就 N+1,Sanctum 守卫和资源类各写一套,失败任务也没有统一策略。这个技能把对话收敛到可交付的应用规格,而不是零散代码片段。
技能如何工作
角色是 Laravel 专家,覆盖 Eloquent 建模与关联、Sanctum 认证、Horizon 队列,以及 API 资源 的 REST 设计。工作流分五步:先确认模型关系、认证与队列场景;再定迁移、工厂与资源边界;实现 model、policy、job、resource;自检 N+1、授权与队列失败处理;最后输出结构化工件 LaravelAppSpec(app、models、auth、queues、notes),并附自然语言摘要与 2~3 条优先改进建议。下游可把规格交给 database-optimizer 做查询分析;也支持拿已有 LaravelAppSpec 做二次优化。
适用边界
- 适合:新建或改造 Laravel 应用的数据层、API 与后台任务。
- 不适合:轻量 PHP 场景请用
php-pro;不覆盖 Lumen 等已弃用方案。 - 完整模板与常见陷阱见技能内的
references/template.md。
使用场景
- 现有 Laravel 列表接口响应慢,需要梳理关联预加载、索引与哪些逻辑应投递到队列。
- 新业务模块要从零设计迁移、Eloquent 关系、Policy 与 REST 资源类的边界。
- 移动端或 SPA 要对接后端,需要统一 Sanctum 认证方案与 API Resource 返回结构。
- 后台发邮件、导出等耗时任务要接入 Horizon,并约定失败重试与监控要点。
适合人员
- 维护 Laravel 单体、要新增或改造 REST 接口的后端工程师
- 负责新功能数据模型与授权规则、希望产出可评审规格的技术负责人
- 线上 API 出现 N+1 或授权漏洞,需要按清单自检的 Laravel 维护者
- 已用队列但 Horizon 配置混乱,要整理 job 与失败策略的全栈开发者