ascend-moe-optimizer-auto-tracelisted
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