메뉴
PyPTO Pass 模块错误诊断技能。包含错误定位、原因分析和提供问题修复建议，提供从问题定位到修复建议的完整工作流程。当遇到 PyPTO Pass 模块抛出错误时使用此技能。触发词：定位 pass 错误、pass 模块异常、pass 报错、pass 失败、pass 异常。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
PyPTO Pass 编译性能优化技能。用于分析和优化 Pass 模块的编译性能，当 Pass 编译耗时过长需要优化时使用此技能。
定位测试案例中出现 aicore error 时的问题 CCE 文件和问题代码行。当用户说"aicore error"、"定位 aicore error 的原因"、"帮我定位 aicore error 报错"时使用此技能。也适用于用户直接提供 CCE 文件希望定位问题代码行或映射到源码的场景。
PyPTO 环境安装与环境问题修复，包括 CANN、torch_npu、编译工具链、第三方依赖和 PyPTO 编译运行等。触发词：PyPTO environment setup, CANN install, torch_npu, NPU environment, Ascend toolkit, compile PyPTO, build PyPTO, NPU driver, prepare_env, diagnose environment, fix import error, torch_npu import fail, DT_FP8E8M0, pto-isa, ASCEND_HOME_PATH, npu-smi, softmax verify, pip dependency conflict
分析当前 session 上下文，识别 PyPTO 框架或文档不完善导致的断裂点，产出可转化为 Issue 的结构化报告。当用户在 pypto 相关 skill 运行结束后提到"断裂点"、"识别断裂点"、"检测断裂点"、"fracture point"时触发此 skill。也适用于用户对 session 中遇到的问题进行复盘、想要生成问题报告、或希望改进 pypto 框架/文档质量的场景。
分析 host 侧捕获异常后的堆栈信息，通过地址到源码行映射和符号解析，定位问题代码位置。支持 Python traceback、C++ stack trace 和混合堆栈的自动识别与分析。支持编译Debug版本PyPTO包并定位具体代码行。Triggers："堆栈分析"、"堆栈反汇编"、"分析堆栈信息"、"地址到源码行"、"stack trace"、"backtrace"
PyPTO MACHINE 内存重叠检测与修复技能。通过系统化流程检测和修复 workspace 内存重叠、内存管理策略问题导致的精度异常。当怀疑精度问题由内存重叠、workspace 不足、内存管理异常引起时使用此技能。触发词：内存重叠、内存重叠检测、workspace问题、内存管理异常、内存复用错误。
| name | pypto-pass-error-locator |
| description | PyPTO Pass 模块错误诊断技能。包含错误定位、原因分析和提供问题修复建议，提供从问题定位到修复建议的完整工作流程。当遇到 PyPTO Pass 模块抛出错误时使用此技能。触发词：定位 pass 错误、pass 模块异常、pass 报错、pass 失败、pass 异常。 |
| license | 完整条款见 LICENSE.txt |
本技能提供 PyPTO Pass 模块错误的完整诊断和修复建议能力，从错误原因定位到提供修复建议的端到端解决方案。
当某业务场景执行失败，需要分析定位某pass抛出异常原因并获取修复建议时使用此技能。
使用此技能前需要满足以下条件：
环境要求
输入要求
依赖技能
pypto-environment-setup：用于检查环境状态pypto-pass-module-analyzer：用于分析对应 Pass 模块实现pypto-pass-workflow-analyzer：用于分析 Pass 业务流和上下游依赖当用户输入包含以下错误日志或关键字时，自动触发此技能：
触发示例
如果用户执行的是python相关的脚本，开启图编译阶段调试模式开关（开启调试模式编译时会默认在$(pwd)/output目录下输出各 pass 模块的计算图和IR等文件）：
@pypto.frontend.jit(
debug_options={"compile_debug_mode": 1, "runtime_debug_mode": 1}
)
设置日志相关环境变量：
export ASCEND_PROCESS_LOG_PATH=$(pwd)/logs/$(date +%Y%m%d%H%M%S) export ASCEND_GLOBAL_LOG_LEVEL=0 根据用户提供的执行命令，复现用户问题
重要: 上述步骤中的 设置日志相关环境变量 与 根据用户提供的执行命令，复现用户问题，必须同一个会话中完成，否则环境变量的设置无法生效。
验证检查点：
日志查找策略：
$ASCEND_PROCESS_LOG_PATH/debug/plog 目录下获取 pypto-*.log日志文件验证：
pass 中断但无异常日志的特殊处理：
计算图和IR查找策略 查找计算图和IR信息，若没有 CodegenPreproc 模块的相关输出，即可判定 pass 未执行到最后一个模块。[ERROR] 日志，且pass执行中断，在最后中断的pass模块中增加异常捕获代码，对该 pass 的 RunOnFunction 增加临时异常捕获代码，至少覆盖：
catch (const std::exception& e)，打印 e.what()catch (...)，打印 unknown exception验证检查点：
CodegenPreproc 是否执行完成RunOnFunction 中补充临时异常捕获或关键日志计算图和IR查找策略：
compile_debug_mode 后，计算图和 IR 默认输出到 $(pwd)/output 目录下。output 目录下生成一个新的子目录，目录名通常类似：output_20260417_153300_744883_2765832_C0A8451A。Pass_* 目录；每个 Pass_xxx 目录下存放对应 pass 模块执行前后的计算图 JSON 和 IR 文件。Before 计算图和 IRAfter 计算图和 IR（若已生成）执行异常时的特殊处理：
Pass_xxx 目录下的 After 计算图是否成功打印。After 计算图未成功打印，不得直接基于 Before 图下结论；必须参考 references/pass-error-analysis-guide.md 中的“异常前补打计算图”相关流程，定位最近异常点并插入临时 DumpJsonFile 代码。DumpJsonFile 代码后，必须重新编译并安装 pypto 包，再重新执行用户复现脚本。python3 build_ci.py --clean --no_isolation && bash build_out/cann-pypto_*.run --full -q --pylocal验证检查点：
output_* 子目录Pass_* 目录Before 计算图和 IRAfter 计算图是否存在After 计算图缺失，已按参考流程插入临时 DumpJsonFile 代码日志格式示例：
以如下 pass 模块打印的日志格式为例，分段解析：
[ERROR] PYPTO(638465):2026-03-16 10:02:24.711 [n_buffer_merge.cpp:530][PASS]:[NBufferMerge.Config]:The VEC_NBUFFER_SETTING key -3 is incorrect; Please set keys of VEC_NBUFFER_SETTING between -1 and max hashOrder 0.
解析字段：
n_buffer_merge.cpp 为文件名，530 为打印该日志代码所在行号NBufferMerge 可能是pass模块名，也可能是其他工具模块名，如果不是pass模块名称要根据日志上下文分析是哪个pass模块调用的该方法多行错误处理：
日志级别处理：
[ERROR]：必须处理的关键错误[WARN]：可能导致问题的警告信息[INFO]：辅助调试的信息日志验证检查点：
| 异常类型 | 日志特征 | 关键信息提取 |
|---|---|---|
| 参数配置异常 | vec_nbuffer_setting, cube_l1_reuse_setting, cube_nbuffer_setting, sg_set_scope | 异常参数名、参数配置值 |
| 算子约束违反 | constraint violated, invalid parameter | opcode类型、op_magic信息 |
| 段错误 | segment fault | 调用堆栈信息 |
| 属性缺失 | attribute not found, missing attribute, required attribute, get attribute failed | 属性名称、算子名称、期望属性类型、缺失的属性列表 |
| 计算图成环 | cycle detected, graph cycle, topological sort failed, circular dependency | 成环节点、循环路径、依赖关系、拓扑排序失败节点 |
| 索引越界 | index out of range, invalid index | 索引值、范围、张量形状 |
sed -n '<line-20>,<line+10>p' <file>pypto-pass-module-analyzer 技能分析理解对应pass模块整体业务逻辑验证检查点：
references/pass-error-analysis-guide.md 文件，其中已包含日志、计算图 JSON 的统一分析流程After 图缺失RunOnFunction 增加异常捕获/临时日志后重新复现验证检查点：
报告格式详见 PyPTO Pass 错误分析报告模板。
一个有效的错误分析报告必须满足：
输出报告后，执行以下校验：
当校验失败时，按以下路径回退：
| 失败类型 | 回退步骤 | 回退原因 |
|---|---|---|
| 格式不完整 | 回退到步骤 5（异常分析） | 重新汇总分析结果 |
| 证据链断裂 | 回退到步骤 2（关键信息获取） | 补充缺失的日志或计算图证据 |
| 修复建议不可执行 | 回退到步骤 4（异常分类） | 重新定位根因并细化修复方案 |
回退后必须记录：回退原因、缺失内容、补充动作。
处理大规模日志文件时：