用途
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。