用途
ln-642-layer-boundary-auditor 是一个 L3 Worker 技能,专门用于审计软件架构中的层边界违规。它读取项目的架构文档,发现层结构,并检测代码是否违反了层边界规则,同时检查跨层一致性问题。
主要能力
- 发现架构:读取 docs/architecture.md,提取架构类型(如 Layered、Hexagonal、Clean、MVC 等)、层定义(名称、目录、用途)以及基础设施层组件。若文档缺失,则使用回退预设。
- 检测层违规:根据 layer_rules.md 中的 I/O 模式边界规则,使用 Grep 搜索违规模式,检查代码是否出现在禁止的目录中(如 I/O 代码出现在基础设施层之外)。
- 跨层一致性检查:
- 事务边界违规:检测 commit()/rollback() 在仓库层、服务层、API 层的不一致调用,根据分布情况判定严重程度(如三层都有提交为 CRITICAL)。
- 会话归属违规:检测依赖注入会话与本地创建会话混用的情况。
- 扁平编排违规:检测服务层函数调用链深度(如 A->B->C->D 为 HIGH)。
- 检查模式覆盖:计算 HTTP 客户端抽象覆盖率,若低于 90% 则报告;检测 HTTP 错误处理重复,若涉及超过 2 个文件则建议集中化。
- 计算评分并生成报告:根据审计评分规则计算分数,生成包含检查表、发现表、数据扩展的 Markdown 报告,并返回摘要。
使用方式
该技能作为 Worker 被协调器调用,输入参数包括:
- architecture_path:architecture.md 路径
- codebase_root:扫描根目录
- skip_violations:跳过的文件列表(遗留代码)
- output_dir:输出目录
- 可选领域感知参数:domain_mode(global 或 domain-aware)、current_domain、scan_path
工作流程包括:发现架构、检测层违规、跨层一致性检查、检查模式覆盖、计算评分、写入报告、返回摘要。支持使用 hex-graph 和 hex-line 等 MCP 工具加速,若不可用则回退到内置 Read/Grep/Glob/Bash。
适用场景
适用于需要审计架构层边界、确保代码分层规范、检查事务和会话一致性的项目,尤其适合在持续集成或代码审查流程中作为自动化审计环节。
限制
- 不负责检测异步函数中的阻塞 I/O 或 fire-and-forget 任务(由 ln-628-concurrency-auditor 负责)。
- 需要项目提供 architecture.md 或使用回退预设,否则可能影响准确性。
- 依赖 Grep 模式匹配,可能存在误报,需人工验证。
- 具体收费、价格、平台支持等信息暂未提供。