tilelang-error-fixer

Diagnose and repair TileLang-Ascend Pass crashes via GDB backtraces, IR dumps, and AOT tests.

346|151|Updated Sep 25, 2025
One-click install
npx skills add https://github.com/tile-ai/tilelang-ascend --skill tilelang-error-fixer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tilelang-error-fixer
Source: https://github.com/tile-ai/tilelang-ascend/tree/main/.agents/skills/tilelang-custom-skill/tilelang-error-fixer
Command: npx skills add https://github.com/tile-ai/tilelang-ascend --skill tilelang-error-fixer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides an end-to-end workflow to locate, diagnose, and repair Pass-level errors and severe runtime crashes (Core Dump / Segmentation Fault) in TileLang-Ascend, bridging GDB backtraces, IR inspection, generated target code analysis, AOT verification, and C++ Pass fixes.

Core Features & Use Cases

  • Environment & build validation: verify TL_ROOT, PYTHONPATH, ASCEND_HOME_PATH, LD_LIBRARY_PATH and that C++ sources are freshly built before debugging.
  • Crash and backtrace analysis: attach GDB to Python processes to capture C++ stack traces and map failures to specific Pass implementations.
  • IR and target code inspection: dump and inspect intermediate IR after lowering and extract generated kernel C++ code for manual review.
  • AOT verification workflow: export operator C++ from TileLang, compile AOT .so, and run Ctypes-based tests to validate behavioral and precision fixes before changing Pass code.
  • C++ Pass repair and validation: propose guarded code edits, generate diffs, run make, re-run reproducer, compare IR/target diffs, and rollback if necessary.
  • Use Case: debugging a segmentation fault caused by a pipeline pass that miscomputes loop extents and validating the fix via AOT-compiled kernel tests.

Quick Start

Provide the failing script and build artifacts and ask the skill to run environment checks, collect GDB backtrace and IR dump, and propose a C++ Pass fix with AOT verification.

Frequently Asked Questions about tilelang-error-fixer

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

FAQPage Schema
How do I debug segmentation faults in TileLang-Ascend compiler passes?

To debug segmentation faults in TileLang-Ascend compiler passes, attach GDB to the Python process to capture C++ stack traces, dump intermediate IR, and map the failure to specific Pass implementations for targeted repair.

How do I validate a TileLang-Ascend C++ Pass fix before rebuilding the compiler?

Validate a TileLang-Ascend C++ Pass fix by exporting operator C++ code, compiling an AOT .so file, and running Ctypes-based tests to verify behavioral and precision corrections before changing Pass code.

What environment variables need to be set to debug TileLang-Ascend codegen regressions?

Debugging TileLang-Ascend codegen regressions requires validating the TL_ROOT, PYTHONPATH, ASCEND_HOME_PATH, and LD_LIBRARY_PATH environment variables to ensure C++ sources are freshly built before analysis.

How can I inspect intermediate IR and generated target code for Ascend NPU crashes?

Inspect intermediate IR and generated target code for Ascend NPU crashes by dumping the IR after lowering and extracting the generated kernel C++ code for manual review to identify pass logic errors.

What is the workflow for repairing TileLang compiler pass logic errors on Ascend targets?

The workflow for repairing TileLang compiler pass logic errors on Ascend targets involves proposing guarded C++ code edits, generating diffs, running make, re-running the reproducer, comparing IR, and rolling back if necessary.