SuperAPI AI 工具集

ln-514-test-log-analyzer

测试与质量

查看项目

更新于 10-15 15:35

技能介绍

用途

ln-514-test-log-analyzer 用于分析应用程序日志,适用于测试运行后、开发过程中或按需审查日志的场景。它帮助区分真正的代码缺陷与测试产生的噪声,并评估日志本身的质量。

主要能力

  • 两层分析:Node.js 脚本负责日志收集和定量分析;AI 负责分类、质量评估和修复建议。
  • 日志来源自动检测:按 docker → file → loki 的优先级自动检测日志来源。
  • 四类错误分类:将错误分为真实缺陷(Real Bug)、测试产物(Test Artifact)、预期行为(Expected Behavior)、运维警告(Operational Warning)。
  • 日志质量评估:从六个维度评估日志质量——噪声、完整性与可追溯性、级别正确性、结构化日志、敏感性、上下文丰富度。
  • 日志格式检查:十项格式标准检查,包括双格式、时间戳、级别字段、追踪 ID、服务名、源位置、额外上下文、PII 脱敏、噪声抑制、可解析性。
  • 堆栈跟踪映射:将真实缺陷的堆栈跟踪映射到源文件,并给出修复建议和优先级。
  • 报告输出:生成包含信号表、真实缺陷表、过滤表、日志质量问题表、噪声报告表以及机器可读数据块的报告。

使用方式

该技能无需必填输入,在项目目录中运行并自动检测日志来源。可选参数为自然语言调用指令,例如时间窗口、预期错误、测试上下文。示例调用:Skill(skill: "ln-514-test-log-analyzer", args: "review last 30min, 401 errors expected")。

工作流程包括:解析指令、日志来源检测与脚本执行、四类错误分类、日志质量评估、堆栈跟踪映射与修复建议、生成报告、元分析(可选)。

脚本路径为 scripts/analyze_test_logs.mjs,若目标项目中不存在则从 references/scripts/analyze_test_logs.mjs 复制。运行命令:node scripts/analyze_test_logs.mjs --mode {detected} [options]。

适用场景

  • 测试运行后对错误进行分类并评估日志质量。
  • 开发过程中审查应用程序日志。
  • 按需分析日志,可指定时间窗口和预期错误。

限制

  • 仅生成报告,不改变状态或创建任务。
  • 测试产物和预期行为始终被过滤,不计为缺陷。
  • 日志质量与格式问题仅供参考,不影响质量判定;只有真实缺陷会阻塞。
  • 若未找到日志来源,返回 NO_LOG_SOURCES 状态。
  • 脚本需优雅处理无 Docker、无日志文件、无 Loki 的情况。

参考文件

  • 错误分类:references/error_taxonomy.md
  • 输出格式:references/log_analysis_output_format.md
  • 分析脚本:references/scripts/analyze_test_logs.mjs

版本:1.0.0,最后更新:2026-03-13。