SuperAPI AI 工具集

ln-642-layer-boundary-auditor

编程与开发

查看项目

更新于 10-16 09:21

技能介绍

用途

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 模式匹配,可能存在误报,需人工验证。
  • 具体收费、价格、平台支持等信息暂未提供。