用途
TileLang 开发技能用于编写、调试和优化 TileLang 内核。它要求以本地 TileLang 源码仓库作为 API、实现模式和构建说明的主要依据,而不是依赖记忆中的函数签名,因为该 DSL、编译器与后端集成演进较快。
定位源码
技能先解析包含 SKILL.md 的目录,再使用其下的 repos/tilelang/ 子目录。安装器会把该路径链接到 agent-gpu-skills/third_party/tilelang/,或链接到通过 TILELANG_REPO 提供的检出目录。命令中需将 TILELANG_REPO 替换为解析后的绝对路径:
TILELANG_REPO=/absolute/path/to/tilelang-skill/repos/tilelang
若检出缺失,可在 agent-gpu-skills 仓库中重新安装:
bash update-repos.sh tilelang bash install.sh --skill tilelang-skill
默认检出是源码参考快照,不会初始化 TileLang 的嵌套第三方子模块。构建 TileLang 或修改其编译器时,应通过 TILELANG_REPO 使用完整的开发检出。
主要能力与源码导航
技能按任务类型指向对应源码位置:语言语法与操作在 tilelang/language/;JIT 包装、适配器与内核对象在 tilelang/jit/;降级与语义检查在 tilelang/engine/;自动调优在 tilelang/autotuner/;基准测试与性能分析辅助在 tilelang/profiler/;布局推断与表示在 tilelang/layout/、tilelang/analysis/;调度推荐与 Carver 在 tilelang/carver/;CUDA、ROCm、Metal、CPU 的 Python 后端分别在 tilelang/cuda/、tilelang/rocm/、tilelang/metal/、tilelang/cpu/;编译器变换与目标代码生成在 src/;当前内核与端到端工作负载在 examples/;语言、编译器、后端与回归测试在 testing/python/;仓库专属构建与测试命令在 .agents/skills/tilelang-build/SKILL.md。
使用方式
查询流程为:先将任务归类为内核 DSL、JIT/运行时、自动调优/性能分析或编译器/后端工作;再为对应操作、目标后端、架构、dtype 与形状区间寻找最接近的当前示例;对照 Python 定义验证每个 DSL 操作,仅在问题需要时追踪降级或后端代码;保留工作负载的形状、dtype、布局、内存作用域、目标、启动配置与数值契约;在调优前先建立正确性并确认实际生成的路径。
技能提供一系列检索命令,例如列出文档与示例、搜索内核模式及其定义、追踪 JIT/降级/目标选择、追踪编译器变换与生成源码、搜索调优与性能分析及邻近测试。
实现规范
诊断时需保持以下层次分离:TileLang Python 内核与编译期参数 → TileLang IR、语义检查与编译器变换 → 后端源码生成与原生编译 → 所选目标上的运行时调度。TileLang 源码构造不能证明生成内核使用哪种硬件指令或内存路径;当该区分重要时,应检查 get_kernel_source()、编译器追踪或性能分析数据。涉及 PTX 语义、计算能力、Nsight 或 Compute Sanitizer 细节时,需补充 cuda-skill。TileLang 在 tilelang/contrib/cutedsl/ 下包含 CuTeDSL 集成;追踪 TileLang 如何选择或调用该集成时使用本技能,而任务本身涉及 CuTeDSL API 或实现时使用 cutlass-skill。
正确性工作:与独立参考在代表性及边界形状上对比;测试尾部、动态维度、布局、dtype 转换与后端特定路径;区分 DSL 解析、降级、原生编译、运行时与数值失败;在最小化用例前复现原始目标与编译期参数。
性能工作:冻结基准形状集、预热、重复次数与同步方法;确认所测调用分派到预期的已编译内核;在将结果归因于 TMA、张量核心、tcgen05 或 CuTeDSL 路径前检查生成源码;每次只更改一个 tile、线程数、阶段数、布局或 pass 配置。
构建与测试
在构建、安装或测试 TileLang 本身之前,需阅读上游仓库说明 .agents/skills/tilelang-build/SKILL.md。这些说明与检出一起版本化,是当前构建命令的权威来源。多数编译器与内核测试需要合适的设备。在解释结果前,需验证活动导入路径、构建目录、目标后端与 GPU。
更新源码
在 agent-gpu-skills 仓库中执行:
bash update-repos.sh tilelang python3 scripts/validate_repo.py --require-sources
检出跟随 TileLang main,而 third_party/UPSTREAMS.toml 记录本技能最后接受的提交。更新该记录前应审查源码映射漂移。
适用场景与限制
适用于 TileLang 内核的编写、调试、优化,以及对其 DSL、JIT、自动调优、性能分析、编译器与后端源码的检索和追踪。限制:默认检出为源码参考快照,不初始化嵌套第三方子模块;构建或修改编译器需完整开发检出;多数编译器与内核测试需要合适设备;具体收费、价格、平台支持范围等资料暂未提供。