codeprobe-patterns 是 machineroom-dev/codeprobe 下的一个设计模式审计子技能,核心定位是充当设计模式顾问:不为了用模式而推荐模式,只在代码中存在具体问题、且某个具名模式能解决该问题时,才提出模式机会或反模式发现。
用途方面,它检测两类设计模式问题:一是模式机会,即某个具体的 GoF 或架构模式能够解决代码中可观察的复杂度、重复、僵化或隐藏依赖问题;二是反模式,即被误用的模式,增加了复杂度、间接层或抽象层,却没有带来可衡量的收益。
主要能力方面,它给出了一组检测规则。模式机会包括:构造函数或工厂方法存在 4 个以上可选参数时建议 Builder;同一类族的 new X() 在 3 处以上伴随条件判断时建议 Factory;按类型分支执行不同算法且分支达 3 个以上时建议 Strategy;同一状态字段在 3 个以上方法中控制行为时建议 State;状态变更后直接调用 3 个以上服务时建议 Observer/Event Dispatcher;横切逻辑与业务逻辑交织时建议 Decorator/Middleware;协调多个子系统的大型类建议 Facade;需要排队、记录或撤销操作时建议 Command;条件式顺序转换流程建议 Pipeline/Chain of Responsibility;多个相似对象仅有少量字段差异时建议 Prototype。反模式检测包括:用 Singleton 隐藏依赖、纯粹转发的 Repository、仅镜像控制器动作的 Service 类、只有单一实现族的 Abstract Factory。所有发现项统一使用 PATTERN- 前缀并按顺序编号,同时给出具体修复提示示例。
使用方式方面,若直接调用(非通过编排器),需先读取 ../codeprobe/shared-preamble.md(相对于本 SKILL.md 所在位置解析,即同级的 codeprobe 技能目录,而非用户项目目录),以获取输出契约、执行模式和约束;再根据项目技术栈从 ../codeprobe/references/ 加载适用的参考文件。除非用户另有指定,默认使用 full 模式。
适用场景方面,适合对既有代码库进行设计模式层面的审计,发现值得引入具名模式的重构点,或识别过度设计带来的反模式。
限制方面,该技能明确划定了不标记的范围:类型/状态 switch 已由 codeprobe-solid(OCP-xxx)标记,本技能仅在能给出具名模式(如 Strategy、State)及具体收益时才标记;God 类已由 codeprobe-architecture(ARCH-xxx)标记,本技能仅在能指定确切模式(如 Facade、Mediator)作为分解方案时才标记;横切关注点重复已由 codeprobe-code-smells(SMELL-xxx)标记,本技能仅在推荐具体模式(如 Decorator、Middleware)作为解决方案时才标记。此外,不为小型脚本或小应用引入会造成过度工程的模式,不建议用一个正确模式替换另一个正确模式,不标记测试文件,低置信度匹配(如 Prototype)最多以建议级输出,存疑时不输出。具体定价、许可与版本信息暂未提供。