CANNBot 是面向 CANN 开发的用于提升开发效率的系列智能体，本仓库为其提供可复用的 Skills 模块。
当前项目代码仓暂无内容
CANNBot Skills
📖 安装指南 · 📋 功能清单 · 🏗️ 架构设计 · 🔥 CHANGELOG · 💬 使用样例
📢 项目概述
CANNBot 是面向 CANN 开发的系列智能体，本仓库提供可复用的 Agent Skills 模块，覆盖 Ascend C / Catlass / PyPTO / TileLang / Triton 算子开发、torch.compile 图模式优化、NPU 模型推理端到端优化、Runtime 开发适配等场景。
面向用户：CANN / 昇腾 NPU 各领域开发者（算子开发、图模式、模型推理、Runtime 等），同时欢迎社区开发者共建 Skills 和 Agents。
🚀 快速开始
前置条件
- 任选一种 AI 编程工具：OpenCode / Claude Code / Trae / Cursor / Codex / GitHub Copilot / CodeArts
安装
完整安装（推荐，含 Skills + Agents + Workflows，适合端到端开发流程编排）：
Linux / macOS
curl -fsSL https://raw.gitcode.com/cann/cannbot-skills/raw/master/install.sh | bash
Windows
iwr -useb https://raw.gitcode.com/cann/cannbot-skills/raw/master/install.ps1 | iex
安装后运行 install-helper 启动交互式向导，或 npx @cannbot-ai/install-helper 免安装运行。
独立 Skill 安装（仅需单个能力，遵循 Agent Skills 开放标准）：
# 浏览可用 Skills
npx skills add https://gitcode.com/cann/cannbot-skills.git --list
# 安装单个 Skill（交互式选择目标工具）
npx skills add https://gitcode.com/cann/cannbot-skills.git --skill ascendc-env-check --agent opencode
安装后使用
启动 AI 编程工具，直接用自然语言描述需求：
"检查环境"
"开发一个 Abs 算子，输入 float16，输出 float16"
📖 完整命令参考、手动脚本安装与故障排查详见 安装指南。
📐 开发路径与核心能力
全量 Skills/Agents 清单见 功能清单，使用样例见 Skills 使用样例。
| 领域 / 路径 | 适用场景 | 入口插件 |
|---|---|---|
| Ascend C 直调 | <<<>>> 直接调用核函数 |
ops-direct-invoke / ops-direct-invoke-flash |
| Ascend C 注册调用 | ACLNN/GEIR 接入框架的标准算子 | ops-registry-invoke |
| Catlass | Cube/Matmul 高阶模板拼装 pipeline | catlass-op-generator |
| PyPTO | 昇腾原生 Python Tile 算子编程 | pypto-op-orchestrator |
| TileLang | DSL + @tilelang.jit，Developer/Expert 双模式 |
tilelang-op-orchestrator |
| Triton | triton_ascend DSL 生成并优化算子 |
triton-op-generator |
| torch.compile 图模式 | npugraph_ex 图捕获与重放 | torch-compile |
| GE | 图模式相关问题定位 | graph |
| 模型推理优化 | NPU 推理端到端优化 | model-infer-optimize |
| Runtime | Runtime LLT 开发与接口迁移 | runtime |
| 科学计算模型迁移 | 框架级代码 NPU 迁移（环境门禁/脚本适配/精度性能对比） | — |
| 治理与协作 | Skill 审查、GitCode PR/Issue 自动化 | — |
🔍 项目架构
目录结构
cannbot-skills/
├── ops/ # 算子 Skills
├── model/ # 模型推理优化 Skills
├── graph/ # 图模式 Skills
├── runtime/ # Runtime Skills
├── infra/ # 基础设施 Skills（治理 / GitCode 协作）
├── tools/ # CANN 工具链 Skills（asys / msaicerr / msnpureport）
├── plugins-official/ # 官方 Plugins（开发路径入口，含 Agents/Workflows）
├── plugins-community/ # 社区 Plugins
├── docs/ # 项目文档
└── tests/ # 自动化测试框架
三层架构
三层架构：Plugin 编排 Agents，Agents 绑定 Skills。
- Plugin（应用编排层）— 通过
AGENTS.md定义各 Agent 协作顺序 - Agent（角色执行层）— 承担方案设计、代码开发、代码检视等职责
- Skill（知识能力层）— 提供领域知识与工程模板
以 Ascend C 算子开发为例：
╔═══════════════════════════════════════════════════════════════════════════════╗
║ PLUGINS（应用编排层） ║
╠═══════════════════════════════════════════════════════════════════════════════╣
║ ║
║ ┌─────────────────────────────┐ ┌─────────────────────────────┐ ║
║ │ ops-direct-invoke │ │ ops-registry-invoke │ ║
║ │ Kernel 直调开发流程 │ │ 算子注册调用开发流程 │ ║
║ └──────┬──────┬──────┬────────┘ └──────┬──────┬──────┬────────┘ ║
║ │ │ │ │ │ │ ║
╚═════════╪══════╪══════╪════════════════════════╪══════╪══════╪════════════════╝
│ │ │ │ │ │
▼ ▼ ▼ ▼ ▼ ▼
╔═══════════════════════════════════════════════════════════════════════════════╗
║ AGENTS（角色执行层） ║
╠═══════════════════════════════════════════════════════════════════════════════╣
║ ║
║ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ║
║ │ architect │ │ developer │ │ reviewer │ │ tester │ ║
║ │ 方案设计 │ │ 代码开发 │ │ 代码检视 │ │ 代码测试 │ ║
║ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ ║
║ ║
╚═══════════════════════════════════════════════════════════════════════════════╝
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
▼ ▼ ▼ ▼ ▼ ▼ ▼ ▼ ▼ ▼ ▼ ▼ ▼ ▼ ▼ ▼
╔═══════════════════════════════════════════════════════════════════════════════╗
║ SKILLS（知识能力层） ║
╠═══════════════════════════════════════════════════════════════════════════════╣
║ ║
║ ┌─ 知识库类 ──────────────────────────────────────────────────────────────┐ ║
║ │ npu-arch NPU 架构知识与芯片映射 │ ║
║ │ ascendc-tiling-design Tiling 设计方法论 │ ║
║ │ ascendc-api-best-practices API 使用最佳实践 │ ║
║ │ ops-precision-standard 算子精度标准 │ ║
║ └────────────────────────────────────────────────────────────────────────┘ ║
║ ║
║ ┌─ 工程模板类 ────────────────────────────────────────────────────────────┐ ║
║ │ ascendc-registry-invoke-to-direct-invoke 注册算子直调改造模板 │ ║
║ │ ascendc-direct-invoke-template Kernel直调工程模板 │ ║
║ └─────────────────────────────────────────────────────────────────────────┘ ║
║ ║
║ ┌─ 调试与测试类 ──────────────────────────────────────────────────────────┐ ║
║ │ ascendc-precision-debug 精度调试与症状速查 │ ║
║ │ ascendc-runtime-debug 运行时错误码解析 │ ║
║ │ ascendc-crash-debug 卡死/崩溃调试、Coredump 分析 │ ║
║ │ ascendc-sync-audit 信号同步检验与修正（SetFlag/WaitFlag/CrossCore） │ ║
║ │ ascendc-env-check NPU 设备查询与环境验证 │ ║
║ └─────────────────────────────────────────────────────────────────────────┘ ║
║ ║
║ ┌─ 测试开发类 ────────────────────────────────────────────────────────────┐ ║
║ │ ascendc-st-design ST 测试用例设计 │ ║
║ │ ascendc-ut-develop UT 开发与覆盖率增强 │ ║
║ │ ascendc-code-review 代码检视规则 │ ║
║ └────────────────────────────────────────────────────────────────────────┘ ║
║ ║
║ ┌─ 工具辅助类 ────────────────────────────────────────────────────────────┐ ║
║ │ ops-profiling 算子性能采集分析 │ ║
║ └─────────────────────────────────────────────────────────────────────────┘ ║
║ ║
╚═══════════════════════════════════════════════════════════════════════════════╝
架构设计详情和各开发路径的逻辑架构图见 项目架构设计。
🔥 最新动态
最新更新与历史记录详见 CHANGELOG.md。
💬 相关信息
- 贡献指南 — 贡献流程、准入门槛、评审规则
- 治理模型 — 成文法+判例法、角色职责
- 开发规范 — 命名规范、结构规范、分类体系
- 测试框架 — 自动化测试验证 Skills 和 Agents 的正确性
- 许可证 — 基于 CANN Open Software License v2.0
- 所属 SIG
💖 免责声明
感谢您关注 CANNBot Skills 项目，希望这些技能和知识能帮助您更好地进行 CANN 开发 ^_^
- 功能满足度：由于技术快速迭代，部分内容可能无法完全适用于所有场景。功能与文档持续完善中，欢迎提 Issue 或参与讨论。
- 自动生成内容：自动生成的代码受模型、Skills 能力、语料质量、输入指令等多因素影响，无法保证完全精准。生成代码仅作辅助研发使用，请开发者务必测试验证、安全审查后再投入使用。
🤝 社区交流
| 渠道 | 适用场景 | 链接 |
|---|---|---|
| GitCode Issue | Skill bug / 功能缺失 / 项目结构与文档问题 | 提交 Issue |
| GitCode Discussions | 使用疑问 / 经验交流 / 功能建议 | 参与讨论 |
| 微信交流群 | 实时交流 | 加入群聊 |
| CANNBot SIG | 社区治理与项目方向 | SIG 主页 |