SuperAPI AI 工具集

lightweight-design-analysis

设计与创作

查看项目

更新于 10-16 02:33

技能介绍

用途:该技能面向类或模块级的小范围代码,用于设计质量评估、重构机会识别、代码评审、架构评估以及模式与反模式检测。它只做分析,不执行修改,由用户决定采纳哪些建议。

主要能力:按8个维度系统评估代码——命名、对象健身操、耦合与内聚、不可变性、领域完整性、类型系统、简洁性、性能。每个维度有具体检测标准,例如通用命名(data、util、helper、manager)、方法缩进层级、特性依恋、贫血领域模型、any 与 as 类型断言、重复代码、循环内 find() 导致的 O(n²) 等。

使用方式:分析前必须先自动调用 lightweight-implementation-analysis-protocol 技能理解代码结构与流程,再依次评估8个维度,最后生成结构化报告。报告包含摘要、🔴 严重问题与 🟡 建议,每条发现都带 file:line 引用、实际代码片段、影响说明、具体修复建议及前后对比代码,并附评估维度数与问题计数。

适用场景:单类、单模块或少量相关文件的设计评审,适合在 TDD 的 REFACTOR 阶段迭代使用,修改后可再次运行。

限制:不分析尚未完全理解的代码;不做实现改动;不报告运行良好的部分;跳过琐碎发现、纯风格偏好和无证据的过早优化;要求基于证据,避免猜测性描述。具体安装与调用命令资料未提供。