Obdiag Check Rca

巡检与根因分析（check / RCA）

使用场景

• 用户要 巡检、健康检查、check、集群检查
• 用户描述 CPU 高、磁盘满、DDL、内存 等，且希望走 RCA 场景化分析
• 需要先看 有哪些巡检项 / RCA 场景 再执行

与其它 skill 的分工

推荐流程

巡检（check）

1. 可选：调用 check_list 列出可用巡检任务（输出依赖 当前会话活跃集群 的配置）。
   • 用户不确定有哪些检查项、或只要跑全量默认巡检时，可跳过 check_list 直接执行 check_cluster。
   • 用户指定特定检查项（如"只跑 OBProxy 内存检查"）时，先调 check_list 确认 任务名或用例名存在再执行。
2. 调用 check_cluster 执行巡检，支持以下参数：
   • Observer 侧：cases（套餐名，来自 observer_check_package.yaml 的顶层 key，如 "ad"、"k8s_basic"、"deep"）、observer_tasks（具体任务名或正则，分号分隔，如 "cluster.*" 或 "disk.data_disk_full;cluster.no_leader"，优先级高于 cases）
   • OBProxy 侧：obproxy_cases（套餐名，如 "proxy"）、obproxy_tasks（具体任务名或正则，分号分隔，优先级高于 obproxy_cases）
   • 示例：check_cluster(observer_tasks="cluster.*") 或 check_cluster(cases="k8s_basic")
3. 需要落盘时传 store_dir。若用户点名 非默认集群，在 check_cluster 上传 cluster_config_path（短名如 obdiag_test 或完整 yml 路径）。
4. 若结果里给出报告路径或采集目录，可用 file_list / file_read 查看 HTML/文本报告摘要。

根因分析（RCA）

1. 症状 → scene 映射：优先加载 obdiag-rca skill，按其"场景速查表"将用户描述的症状（如"合并卡住"、"断连"、"OOM"）匹配到正确 scene 名称；不要凭感觉猜测 scene。
2. 可选：调用 rca_list 确认该 scene 在当前环境中可用。
3. 调用 rca_run(scene="<scene_name>")；非默认集群加 cluster_config_path。
4. rca_run 无结论时：按 obdiag-rca 中对应场景的手动降级步骤继续分析，不要直接告知用户"无法定位"。

阶段完成标准（SOP）

自检清单

• 日志主路径未误用本 skill 代替 observer-log-analysis / obproxy-log-analysis。
• 需要 另一集群 的 check_list/rca_list 时，已 /use 切换或向用户说明当前列表对应哪套 config。
• check_cluster/rca_run 在点名集群时已传 cluster_config_path（若适用）。

多集群注意

• check_list / rca_list 使用会话 当前 config_path，不接收 cluster_config_path。若用户要列的是 另一套集群 的任务列表，需先在 agent 里 /use <name|path> 切换活跃集群（见 obdiag-multi-cluster skill），再调用 list。
• check_cluster / rca_run 支持 cluster_config_path，可在不切换会话的情况下定向某集群。

输出

• 用表格或列表归纳 失败项 / 告警 / RCA 结论；给出 下一步（例如继续 gather_log、db_query、或知识库查参数）。