SuperAPI AI 工具集

ln-622-build-auditor

测试与质量

查看项目

更新于 10-15 14:34

技能介绍

用途

ln-622-build-auditor 是一个 L3 Worker 技能,作为代码库审计流水线中的专门工作者,负责审计构建健康状况与代码质量工具链。它针对“构建健康”类别(Category 2:关键优先级)对代码库进行审计,检查编译器/linter 错误、弃用警告、类型错误、失败的测试以及构建配置问题,并将结构化发现返回给协调器,同时计算该类别 0-10 的合规评分。

主要能力

该技能执行五类构建检查:

  1. 编译器/Linter 错误:检测语法错误、编译失败、linter 规则违规。通过检查退出码、解析 stderr 获取错误,并在可用时使用 JSON 输出标志。严重程度从 CRITICAL(编译失败)到 LOW(格式类风格警告)。

  2. 不受支持的 API 警告:检测不受支持的 API、库或语言特性的使用,包括编译器警告(UnsupportedApiWarning、@obsolete)、依赖警告(npm outdated、pip list --outdated)以及静态分析。严重程度依据移除时间线判定。

  3. 类型错误:检测类型不匹配、缺失类型注解、类型检查器失败。严重程度从 CRITICAL(类型错误阻止编译)到 LOW(过于宽松的类型)。

  4. 失败或跳过的测试:检测测试套件失败、被跳过的测试、缺失的测试覆盖。严重程度从 CRITICAL(CI/生产代码测试失败)到 LOW(带 TODO 注释的跳过测试)。

  5. 构建配置问题:检测构建工具配置错误、缺失脚本、错误路径、缺失的环境特定配置、未使用或冲突的构建依赖。严重程度从 CRITICAL(配置错误导致构建失败)到 LOW(未使用的配置选项)。

使用方式

该技能作为审计流水线中的工作者运行,接收包含 tech_stack(含 build_tool、test_framework)、best_practices、principles、codebase_root、output_dir 的 contextStore。工作流程为:解析上下文、运行构建检查(第一层)、分析输出上下文(第二层)、收集发现、计算评分、写入报告、进行趋势跟踪、返回摘要。

报告写入 {output_dir}/ln-622--global.md,类别为 "Build Health",检查项包括 compilation_errors、linter_warnings、type_errors、test_failures、build_config。在托管模式下调用方传入 runId 和 summaryArtifactPath;在独立模式下工作者自行生成运行范围的工件路径。

该技能会加载多个参考文件,包括 audit_worker_core_contract.md、ci_tool_detection.md、audit_scoring.md、templates/audit_worker_report_template.md、audit_summary_contract.md、results_log_pattern.md、build_rules.md 等。

适用场景

适用于需要对代码库进行构建健康审计的场景,例如在代码库审计流水线中作为构建健康类别的专门检查环节。它支持多种技术栈(npm、cargo、gradle 等),会根据 contextStore 运行相应的构建命令。

限制

该技能只报告违规、不自动修复,由协调器创建任务交由用户修复。它需要先加载核心契约文件。构建/测试命令默认超时 5 分钟。对于预期超过 30 秒的构建/lint/类型检查/测试命令,使用 Monitor(2.1.98+),回退方案为 Bash(run_in_background=true)。在检测到 CI 环境时以 CI 模式运行(无交互提示)。

版本信息

版本 3.0.0,最后更新于 2025-12-23。