pypto-op-knowledge

Query PyPTO operator development experience tables and problem lookup indexes for error diagnosis.

Updated Sep 15, 2026
One-click install
npx skills add https://github.com/WangWindow/CANN-BatchMatMulMaxsum --skill pypto-op-knowledge-wangwindow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pypto-op-knowledge
Source: https://github.com/WangWindow/CANN-BatchMatMulMaxsum/tree/main/.agents/skills/pypto-op-knowledge
Command: npx skills add https://github.com/WangWindow/CANN-BatchMatMulMaxsum --skill pypto-op-knowledge-wangwindow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When developing PyPTO operators on Ascend NPU, developers encounter cryptic error codes (F00001, FC4000, etc.) and runtime failures without knowing the root cause or fix. This Skill provides a structured serial lookup over a curated knowledge base of verified fixes and official documentation routes. ## Core Features & Use Cases - Experience Table Lookup: Searches an indexed experience table by error code plus secondary keyword, then drills into 8 classified component files (external, function, machine, pass, matmul, vector, view_op, codegen) to return symptom, root cause, and fix. - Problem Lookup Fallback: When the experience table misses, queries four parallel indexes (keyword index, error-code routing, runtime symptoms, quick-fix table) that route to official troubleshooting documentation chapters and URLs. - Multi-Entry Disambiguation: When one error code maps to multiple entries, returns all candidates for the caller to select based on actual logs instead of guessing. - Use Case: A developer hits F40005 TENSOR_MEMORY_ALLOCATION during PyPTO kernel compilation; the Skill locates the UB/L0B/L1 overflow entry and returns the diagnosis steps and tile-shape fix. ## Quick Start Ask the assistant to look up error code F00001 in the PyPTO experience table and return the matching symptom, root cause, and fix.

Frequently Asked Questions about pypto-op-knowledge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I look up a PyPTO error code like F00001?

Search the experience table index by error code plus the secondary keyword after the plus sign. On a hit, open the matching classified file and extract the symptom, root cause, and fix; on a miss, fall through to the problem lookup table.

What happens when the experience table has no matching entry?

The query falls through to the problem lookup table, which searches four indexes in parallel: keyword index, error-code routing, runtime symptoms, and a quick-fix table. If all miss, it returns no match rather than guessing a fix.

How are multiple entries for the same error code handled?

An exact match on error code plus secondary keyword is returned first. Without an exact match, all candidate entries for that error code are returned so the caller can choose based on the actual error log.

Can I query PyPTO issues by symptom instead of error code?

Yes. The problem lookup table includes a runtime symptoms index covering issues like aicore errors, hangs, segfaults, and precision failures, routing each symptom to the relevant official documentation chapter with a URL.

What error code ranges does the knowledge base cover?

It covers F0XXXX external usage errors, F2-F3XXXX FUNCTION, F4-F5XXXX PASS, F6XXXX CODEGEN, F7-F8XXXX MACHINE, and FCXXXX OPERATION sub-ranges including VECTOR, MATMUL, and view operations.