昇腾产品案例研发实训项目

项目定位

本项目构建一套面向学生学习的产品案例研发实训体系，覆盖 9 个实训（L01-L09），运行于鲲鹏 920B（aarch64）、昇腾 AI 卡（CANN 7.0+）、RK3588、SG2044、Hi3863 等多硬件平台，采用「智能体辅助研发」方式组织教学与交付。

2026 年 8 月 3 日至 8 月 31 日执行第一阶段冲刺，形成 v0.1 基线。

9 个实训

实训	主题	关键链路
L01	鲲鹏上架检测	硬件验收检测主链路
L02	openEuler 与 RAID	系统安装 + RAID 配置
L03	算力切片与容器	资源配置 + Docker Compose
L04	CANN 部署	MindSpore→AIR→OM→AscendCL
L05	RKNN 部署	MindSpore→ONNX→RKNN
L06	CI/CD	lint/test/build/package/deploy-dry-run
L07	边云协同运维	MQTT + Ansible
L08	RAG 应用	Chroma + CLI/SDK + 评测
L09	边缘 AI 应用	Ascend/RKNN 适配层 + MQTT 桥接

目录导航

ascend-ai-engineering/
├── AGENTS.md                     # 智能体入口地图（行为原则/权限/审批点）
├── README.md                     # 本文件
├── EXECUTION-PLAN.md             # 第一阶段冲刺执行计划
├── QUALITY.md                    # 质量要求（G1-G7 门禁 + 11 项指标）
├── GOVERNANCE.md                 # 权限分级 / 审批规则 / 异常升级
├── pyproject.toml                # Python 工程配置（ruff/pytest 基线）
│
├── .planning/                    # GSD 式状态管理（唯一状态源）
│   ├── PROJECT.md                # 项目章程
│   ├── ROADMAP.md                # 路线图
│   ├── STATE.md                  # 当前状态（唯一状态源）
│   ├── handoffs/                 # 交接记录
│   └── phases/                   # 阶段（01-sprint1 … 05-release）
│
├── baseline/                     # 规范持久层（锁定后须专家升级）
│   ├── version-matrix.md         # 版本矩阵
│   ├── interface.md              # 接口基线
│   ├── common-libs.md            # 公共库基线
│   ├── project.md                # 项目基线
│   ├── acceptance/               # 验收基线
│   ├── changes/                  # 变更记录（active/archive）
│   └── decisions/                # 决策记录
│
├── .agents/                      # 智能体与 Skills 配置
│   ├── agents/                   # 智能体定义
│   │   ├── lab-orchestrator.md   # 主智能体（mode: primary）
│   │   └── *-agent.md            # 5 个子智能体（mode: subagent）
│   └── skills/                   # Skills 三层
│       ├── actions/              #   执行类（text-humanizer 等）
│       ├── verifiers/            #   验证类（make-verify-check 等）
│       └── recovery/             #   恢复类（interface-mismatch-escalation 等）
│
├── .loops/                       # Loop Engineering
│   ├── lab-development/          # 实训开发
│   ├── hardware-verify/          # 硬件验证
│   ├── kb-ingestion/             # 知识库摄入
│   ├── integration-verify/       # 集成验证
│   └── review-resolution/        # 评审处置
│
├── .harness/                     # Harness 工程配置
│   ├── schemas/                  # 模式定义
│   ├── policies/                 # 策略
│   ├── linters/                  # 检查器
│   ├── evaluators/               # 评估器
│   └── permissions/              # 权限
│
├── evidence/                     # 证据回执
├── kb/                           # 知识库
│   └── evals/                    # 评测集（retrieval-test-set.json）
├── configs/                      # 统一配置
│
├── common/                       # 公共库（被实训复用的通用能力）
│   ├── ascend/                   # 昇腾适配层
│   ├── rknn/                     # RKNN 适配层
│   ├── mqtt/                     # MQTT 客户端 + schema/
│   ├── kb/                       # 知识库工具
│   ├── logging/                  # 日志
│   └── testing/                  # 测试工具
│
├── scripts/                      # 项目脚本
│   ├── common.py                 # 公共函数
│   ├── init_lab.py               # 实训初始化
│   ├── kb_ingest.py              # 知识库摄入
│   ├── kb_stats.py               # 知识库统计
│   ├── run_eval.py               # 检索评测
│   └── run_regression.py         # 回归测试
│
├── docs/                         # 文档与设计
│   ├── architecture/             # 架构设计（框架/设计规格/开发指南）
│   ├── guides/                   # 规范指南（命名/代码编写/改写策略/开发规范）
│   ├── pm/                       # PM 归档（评估/风险/评审）
│   ├── reports/                  # 会议纪要/报告
│   ├── superpowers/              # 流程计划
│   └── assets/                   # 文档资源（images/）
│
├── colab/                        # 案例库
│   ├── 01-introduction/          # 课程介绍
│   ├── 02-syllabus/              # 教学大纲
│   ├── 03-lectures/              # 讲义（docx/md/pdf/ppt）
│   ├── 04-handbooks/             # 手册
│   ├── 05-notebooks/             # Notebook
│   ├── 06-src/                   # 源码
│   ├── 07-assessments/           # 评测
│   ├── 08-samples/               # 实训案例（L01-L09，见下）
│   └── 09-assets/                # 素材（images/）
│
└── 08-samples 内单个实训结构：
    colab/08-samples/L0x-xxx/
    ├── L0x-xxx.md                # 实训主文档
    ├── introduction/             # 案例介绍
    ├── syllabus/                 # 案例大纲
    ├── lectures/                 # 案例讲义（docx/md/pdf/ppt）
    ├── handbooks/                # 案例手册
    ├── notebooks/                # 案例 Notebook
    ├── src/                      # 案例源码（starter/solution）
    ├── assessments/              # 案例评测
    └── (solution/tests 等由 make verify 门禁约束)