← ClaudeAtlas

ascend-moe-optimizer-auto-tracelisted

为昇腾算子在源码中接入 TRACE_POINT 与 MoeTracing,串通 trace_preprocessor、profiling tensor、point_map.json、 save_profiling_data 与 trace_collector 生成 Chrome trace。强调门禁 G1–G5:全链路预处理与 OPP、profiling 为数据输出最后一位、 整条编译与示例脚本联调、落盘路径在 spawn 前 resolve。遵循函数级粒度与就地扩展,禁止另注册 xxx_profiling 类第二入口, 保持原 Op 与 torch.ops 名称及签名不变。在用户提到算子打点、Profiling、Chrome trace、MoeTracing,或将结论写入本 skill 时读取。
SOYL-AI/soyl-skills-hub · ★ 0 · AI & Automation · score 72
Install: claude install-skill SOYL-AI/soyl-skills-hub
# 昇腾算子自动打点 ## Agent 速查(执行本 skill 时先读) **红线**:用户未明确说「只要改源码里的 TRACE / 不要 GM / 不要改 Op 输出与 pybind」时,**禁止只改 `op_kernel` 或只插桩不交联调脚本**。须满足下表 **G1–G5**;任一缺失须在回复中写明「未完成项 + 后续风险」,不得宣称已闭环。 | 门禁 | 必须满足 | |------|----------| | **G1 预处理** | 团队 **`compile_ascend_proj.sh`(或等价)** 已接入 **`trace_preprocessor.py` hook**;**当次编译**在构建树生成 **`point_map.json`**,且与**当前运行的 OPP/核**同源 | | **G2 输出位次** | **`profiling_data` 为全部 Tensor「数据输出」中的最后一个**(主输出 `1…N`,再第 `N+1` 路 profiling)。**`op_host` / infer / tiling(若描述输出)/ 类 `Init` / `__global__` / `aclnnInner_*` / 手写 `pregen/.../aclnn_*` / `EXEC_NPU_CMD` 实参** 顺序一致;禁止只改其中一层 | | **G3 编译** | 用项目**常用整条命令**跑通 **OPP**(及若有的 **pybind whl**)。**不等于**仅通过 `validate_trace_points.py` / `check_compile_safety.py` | | **G4 联调与后处理** | 在既有 **`examples/*_sample.py` 和/或 `test_*.py`** 中:**设备同步**(如 `torch_npu.npu.synchronize`)→ **`trace_utils.save_profiling_data`**;若生成 Chrome:调用 **`trace_collector.py`**,且 **`point_map.json` 满足 G1**。**不得**「算子已多一路输出,但脚本仍按旧 arity 解包且从不落盘」 | | **G5 落盘路径** | 传给 `save_profiling_data` / `trace_collector` 的 **`profiling_dir`、`chrome_trace`、`point_map`**:在 **`multiprocessing.spawn` 或等价并行之前** 一律 **`Path(...).expanduser().resolve()` 为绝对路径**。相对路径在 `save_profiling_data` 内会拼到 **`trace_utils.py` 所在目录**,与 shell cwd 不一致 → 易出现 **No rank\*.pt** | **模式 A / B(与步骤 7 一致)**:**A** = `profiling_data` **OPTIONAL**,Python 侧可不增返回值个数;**B** = 同一 `torch.ops` 名,**返回值最后一项**为 profiling。**用户要落盘 / Chrome** 时优先 **B** 或在 sample 中显式接 optional 内核参数;OpDef **REQUIRED** 时禁止用 null