SuperAPI AI 工具集

webman-best-practices

部署与运维

查看项目

更新于 10-15 23:47

技能介绍

用途:该技能必须用于 Webman 框架项目,帮助开发者按 DDD 架构与 PER Coding Style 组织代码,并识别常见反模式。

主要能力: 架构与依赖:检查控制器是否跳过 Service 直接依赖 Model、领域层是否依赖框架类(如 Request、DB)、Service 之间是否存在循环依赖、基础设施层是否未实现 Contract 接口、Service 是否绕过 Repository 直接使用 Model。 命名约定:目录须小写,接口须带 Interface 后缀,Service 遵循 VerbNounService 模式,Repository 实现须有描述性前缀,命名空间须与目录结构一致。 代码风格(PER Coding Style):文件开头须有 declare(strict_types=1),默认使用 final class,不可变属性使用 readonly,参数与返回类型须完整声明,使用构造函数属性提升。 领域模式:实体须有唯一标识,值对象须不可变,业务逻辑应放在领域层而非 Service,副作用使用领域事件,避免只有 getter/setter 的贫血模型。 依赖注入:避免静态方法,使用构造函数注入,不使用服务定位器模式。

使用方式:资料未提供具体安装命令或调用步骤,暂未提供。

适用场景:Webman 项目的代码审查、重构与规范落地。

限制:资料仅列出检查项与对应条目名称,未提供各条目的详细说明、示例代码、配置方式或工具集成方法。