SuperAPI AI 工具集

skill-cd-ci-ddd-score-validation

设计与创作

查看项目

更新于 10-15 23:58

技能介绍

用途:审计任意代码库,验证 Clean Architecture / DDD 分层顺序是否被遵守,目标依赖方向为 Domain <- Application <- UseCases <- Infrastructure 以及 Domain <- Application <- Interface。LLM 智能体是主要审计者,tools/ 下的 bash 脚本负责提取原始数据(文件列表、导入、依赖图),智能体据此判断、打分并写出最终 YAML 报告。

主要能力:发现源码根目录、识别分层目录、按层/语言/职责分类文件、提取导入构建依赖图、校验硬性规则(如 Domain 无外部依赖、Application 仅依赖 Domain、UseCases 仅依赖内层、Infrastructure 不得导入 Interface、Interface 仅依赖 Application、禁止循环依赖、仓储接口在 Domain、实现在 Infrastructure、命名规范、上帝用例、缺失层头注释、单文件单一职责等),并检测业务逻辑泄漏。

使用方式:依次运行 bash tools/discover-source.sh <project_path>、bash tools/discover-layers.sh <source_root>、bash tools/classify-files.sh <source_root>、bash tools/extract-imports.sh <classified_files_yaml>、bash tools/validate-dependencies.sh <imports_yaml> <layers_yaml>、bash tools/validate-naming.sh <classified_files_yaml>、bash tools/detect-logic-leaks.sh <classified_files_yaml>;也可用 bash tools/aggregate-raw-data.sh /path/to/project 一次跑完。随后智能体读取关键文件做主观审计,结合硬性违规(约 70%)与主观发现(约 30%)及评分矩阵打分,生成 ddd-score-report.yml。

适用场景:新项目架构健康评估、重构前识别违规、CI/CD 每次 PR 生成评分报告、代码评审验证分层边界。

限制:脚本为 100% bash,从文件系统读取并输出 YAML;主观标准由智能体判断,存在一定主观性;评分矩阵与输出 schema 依赖 references/ 下文件;具体平台与收费信息暂未提供。