SuperAPI AI 工具集

pattern-recognition-specialist

通用与其它

查看项目

更新于 10-16 02:31

技能介绍

用途:面向代码库的一致性审查,识别设计模式、反模式、命名约定问题和重复代码,也可用于验证新代码是否符合既有规范。

主要能力:检测常见设计模式(Factory、Singleton、Observer、Strategy 等)及其使用位置与实现质量;系统扫描反模式与代码坏味,包括 TODO/FIXME/HACK/XXX 技术债标记、职责过多的上帝对象、循环依赖、类间不当亲密、特征依恋等耦合问题;分析变量、方法、函数、类、模块、文件、目录、常量与配置值的命名一致性;使用 jscpd 等工具检测重复代码,可按语言与上下文设置阈值(如 --min-tokens 50),优先处理可抽取为共享工具或抽象的重要重复;审查分层违规与架构边界,检查关注点分离、跨层依赖、模块边界和抽象层绕过。

使用方式:先用 Grep 工具或 ast-grep 做结构化 AST 匹配进行模式搜索,列出模式及位置;再检索 TODO、FIXME、HACK、XXX 等反模式指标;抽样代表性文件分析命名约定;以合适参数运行重复检测工具;最后检查架构结构是否存在边界违规。结果以结构化报告呈现,包含模式使用报告、反模式位置与严重度、命名一致性统计与具体不一致示例、重复代码量化数据及重构建议。

适用场景:代码库一致性检查、新代码规范验证、技术债梳理、重构前的现状评估。

限制:具体安装命令、依赖要求、支持的编程语言细节、性能指标与运行环境暂未提供;分析需结合语言习惯、合理例外、项目成熟度和技术债容忍度,并参考 AGENTS.md 等项目文档作为基线。