用途:作为 ln-620 协调器流水线中的 L3 工作单元,审计代码库的架构原则与设计模式,覆盖 DRY、KISS、YAGNI、分层边界、错误处理与依赖注入等类别,输出结构化问题清单并计算架构与设计评分(X/10)。
主要能力:1)DRY 检查分七类,包括相同代码重复、重复校验逻辑、重复错误信息、相似代码(>80%)、重复 SQL、复制粘贴的测试、重复 API 响应结构。2)KISS 检查过度抽象、单一实现抽象类、为两个对象使用工厂、深层继承等。3)YAGNI 检查未用扩展点、恒真/恒假的特性开关等。4)分层边界检查,如 UI 直连数据库、Controller 跳过 Service 直接使用 Repository。5)扫描 TODO/FIXME/HACK/XXX/OPTIMIZE,结合 git blame 判断新旧。6)缺失错误处理与集中式错误处理检查,含 uncaughtException 反模式。7)依赖注入/集中初始化检查,识别是否使用 DI 容器与集中 Init 模块。8)检查是否缺少架构最佳实践文档。
使用方式:接收协调器传入的 contextStore,解析 tech_stack、best_practices、principles、codebase_root;当 domain_mode 为 domain-aware 时,scan_path 为 codebase_root 拼接 current_domain.path,否则为 codebase_root;所有 Grep/Glob 均使用 scan_path。问题需标注 severity、location、effort、recommendation,domain-aware 时额外打 domain 标签。评分算法:penalty = critical2.0 + high1.0 + medium0.5 + low0.2,score = max(0, 10 - penalty)。最终以 JSON 返回,包含 category、score、各严重级别计数与 findings。工作量定义:S=<1 小时,M=1-4 小时,L=>4 小时。
限制:该工具只报告不自动修复;领域感知模式下只扫描指定 scan_path;判定需结合项目 principles.md 作为可接受标准;TOD 的时效性影响严重级别。其余如具体安装命令、运行环境与调用示例,资料暂未提供。