追踪分析 (Trace)

OMC 框架的因果调查引擎 - 找到问题的真正根源

什么是 Trace？

Trace 是 OMC 的根因分析引擎，专门回答”为什么”的问题。

与 Deep-Dive 的关系

Trace → 找根因
   ↓
Deep-Interview → 基于根因定义解决方案
   ↓
Deep-Dive = Trace + Deep-Interview

何时用 Trace 单独：

已经知道根因，只需要记录
只需要调查，不需要解决方案

核心方法论

1. 三条并行调查线

Trace 同时运行三条调查线，从不同角度分析问题：

调查线	目标	方法
时间线	事件顺序	重建时间序列
因果链	原因结果	追溯逻辑链条
系统映射	影响范围	识别相关模块

2. 证据驱动

每个结论必须有：

文件/行号引用 - 在哪里
具体数据 - 什么问题
逻辑推导 - 为什么

3. 输出结构

Trace 输出包含：

1. 问题摘要
2. 时间线分析
3. 根因链
4. 影响区域
5. 关键未知点
6. 建议（可选）

使用场景

场景 1：生产问题诊断

用户报告: 用户登录失败

trace login failure

输出:
- 时间线: 请求 → 认证 → 失败
- 根因: Token 过期验证逻辑 bug
- 影响: 所有 Token 过期用户

场景 2：性能问题定位

用户报告: API 响应慢

trace api latency

输出:
- 时间线: 请求 → 瓶颈 → 响应
- 根因: 数据库查询未索引
- 影响: 搜索 API

场景 3：行为异常

用户报告: 数据不一致

trace data inconsistency

输出:
- 时间线: 创建 → 修改 → 读取
- 根因: 事务隔离级别问题
- 影响: 并发写入场景

核心命令

/trace                           # 启动追踪
trace <问题描述>                # 分析问题
trace --timeline                # 专注时间线
trace --causal                  # 专注因果链
trace --system                  # 专注系统映射
trace --brief                   # 简要输出
trace --detailed                # 详细输出
trace --report                  # 生成报告

与其他技能的关系

技能	关系
Deep-Dive	Trace + Deep-Interview
Deep-Interview	Trace 之后的下游
Plan	定义解决方案

最佳实践

✅ 应该做

提供具体问题 - 越具体越好
允许足够时间 - 深度分析需要时间
验证根因 - 确认根因正确
记录发现 - 保存分析结果

❌ 不要做

不要只描述现象 - “系统慢了”
不要跳过步骤 - 完整分析更准确
不要忽视未知 - 关键未知也要记录

官方文档: trace/SKILL.md