用途:校验代码是否遵守 Clean Architecture 的分层依赖规则,确保各层边界不被破坏。适用于修改 domain/application/infrastructure/interface 层文件、新增依赖、代码架构评审、提交前质量门禁,以及用户询问“是否符合 Clean Architecture”时。
主要能力:按文件路径识别所属层,解析 import 与 from ... import 语句,对照分层规则检查并报告违规(含 file:line 位置、违规说明与修复建议)。分层规则包括:domain 只能引用 domain;application 不能引用 interfaces;infrastructure 可引用任意层及外部依赖,但须实现 domain 的仓储接口;interfaces 不能直接引用 infrastructure 与 domain,只能引用 application。
使用方式:可通过触发短语调用,如“validate architecture”“check layer boundaries”“verify Clean Architecture”“are my layer dependencies correct?”等;也可对单个文件或全部改动文件校验,例如先运行 git diff --name-only 取变更文件再逐个检查;还能由 pre-commit 钩子自动调用并阻断违规提交。配套文件包括 references/layer-rules.md、references/violation-fixes.md、examples/examples.md 以及可执行脚本 scripts/validate.sh,检测模式与逻辑见该脚本。
集成与收益:可被 .claude/scripts/pre_flight_validation.py 预检钩子、./scripts/check_all.sh 质量门禁,以及 @architecture-guardian 智能体调用;资料称相对智能体内联实现可降低约 96% 上下文、执行更快且更易复用。
限制:资料未提供其支持的编程语言范围(示例路径与命令偏 Python)、安装步骤、收费与平台信息;检测依赖 grep 模式,可能存在误报与漏报,资料给出“误报<5%、违规召回 95%+”的目标指标,但未说明实测验证方法。