告警触发后结构化诊断根因、影响范围与处置动作

当可观测性告警被触发并带有结构化上下文时，使用 LaunchDarkly observability MCP 工具排查并输出可解析的结构化诊断。

适用场景

解决思路

1. 从对话第一轮中解析告警上下文变量：`alertID`、`alertName`、`alertValue`、`group`、`groupValue`、`query`、`thresholdWindow`、`timeRange`，以及产品特定链接；直接使用这些值，不要重新推导。
2. 使用 `query-logs` 查询日志记录。
3. 使用 `query-traces` 查询分布式链路。
4. 使用 `query-error-groups` 查询错误组。
5. 使用 `query-sessions` 查询会话。
6. 使用 `query-aggregations` 查询聚合/时间分桶指标。
7. 使用 `get-keys` 在过滤前发现可用属性键。
8. 根据告警的产品类型加载对应的伴随文件：`logs.md`、`traces.md`、`errors.md`、`sessions.md` 或 `metrics.md`，以采用该产品的排查形态。
9. 对 log alert、log pattern alert 加载 `logs.md`。
10. 对 latency alert、trace-error-rate alert、span-specific alert 加载 `traces.md`。
11. 对 error-rate alert、new-error-group alert、crash-rate alert 加载 `errors.md`。
12. 对 session-health alert、user-facing-error-rate alert 加载 `sessions.md`。
13. 对 custom metric threshold、aggregated metric alert、composite alert 加载 `metrics.md`。
14. 如果告警跨产品边界（例如 metric alert 由 error data 驱动），同时加载两个伴随文件。
15. 按 investigate 技能的方法执行排查：交叉引用 logs/traces/errors/sessions/metrics；引用标识符；先聚合再分页。
16. 将排查范围限定在告警的 `timeRange` 和过滤条件内。
17. 生成结构化诊断，使用固定输出模板，便于通知渠道、仪表盘等消费方解析。
18. 在 `## What triggered` 中用 1-2 句话说明告警名称、阈值以及越界值。
19. 在 `## Likely cause` 中给出根因叙述，并引用具体证据：trace IDs、log timestamps、error group IDs、flag keys、deploy timing。
20. 在 `## Scope` 中说明受影响对象：用户数、服务、会话、错误组数量，以及影响时间窗口。
21. 在 `## Next steps` 中给出 1-3 个 on-call 或 owner 可执行的具体动作；优先具体动作，例如「roll back flag X in env Y」「restart service Z」「investigate trace <id> for downstream failure」。
22. 在 Next steps 中避免写「investigate further」；如果没有根因，明确说明具体应排查什么以及如何排查。
23. 保持输出紧凑：告警排查结果会进入通知，保持结构化、可扫读；不要写开场白（如「Here is my analysis...」），不要重复框架。
24. 引用标识符：诊断中的每个论断都应引用具体的 trace ID、error group ID、session ID 或 log timestamp。
25. 如果告警看起来是噪音，明确说明，例如「This alert fired because of <X>, but the underlying behavior is within normal variance because <Y>」；噪音是合法结果，不要编造根因。
26. 不要重做刚刚完成的排查；诊断输出应让 on-call 无需重新查询即可行动。

适用边界 · 注意事项

• 不适用于没有触发告警、需要主动巡检或探索性排查的场景。
• 不适用于无法访问 remotely hosted LaunchDarkly MCP server 或缺少其可观测性 MCP 工具的场景。
• 不适用于没有结构化告警上下文（如 `alertID`、`timeRange` 等）的普通问题排查。