mindspore-ai/akg/cuda-c-basics
Claude Code and agent skill by mindspore-ai/akg
Trust tier 3
- community
Source check pending
Checking that the SKILL.md file is still in the repository.
CUDA C 核心概念、内核结构和标准编程模式
Install
npx vskill@latest install mindspore-ai/akg/cuda-c-basicsSKILL.md
The same SKILL.md was published earlier as mindspore-ai/akg/cuda-c-basics.
CUDA C 编程基础
1. 核心概念
内核 (Kernel)
- 定义: 使用
__global__修饰的 C/C++ 函数,在 GPU 上并行执行 - 特点: 每个内核实例处理数据的一个子集,通过线程索引区分
- 调用: 使用
<<<grid_size, block_size>>>语法从主机代码启动
网格 (Grid) 与块 (Block)
- 网格: 内核启动时的并行维度配置,如
(num_blocks_x, num_blocks_y) - 块: 每个线程块包含的线程数,如
block_size = 256 - 关系:
grid_size = ceil(total_elements / block_size) - 限制: 每块最多 1024 线程(大多数 GPU)
线程层次
- Grid: 所有线程块的集合
- Block: 一组可以协作的线程(共享内存、同步)
- Warp: 32 个线程为一组并行执行(SIMT 执行模型)
- Thread: 最基本的执行单元
内存层次
- 全局内存 (Global Memory): 所有线程可访问,延迟高,容量大
- 共享内存 (Shared Memory): 块内线程共享,延迟低,容量有限(通常 48-164 KB/SM)
- 寄存器 (Registers): 每个线程私有,最快访问
- 常量内存 (Constant Memory): 只读,缓存优化
- 纹理内存 (Texture Memory): 只读,空间局部性优化
2. 标准内核结构(五步模式)
所有 CUDA C 内核都遵循相同的五步结构模式:
内核启动方式
3. 全局索引计算
一维数据处理
二维数据处理
三维数据处理
网格配置
4. 边界处理
基本边界检查
二维边界检查
5. 内存管理模式
主机-设备数据传输
6. PyTorch 集成方式
⚠️ 重要:使用 Python JIT 编译方式
在生成算子时,必须在 Python 模块中内嵌 CUDA C 代码,使用 torch.utils.cpp_extension.load_inline 进行 JIT 编译:
7. 最佳实践总结
编程原则
- 单一职责: 每个内核只做一件事
- 参数简单: 避免复杂的数据结构传递
- 边界检查: 所有数组访问前必须检查边界
- 内存局部性: 尽量访问相邻内存位置
常见错误避免
- 越界访问: 忘记边界检查导致运行时错误或结果异常
- 内存泄漏: 忘记调用
cudaFree释放设备内存 - 同步错误: 共享内存操作缺少
__syncthreads() - 类型不匹配: 主机和设备端数据类型不一致
- 设备内存不足: 块大小过大或数据量超出 GPU 内存
⚠️ 注意事项
- 生成的内核代码不要包含任何测试代码片段
- 禁止使用
printf()、throw std::runtime_error()等打印/异常语句 - 内核内不使用
malloc/new进行动态分配
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingakg_agents/python/akg_agents/op/resources/skills/cuda-c/guides/cuda-c-basics/SKILL.md
Popularity
- Repository stars
- 259
- Repository forks
- 48
- 7-day trend score
- 28
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/mindspore-ai/akg/cuda-c-basics)