SuperAPI AI 工具集

solid-php

编程与开发

查看项目

更新于 10-24 06:32

技能介绍

solid-php 是一个面向 Laravel 13 / PHP 8.3+ 的编码规范技能,目标是在编写、重构和评审代码时落实 SOLID 原则、DRY 复用与统一的模块化目录结构。

用途 适用于为 Laravel 13 项目(尤其是采用 FuseCore 模块化架构的项目)编写新代码、拆分过长文件、调整接口位置或补充 PHPDoc 时使用。该技能会先确认环境版本(通过 php artisan --version 确认为 Laravel 13.x),再按模块化结构决定代码放置位置。

主要能力

  1. 强制性代理工作流:在开始实现前并行启动三类代理,分别用于分析现有架构、通过 Context7 核对 Laravel/PHP 文档、以及查询 SOLID 模式;实现完成后运行 sniper 做验证。
  2. DRY 复用规则:在写任何新代码前,先用 grep 检索代码库中相似的类名、方法或逻辑,检查 FuseCore/Core/App/Services/、FuseCore/Core/App/Traits/、FuseCore/[Module]/App/Contracts/ 等共享位置;代码被两个以上功能使用时应放入共享 Services 或 Traits,出现三次以上的重复逻辑应抽取为共享 helper 或 Trait;编写后需确认未引入重复。
  3. 自动检测与结构约定:检测到 FuseCore/ 目录或模块内的 module.json 时,按 FuseCore 模块化架构处理,共享代码放在 FuseCore/Core/App/。
  4. 代码放置决策树:HTTP 校验放 Http/Requests/,单一操作放 Actions/,业务逻辑放 Services/,数据访问放 Repositories/,数据传输放 DTOs/,接口放 Contracts/,事件放 Events/,授权放 Policies/。
  5. 模式选择表:控制器用于 HTTP 处理,FormRequest 用于校验,Action 用于单一操作,Service 用于复杂逻辑,Repository 用于数据访问,DTO 用于数据结构,Interface 用于抽象。
  6. 关键规则:文件行数不得超过 FUSE_SOLID_MAX_LINES(默认 200),应在触顶前主动拆分;控制器只处理 HTTP 关注点,模型只保留关联与类型转换,服务只承载业务逻辑;模块接口与共享接口按目录分离;公共方法必须写 PHPDoc(含 @param、@return、@throws)。
  7. 反模式清单:包括超长文件、控制器含业务逻辑、接口写在实现文件中、模型含业务逻辑、使用 new Class() 的具体依赖、缺少 PHPDoc、缺少 strict_types、超过 5 个公共方法的臃肿类、跨文件重复逻辑、编码前不检索代码库等,并给出对应修正方式。
  8. 参考文档与模板:涵盖 SOLID 总览、SRP、OCP、LSP、ISP、DIP、反模式、模式决策指南、PHP 8.5 特性、Laravel 12 结构、FuseCore 结构,以及 Service/DTO/Repository/Interface 模板、Controller/Action/FormRequest/Policy 模板和从遗留代码迁移的重构指南。
  9. 最佳实践对照:推荐构造器属性提升、依赖接口、final readonly class、declare(strict_types=1)、使用 DTO 而非数组;不推荐属性赋值、依赖具体类、可变类、省略类型声明、等到行数钩子拦截才拆分。

使用方式 该技能以文档与工作流形式提供,未给出独立的安装命令或运行命令(暂未提供)。使用时按技能内的工作流先做环境确认与代码库检索,再依据决策树选择目录与模式,编写后按规则校验文件行数与接口位置,并运行 sniper 验证。

适用场景 Laravel 13 / PHP 8.3+ 项目的日常开发与代码评审;控制器或模型过于臃肿需要按 SRP 拆分;新增支付方式等需要遵循 OCP 的扩展点;接口契约调整与提供方替换;收紧依赖注入与可测试性;从遗留代码逐步重构迁移。

限制 资料仅覆盖 Laravel 13、PHP 8.3+ 与 FuseCore 模块化结构相关内容,其他框架或版本暂未提供;文中提到的 explore-codebase、research-expert、Context7、sniper 等工具的具体配置与获取方式暂未提供;FUSE_SOLID_MAX_LINES 的具体配置方法暂未提供。