用途:为 Laravel 应用提供最佳实践与架构模式参考,在编写、审查或重构 Laravel 代码时使用,指导自动化重构和代码生成。
主要能力:共 40 条规则,分 10 个类别并按影响优先级排列——架构(arch-,关键)、依赖注入(di-,关键)、错误处理(error-,高)、安全(security-,高)、性能(perf-,高)、测试(test-,中高)、数据库与 ORM(db-,中高)、API 设计(api-,中)、微服务(micro-,中)、DevOps 与部署(devops-,中低)。示例规则包括避免循环服务提供者依赖、按领域/功能组织模块、避免服务定位器、优先构造器注入、集中异常处理、Form Request 验证输入、限流、缓存策略、避免 N+1 查询、使用事务与迁移、API 资源序列化、健康检查、队列、结构化日志、零停机部署等。
使用方式:按需阅读 rules/ 目录下的单条规则文件(如 rules/arch-avoid-circular-deps.md、rules/security-validate-all-input.md),每条含原因说明、错误示例、正确示例及参考。仅在需要某条规则的完整实现细节时读取 AGENTS.md 或对应规则文件,不要预先全部加载。完整指南见 AGENTS.md。若已安装 Laravel Boost,则 security-validate-all-input、security-auth-jwt、db-avoid-n-plus-one、db-use-migrations、perf-use-caching、test-use-testcase-refresh-database、devops-use-logging、api-versioning 这些规则已被其核心指南覆盖,可跳过。
适用场景:编写新控制器、服务或模型;实现认证与授权;审查架构与安全问题;重构既有 Laravel 代码库;优化性能或数据库查询;构建微服务或基于队列的架构。
限制:资料未提供安装命令、许可或价格信息。规则的具体代码示例未在此展开。