用途:面向昇腾 NPU 硬件场景的错误分析技能,解析用户提供的报错信息、日志、堆栈与环境信息,识别根因并生成面向客户的回复。适用于涉及 MindSpeed、MultimodalSDK、Vision SDK、CANN、Ascend NPU 的报错,以及用户询问失败原因、请求调试或根因分析的场景。
主要能力:解析错误信息(parse_error.py 可提取 error_type、error_message、category、environment、traceback、npu_specific 等字段);与已知错误模式匹配(error-patterns.md、sdk-knowledge.md);按调试清单进行根因分析;可选地按仓库路径检索源码上下文,支持多仓库(MindSpeed-RL、MultimodalSDK、Vision SDK、AgentSDK);覆盖 CANN 初始化、NPU 运行时、NPU 显存不足、ACL、mxvision、图像解码、配置缺键等典型错误;按响应模板生成客户友好回复。输出通常包含问题分析、根因、解决方案、预防建议与 NPU 上下文。
使用方式:期望输入包含报错信息、环境、上下文,可选仓库路径。解析示例:python scripts/parse_error.py "Error: Module not found";python scripts/parse_error.py --file error.log;python scripts/parse_error.py --interactive;输出格式可用 --output json|markdown|summary。可选深度分析:python scripts/analyze_error.py --error-log error.log --repo-path /path/to/repo --output analysis.md。技能自包含、零依赖(仅需 Python 3.7+),可在任意目录运行、解压即用、免配置,支持跨平台与多仓库配置,可用于 CI/CD 自动分类、支持工作流一线响应、开发自助调试等。
限制:分析基于所提供信息与已知模式;复杂问题可能需进一步调试,部分错误需开发者排查;持续性问题建议提交 issue。对 CANN 环境变量、版本兼容、NPU 状态等具体取值,资料未提供完整清单,需以实际环境信息为准。