Agent skill

Tilelang Op Design

by tile-ai in tile-ai/tilelang-ascend

根据算子需求生成 TileLang-Ascend 算子设计文档(design.md)。涵盖编程模式选型(Developer/Expert/混合)、API 映射、内存层级规划、Tiling 策略、循环结构、同步策略、验证方案等。触发:设计算子、生成 design.md、算子方案设计、新算子开发、算子实现方案。

MITAuto-check passedFrontend & Design

Install Tilelang Op Design

skills CLI
$ npx skills add tile-ai/tilelang-ascend --skill tilelang-op-design -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install tile-ai/tilelang-ascend tilelang-op-design --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/tile-ai/tilelang-ascend.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/tilelang-op-design .claude/skills/tilelang-op-design && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
tilelang-op-design
GitHub stars
403
Token cost
~1.7k tokens
SKILL.md length
517 words
Files
7 (incl. references)
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

根据算子需求生成 TileLang-Ascend 算子设计文档(design.md)。涵盖编程模式选型(Developer/Expert/混合)、API 映射、内存层级规划、Tiling 策略、循环结构、同步策略、验证方案等。触发:设计算子、生成 design.md、算子方案设计、新算子开发、算子实现方案。

  • Works in 9 steps: 目标 → 输入要求 → 技术约束(必须遵守) → …
  • Tasks that involve Design tokens
  • SKILL.md covers 1. 目标, 2. 输入要求, 3. 技术约束(必须遵守) and 4. 工作流程, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Tilelang Op Design is an agent skill from tile-ai/tilelang-ascend. 根据算子需求生成 TileLang-Ascend 算子设计文档(design.md)。涵盖编程模式选型(Developer/Expert/混合)、API 映射、内存层级规划、Tiling 策略、循环结构、同步策略、验证方案等。触发:设计算子、生成 design.md、算子方案设计、新算子开发、算子实现方案。

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `examples/completion-report-template.md`, `examples/design-template.md` and `references/ascend-constraints.md`).

It sits in Frontend & Design, covering Design tokens. The repository describes itself as: Ascend TileLang adapter. The licence is MIT.

When your agent uses it

  • Tasks that involve Design tokens

Example prompts

  • “/tilelang-op-design”

Requirements

  • Python 3

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. 目标
  2. 输入要求
  3. 技术约束(必须遵守)
  4. 工作流程
  5. 算子特征分析决策树
  6. 信息源优先级
  7. 错误处理
  8. 完成报告
  9. 生成算子

What it can do on your machine

Read from SKILL.md and the folder at commit 83b0ece. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tilelang Op Design loads about 1.7k tokens when it runs, and up to ~9k if it reads all its reference files. Until then it costs about 43 tokens; SKILL.md has 517 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from tile-ai/tilelang-ascend at commit 83b0ece, republished under its MIT licence (© tile-ai). 517 words, ~1,684 tokens.

Download SKILL.mdSave it as .claude/skills/tilelang-op-design/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
tilelang-op-design
description
根据算子需求生成 TileLang-Ascend 算子设计文档(design.md)。涵盖编程模式选型(Developer/Expert/混合)、API 映射、内存层级规划、Tiling 策略、循环结构、同步策略、验证方案等。触发:设计算子、生成 design.md、算子方案设计、新算子开发、算子实现方案。

TileLang-Ascend 算子设计文档生成

1. 目标

根据算子需求信息,生成一份完整的 TileLang-Ascend 算子设计文档(design.md),涵盖以下核心决策:

  • 编程模式选型:Developer / Expert / 混合模式
  • API 映射:将数学公式拆解为 TileLang DSL 原语组合
  • 内存层级规划:GM → L1/UB → L0 的数据搬运路径
  • Tiling 策略:Block 划分与 Tile Shape 设计
  • 循环结构:T.Parallel / T.serial / T.Pipelined / T.Persistent 的选择
  • 同步策略:自动同步 vs 手动同步标志
  • 验证方案:Golden 函数与 L0 门槛测试计划(完整分层套件 L1/L2/Boundary 由 tilelang-op-test-design 生成)

2. 输入要求

必需信息
字段说明
算子名称如 softmax、layer_norm、flash_attention
数学公式算子的数学表达,如 $\text{softmax}(x_i) = e^{x_i} / \sum e^{x_j}$
输入张量规格shape、dtype
输出张量规格shape、dtype
编程模式偏好Developer / Expert / 混合
迁移算子路径 ⭐原算子文件路径(迁移时必需),用于获取 golden 实现
输出形状 ⭐原算子输出 shape(迁移时必需),如 (N, M) 或 (M, N)

迁移算子时必须提供原算子路径和输出形状,否则无法证明迁移正确性。Golden 实现一致性要求详见 tilelang-op-develop checklist.md #9 Golden 实现一致 / #10 输出形状匹配。

提问规则(必须严格遵守):

  1. 优先使用调用方传入的字段:若调用方(如 @tilelang-op-orchestrator 通过 analyst 传入 op_requirements 结构)已经提供了字段值,全部跳过提问,直接进入技术约束检测和 design 生成
  2. 每次只询问一个字段:使用 question 工具时,questions 数组中只包含一个元素
  3. 按表格顺序依次询问:算子名称 → 数学公式 → 输入张量规格 → 输出张量规格 → 编程模式偏好
  4. 已提供的字段跳过:如果用户在初始请求中已提供某个字段的值,跳过该字段继续下一个
  5. 示例:
    • 第 1 次询问:只问"数学公式"
    • 用户回答后,第 2 次询问:只问"输入张量规格"
    • 以此类推

⚠️ 当被 orchestrator → analyst Subagent 链路调度时:

  • analyst 会把 orchestrator 在 Primary 上下文预检收集到的 op_requirements 完整传入
  • 此时 5 个必需字段应当全部已 provided,跳过整个提问环节
  • 若 skill 仍发现字段歧义或缺漏,不要在当前 Subagent 上下文调用 AskUserQuestion(透传不到真实用户),而是让 analyst 返回 partial_input + 缺失字段名给 orchestrator,由 orchestrator 在 Primary 上下文追问
推荐信息
字段说明
典型配置常用的 shape 组合与优先级
参考实现PyTorch / NumPy 参考代码
性能目标目标吞吐量或延迟
动态轴说明哪些维度在运行时变化

若用户未提供必需信息中的任一项,通过提问补全后再继续。


3. 技术约束(必须遵守)

本项目为 TileLang-Ascend(华为昇腾 NPU),与 GPU 版 TileLang 有显著差异。外部参考实现不可直接使用,必须转换为 Ascend 兼容方案。

生成 design.md 前必须执行强制检测:三维 Kernel、threads 参数、动态循环边界、GPU 专用 API、GEMM 非整除、L0C 溢出等。

详细已知限制清单、强制检测规则、警告输出模板见 references/ascend-constraints.md。


4. 工作流程

Phase 1:输入解析与算子特征分析
  1. 解析算子名称与数学公式
  2. 验证必需字段是否完整
  3. 分析算子特征:
    • 计算类型判定:
      • 纯 Vector(element-wise / reduction)→ 仅需 UB
      • 纯 Cube(仅 matmul)→ 需要 L1 + L0A/L0B/L0C
      • 混合(matmul + element-wise 后处理)→ 核间流水线,需要 CV 融合
      • Host 预处理:如 im2col 等 Python 侧预处理步骤,标明在 design 的 §1 和 §4 中
    • 复杂度级别:
      • 单步(如 element-wise add)→ 无循环、单次搬运
      • 多步(如 softmax = max + sub + exp + sum + div)→ 多次计算、可能需要中间缓冲
      • 融合(如 flash attention = GEMM + softmax + GEMM)→ 核间协作、流水线
    • 动态 shape 判定:是否存在运行时才确定的维度
  4. 非整除场景预判:检查输入 shape 是否可能不被 block size 整除。T.ceildiv(M, block_M) 对非整除或 M < block_M 返回 ≥1(非零),T.copy 已支持动态 shape 切片自动处理尾块,不需要 host padding。用 T.ceildiv + 动态切片 T.copy(A[m:m+valid, ...]),参考 examples/chunk_gated_delta_rule/expert_chunk_gated_delta_rule.py:107-108。仅当多个 group 共享同一输出 buffer 时需注意尾块写入竞态——用 metadata 的 valid_m 字段限制写入范围 T.copy(C_L0, Y[m:m+valid_m, ...])
  5. 多 group 输出竞态约束(grouped 类算子):当多个 group 共享同一输出 buffer(紧凑排列,不 padding)时,尾块按 block_M 整块写会溢出到隔壁 group 的区域,导致竞态条件(执行顺序不确定→结果不确定)。解法:metadata 记录 valid_m,kernel 用 T.copy(C_L0, Y[m_start : m_start + valid_m, ...]) 只写有效行。参考 examples/grouped_gemm/example_grouped_gemm_fwd.py 的 block_metadata[2](valid_m 字段,当前未使用,应启用)。
  6. 数据重排成本建模:按 references/ascend-constraints.md §4.2 为每条路径和最大/关键 case 计算 DMA/GM 标量访问/地址解码/并行度;不能只给 tile shape,不计算 transaction 数量。
Show full SKILL.md (196 more words)Show less
Phase 2:信息收集

必须执行强制步骤 0:搜索本项目同类实现。详细工具调用、信息收集步骤、禁止行为见 references/info-sources.md。

Phase 3:生成 design.md

⚠️ 生成 design.md 时必须遵守 references/ascend-constraints.md §5「Host 侧 Buffer 操作约束」。下游 tilelang-op-develop 会再次校验;违规设计在 Stage 2 返回 [DESIGN_ERROR]。

基于 examples/design-template.md 模板,填充所有章节:

  1. 概述
  2. 编程模式选型
  3. API 映射设计
  4. 数据规格与内存规划
  5. Tiling 策略(非整除时用输入、输出两侧显式 valid extent/BufferRegion;前端负责 按这些动态切片裁剪搬运,不代表尾块无需设计;host 侧不允许 padding + crop)
  6. 循环与调度结构
  7. 同步策略
  8. CV 融合设计(按模式分支:Developer 默认消除 workspace/vid——threads=2 + 片上直连,不产出 workspace 规格;仅 Expert/混合或复杂场景回退才设计 workspace + workspace_idx。详见 design-template.md §8.2)
  9. 验证方案(Golden + L0 门槛测试计划 + 性能可行性哨兵;除规则 shape 外,至少包含每条路径最坏 dtype/最大任务数的用户关键 case,并给出单 case 超时预算; 完整分层套件 L1/L2/Boundary 交由 tilelang-op-test-design)。若算子支持 NaN/Inf,精度方案必须声明位置敏感比较:特殊值用“有限值 + 稀疏特殊值”的 混合输入,先严格比较 NaN/正 Inf/负 Inf mask,再只对有限值应用数值容差; 禁止使用全 NaN/全 Inf 输入作为唯一特殊值用例,因为数据重排或索引错误可能被掩盖
  10. 风险点与注意事项
  11. 交付清单
Phase 4:质量自检

⚠️ 首要检查:host 侧 Buffer 操作合规性(违反则立即修订,不得继续)

核对 design.md 的完整 host 路径是否只含经证明不物理化的 metadata view、kernel 调用与验证;命中真实拷贝或 aclnn 调用必须修订(详见 references/ascend-constraints.md §5)。

按照 references/quality-checklist.md 中的自检清单逐项检查,确保文档质量。

Phase 5:针对性修订

仅修正未通过自检的项目。信息确实不足的标注为「待确认」并说明原因。

Phase 6:输出
  • 将 design.md 输出到当前目录或用户指定路径。若文件已存在,询问是否覆盖。
  • 同时产出 proto.yaml(算子接口规格,模板见 examples/design-template.md §11.5):dtype 全集取自 §9.3 精度表(每个支持的 dtype 一行;§4.1 只给代表性 dtype,不作 dtype 全集来源)、attr 取自 §1/§4,机械派生写到同目录(examples/{op}/proto.yaml)。这是覆盖门禁 coverage_check.py --proto 的权威 dtype/attr 来源,每个算子都必须产出;inputs[].dtype 须与 §9.3 精度表的 dtype 行一致。

5. 算子特征分析决策树

详细决策树(Ascend 版)、平台识别、API 映射规则、NPU 硬件约束(分形限制 / 对齐要求 / 存储大小上限)见 references/decision-tree.md。


6. 信息源优先级

信息源优先级表与冲突处理原则见 references/info-sources.md。


7. 错误处理

场景处理方式
用户未提供数学公式提问补全,给出常见算子公式作为参考
必需字段缺失列出缺失项,逐一提问
API 查询无结果标注为「需扩展」,在风险点中说明
目标文件已存在询问用户是否覆盖或另存
算子过于复杂建议拆分为多个子算子分别设计

8. 完成报告

文档生成完成后,按 examples/completion-report-template.md 输出报告。


9. 生成算子

完成报告后,询问用户是否根据此报告生成对应算子代码。


子目录索引

© tile-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (references) in .agents/skills/tilelang-op-design of tile-ai/tilelang-ascend.

  • SKILL.md
  • examples/completion-report-template.md
  • examples/design-template.md
  • references/ascend-constraints.md
  • references/decision-tree.md
  • references/info-sources.md
  • references/quality-checklist.md

Open the folder on GitHubat commit 83b0ece

Compare with similar skills

Tilelang Op Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Tilelang Op Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tilelang Op Design this skilltile-ai/tilelang-ascend403—~1.7kAutomated safety check: PassMIT
Figma Design System Builderwarpdotdev/warp65k2 repos~4.4kAutomated safety check: PassAGPL-3.0
Figma use_figma Plugin API Ruleswarpdotdev/warp65k4 repos~4.4kAutomated safety check: PassAGPL-3.0
MCP Developmentcoollabsio/coolify63k1 repos~949Automated safety check: PassMIT
Design SystemOhh-889/skyroc79511 repos~1.7kAutomated safety check: PassMIT
Design Dnazanwei/design-dna1.9k1 repos~2.1kAutomated safety check: PassMIT

Similar skills

  • Builds or updates a design system in Figma from a codebase in ordered phases: discovery, variables and tokens, components, theming and documentation, with checkpoints.

    65k GitHub starsUsed in 2 repos~4.4k tokens
    Frontend & DesignAuto-check passed
  • Required groundwork before any use_figma call: the rules and reference files for running JavaScript in a Figma file through the Plugin API without common failures.

    65k GitHub starsUsed in 4 repos~4.4k tokens
    Frontend & DesignAuto-check passed
  • MCP Development

    coollabsio/coolify

    A skill your agent uses for Laravel MCP development. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 1 repo~949 tokens
    Frontend & DesignAuto-check passed
  • Design System

    Ohh-889/skyroc

    Token architecture, component specifications, and slide generation.

    795 GitHub starsUsed in 11 repos~1.7k tokens
    Frontend & DesignAuto-check passed
  • Design Dna

    zanwei/design-dna

    Extract, define, and apply design DNA across three dimensions: design system (tokens), design style (qualitative feel), and visual effects (Canvas, WebGL, 3D, particles, shaders, scroll effects…

    1.9k GitHub starsUsed in 1 repo~2.1k tokens
    Frontend & DesignAuto-check passed
  • Figma Design to Code

    warpdotdev/warp

    Turns a Figma frame or component into production code that matches the design, using the Figma MCP server and the project's own design system.

    65k GitHub starsUsed in 4 repos~2.9k tokens
    Frontend & DesignAuto-check passed

More from tile-ai/tilelang-ascend

All 20 skills in this repo
  • Tilelang Submodule Pull

    tile-ai/tilelang-ascend

    Automatically pull tilelang repository and its third-party code.

    403 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed
  • Tilelang Debug Helper

    tile-ai/tilelang-ascend

    How to add debugging capabilities to TileLang Ascend example operators.

    403 GitHub stars~1.7k tokensUpdated yesterday
    Auto-check: notes
  • Tilelang A5 Sim Convert

    tile-ai/tilelang-ascend

    将 tilelang example 脚本转换为可在 A5 camodel 仿真器上直接运行的版本。输入脚本路径,输出一个新的 sim.py 文件,不覆盖原始文件。触发:仿真运行、camodel、A5 仿真、sim 模式、转换脚本为仿真、不需要 NPU 跑 kernel、simulate A5。

    403 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Tilelang Env Check

    tile-ai/tilelang-ascend

    TileLang-Ascend 环境检查与配置验证技能。检查代码仓库完整性、编译安装状态、环境变量配置,并运行简单测试验证环境。发现问题会自动调用相关 skill 进行修复,并按依赖顺序重新执行后续步骤。触发关键词:"环境检查"、"检查环境"、"验证环境"、"环境配置"、"环境搭建"、"env check"、"check environment"、"verify…

    403 GitHub stars~3.4k tokensUpdated yesterday
    Auto-check passed
  • Tilelang Op Test Design

    tile-ai/tilelang-ascend

    TileLang-Ascend 算子测试设计技能。支持多种场景:(1) 从 design.md 设计测试配置 (2) 从 examples/{op}/.py 补充测试 (3) 手动提供算子信息生成测试 (4) 测试覆盖率分析。理解算子实现逻辑后智能判断测试策略。触发:设计算子测试、生成测试用例、补充测试、测试覆盖率不足。

    403 GitHub stars~5.6k tokensUpdated yesterday
    Auto-check passed
  • Tilelang Review

    tile-ai/tilelang-ascend

    检查代码格式是否符合 CI 规则。自动检测并安装缺失工具(ruff、clang-format),先运行检查生成报告,使用醒目方式询问用户后,仅在用户同意时执行修复。工作流程:检测环境→自动安装缺失工具→运行检查→生成报告→醒目询问→用户确认→执行修复。使用此技能当:用户要求"格式检查"、"格式化代码"、"代码格式化"、"检查代码格式"、"代码…

    403 GitHub stars~2.8k tokensUpdated yesterday
    Auto-check: notes

Questions about Tilelang Op Design

What does Tilelang Op Design do?

根据算子需求生成 TileLang-Ascend 算子设计文档(design.md)。涵盖编程模式选型(Developer/Expert/混合)、API 映射、内存层级规划、Tiling 策略、循环结构、同步策略、验证方案等。触发:设计算子、生成 design.md、算子方案设计、新算子开发、算子实现方案。. Tilelang Op Design is an agent skill from tile-ai/tilelang-ascend.

When should I use Tilelang Op Design?

Tilelang Op Design fits situations like: tasks that involve Design tokens.

How do I install Tilelang Op Design in Claude Code?

Run `npx skills add tile-ai/tilelang-ascend --skill tilelang-op-design -a claude-code`. Or copy the skill folder (.agents/skills/tilelang-op-design in tile-ai/tilelang-ascend) into .claude/skills/tilelang-op-design in your project. Claude Code loads it when a task matches its description.

How do I install Tilelang Op Design in Codex?

Run `npx skills add tile-ai/tilelang-ascend --skill tilelang-op-design -a codex`. Or copy the skill folder (.agents/skills/tilelang-op-design in tile-ai/tilelang-ascend) into .agents/skills/tilelang-op-design in your project. Codex loads it when a task matches its description.

Can I use Tilelang Op Design in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add tile-ai/tilelang-ascend --skill tilelang-op-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tilelang-op-design, .gemini/skills/tilelang-op-design, .github/skills/tilelang-op-design and .opencode/skills/tilelang-op-design in your project.

What does Tilelang Op Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Tilelang Op Design is instructions for the agent only. Our summary lists: Python 3.

Does Tilelang Op Design access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Tilelang Op Design safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Tilelang Op Design use?

Tilelang Op Design is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Tilelang Op Design use?

About 1.7k tokens (SKILL.md is roughly 6.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.3k tokens, read only when the agent opens those files.

What are the alternatives to Tilelang Op Design?

Skills that share tags, products or a category with Tilelang Op Design: Figma Design System Builder (warpdotdev/warp, 65k stars), Figma use_figma Plugin API Rules (warpdotdev/warp, 65k stars), MCP Development (coollabsio/coolify, 63k stars) and Design System (Ohh-889/skyroc, 795 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tilelang Op Design?

tile-ai (a GitHub organization) maintains it in tile-ai/tilelang-ascend, which has 403 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on October 9, 2026.

Source: tile-ai/tilelang-ascend on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.