opik-diagnose

用途：opik-diagnose 用于从 Opik 项目的线上/生产追踪中，筛出一份按信号排序的少量值得关注的踪迹与 Diagnostics 问题清单，每项带触发信号、trace id 与可点击的 Opik UI 链接，并可交给 /opik-explain 深入分析。它是只读技能，不修改代码，也不做根因定位。 主要能力：优先读取 Opik Diagnostics 已分组的问题（severity、出现次数、原因、建议修复、示例追踪）；再按信号补充追踪——错误、工具调用失败、延迟异常、低在线评估分、相对上一窗口的回归。输出为简短排序清单加一个下一步建议，而非全部追踪的转储。 使用方式：入口为 /opik-diagnose、/opik-diagnose <project> 或 /opik-diagnose <what to look for>。需先配置 Opik：存在 ~/.opik.config 或设置了 OPIK_API_KEY；否则提示运行 opik configure，然后重跑 /opik-diagnose。连接 Opik MCP 时通过 list('agent_insights_issue', project_name='<project>') 与 read 获取问题；无 MCP 时用 SDK：client = opik.Opik()；client.rest_client.agent_insights.find_agent_insights_issues(project_id=project_id)；client.search_traces(project_name='<project>', max_results=200)。MCP 列表支持 since、filters（OQL）、sort 参数。 适用场景：线上项目的日常分诊、排查需要优先查看的错误、延迟或评估分数异常踪迹，并衔接 /opik-explain。 限制：仅处理线上/生产追踪，不呈现离线实验结果（属 /opik-evaluate 与 /opik-compare）；不轮询等待扫描；不修改问题状态；不改代码。阻断时只返回一个下一步。若未安装 opik 技能，应说明并参考 https://www.comet.com/docs/opik/。