用途:在编写、审查或重构 Laravel PHP 代码时提供最佳实践指导。该技能以规则文件索引的形式组织,每个规则文件说明做什么以及为什么。精确 API 语法需通过 search-docs 核实。
主要能力:覆盖数据库性能(查询数量、预加载、索引、大数据集)、高级查询(子查询、聚合、复杂排序与查询计划)、Eloquent(模型、关系、作用域、类型转换)、安全(认证、授权、输入安全、密钥、上传)、验证(表单请求与验证规则)、路由(控制器、路由绑定、资源、中间件)、迁移(结构变更、列、外键、索引)、队列任务(重试、唯一性、批处理、Horizon)、缓存(生命周期、失效、锁、记忆化)、HTTP 客户端(出站请求、重试、超时、伪造)、错误处理、事件与通知、邮件、调度、集合、Blade 视图、配置、风格与架构等。测试相关指向 testing-best-practices 技能。
使用方式:先检查改动文件、邻近代码、项目配置和相关测试中的既有模式;将每个受影响的关注点映射到规则索引,编辑前阅读对应规则文件,跳过无关文件;做最小且连贯的改动,保持应用架构与命名;用 search-docs 核实与版本相关的 API;先运行最相关的测试,再按需运行格式化与静态分析;完成前对照每条映射规则复查差异。
限制与原则:一致性优先,若代码库已有某种做法,即使另一种理论上更好也应沿用,不一致比次优模式更糟;规则是尚无既有模式时的默认值,而非覆盖项;仅在正确性或安全缺陷时偏离并说明;优先使用框架特性和既有抽象,避免推测性抽象;数据库访问不得出现在 Blade 视图中,防止隐藏的 N+1 查询。具体规则文件内容与完整 API 示例暂未提供。