codeprobe-solid 是 codeprobe 技能体系下的一个子技能,专注于检测代码中违反 SOLID 五项设计原则的问题。
用途:对项目代码做静态审计,识别单一职责(SRP)、开闭(OCP)、里氏替换(LSP)、接口隔离(ISP)与依赖倒置(DIP)方面的设计缺陷,按信号和严重程度输出发现项。
主要能力:
- SRP:类有 5 个以上公开方法且涉及无关职责、方法超过 30 行且混合多个关注点、类名含糊(Manager、Handler、Utils 等)、构造函数注入 5 个以上依赖。
- OCP:基于类型/状态/角色的 switch 或 if-else 链(3 个以上可增长分支)、缺少接口或策略等扩展点。
- LSP:子类重写改变语义、抛出父类未声明的异常、空实现或忽略父类行为、多态调用后再做 instanceof/type 检查。
- ISP:接口方法达 8 个以上、实现类留空或抛未实现异常、接口内存在多组无关方法。
- DIP:业务逻辑中直接 new 具体类、高层模块直接导入基础设施层、通过静态方法紧耦合具体依赖。
使用方式:作为独立模式调用时,需先读取同级 codeprobe 技能目录下的 shared-preamble.md 以获取输出契约、执行模式与约束,再按项目技术栈从 references/ 加载相应参考文件;默认使用 full 模式,除非用户另行指定。发现项按 SRP-、OCP-、LSP-、ISP-、DIP- 前缀顺序编号,并可生成修复提示示例。
适用场景:代码评审、重构前诊断、架构设计检查,尤其适合需要落实 SOLID 原则的面向对象项目。
限制:明确不标记简单多字段 DTO/值对象、无需依赖注入的小脚本与 CLI、稳定且封闭的枚举 switch、遵循框架约定的框架生成类,以及聚合测试初始化工具的测试辅助类;具体技术栈覆盖范围与许可证等事实暂未提供。