用于 OP / QBot 对话链路排查的路由型 Skill。保持入口轻量:先判断路径,再按需读取对应流程文件和参考资料。
references/mcp_utilization_playbook.md 先识别系统、读取工具描述、选择最小必要 MCP、交叉验证后再下结论。先读取 references/workflows/triage-dispatcher.md 完成模式判定和路径选择;随后只读取当前路径需要的流程文件。references/workflows/ 下文件是普通 Markdown 工作流文档,不是独立或嵌套 Skill。
输出最终结论前,依据 references/workflows/anti-misdiagnosis-check.md 完成自检;需要对外同步、提单或复盘时,再读取 references/workflows/compose-triage-report.md。
| 场景 | 按需读取 | 说明 |
|---|---|---|
| --- | --- | --- |
| 任意排查起点 | references/workflows/triage-dispatcher.md | 先判模式,再分流 |
| OP 链接 / record_id / session_id | references/workflows/query-record.md | 查询 OP 结构化数据后转 Galileo 复核 |
| 安灯工单 / ticket 链接 | references/workflows/collect-andon-evidence.md | 只提取排查线索,再回到 OP/Galileo 主链路 |
| 只有截图/现象/业务描述 | references/workflows/collect-minimal-evidence.md | 最小补料,不阻塞推进 |
| 已有 OP 字段(reply_method/prompt_raw 等) | references/workflows/analyze-record-path.md | 做 Record/路径层归因 |
| request_id / 接口报错 / 请求失败 | references/workflows/query-api-error.md | API 错误链路,按服务归属定位 |
| 知识库索引 / chunk / segment / 召回排序 | references/kb_vector_chunk_retrieval_runtime.md | 定位解析、入索引、embedding、VDB、rerank/RRF、passage 入模问题 |
| 图片问答 / 文件解析 / 图文检索 / 实时文档 | references/multimodal_file_dialog_runtime.md | 定位文件解析 SSE、多模态状态、图片理解、实时文档问答问题 |
| 只有 trace_id / Galileo 链接 | references/workflows/verify-with-galileo.md | 先做运行时复核,再回填 OP 层判断 |
| 用户要求汇报/提单/复盘 | references/workflows/compose-triage-report.md | 输出诊断卡/报告 |
| 历史导出五文件(补充证据) | references/workflows/analyze-op-five-files.md | 仅作为补充证据,不是默认入口 |
| 需要实现级归因 | references/adp_implementation_map.md、references/runtime_code_path_matrix.md | 把 OP/Galileo 现象映射到 ADP 模块与代码路径 |
| OP 字段互相矛盾 | references/op_field_lineage.md | 判断问题记录、答案记录、chat_prompt、pipeline、procedures 的字段血缘 |
| 标准模式 RAG 运行时问题 | references/rag_runtime_implementation.md | 排查 BasicSearch、Rewrite、KnowledgeSearch、IntentRecognize、DirectReply |
| 工作流引擎运行时问题 | references/workflow_engine_runtime.md | 排查 Master/Executor、NodeTask/NodeResult、belongNodeID、结束节点输出 |
| 工作流配置/发布态问题 | references/workflow_config_publish_runtime.md | 排查草稿/发布态差异、引用关系、发布依赖、START/END 输入输出 |
| Chat/SSE/网关入口问题 | references/chat_gateway_runtime.md | 排查 CreateSession、SSE connect、RecordTrace、OpenAI 风格 remote bot 网关 |
| 模型调用/无输出/慢响应问题 | references/model_gateway_runtime.md | 排查 ai-gateway 路由、限流、熔断、endpoint、LLM span、TTFT/TPOT |
| Agent 工具/Skill/沙箱问题 | references/agent_runtime_environment.md | 排查 tool_call、project_path、stdout/stderr、用户 Skill 目录 |
| Agent 编排/task_done/Steps 问题 | references/agent_orchestration_runtime.md | 排查工具定义入模、思考上限、task_done、ReplyEvent、Step 上报 |
| 插件/MCP 工具调用问题 | references/plugin_gateway_runtime.md | 排查 OAuth、session、tools/call、配额、下游 MCP 转发 |
| 知识库文件/解析/索引问题 | references/kb_file_import_runtime.md | 排查 FileId、SaveDoc、文档解析、学习任务、Connector 导入 |
| API 网关/身份/metadata 问题 | references/api_gateway_runtime.md | 排查 request_id、upstream_action、uin/sub_uin、metadata 映射 |
| 权限/401/403/资源鉴权问题 | references/platform_permission_runtime.md | 排查主账号/子账号、SpaceID、企业权限、角色、资源权限 |
默认输出一屏诊断卡,不展开长文:
仅在提单、复盘或用户明确要求时展开完整报告。
knowledge_raw 下结论;必须结合 prompt_raw、 与 Galileo runtime 证据。references/workflows/triage-dispatcher.mdreferences/workflows/anti-misdiagnosis-check.mdreferences/output_templates.mdreferences/mcp_utilization_playbook.md(工具发现、参数确认、场景选择、交叉验证、证据格式)references/standard_mode_main_flow.md、references/rag_runtime_implementation.mdreferences/workflow_node_analysis.md、references/workflow_engine_runtime.md、references/workflow_config_publish_runtime.md(模式判定、Record 定路径、Steps 定节点、State/Status 字段兼容、Master/Executor、配置校验、发布依赖、条件分支、结束节点与最终 answer 比对、诊断卡模板)references/adp_workflow_node_types.md(NodeType 1~19 对照、分组、字段与误判规则)references/rag_query_rewrite_flow.md、references/rag_intent_flow.md、references/rag_doc_reply_flow.md、references/rag_reference_flow.mdreferences/kb_vector_chunk_retrieval_runtime.md(解析、segment、embedding、VDB、mixed retrieval、rerank/RRF、小找大、大 TopN 补召)references/multimodal_file_dialog_runtime.md(文件解析 SSE、StreamSaveDoc、多模态 session、图片问答、图文检索、实时文档问答)references/chat_gateway_runtime.mdreferences/model_gateway_runtime.mdreferences/agent_runtime_environment.md、references/agent_orchestration_runtime.mdreferences/plugin_gateway_runtime.mdreferences/platform_permission_runtime.mdreferences/andon_evidence_extraction.mdreferences/galileo_playbook.mdreferences/api-error-query/references/adp_implementation_map.md、references/op_field_lineage.md、references/runtime_code_path_matrix.md、references/rag_runtime_implementation.md、references/workflow_engine_runtime.md、references/workflow_config_publish_runtime.md、references/chat_gateway_runtime.md、references/model_gateway_runtime.md、references/agent_runtime_environment.md、references/agent_orchestration_runtime.md、references/plugin_gateway_runtime.md、references/kb_file_import_runtime.md、references/api_gateway_runtime.md、references/platform_permission_runtime.md、references/kb_vector_chunk_retrieval_runtime.md、references/multimodal_file_dialog_runtime.md共 2 个版本