用途
ffca-audit 用于对整个 FFCA 单体仓库做架构健康检查。它与逐条约束单个 pubspec 编辑的 hook 不同,关注的是仓库整体是否健康。审计工作由 ffca-layer-auditor 代理执行,因而在独立的上下文中运行,并可被构建、评审和提交 PR 前等流程复用;本技能是负责调度该代理的入口。
主要能力
- 结构判定:确认仓库是否为 FFCA 形态,即存在 features/ 目录且其中包含 {feature}_{layer} 包;不符合则提示并停止。
- 机械检查:通过 dart run scripts/validate_layers.dart --all 检查命名、分层规则、循环依赖、功能归属、导入与 barrel。
- 源码级定性审查:在机械检查之上补充 barrel 作用域、DTO 泄漏、Command/Query 必要性、模块入口、包位置错放、高扇入等检查,细节参考插件根目录下 references/ffca/ 的内容。
- 结果输出:转发代理产出的按包判定表与按严重程度排序的发现列表,每条发现给出规则与修复方式。
使用方式
先确认仓库为 FFCA 结构,否则终止。随后以 ffca-layer-auditor 子代理类型针对该仓库启动审计。代理先执行机械检查脚本,再进行源码级检查。若代理因任何原因不可用,则改为自行运行 dart run ${CLAUDE_PLUGIN_ROOT}/scripts/validate_layers.dart --all 并报告其违规项,同时注明定性源码检查已跳过。
适用场景与限制
适用于采用 features/ 目录与 {feature}_{layer} 包结构的 FFCA 仓库的整体架构审查,尤其适合在构建、代码评审和提交 PR 前等流程中复用。该技能仅做只读审计,不会自动修复问题;对非 FFCA 结构仓库不执行审计。脚本的具体参数、输出格式细节以及定性检查的完整规则清单,资料中未提供。