SuperAPI AI 工具集

validate-architecture

通用与其它

查看项目

更新于 10-16 07:18

技能介绍

用途:静态检测项目中的层间导入规则违规与循环引用。若 CLAUDE.md 定义了架构,则以其层定义为准;否则使用通用三层模型(表现层/业务层/数据访问层),依赖方向为表现层 -> 业务层 <- 数据访问层,业务层不得依赖其他层。

主要能力:按顺序解析目标目录(优先读取 CLAUDE.md 的 Project Structure,缺失时用 Glob 匹配源码文件并取顶层目录,无源码则报告 SHALLOW);默认排除 node_modules/、.git/、dist/、build/、coverage/ 及测试文件;用 Grep 提取 import/from/require/@import 语句;检测 domain/core 导入 infrastructure、domain/core 导入 presentation、presentation 直接导入数据库相关包,以及模块间双向导入形成的循环引用。

使用方式:执行前先输出目标解析结果,再输出架构验证矩阵,最后生成 Markdown 报告并保存到 .ww-w-ai/devtools/validate-architecture/,写入 latest.json、latest.md,并将 latest.json 归档到 history/{timestamp}.json。报告语言与用户对话语言一致,JSON 字段名保持英文。

适用场景:需要约束分层架构的项目,尤其使用 Clean Architecture 的代码库,可用于持续检查依赖方向与循环依赖。

限制:仅做静态导入分析,不修改项目源码;验证过程为只读,Bash 仅用于只读查询与创建输出目录。测试文件被排除。若无法解析目标则返回 SHALLOW。严重级别中 ERROR 对应依赖方向违规,WARN 对应循环引用与层归属不明确。费用、性能数据与平台支持暂未提供。