SuperAPI AI 工具集

codeprobe-architecture

测试与质量

查看项目

更新于 10-16 09:46

技能介绍

codeprobe-architecture 是 nishilbhave/codeprobe-claude 项目中的架构与结构分析子技能,属于代码审查能力的一部分。

用途:检测项目中的架构与结构问题,覆盖分层违规(控制器含业务逻辑、模型含展示逻辑、视图直连数据库)、循环依赖、上帝对象(文件超 500 行、类方法 20 个以上、单文件承担完整请求生命周期)、贫血领域模型、边界缺失、目录结构违规以及硬编码环境值与配置抽象缺失。

主要能力:所有发现项使用 ARCH- 前缀顺序编号(ARCH-001 等),并给出严重级别;提供修复提示示例,如把业务逻辑迁入新服务类、把臃肿类拆分为多个服务、抽取共享接口打破循环依赖、用环境变量替换硬编码 URL、按领域组织目录结构。

使用方式:独立调用时需先读取 ../codeprobe/shared-preamble.md 以获取输出契约、执行模式与约束,再根据项目技术栈加载 ../codeprobe/references/ 下的参考文件,默认使用 full 模式。通过编排器 /codeprobe audit 或 /codeprobe architecture 调用时,编排器会预先运行 scripts/dependency_mapper.py 生成依赖图,以 === DEPENDENCY_GRAPH === 与 === END DEPENDENCY_GRAPH === 标记在上下文中提供,其中 circular_dependencies 数组中每个环都作为一条 ARCH 发现项,不建议自行做环检测。可用 python3 scripts/file_stats.py <target_path> 获取每文件的代码行数、类数与方法数。

限制:不标记少于 5 个文件的小项目/脚本、有意保持薄层的微服务、框架惯用的单体模式(如 Laravel、Rails、Next.js 约定)、明确标注的原型与概念验证代码,以及生成目录(dist/、build/、.next/、pycache/)。若脚本或 Python 3 不可用,则降级为人工读取文件估算,不中断分析。具体收费、价格与平台信息暂未提供。