tracelens-analysis-orchestrator

分析编排器

协调系统级分析（CPU/空闲、内核融合、多内核 / 通信 / 内存复制）和计算内核分析（GEMM、SDPA、逐元素等）：加载一次跟踪数据，共享预处理，并行启动子 Agent，然后汇总至 analysis.md。

完整流程

每一步都遵循 reference.md（用户提示词、<prefix> / {CMD} 用法、CLI 命令、子 Agent 启动文本、验证、报告 tee 顺序、图表嵌入和跟踪诊断）。

工作流索引

0. Query User Inputs (Platform, Trace Path(s), Analysis Mode, Environment Setup)
1. Generate Performance Report (branches on analysis mode: training vs inference then, comparison scope)
2. Trace-Quality Gate → Deterministic fallback analysis
3-6. Prepare Category Data (GPU Util, Top Ops, Tree Data, Multi-Kernel Data, Category Filtering)
7. System-Level Analysis (PARALLEL) → system_findings/
8. Compute Kernel Subagents (PARALLEL) → category_findings/
  8.5. Aggregate → priority_data.json::findings[]
9. Validate Subagent Outputs
10. load_findings + Model Identification (subagent) → metadata/model_info.json
11. Render performance PNG if agent_extension.py is absent
12. Generate analysis.md (orchestrator writes via <prefix> tee), optional extension, embed PNG

规则

• 子 Agent： 仅在 reference.md 指定“subagent”的位置使用运行器的子 Agent 原语（Claude Code 或 Cursor 中的 Task 工具，Codex 中的 spawn_agent）（步骤 7、8、10）。其余所有操作均由编排器执行，包括步骤 8.5；使用 <output_dir>/cache/cmd_prefix.txt 中的命令前缀（替换 {CMD}）。
• 语言： 优先使用与厂商无关的术语（GPU 内核、集合通信、厂商 GEMM 库、DNN 原语、GPU 图）。引用跟踪数据时，可使用实际内核名称。
• 子 Agent 提示词： 指向已检入的 Agent 文件：TraceLens/Agent/Analysis/skills/analysis-orchestrator/agents/<name>.md（确切路径和提示词模板请参见 reference.md）。

主要输出

• 交付物： <output_dir>/analysis.md
• 内部文件： system_findings/、category_findings/、category_data/、metadata/、perf_report*.xlsx、CSV 文件夹——目录结构请参见软件包 README。

Agent 目录结构

此技能附带项目子 Agent：TraceLens/Agent/Analysis/skills/analysis-orchestrator/agents/*.md。