Ascend/triton-operator-doc-gen
skills/triton-operator-doc-gen/SKILL.md
为昇腾 NPU Triton 算子生成标准化接口文档。当用户需要为算子创建 README、生成 API 文档、编写产品支持表、整理参数说明时使用。关键词：文档生成、doc generation、README、接口文档、API documentation。
$ install --global
skillsauthnpx skillsauth add Ascend/agent-skills triton-operator-doc-genInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 1, 2026, 2:44 AM134.6s3 files scanned
SKILL.md
- name:
- triton-operator-doc-gen
- description:
- 为昇腾 NPU Triton 算子生成标准化接口文档。当用户需要为算子创建 README、生成 API 文档、编写产品支持表、整理参数说明时使用。关键词：文档生成、doc generation、README、接口文档、API documentation。
Triton 算子接口文档生成
工作流
- 收集算子信息：名称、功能、公式、接口、参数、约束
- MANDATORY：完整阅读
triton_operator_template.md获取输出格式 - 参考示例：完整阅读
layer-norm.md理解完整文档结构 - 需要确认 API 签名时，完整阅读
triton-api-reference.md - 按模板生成文档，确保包含：
- 产品支持情况表（Ascend 全系列产品）
- 功能说明 + LaTeX 公式
- 函数原型
- 参数说明表
- 约束条件（各平台数据类型支持）
- 调用示例
常见陷阱
| 陷阱 | 症状 | 解决 | |------|------|------| | 产品支持表不全 | 文档缺平台行 | 覆盖所有 Ascend 产品线（A3/A2/950/Kirin） | | 约束表缺少 dtype 组合 | 用户按文档用不支持的类型 | 从 code 的 BLOCK_SIZE/dtype 限制反推，列出所有合法组合 | | 公式与实现不一致 | 文档说的和代码算的不一样 | 从 kernel 代码逐行验证公式 | | 调用示例不可运行 | 用户复制粘贴报错 | 示例必须完整可执行，包含 import 和数据构造 |
反模式清单（NEVER）
- ❌ 生成空模板占位符（如
{公式}、{参数描述}未填写）——所有占位符必须替换为实际内容 - ❌ 调用示例缺少 import 语句或数据构造
- ❌ 约束表缺少 dtype × 平台组合
- ❌ 函数原型与实际 kernel 签名不一致
- ❌ 公式使用纯文本而非 LaTeX 语法
- ❌ 产品支持表包含不支持的型号标记为 √
Related Skills
Ascend/k8s-check-fix
testing
VerifiedTrustedCommunity
Kubernetes 集群健康检查与安全修复 — 诊断问题，用户确认后执行修复
13SKILL.mdUpdated May 8, 2026
Ascend/cann-nnal-installer
tools
VerifiedTrustedCommunity
昇腾NPU CANN Toolkit+Kernels+NNAL安装部署技能。支持从官网下载run包安装和从Docker镜像提取两种方式，覆盖驱动检查、包下载、安装、环境变量配置与验证全流程。当用户需要安装CANN全套组件或指定版本CANN到自定义路径时调用。
13SKILL.mdUpdated May 8, 2026
Ascend/atb-testframework-build
development
VerifiedTrustedCommunity
编译 ATB (Ascend Transformer Boost) 测试框架。当用户需要编译 ATB 测试框架、 运行 CSV 测试、或构建 atb_test_framework 时调用。支持全量编译（含第三方依赖克隆与源替换） 和增量编译两种模式。需在 Docker 容器内配合 CANN 环境执行。
13SKILL.mdUpdated May 7, 2026
Ascend/atb-ops-to-aclnn-migration-workflow
databases
VerifiedTrustedCommunity
ATB OPS→ACLNN 迁移标准化工作流主模板。整合前置学习、设计文档生成、CSV用例设计、 实际迁移、编译验证、测试验证全流程，提供明确的阶段 Gates 和用户确认机制。
13SKILL.mdUpdated May 7, 2026