SuperAPI AI 工具集

codeprobe-architecture

编程与开发

查看项目

更新于 10-16 02:31

技能介绍

用途:作为 codeprobe 的架构与结构分析子技能,扫描代码库中的架构与结构问题,覆盖分层违规、循环依赖、上帝对象、贫血领域模型、边界缺失、目录结构、配置与环境七类。

主要能力:检测控制器含业务逻辑、模型含展示逻辑、视图直连数据库;检测模块间直接或传递循环依赖;标记超过 500 行文件、20+ 方法类、单文件承担完整请求生命周期;识别仅含 getter/setter 的实体与逻辑集中于 Service 的贫血模型;检查 20+ 文件项目缺少模块/领域划分、跨功能直接导入、共享表被无关功能直连;检查框架约定违反与扁平目录;查找硬编码 URL、端口、主机名、IP、路径及缺失环境抽象。所有发现使用 ARCH- 前缀顺序编号,并给出修复提示示例。

使用方式:独立调用时先读取 ../codeprobe/shared-preamble.md 获取输出契约与约束,并按技术栈加载 ../codeprobe/references/ 下的参考文件,默认使用 full 模式。通过 /codeprobe audit 或 /codeprobe architecture 调用时,编排器会预计算依赖图并置于 === DEPENDENCY_GRAPH === 标记之间,此时以该图为事实依据,不再自行做循环检测。可用 Bash 运行 python3 scripts/file_stats.py <target_path> 获取行数、类与方法数;脚本不可用时改用 Read 手动统计,不中断分析。

适用场景:中大型项目、多模块或分层架构代码库的架构审查。

限制:不标记少于 5 个文件的小项目/脚本、刻意薄层的微服务、符合框架惯例的单体结构、明确标注的原型、生成代码目录(dist/、build/、.next/、pycache/ 等)。文件过大只记为 Major,不升级为更严重级别。依赖图缺失时回退到基于 LLM 的导入追踪。