Vibe Coding + 算子 Agent 实战营（沐曦 C500 原生）

本仓库是「Vibe Coding + 算子 Agent 实战营」课程的代码与任务仓库。全程基于沐曦 C500 GPU 算力，使用 mcPy（兼容 NumPy 的沐曦 GPU 加速库）和 MXMACA 工具链，通过模力方舟平台获取 C500 算力实例。

📚 课程文档（飞书）

完整的课程说明、任务手册和教程已迁移至飞书文档（全部公开访问）：

文档	链接
课程总览与快速开始	飞书文档
第一课基础：个人网页简历	飞书文档
第一课进阶：算子测评结果分析器	飞书文档
第二课：沐曦算子开发入门（Softmax on C500）	飞书文档
第三课：Agent 架构深度解析（C500 算子优化）	飞书文档
第四课：算子开发 Agent 设计与实现（C500 原生）	飞书文档
第五课：CUDA 生态工具沐曦迁移实战	飞书文档
DSH 远程部署保姆级教程	飞书文档
课程代码包说明	飞书文档

🎯 课程特色

• 全程沐曦 C500 原生：所有算子开发和性能测试在真实 C500 GPU 上运行，不使用本地 CPU 模拟
• mcPy 兼容 NumPy：使用沐曦 mcPy 库，简单代码替换即可将 NumPy 应用迁移到 C500
• Vibe Coding 实战：每课都有完整的「需求 → 生成 → 运行 → 反馈 → 优化」闭环
• Agent 架构进阶：从 ReAct 基础到完整的算子开发 Agent，循序渐进
• 全程承上启下：每节课复用前一课的代码与环境——第一课配好 C500 与 mcPy，第二课产出 Softmax 算子，第三课在其上构建 ReAct Agent，第四课升级为完整算子 Agent，第五课用它完成 CUDA 生态迁移
• 每课配 Agent 引导文档：AGENT_GUIDE.md 可直接被 AI 编程助手读取，自动引导完成任务

🚀 快速开始

git clone https://www.gitlink.org.cn/Dryoung/vibe-coding-on-metax.git
cd vibe-coding-on-metax

算力平台

• 模力方舟：https://ai.gitee.com
• 沐曦 C500 GPU 实例
• 沐曦免费算力券（课程提供）

环境配置

# 验证 C500 环境
mx-smi  # 或 nvidia-smi 兼容模式

# 验证 mcPy
python -c "import mcPy as np; print('mcPy version:', np.__version__); print('GPU available:', np.cuda.is_available())"

📁 目录结构

vibe-coding-on-metax/
├── lessons/
│   ├── 01-resume/           # 第一课基础：个人网页简历（Vibe Coding 入门）
│   ├── 01-report-lab/       # 第一课进阶：算子测评结果分析器（C500 原生）
│   ├── 02-metax-operator/   # 第二课：沐曦算子开发入门（Softmax on C500，mcPy 实战）
│   ├── 03-agent-lab/        # 第三课：Agent 架构深度解析（Agent 辅助 C500 算子优化，承上启下）
│   ├── 04-operator-agent/   # 第四课：算子开发 Agent 设计与实现（C500 原生，完整 Agent 闭环）
│   └── 05-ecosystem-migration/ # 第五课：CUDA 生态工具沐曦迁移实战（综合收官）
└── scripts/
    └── dsh-remote/          # DSH 远程部署工具包（模力方舟 + 沐曦算力，含 Agent 操作手册）

每个课程目录下都有两类文档：

• **TASK.md**：面向学员的完整任务书（任务说明、验收标准、打卡模板）
• **AGENT_GUIDE.md**：面向 AI Agent 的任务引导——把链接直接发给 Claude Code / Cursor / DSH 等，Agent 即可读取任务、收集必要信息并分步引导完成

🤖 面向 Agent 的任务文档

本课程为每节课都提供了可直接被 AI 编程助手读取的 AGENT_GUIDE.md。使用方式：在你的 AI 编程工具中直接引用对应链接，Agent 会自动了解任务目标、需要向你确认的信息、分步流程和验收自检表。

课程	Agent 引导文档
第一课基础	AGENT_GUIDE.md
第一课进阶	AGENT_GUIDE.md
第二课	AGENT_GUIDE.md
第三课	AGENT_GUIDE.md
第四课	AGENT_GUIDE.md
第五课	AGENT_GUIDE.md
DSH 远程部署	AGENT_GUIDE.md

📝 任务打卡

各课程任务在 GitLink Issue 中打卡：

• Issue #1：第一课进阶任务
• Issue #2：第一课基础任务
• Issue #3：第三课任务
• Issue #4：第四课任务
• Issue #5：第二课任务
• Issue #6：第五课任务

🔧 技术栈

层级	技术	说明
GPU 硬件	沐曦 C500	课程全程使用
GPU 软件栈	MXMACA	沐曦异构计算软件栈
Python GPU	mcPy	兼容 NumPy 的沐曦 GPU 加速库
底层编程	MXMACA C/C++ / TileLang	选做，高性能算子开发
LLM	模力方舟 API（Atria-Dawn-Preview）	Agent 驱动、代码生成
Agent 框架	ReAct	Thought-Action-Observation 循环
算力平台	模力方舟	https://ai.gitee.com