pypto

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问题、内存管理异常、内存复用错误。

PyPTO Pass 模块错误诊断技能。包含错误定位、原因分析和提供问题修复建议，提供从问题定位到修复建议的完整工作流程。当遇到 PyPTO Pass 模块抛出错误时使用此技能。触发词：定位 pass 错误、pass 模块异常、pass 报错、pass 失败、pass 异常。

根据 Pass 业务描述，生成单元测试用例（UT）。当用户输入业务情况时，能根据业务，生成对应 Pass 的 UT 用例。

修复 PyPTO PR 的 CodeCheck CI 失败和 review 评论。自动获取 CodeCheck 违规详情、匹配规则、应用修复。触发词：修复codecheck、codecheck问题、codecheck报错、codecheck失败、codecheck不通过、CI失败、CI报错、PR评论修复、review意见修复、修复PR、PR review fixer。

Pass精度校验技能。开启PreCheck/PostCheck进行全链路Pass校验，通过pass校验定位报错Pass，使用pass_compare逐Op对比定位具体问题Op，支持动态shape上板数据打印验证。触发词：pass精度、pass校验、pass_verify、pass_compare、精度校验。

PyPTO 算子精度校验与对比技能。包含 tensor_graph 校验流程和精度工具对比法（文件保存）。先通过 tensor_graph 校验判断前端构图是否正确，校验失败则开启保存 tensor 对比流程定位首个失败 op。触发词：精度工具、精度对比、文件保存、pass_verify_save、tensor_graph 校验。

PyPTO 算子精度问题调试技能。提供场景路由式排查：根据用户问题自动选择排查路径，支持前端校验、Pass校验、特定问题排查、上板二分的自由组合。当需要调试 PyPTO 算子精度、定位精度差异来源时使用此技能。

对一个 skill 目录进行质量与最佳实践合规性评审并评分，同时检查 references 文件与 docs 目录的一致性。用于需要审计某个 skill、检查 skill 是否遵循规范、或在发布前评估 skill 的场景。触发词：评审 skill、skill 质量、skill 审计、检查 references。

PyPTO Workspace 内存异常偏大问题自动诊断技能。通过系统化的日志分析流程，逐层拆解内存预算结构，定位导致 workspace 内存超大的根因组件和具体 Tensor，并给出配置调优或问题归属建议。当用户报告 workspace 内存异常、NPU OOM、rtMalloc failed、内存申请失败、workspace 过大等问题时使用此技能。

PyPTO 算子上板二分定位法。通过在 kernel 函数中添加检查点 tensor 作为输入参数进行原地修改，对比中间结果的精度。专注：修改 kernel 签名 → 修改 golden 返回值 → 修改测试函数 → 二分定位首个出错的 op。

PyPTO 跨模块问题分诊与历史 bug 模式匹配技能。仅在故障归属尚不明确、需要先判断是否应归因于 Pass，或需要匹配随包静态历史模式时使用；输出可验证的根因假设和排查方向，不替代已确认 Pass 报错后的源码定位、模块分析、业务流分析、性能优化或 UT 生成技能。

PyPTO Soc CAModel 仿真执行技能。用于在 CPU 上模拟昇腾 AI 处理器行为，生成核内流水报告。触发词：Soc CAModel 仿真、核内流水、流水报告。

为任意 skill 生成校验提示词（validation prompt）。当需要验证某个 skill 的实际执行效果——即它在真实场景下产出的制品是否符合自身声明的规范——时使用。本技能的输出是一份结构化的中文校验提示词文档，可交给 AI 代理独立执行，产出一份数据驱动的优化报告。适用场景：新 skill 上线前的质量把关、现有 skill 的定期审计、skill 修改后的回归验证。触发词：校验skill、验证skill、生成校验提示词、skill验证、审计skill、skill质量评估。

安装和配置 GitCode MCP Server，使 AI 客户端能与 GitCode 平台交互（仓库/分支/Issue/PR 管理）。触发词：安装 gitcode mcp、配置 gitcode mcp、gitcode mcp server。

将本地修改创建或更新到 cann/pypto 仓库的 PR。覆盖 fork 验证、Git 认证、upstream 同步、commit 规范检查、PR 创建/更新和 CLA 检查。当用户提到创建 PR、提交代码、代码合并、推送到 cann/pypto，或已完成开发需要提交变更时使用。触发词：创建PR、修改更新、提交PR、更新PR、修改PR、PR规范、commit message、pypto贡献、提交代码。

基于会话上下文智能创建 GitCode Issue。支持 5 种类型：Bug Report（报错/异常/失败/精度问题）、Feature Request（新功能/优化）、Documentation（文档问题）、Question（使用问题）、Task（开发任务）。触发词：创建issue、提交issue、反馈问题、报告bug、功能请求、文档问题、提问、咨询、创建任务、跟踪任务。

快捷模式 A — 已知 CCE 文件路径，跳过步骤 1-3，直接执行二分查找定位问题代码行并映射到源码。当用户提供了 CCE 文件路径但未提供问题行号时触发。

快捷模式 B — 已知 CCE 文件路径和问题代码行号，直达源码映射。当用户同时提供了 CCE 文件路径和问题行号时触发。不需要 test_cmd。

PyPTO Pass 模块代码分析技能。用于分析 PyPTO pass 的代码，并结合输入文档中的相应内容，生成 Pass 模块分析文档。帮助开发者理解各个模块的接口、功能与特殊场景。当需要理解 PyPTO pass 中某个模块的代码、功能和设计时使用此技能。

PyPTO Pass 业务流分析技能。用于分析 PyPTO pass 文档中的业务流程设计部分，帮助理解业务执行流程、各模块在当前场景中的职责、执行顺序依赖关系及数据流转过程。当需要理解某个业务场景中，pass 各模块在当前业务流程中的作用、执行顺序、依赖关系及数据流转过程时使用该技能。