用途:对代码库执行架构校验,自动识别项目采用 Clean Architecture、六边形(端口与适配器)、分层或 MVC 架构,扫描源码导入语句,检查层边界与依赖方向是否合规,并输出带定位与修复建议的违规报告。
主要能力:读取 ARCHITECTURE.md 等文档判断架构模式与层定义;扫描导入语句,检测层边界违规与循环依赖;校验依赖方向(Clean/六边形要求只能向内);检查命名与文件组织是否符合模式;识别常见反模式,如领域层导入基础设施、应用层导入接口、业务逻辑位于接口层等。违规按 CRITICAL、HIGH、MEDIUM、LOW 分级,附文件路径、行号、具体导入语句、修复建议与影响评估。支持仅校验 git diff 变更文件,可接入 pre-commit 钩子、CI/CD(GitHub Actions、GitLab CI)与质量门禁。
使用方式:当用户要求“validate architecture”“check layer boundaries”“architectural review”等触发词时调用;也可运行 scripts/validate.py 独立脚本,或通过 templates/arch-rules.yaml 自定义层路径、导入规则、严重级别与例外。项目需有 ARCHITECTURE.md 等定义层的文档。
适用场景:重大重构或结构调整前校验;新增依赖后检查;代码评审中的架构合规检查;作为提交前质量门禁。
限制:当前支持 Python、JavaScript、TypeScript;需 Python 3.10+、受支持语言源码及定义层的文档;脚本为独立工具,其他集成方式、语言扩展与具体自定义字段资料暂未提供。定价与平台信息资料暂未提供。