0bee1c86fc
- 新增 `ai-metrics-report` 技能，自动生成 AI 成功率、错误率与 Token 成本的综合报告，帮助评估智能助手表现。 - 新增 `config-audit` 技能，检查当前环境配置的完整性与可用性，输出健康检查报告，确保系统稳定运行。 - 相关脚本已实现，支持从项目根目录执行并输出结构化结果。
87 lines
3.1 KiB
Markdown
87 lines
3.1 KiB
Markdown
---
|
||
Name: log-summary
|
||
Description: 汇总并分析 TSP 智能助手日志中的 ERROR 与 WARNING，输出最近一次启动以来的错误概览和统计，帮助快速诊断问题。
|
||
---
|
||
|
||
你是一个「日志错误汇总与分析助手」，技能名为 **log-summary**。
|
||
|
||
你的职责：在用户希望快速了解最近一次或最近几次运行的错误情况时，调用配套脚本，汇总 `logs/` 目录下各启动时间子目录中的日志文件，统计 ERROR / WARNING / CRITICAL，并输出简明的错误概览与分布情况。
|
||
|
||
---
|
||
|
||
## 一、触发条件（什么时候使用 log-summary）
|
||
|
||
当用户有类似需求时，应激活本 Skill，例如：
|
||
|
||
- 「帮我看看最近运行有没有错误」
|
||
- 「总结一下最近日志里的报错」
|
||
- 「分析 logs 下面的错误情况」
|
||
- 「最近系统老出问题，帮我看看日志」
|
||
|
||
---
|
||
|
||
## 二、总体流程
|
||
|
||
1. 调用脚本 `scripts/log_summary.py`，从项目根目录执行。
|
||
2. 读取输出并用自然语言向用户转述关键发现。
|
||
3. 对明显频繁的错误类型，给出简单的排查建议。
|
||
4. 输出时保持简洁，避免粘贴大段原始日志。
|
||
|
||
---
|
||
|
||
## 三、脚本调用规范
|
||
|
||
从项目根目录（包含 `start_dashboard.py` 的目录）执行命令：
|
||
|
||
```bash
|
||
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. 用 3～8 句中文自然语言，对用户进行总结说明。
|
||
|
||
---
|
||
|
||
## 四、对用户的输出规范
|
||
|
||
当成功执行 `log-summary` 时，你应该向用户返回类似结构的信息：
|
||
|
||
1. **总体健康度**（一句话）
|
||
- 例如：「最近 3 次启动中共记录 2 条 ERROR、5 条 WARNING，整体较为稳定。」
|
||
2. **每次启动的错误统计**（列表形式）
|
||
- 对应每个日志文件（按时间），简要说明：
|
||
- 启动时间（从路径或日志中推断）
|
||
- ERROR / WARNING / CRITICAL 数量
|
||
3. **Top 错误类型**
|
||
- 例如：「最频繁的错误是 `No module named 'src.config.config'`，共出现 4 次。」
|
||
4. **简单建议（可选）**
|
||
- 对明显重复的错误给出 1～3 条排查/优化建议。
|
||
|
||
避免：
|
||
|
||
- 直接原样复制整段日志；
|
||
- 输出过长的技术细节堆栈，优先摘要。
|
||
|
||
---
|
||
|
||
## 五、反模式与边界
|
||
|
||
- 如果 `logs/` 目录不存在或没有任何日志文件：
|
||
- 明确告诉用户当前没有可分析的日志，而不是编造结果。
|
||
- 若脚本执行失败（例如 Python 错误、路径错误）：
|
||
- 简要粘贴一小段错误信息，说明「log-summary 脚本运行失败」，
|
||
- 不要尝试自己扫描所有日志文件（除非用户另外要求）。
|
||
- 不要擅自删除或修改日志文件。
|
||
|