TraceAI CLI 诊断与报表助手

解决什么问题

Agent 工具调用、MCP 和 SDK 事件发生后，工程师常缺少一个稳定入口来确认 traceai 是否可用、存储是否正常、失败来自参数设计还是代码故障。这个技能面向这类排障和分析任务，把安装、验证、指标查看与报表导出组织成可执行步骤。

技能如何工作

它以 traceai 命令为默认入口，优先使用本地构建与 SQLite 存储，默认数据库名为 traceai.db。典型路径是：先用 version 确认二进制与版本注入，再用 health 确认存储与服务可用，接着用 metrics 查看运行指标，最后用 report 和 export 分析工具热度、错误率、行为画像与 Agent 使用情况。报告通常包含 Tool Heatmap、Error Rate Ranking、Behavior Profile、Failure Reasons、Agent Usage 与 Trend；导出支持 CSV 和 JSON，便于表格查看或二次分析。

适用边界

适合执行命令、验证 release、检查配置、数据库路径、权限和日志的场景；不适合只讨论产品路线、功能价值或不需要实际运行命令的情况。遇到 health 失败时应检查存储路径与权限，不要直接解释为没有数据；export 为空也不等于命令失败；不要默认写入 demo 数据。