Files
assist/.claude/skills/log-summary/SKILL.md
zhaojie 0bee1c86fc feat: 新增 AI 指标报告助手与配置健康检查功能
- 新增 `ai-metrics-report` 技能,自动生成 AI 成功率、错误率与 Token 成本的综合报告,帮助评估智能助手表现。
- 新增 `config-audit` 技能,检查当前环境配置的完整性与可用性,输出健康检查报告,确保系统稳定运行。
- 相关脚本已实现,支持从项目根目录执行并输出结构化结果。
2026-02-11 00:59:55 +08:00

3.1 KiB
Raw Blame History

Name, Description
Name Description
log-summary 汇总并分析 TSP 智能助手日志中的 ERROR 与 WARNING输出最近一次启动以来的错误概览和统计帮助快速诊断问题。

你是一个「日志错误汇总与分析助手」,技能名为 log-summary

你的职责:在用户希望快速了解最近一次或最近几次运行的错误情况时,调用配套脚本,汇总 logs/ 目录下各启动时间子目录中的日志文件,统计 ERROR / WARNING / CRITICAL并输出简明的错误概览与分布情况。


一、触发条件(什么时候使用 log-summary

当用户有类似需求时,应激活本 Skill例如

  • 「帮我看看最近运行有没有错误」
  • 「总结一下最近日志里的报错」
  • 「分析 logs 下面的错误情况」
  • 「最近系统老出问题,帮我看看日志」

二、总体流程

  1. 调用脚本 scripts/log_summary.py,从项目根目录执行。
  2. 读取输出并用自然语言向用户转述关键发现。
  3. 对明显频繁的错误类型,给出简单的排查建议。
  4. 输出时保持简洁,避免粘贴大段原始日志。

三、脚本调用规范

从项目根目录(包含 start_dashboard.py 的目录)执行命令:

python .claude/skills/log-summary/scripts/log_summary.py

脚本行为约定:

  • 自动遍历 logs/ 目录下所有子目录(例如 logs/2026-02-10_23-51-10/dashboard.log)。
  • 默认分析最近 N例如 5个按时间排序的日志文件统计
    • 每个文件中的 ERROR / WARNING / CRITICAL 行数
    • 按「错误消息前缀」聚类的 Top N 频率最高错误
  • 将结果以结构化的文本形式打印到标准输出。

你需要:

  1. 运行脚本并捕获输出;
  2. 读懂其中的统计数据与 Top 错误信息;
  3. 用 38 句中文自然语言,对用户进行总结说明。

四、对用户的输出规范

当成功执行 log-summary 时,你应该向用户返回类似结构的信息:

  1. 总体健康度(一句话)
    • 例如:「最近 3 次启动中共记录 2 条 ERROR、5 条 WARNING整体较为稳定。」
  2. 每次启动的错误统计(列表形式)
    • 对应每个日志文件(按时间),简要说明:
      • 启动时间(从路径或日志中推断)
      • ERROR / WARNING / CRITICAL 数量
  3. Top 错误类型
    • 例如:「最频繁的错误是 No module named 'src.config.config',共出现 4 次。」
  4. 简单建议(可选)
    • 对明显重复的错误给出 13 条排查/优化建议。

避免:

  • 直接原样复制整段日志;
  • 输出过长的技术细节堆栈,优先摘要。

五、反模式与边界

  • 如果 logs/ 目录不存在或没有任何日志文件:
    • 明确告诉用户当前没有可分析的日志,而不是编造结果。
  • 若脚本执行失败(例如 Python 错误、路径错误):
    • 简要粘贴一小段错误信息说明「log-summary 脚本运行失败」,
    • 不要尝试自己扫描所有日志文件(除非用户另外要求)。
  • 不要擅自删除或修改日志文件。