SuperAPI AI 工具集

beyond-solid-principles

设计与创作

查看项目

更新于 10-16 05:47

技能介绍

用途:分析源码与系统架构,检查模块、服务、分层与组件结构是否违反十项系统级设计原则,作为类级 SOLID 的补充。

主要能力:支持整体审计或单原则检查,子命令包括 sw-soc(关注点分离)、sw-srp-sys(系统级单一职责)、sw-dry、sw-demeter(迪米特法则/最少知识)、sw-coupling(松耦合高内聚)、sw-evolvability(为变化而构建)、sw-resilience(为失败而设计)、sw-kiss、sw-pola(最小惊讶)、sw-yagni;beyond-solid-principles 检查全部十项。未指定子命令时默认检查全部;按名称提及原则也会匹配对应子命令。

使用方式:先确定目标代码(文件、目录或按名称定位服务/模块,含糊时询问);分析前读取对应 references 下的参考文件(如 references/soc.md、references/coupling.md,全量审计读全部十份);随后按参考中的违规模式分析静态结构、变更模式、运行时拓扑、API 契约与运维姿态;最后按“原则—严重级别 HIGH/MEDIUM/LOW—位置—问题—建议”输出,并给出计数表、前三优先项与整体评估。可选重构模式在请求修复时产出重构代码或架构方案并简要说明改动。

适用场景:适用于任意语言与架构风格(单体、模块化单体、微服务、无服务器、事件驱动、分层、六边形等),小代码库侧重模块/包边界与依赖方向,分布式系统还考虑服务边界、API 契约、数据归属、消息模式与运维韧性。

限制:原则是指导而非定律,需结合项目规模、团队与成熟度判断;已记录的权衡(如 ADR)应被承认;原则间存在张力(DRY 与跨服务松耦合、KISS 与韧性、YAGNI 与可演进性),应给出判断而非教条;优先少量可执行发现。具体安装命令与收费信息暂未提供。