SuperAPI AI 工具集

code-antipatterns

前端与建站

查看项目

更新于 10-15 23:49

技能介绍

用途:对代码库执行反模式分析,用 ast-grep 做确定性扫描,再由使用者做严重级判断、建议与修复规划。分析路径默认为当前目录,也可传入 $1 指定。

主要能力:扫描覆盖空 catch、console.log、var、eval/new Function、innerHTML/outerHTML、as any 与 : any、魔术数字定时器、Vue props 修改、Python 可变默认参数、裸 except、global、type() == 等模式。规则以 ast-grep 规则项目存放于 rules/(sgconfig.yml 加 rules/lib/*.yml,每个规则有测试夹具)。按语言可分析 JS/TS 回调、魔法值、async/Promise 嵌套、Vue 3 与 React 框架问题、TypeScript 类型质量、复杂度、安全与内存性能、Python 反模式。

使用方式:先运行一次全目录扫描:ast-grep scan -c ${CLAUDE_SKILL_DIR}/rules/sgconfig.yml --json=compact <path>,解析输出中的 ruleId、file、range、message 与匹配文本。若未安装 ast-grep(包名 ast-grep 或 sg),回退到逐模式流程:读 REFERENCE.md,按其中每个规则对应的 .yml 逐一执行 ast-grep -p '<pattern>' --lang <lang>。可选参数:--focus <category>、--severity <level>、--fix。

委派与边界:空 catch、裸 except、浮动 Promise 等错误吞没问题不在此重新实现,改用 /code:hidden-failures --track errors 并合并结果。深层嵌套、长函数、圈复杂度属于度量而非单节点模式,应使用 /code:complexity。浮动 Promise 以仓库自身工具链为准(tsc 与 no-floating-promises),或走上述专用扫描。

输出:汇总为 Anti-pattern Analysis Report,含 Summary、Critical/High/Medium/Low 分级表、Recommendations 与 Category Breakdown。

限制:不覆盖复杂度与浮动 Promise 的结构化检测;检测规则不保证全部语言;未提供收费、平台与效果数据。