CANNBot 是面向 CANN 开发的用于提升开发效率的系列智能体，本仓库为其提供可复用的 Skills 模块。

文件	最后提交记录	最后更新时间
.claude-plugin	refactor: 将 asc-devkit 路径封装到 ascendc-docs-search skill 内部 Co-authored-by: jiangyixuan2<jyx1960551938@gmail.com> # message auto-generated for no-merge-commit merge: !354 merge refactor/encapsulate-asc-devkit-paths into master refactor: 将 asc-devkit 路径封装到 ascendc-docs-search skill 内部 Created-by: jiangyixuan2 Commit-by: jiangyixuan2 Merged-by: cann-robot Description: ### 背景此前，项目中大量 skill、agent、workflow 文件直接硬编码了 `asc-devkit/` 相对路径来引用 API 文档和示例代码，导致： - 路径与项目目录结构强耦合，asc-devkit 位置变动时需逐文件修改 - 无法灵活适配不同部署环境下的 asc-devkit 安装位置 ### 改动内容将所有硬编码的 `asc-devkit/` 路径统一替换为环境变量 `$ASC_DEVKIT_DIR/`，并在外部引用处改为通过 `/ascendc-docs-search` skill 间接访问文档，共涉及 30 个文件，89 处修改。 #### 1. Skill 内部路径动态化（4 个文件） - `SKILL.md`：搜索命令从 `ls asc-devkit/docs/api/context/` 改为 `find "$ASC_DEVKIT_DIR/docs/api/" -name "*.md"` 等 - `references/` 下的 `api-index.md`、`compatibility.md`、`example-catalog.md`：路径前缀统一替换为 `$ASC_DEVKIT_DIR/` #### 2. 外部 skill 引用改为 skill 调用（11 个文件） - `ascendc-api-best-practices`、`ascendc-code-review`、`ascendc-docs-gen`、`ascendc-precision-debug`、`ascendc-simt-best-practices`、`ascendc-tiling-design`、`torch-ascendc-op-extension` 等 skill 中的文档引用，统一改为 `通过 /ascendc-docs-search skill 查阅 $ASC_DEVKIT_DIR/...` #### 3. Plugin agent/workflow 路径替换（12 个文件） - `ops-direct-invoke`、`ops-registry-invoke`、`catlass-op-generator` 三个 plugin 下的 agent、workflow、AGENTS.md、quickstart 等文件中的路径全部替换为 `$ASC_DEVKIT_DIR/` #### 4. 版本号更新（3 个文件） \| 模块 \| 旧版本 \| 新版本 \| \|------\|--------\|--------\| \| `ops-direct-invoke` \| `1.2.3` \| `1.2.4` \| \| `catlass-op-generator` \| `1.0.0` \| `1.0.1` \| \| `marketplace.json` \| — \| 同步更新 \| ### 效果 - asc-devkit 路径由 `$ASC_DEVKIT_DIR` 环境变量统一管理，支持多位置自动检测（环境变量 → 当前目录 → plugin 目录 → `~/.config` → `~/.claude`） - 外部模块通过 `/ascendc-docs-search` skill 访问文档，无需感知内部目录结构 - 后续 asc-devkit 位置调整只需修改一处配置，无需逐文件修改 See merge request: cann/cannbot-skills!354	3 天前
.gitcode	docs(update): 同步更新README入门指南、CHANGELOG、ST测试框架及PR模板 Co-authored-by: yanhf<yanhaifeng5@huawei.com> # message auto-generated for no-merge-commit merge: !286 merge master into master docs(update): 同步更新README入门指南、CHANGELOG、ST测试框架及PR模板 Created-by: yanhf Commit-by: yanhf Merged-by: cann-robot Description: ## 描述 #### 文档更新本批次全部为文档类更新，覆盖README 快速开始、测试框架文档、CHANGELOG、PR 模板及项目架构说明，旨在降低新用户上手门槛并同步最新项目状态。【README 快速开始】README.md - 重写快速开始指南，拆分为四步：克隆 → 选场景安装 → 验证 → 开始使用 - 新增前置条件说明，明确 AI 工具与 CANN 环境要求 - 统一命令格式，使用 `<tool>` 占位符代替具体的工具名列表 - 增加安装验证方法（目录检查 + AI 交互验证） - 修正安装命令格式：`./path/init.sh` → `cd path && bash init.sh` - 更新 AI 工具安装说明（补充 npm install / 下载地址）与官方文档直达链接【README 场景与架构】README.md - 补充 Catlass 算子直调、代码检视、torch.compile 图模式 3 个场景到快速开始表格 - 更新项目架构树，统一缩进并对齐注释，新增 `plugins-community/` 和社区 Plugin 条目 - 补充多个缺失 Skills（blaze-best-practice、performance-best-practices、regbase-best-practice、cann-env-setup、aiss-tiling-solver 等） - 修正 `ops-simulator` 技能名称（原 `cann-simulator`） - 统一 quickstart 引用描述【测试框架文档】tests/README.md - 补充 ST 系统测试框架完整文档（300 行新增），涵盖 system/ 目录结构、本地开发调试指南（L1 快速验证 / 行为验证 / ST 语义评测）、gate_check.sh CI 入口、换行符检查及环境变量说明 - 新增 `opencode_runner_examples.py` 到 system/ 目录树 - 将默认测试超时从 300s 调整为 600s - 删除 GitHub Actions CI 示例（项目已迁移至 GitCode CI） - 修正 `claude-code` npm 包名【CHANGELOG 维护】CHANGELOG.md - 补充 2026-05-20 ~ 2026-05-25 期间的特性、增强与修复条目 - 新增 05-26 条目（cuda2ascend-simt、pypto-golden-generate、PR 模板统一） - 新增 05-21 条目（tiling-solver、示例提示词） - 修正 05-25 条目内容归属（性能调试 / 代码检视 / PyPTO / 测试框架等） - 简化 README 最新动态为每日一行【PR 模板与测试报告】 - `.gitcode/PULL_REQUEST_TEMPLATE.zh-CN.md`：修正 UT_Test 未通过时的下载指引，明确下载的是 HTML 格式的 CANNBot-skills UT 测试报告 - `tests/run-tests.sh`：将 HTML 报告标题统一为 `CANNBot-skills UT 测试报告`，与 PR 模板指引保持一致 ## 关联的Issue <!-- 无特定 Issue --> ## 测试 - `./tests/run-tests.sh --fast` 全部通过（10/10） - `./tests/run-tests.sh --test unit/teams/test-version.sh` PASS（version bump 验证通过） ## 文档更新 - `tests/README.md`：ST 系统测试框架文档、目录结构、CI 示例、超时配置 - `CHANGELOG.md`：补充 05-20 ~ 05-26 期间全部变更条目 - `README.md`：快速开始指南、场景列表、项目架构、Skills 目录 - `.gitcode/PULL_REQUEST_TEMPLATE.zh-CN.md`：UT_Test 下载指引 - `tests/run-tests.sh`：HTML 报告标题 ## 类型标签 - [x] 📝 文档更新 See merge request: cann/cannbot-skills!286	1 个月前
docs	说明示例补充及修正个别逻辑矛盾或格式问题 Co-authored-by: gitcode-bot<noreply@gitcode.com> Co-authored-by: zengyuhang<231880381@smail.nju.edu.cn> # message auto-generated for no-merge-commit merge: !461 merge master into master 说明示例补充及修正个别逻辑矛盾或格式问题 Created-by: zengyuhang Commit-by: gitcode-bot;zengyuhang Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述您的改动，包括改动的原因和所采取的方法。 ### 举例： #### 新特性 New Features - 【仿真 ops-simulator】新增Ascend 950 仿真Skill：支持 Ascend 950 仿真，并且输出性能分析报告和流水线图。 - 【PyPTO】【pypto-op-design】新增 Skill：pypto-op-design，PyPTO算子方案设计，含快速参考和设计模板。 #### 问题修复 Bug Fix 【算子直调 ops-direct-invoke】修改verify_environment.sh脚本，返回environment.json 固定为1的bug，应该按实际设备的npu count返回。 --> ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #000--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单的链接。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🌟 新特性 - [ ] ✨ 特性增强 - [ ] 🐛 Bug 修复 - [ ] ⚡ 性能优化 - [ ] 🧪 测试用例 - [ ] 📦 构建 / CI - [ ] 📝 文档更新 - [ ] 🔧 配置变更 - [ ] ⬆️ 依赖升级 - [ ] 🔒 安全修复 - [ ] ♻️ 代码重构 - [ ] 🧹 代码清理 - [ ] ❓ 其他，请描述： ## 流水线故障排查 <!-- 如果下方的流水线检查未通过，可参考以下指引进行自助修复 --> > UT_Test 未通过？ > 请在下方流水线表格的 UT_Test 行，点击右侧的 `>>>>>` 下载 CANNBot-skills UT 测试报告（HTML 格式）。 > 打开报告后，展开页面中的「UT Test 失败修复指南」，复制其中的提示词并粘贴给 Agent，Agent 将根据日志自动定位并修复问题。 > > 示例： > ![UT_Test下载示例](pipeline-ut-test-download-link.png) See merge request: cann/cannbot-skills!461	1 天前
graph	【feat】add dfx triage runner and performance diagnosis Co-authored-by: ganon0327<zhoujialong4@huawei.com> # message auto-generated for no-merge-commit merge: !314 merge feat/torch-compile-dfx-triage-runner into master 【feat】add dfx triage runner and performance diagnosis Created-by: ganon0327 Commit-by: ganon0327 Merged-by: cann-robot Description: ## 描述 #### 新特性 New Features - 【torch-compile】新增torch-npugraph-ex-performance-diagnosis Skill：支持分析图中冗余拷贝，并快速定位源码根因。 See merge request: cann/cannbot-skills!314	26 天前
infra	refactor(infra): gitcode-toolkit 渐进式披露重构 + 确定性操作脚本化 Co-authored-by: kpge90<gekangping@huawei.com> # message auto-generated for no-merge-commit merge: !338 merge master into master refactor(infra): gitcode-toolkit 渐进式披露重构 + 确定性操作脚本化 Created-by: kpge90 Commit-by: kpge90 Merged-by: cann-robot Description: ## 描述对 `infra/gitcode-toolkit` 进行两项结构化改进： ### 1. 渐进式披露重构 - SKILL.md 从 289 行缩减至 86 行（-70%） - 完整 PR 创建工作流（7 步）迁移至 `references/pr-creation-workflow.md` - 速查索引表增加约束级别标注（MUST / SHOULD / MAY） - 移除不存在的消费者引用（code-review、pr-to-design-doc、pr-compile 等） ### 2. 确定性操作脚本化新增 `scripts/` 目录，将原本以 prose + shell 片段描述的操作实现为确定性脚本： \| 脚本 \| 功能 \| \|------\|------\| \| `scripts/parse_gitcode_url.py` \| URL 解析（输入 URL → 输出 JSON: owner/repo/type/number）\| \| `scripts/preflight.sh` \| 环境预检（token/git/curl/python3/tmp/git-author → 结构化报告）\| \| `scripts/fetch_pr_context.py` \| PR 上下文一键获取（clone + checkout + merge-base + diff + log）\| 消费者 skill 的流程从"读 N 个 reference + 手工拼装 8+ 条命令"变为"调 2-3 个脚本 + 读 JSON 输出"。 ## 关联的Issue Fixes #258 ## 测试 - [x] `parse_gitcode_url.py` 通过 3 种 URL 格式测试（pull/pulls/merge_requests + issue） - [x] `preflight.sh` 输出结构化 JSON，6 项检查全部 pass - [x] 消费者 skill 相对路径引用一致性检查通过 - [x] 无回归：所有 references 路径保持不变 ## 文档更新 - [x] SKILL.md 更新为渐进式披露结构 - [x] references/env-check.md 增加脚本引用 - [x] references/clone-and-checkout.md 增加脚本替代说明 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他（重构） See merge request: cann/cannbot-skills!338	3 天前
model	feat(model): add model-infer-harmony skill for Kirin9030 ASR 4bit quantization Co-authored-by: 2401_86180933<haikefeng@qq.com> # message auto-generated for no-merge-commit merge: !472 merge feat/model-infer-harmony into master feat(model): add model-infer-harmony skill for Kirin9030 ASR 4bit quantization Created-by: 2401_86180933 Commit-by: 2401_86180933 Merged-by: cann-robot Description: ## 一、背景信息 CANNBot Skills 已覆盖算子开发（ops/）、模型推理优化（model/model-infer-*）、图模式诊断（graph/）、协作工具（infra/）等领域，但「端侧（HarmonyOS / 麒麟 Kirin NPU）模型部署」域目前仍为空白，缺少把浮点模型量化、转换、打包到端侧可加载产物的体系化能力。端侧模型落地是一条完整链路：浮点 PyTorch 模型 →「PTQ 量化 → omg 离线转换 → CANNPAK 打包」→ 麒麟端侧可加载的离线模型（.omc / 单 bin）。这条链路在 Kirin9030 上落地时，反复出现且最耗时的是一批平台专属问题：W4 仅支持 UINT4 导致权重越界（CompressInt4ToInt8 ... out of range）、omg 必须在容器内跑（宿主 glibc 不足）、拆分子图需替换网格权重、offset/att_mask 需 int32 导出再转 float 才能保住端侧精度等。以 ASR 模型（encoder / decoder / 标点）为代表，上述诊断与修复方法已在 Kirin9030 端侧量化实战中沉淀成熟，但散落在工程目录和个人经验里，缺乏标准化、可触发、可复用的 Agent Skill 承载，新成员遇到同类问题只能重复试错。新增 model-infer-harmony，即为补齐端侧（harmony）部署这一空白，把麒麟端侧 ASR 量化与模型转换的全流程方法论固化为可复用 Skill。 ## 二、价值/作用 - 补齐端侧域：CANNBot 在 HarmonyOS / 麒麟端侧模型落地场景下，从「无 Skill 可用」到具备标准化的量化与模型转换能力。 - 方法论平台/模型解耦、经验可迁移：方法论沉淀自 Kirin9030 ASR 端侧量化实战，已做解耦处理；平台铁律与五阶段流程对其他端侧模型同样适用，Kirin9030 / ASR 仅作为示例标注。 - 降低落地门槛：开发者遇到 UINT4 越界 / MatMul don't support / GatherV2D INT64 / 容器 glibc / 端侧精度等问题时，有可直接触发的标准流程 + 报错速查，减少重复踩坑。 ## 三、设计方案 ### 领域定位与命名归入 model/ 域，命名 model-infer-harmony，定位为麒麟端侧 ASR 模型 4bit W4A16 量化与模型转换全流程知识库，面向 Kirin9030（HarmonyOS 端侧）。Skill 自包含 SKILL.md + references/（按需加载的知识），后续按需补充 scripts/（分析/转换工具）与 ST 评测用例。边界：本 Skill 面向端侧离线模型量化、转换与打包；不实现端侧推理引擎代码，不训练上游浮点模型。 ### 初期上线（已实现）：model-infer-harmony —— 麒麟端侧 ASR 4bit 量化与模型转换 - 适用场景：在 Kirin9030 上把浮点 PyTorch 的 ASR encoder / decoder / 标点（punc）量化为 W4A16 的 .omc；遇到 UINT4 越界、type MatMul don't support、GatherV2D INT64、容器 glibc 等 omg 转换报错或端侧精度问题；需要把多个 omc 打包成端侧可加载的单 bin。 - 能取得的效果： - 固化 Kirin9030 两条平台铁律（omg 必须容器内跑、W4 仅支持 UINT4）； - 给出五阶段量化流程方法论（PTQ 标定 → 导量化参数 → 导 ONNX → 图改写 → MatMul 补维 → 容器内 omg 转 omc）； - 给出 encoder / decoder / punc 三类模型的混合精度策略与各自专属坑（如 encoder 的 offset/att_mask int32 精度修复、decoder 必须 torch 导出落网格、punc 单输入切图与两遍标定）； - 覆盖典型报错的「现象 → 阶段 → 根因 → 对策」速查； - encoder 拆分流水线与 CANNPAK 打包说明。 - 边界：依赖用户提供浮点模型与真实校准数据；omg 需在 glibc ≥ 2.35 容器内执行；端侧精度仍需端侧实测验证；当前不含端侧推理引擎代码。 ### 设计原则 - 方法论平台/模型解耦 + 示例标注：通用流程与约束直接复用，Kirin9030 / ASR / 脚本命名均作为示例显式标注。 - 渐进式披露：SKILL.md 只写核心流程与路由，详细内容拆到 references/（pipeline / platform-9030 / model-strategies / split-and-packing / troubleshooting）。 - 门禁合规：已通过仓库 skill_validator.py（content / structure 子集零 error、零 warn）与行尾（LF）检查；无内部绝对路径泄漏、无私有模型权重/校准数据。 ### 后期规划 \| 规划 Skill / 内容（暂定） \| 方向 \| \| --- \| --- \| \| model-infer-harmony 端侧推理章节 \| 补充 CANNPAK 加载、asr_init_from_packed 端侧调用范式 \| \| 9020 / 9030 差异专项 \| 不同麒麟端侧平台量化链路差异对照（INT4 vs UINT4 等） \| \| 更多端侧模型类型 \| 扩展 ASR 以外的端侧模型量化与转换经验 \| \| scripts/ 脚本化 \| 把 s1_ptq / s3_export / s4_buwei 等关键步骤确定性脚本化 \| \| ST evals + quickstart \| 配套触发 / 边界 / 抗干扰评测用例与快速上手文档 \| ## 💡 备注初期 Skill model-infer-harmony 已提 PR：cann/cannbot-skills!472，已通过 skill_validator（content/structure 零 error/warn）与行尾检查，待 review。 See merge request: cann/cannbot-skills!472	2 天前
ops-lab	fix(ops): crash-debug 和 ops-lab 文档链接路径修复 Co-authored-by: xutianze<xutianze2@huawei.com> # message auto-generated for no-merge-commit merge: !449 merge fix/issue-330-crash-debug-ops-lab-path into master fix(ops): crash-debug 和 ops-lab 文档链接路径修复 Created-by: xutianze Commit-by: xutianze Merged-by: cann-robot Description: ## 描述修复 2 个文件中的文档链接路径错误： 1. `ops/ascendc-crash-debug/references/memcheck/automated_workflow.md:322` - 修复前：`[SKILL.md](./SKILL.md)` → 解析为 `memcheck/SKILL.md`（不存在） - 修复后：`[SKILL.md](../../SKILL.md)` → 解析为 `ascendc-crash-debug/SKILL.md`（正确） - 原因：`automated_workflow.md` 在 `references/memcheck/` 子目录下，需向上两级才能到达 skill 根目录 2. `ops-lab/tilelang-to-ascendc/skills/tilelang2ascend-translator/references/dsl2Ascendc_compute_cv.md:43` - 修复前：链接指向 `/Users/wzz/Desktop/Research/AscendOpGenAgent/...`（开发者本地绝对路径） - 修复后：移除链接，仅保留内联代码引用 ` archive_tasks/... `- 原因：本地绝对路径泄漏到仓库，其他用户无法访问 ## 关联的Issue [#330 crash-debug 和 ops-lab 文档链接路径错误](https://gitcode.com/cann/cannbot-skills/issues/330) ## 测试 - [x] 修改后` automated_workflow.md `中 SKILL.md 链接指向正确文件 - [x] 修改后` dsl2Ascendc_compute_cv.md` 中不再包含本地绝对路径 ## 文档更新修复了 crash-debug 和 ops-lab 模块的文档链接路径。 ## 类型标签 - [x] 🐛 Bug 修复 See merge request: cann/cannbot-skills!449	5 天前
ops	ascend-ut-developer适配custom Co-authored-by: sky-zyh<zhangyuhan45@huawei.com> # message auto-generated for no-merge-commit merge: !454 merge zyh into master ut skill custom 自定义检测跳过问卷 Created-by: sky-zyh Commit-by: sky-zyh Merged-by: cann-robot Description: ## 描述 feat(ascendc-ut-develop): ut skill custom 自定义检测跳过问卷为registry-invoke-template中的build.sh添加--cov选项以及对应修改以便于custom自定义算子工程触发ut时生成覆盖率报告 ## 关联的Issue ## 测试 <!--描述进行了哪些测试来验证你的改动。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🌟 新特性 - [ ] ✨ 特性增强 - [ ] 🐛 Bug 修复 - [ ] ⚡ 性能优化 - [ ] 🧪 测试用例 - [ ] 📦 构建 / CI - [ ] 📝 文档更新 - [ ] 🔧 配置变更 - [ ] ⬆️ 依赖升级 - [ ] 🔒 安全修复 - [ ] ♻️ 代码重构 - [ ] 🧹 代码清理 - [ ] ❓ 其他，请描述： ## 流水线故障排查 <!-- 如果下方的流水线检查未通过，可参考以下指引进行自助修复 --> > UT_Test 未通过？ > 请在下方流水线表格的 UT_Test 行，点击右侧的 `>>>>>` 下载 CANNBot-skills UT 测试报告（HTML 格式）。 > 打开报告后，展开页面中的「UT Test 失败修复指南」，复制其中的提示词并粘贴给 Agent，Agent 将根据日志自动定位并修复问题。 > > 示例： > ![UT_Test下载示例](pipeline-ut-test-download-link.png) See merge request: cann/cannbot-skills!454	1 天前
plugins-community	feat: 新增 install-helper 交互式安装助手，支持双轨制安装（完整插件 + Agent Skills 标准） Co-authored-by: yanhf<yanhaifeng5@huawei.com> # message auto-generated for no-merge-commit merge: !388 merge fix_bug into master feat: 新增 install-helper 交互式安装助手，支持双轨制安装（完整插件 + Agent Skills 标准） Created-by: yanhf Commit-by: yanhf Merged-by: cann-robot Description: ### 概述本 PR 新增 `install-helper` 交互式安装助手 CLI 工具，并全面优化 README 安装文档和 CHANGELOG 记录，为 CANNBot Skills 提供一键式安装体验。 ### 主要变更 #### 1. 新增 install-helper CLI 工具（`plugins-community/install-helper/`）发布到 npm 为 `@cannbot-ai/install-helper@1.0.3`，提供完整的插件/Skill 安装生命周期管理： - 9 个命令：`init`（交互式向导）、`install`、`uninstall`、`update`、`list`、`status`、`info`、`doctor --fix`（健康检查+自动修复）、`lang`（语言切换） - i18n 国际化：支持中文（zh_CN）和英文（en_US），i18n 字符串外置为 JSON 文件 - 插件注册表：通过 `plugins.d/.yml` 声明式管理 10 个官方插件的元数据 - Skill 扫描器：运行时递归扫描 `SKILL.md` frontmatter，自动发现 88 个独立 Skill，支持 24 小时缓存 - 仓库管理：自动检测/克隆 cannbot-skills 仓库，支持 `CANNBOT_REPO_PATH` 环境变量和 `~/.cannbot/repo` 缓存 - 多工具支持：自动检测 OpenCode / Claude Code / Trae / Cursor / Copilot - Agent Skills 标准兼容：支持 `npx skills add` 开放标准，Skill 可安装到 70+ 种 AI 编程工具 - 安全改进：卸载时保护 AI 工具配置目录、统一缓存目录路径解析、`--tool` 和 `--level` 参数校验 #### 2. 新增顶层安装脚本（`install.sh`）支持 `curl -fsSL https://raw.gitcode.com/cann/cannbot-skills/raw/master/install.sh \| bash` 一键安装，自动检查 Node.js/npm 环境并全局安装 install-helper。 #### 3. README.md 全面优化 - 安装方式表格化：curl / npx / npm 三种方式一目了然 - 双轨制安装：完整插件安装（install-helper）与独立 Skill 安装（`npx skills add`，遵循 Agent Skills 开放标准）清晰分离 - Agent Skills 标准支持：新增 `npx skills add` 安装方式，支持 OpenCode / Claude Code / Trae / Cursor - 安装指南统一命名：消除"方式一/二/三"与"完整安装/独立 Skill 安装"的命名不一致 - 手动安装脚本增加具体示例：以 `ops-direct-invoke` 为例演示 `init.sh` 用法 - 目录树更新：`plugins-community/` 下新增 `install-helper/` 条目 - 最新动态更新*：基于已合入主线 commit 更新最近两周动态 #### 4. CHANGELOG.md 补充 - 新增【2026-06-25】install-helper CLI 工具、install.sh 脚本、README 优化 - 补充已合入主线缺失条目（06-18 ~ 06-24），按日期倒序排列 #### 5. 其他 - `AGENTS.md`：更新项目结构，`install-helper/` 归入 `plugins-community/` - `.gitignore`：排除外部克隆仓库（asc-devkit/cann-samples/tilelang-ascend/pypto），防止误提交 ### 文件变更统计 - 190 个文件变更，+19591 行 / -2392 行 - 新增 `plugins-community/install-helper/`（~4,400 行 TypeScript + 配置文件） - 新增 `install.sh`（124 行） - 修改 `README.md`、`CHANGELOG.md`、`AGENTS.md`、`.gitignore` ### 测试 - ✅ `npm run build` 构建通过 - ✅ `install-helper --version` 输出 `1.0.3` - ✅ `npx skills add https://gitcode.com/cann/cannbot-skills.git --list` 发现 88 个 Skill - ✅ `npx skills add ... --skill ascendc-tiling-design --agent opencode` 安装成功 - ✅ npm 发布成功（`@cannbot-ai/install-helper@1.0.3`） See merge request: cann/cannbot-skills!388	3 天前
plugins-official	fix(ops-registry-invoke): 删除 task-prompts.md 1.4 测试设计中重复/游离的代码块结尾 Co-authored-by: jiangyixuan2<124090275@link.cuhk.edu.cn> # message auto-generated for no-merge-commit merge: !482 merge fix/issue354-remove-duplicate-code-block into master fix(ops-registry-invoke): 删除 task-prompts.md 1.4 测试设计中重复/游离的代码块结尾 Created-by: jiangyixuan2 Commit-by: jiangyixuan2 Merged-by: cann-robot Description: ## 描述 Issue #354 反馈 `plugins-official/ops-registry-invoke/workflow/resources/task-prompts.md` 的 1.4 测试设计段落中，`【主 Agent 处理规则】` 出现了两次： - 第一次（第 388-393 行）：正常，在代码块内并正确关闭 JSON（`" }`）和闭合 `` `。 - 第二次（第 395-400 行）：游离在代码块之外，且末尾的` " } `是非法的 JSON/文本碎片。这会导致调用方（LLM）解析该 prompt 时，末尾多出一个无头无尾的 JSON 片段，可能破坏 JSON 解析或导致 prompt 被截断。 ## 变更内容删除重复/游离的第二个段落（7 行，含其前的空行）：` -【主 Agent 处理规则】（供调用方参考、非本任务执行项） -- 状态=✅ → 若 1.3R 也已通过则进入 CP2 用户确认；否则等待 1.3R 通过后再触发 CP2 -- 状态=❌（含日志摘要中报告 REQUIREMENTS/spec 冲突）→ 流程终止，向用户报告冲突详情。spec 已通过校验 + 人工 review，若 REQUIREMENTS 仍与 spec-owned 字段冲突，属于流程异常，禁止自动修复 -- 禁止把 ❌ 报告或冲突日志直接抛给用户 - " -} `保留首个正确的` 【主 Agent 处理规则】 `段落及闭合的` ``，使 1.4 测试设计代码块结构与其上方的 1.3R 段落保持一致。 ## 变更影响 - 修复后 1.4 测试设计段落的 JSON 代码块完整闭合，不再有游离碎片 - 不改变测试设计的实际逻辑与验收标准（首个段落内容完整保留） - 仅影响` ops-registry-invoke `插件，其他插件的` task-prompts.md` 已确认无此问题 ## 关联 Issue Closes #354 See merge request: cann/cannbot-skills!482	1 天前
tests	test(install): 容忍 agentless 插件并修复 cleanup 误删源码配置 Co-authored-by: yanhf<yanhaifeng5@huawei.com> # message auto-generated for no-merge-commit merge: !478 merge pr_465 into master test(install): 容忍 agentless 插件并修复 cleanup 误删源码配置 Created-by: yanhf Commit-by: yanhf Merged-by: cann-robot Description: ## 描述本 PR 针对 PR #465（refactor: 将 triton-op-generator 的 install.sh 重命名为 init.sh 并对齐 CLI）线上 UT 未通过的问题，修复测试套件中两处缺陷，使 `./tests/run-tests.sh --fast` 恢复全绿。 ### 背景 PR #465 把 `plugins-official/triton-op-generator/install.sh` 重命名为 `init.sh` 后，`unit/install/test-init-install.sh` 开始遍历到该目录并按"团队（team）"契约对其校验。但 triton-op-generator 是单插件安装器，仅安装 skills、不安装 agents，不满足团队的 `agents/` 目录、`INCLUDED_AGENT_PATTERN`、init.sh 可执行位等要求，导致 4 项硬失败： - `init.sh is executable`（git 模式 100644，非 100755） - `agents/ exists` - `agents/ has .md files` - `INCLUDED_AGENT_PATTERN not found` 改名前 triton 仅有 `install.sh`，被 `[ -f .../init.sh ]` 判断跳过，从未进入校验；改名为 `init.sh` 后校验全部触发，属于测试侧的误判（triton 语义上不是 team）。 ### 改动内容 1. `tests/unit/install/test-init-install.sh` — 容忍 agentless 插件按"有无 `agents/` 目录"分流，仅对真正承载 agents 的团队执行 agent 相关硬校验： - Check 1（executable）：有 `agents/`→保持硬失败；无→`print_warn`（与既有 shebang 的 warn-only 处理一致） - Check 2（agents 目录与文件）：用 `if [ -d "$team_dir/agents" ]` 包裹，无则 `print_info` 跳过 - Check 5（INCLUDED_AGENT_PATTERN）：无 `agents/`→`print_info` 跳过；有则维持"缺失即硬失败" 效果：triton 仍被校验 init.sh 存在性、shebang、AGENTS.md、INCLUDED_SKILLS 引用等基础项，仅跳过与其语义不符的 agent 校验。9 个含 agents/ 的现有团队校验逻辑完全不变。 2. `tests/behavior/install/test-init-behavior.sh` — 修复 cleanup 误删源码配置 `cleanup_team_artifacts()` 原默认 `dir="${1:-$TEAM_DIR}"`，8 处无参调用（main 预清理/收尾、global 场景 trap 与结尾）会把 `rm -rf` 落到真实插件源码树 `$TEAM_DIR` 上，误删 `ops-direct-invoke-flash` 已提交的 `.claude/`、`.opencode/` 配置（6 个 tracked 文件）。实际上 init.sh 在所有场景只写入临时目录（project→`$tmp_pwd`，global→`$tmp_home`），从不写 `$TEAM_DIR`，这些无参调用既多余又破坏性。修复：加守卫——无参或目标等于 `$TEAM_DIR` 时直接 `return 0`，只清理显式传入的临时目录。13 处传 `$tmp_pwd` 的调用行为不变；8 处无参调用变为安全 no-op。 ## 关联的Issue 关联 PR #465：refactor(triton-op-generator): 将 install.sh 重命名为 init.sh 并将 CLI 与其他插件对齐 ## 测试 - `./tests/run-tests.sh --fast`：12 passed / 0 failed（231s） - `unit/install/test-init-install.sh`：189 passed，triton 仅剩 1 条 warn（`init.sh is not executable`），不再阻断 - `behavior/install/test-init-behavior.sh`：1068 passed / 16 warnings（215s），其余用例无回归 - 回归验证：运行 behavior 测试后 `git status` 仅含本 PR 两个测试文件改动，`ops-direct-invoke-flash/.claude`、`.opencode` 6 个 tracked 文件完好，确认 cleanup bug 已修复 ## 文档更新无 ## 类型标签 - [ ] 🌟 新特性 - [ ] ✨ 特性增强 - [x] 🐛 Bug 修复 - [ ] ⚡ 性能优化 - [x] 🧪 测试用例 - [ ] 📦 构建 / CI - [ ] 📝 文档更新 - [ ] 🔧 配置变更 - [ ] ⬆️ 依赖升级 - [ ] 🔒 安全修复 - [ ] ♻️ 代码重构 - [ ] 🧹 代码清理 - [ ] ❓ 其他，请描述： ## 流水线故障排查 <!-- 如果下方的流水线检查未通过，可参考以下指引进行自助修复 --> > UT_Test 未通过？ > 请在下方流水线表格的 UT_Test 行，点击右侧的 `>>>>>` 下载 CANNBot-skills UT 测试报告（HTML 格式）。 > 打开报告后，展开页面中的「UT Test 失败修复指南」，复制其中的提示词并粘贴给 Agent，Agent 将根据日志自动定位并修复问题。 > > 示例： > ![UT_Test下载示例](pipeline-ut-test-download-link.png) See merge request: cann/cannbot-skills!478	1 天前
.gitattributes	feat: add CRLF line-ending detection test and .gitattributes Co-authored-by: yanhf<yanhaifeng5@huawei.com> # message auto-generated for no-merge-commit merge: !183 merge master into master feat: add CRLF line-ending detection test and .gitattributes Created-by: yanhf Commit-by: yanhf Merged-by: cann-robot Description: 新特性 New Features - 【代码看护】新增行尾检测单元测试 tests/unit/test-line-endings.sh：扫描仓库中所有文本文件，检测 DOS 风格 CRLF 行尾，发现时报告 FAIL。已集成到 --fast 默认拦截链，排在所有单测首位执行。 - 【代码看护】新增 .gitattributes：对所有文本文件类型（.c .h .py .sh .md .yaml .json 等）强制 eol=lf，从 Git 层防止未来提交引入 CRLF 行尾。问题修复 Bug Fix - 【代码看护】修复 22 个存量文件的 CRLF 行尾问题：涉及 ops/ascendc-direct-invoke-template、ops/ascendc-registry-invoke-template、ops/ascendc-code-review、plugins- official/ops-direct-invoke、model/teams/infer-model-optimize-team 等模块。使用 dos2unix 统一转换为 Unix LF。 --- 关联的Issue --- 测试 - 新增的 tests/unit/test-line-endings.sh 已通过 20 项场景验证（含 CRLF 检测、二进制排除、目录排除、混合行尾、空文件等边缘用例），全部 PASS - run-tests.sh --fast 集成验证通过，测试项共 10 个，新测试排首位并 PASS - 修复后真实仓库扫描 882 个文件，确认无 CRLF 残留 --- 文档更新无 --- 类型标签 - [x] 🌟 新特性 - [x] 🐛 Bug 修复 - [x] 🧪 测试用例 - [x] 🔧 配置变更 See merge request: cann/cannbot-skills!183	1 个月前
.gitignore	feat: 新增 install-helper 交互式安装助手，支持双轨制安装（完整插件 + Agent Skills 标准） Co-authored-by: yanhf<yanhaifeng5@huawei.com> # message auto-generated for no-merge-commit merge: !388 merge fix_bug into master feat: 新增 install-helper 交互式安装助手，支持双轨制安装（完整插件 + Agent Skills 标准） Created-by: yanhf Commit-by: yanhf Merged-by: cann-robot Description: ### 概述本 PR 新增 `install-helper` 交互式安装助手 CLI 工具，并全面优化 README 安装文档和 CHANGELOG 记录，为 CANNBot Skills 提供一键式安装体验。 ### 主要变更 #### 1. 新增 install-helper CLI 工具（`plugins-community/install-helper/`）发布到 npm 为 `@cannbot-ai/install-helper@1.0.3`，提供完整的插件/Skill 安装生命周期管理： - 9 个命令：`init`（交互式向导）、`install`、`uninstall`、`update`、`list`、`status`、`info`、`doctor --fix`（健康检查+自动修复）、`lang`（语言切换） - i18n 国际化：支持中文（zh_CN）和英文（en_US），i18n 字符串外置为 JSON 文件 - 插件注册表：通过 `plugins.d/.yml` 声明式管理 10 个官方插件的元数据 - Skill 扫描器：运行时递归扫描 `SKILL.md` frontmatter，自动发现 88 个独立 Skill，支持 24 小时缓存 - 仓库管理：自动检测/克隆 cannbot-skills 仓库，支持 `CANNBOT_REPO_PATH` 环境变量和 `~/.cannbot/repo` 缓存 - 多工具支持：自动检测 OpenCode / Claude Code / Trae / Cursor / Copilot - Agent Skills 标准兼容：支持 `npx skills add` 开放标准，Skill 可安装到 70+ 种 AI 编程工具 - 安全改进：卸载时保护 AI 工具配置目录、统一缓存目录路径解析、`--tool` 和 `--level` 参数校验 #### 2. 新增顶层安装脚本（`install.sh`）支持 `curl -fsSL https://raw.gitcode.com/cann/cannbot-skills/raw/master/install.sh \| bash` 一键安装，自动检查 Node.js/npm 环境并全局安装 install-helper。 #### 3. README.md 全面优化 - 安装方式表格化：curl / npx / npm 三种方式一目了然 - 双轨制安装：完整插件安装（install-helper）与独立 Skill 安装（`npx skills add`，遵循 Agent Skills 开放标准）清晰分离 - Agent Skills 标准支持：新增 `npx skills add` 安装方式，支持 OpenCode / Claude Code / Trae / Cursor - 安装指南统一命名：消除"方式一/二/三"与"完整安装/独立 Skill 安装"的命名不一致 - 手动安装脚本增加具体示例：以 `ops-direct-invoke` 为例演示 `init.sh` 用法 - 目录树更新：`plugins-community/` 下新增 `install-helper/` 条目 - 最新动态更新*：基于已合入主线 commit 更新最近两周动态 #### 4. CHANGELOG.md 补充 - 新增【2026-06-25】install-helper CLI 工具、install.sh 脚本、README 优化 - 补充已合入主线缺失条目（06-18 ~ 06-24），按日期倒序排列 #### 5. 其他 - `AGENTS.md`：更新项目结构，`install-helper/` 归入 `plugins-community/` - `.gitignore`：排除外部克隆仓库（asc-devkit/cann-samples/tilelang-ascend/pypto），防止误提交 ### 文件变更统计 - 190 个文件变更，+19591 行 / -2392 行 - 新增 `plugins-community/install-helper/`（~4,400 行 TypeScript + 配置文件） - 新增 `install.sh`（124 行） - 修改 `README.md`、`CHANGELOG.md`、`AGENTS.md`、`.gitignore` ### 测试 - ✅ `npm run build` 构建通过 - ✅ `install-helper --version` 输出 `1.0.3` - ✅ `npx skills add https://gitcode.com/cann/cannbot-skills.git --list` 发现 88 个 Skill - ✅ `npx skills add ... --skill ascendc-tiling-design --agent opencode` 安装成功 - ✅ npm 发布成功（`@cannbot-ai/install-helper@1.0.3`） See merge request: cann/cannbot-skills!388	3 天前
AGENTS.md	feat: 新增 install-helper 交互式安装助手，支持双轨制安装（完整插件 + Agent Skills 标准） Co-authored-by: yanhf<yanhaifeng5@huawei.com> # message auto-generated for no-merge-commit merge: !388 merge fix_bug into master feat: 新增 install-helper 交互式安装助手，支持双轨制安装（完整插件 + Agent Skills 标准） Created-by: yanhf Commit-by: yanhf Merged-by: cann-robot Description: ### 概述本 PR 新增 `install-helper` 交互式安装助手 CLI 工具，并全面优化 README 安装文档和 CHANGELOG 记录，为 CANNBot Skills 提供一键式安装体验。 ### 主要变更 #### 1. 新增 install-helper CLI 工具（`plugins-community/install-helper/`）发布到 npm 为 `@cannbot-ai/install-helper@1.0.3`，提供完整的插件/Skill 安装生命周期管理： - 9 个命令：`init`（交互式向导）、`install`、`uninstall`、`update`、`list`、`status`、`info`、`doctor --fix`（健康检查+自动修复）、`lang`（语言切换） - i18n 国际化：支持中文（zh_CN）和英文（en_US），i18n 字符串外置为 JSON 文件 - 插件注册表：通过 `plugins.d/.yml` 声明式管理 10 个官方插件的元数据 - Skill 扫描器：运行时递归扫描 `SKILL.md` frontmatter，自动发现 88 个独立 Skill，支持 24 小时缓存 - 仓库管理：自动检测/克隆 cannbot-skills 仓库，支持 `CANNBOT_REPO_PATH` 环境变量和 `~/.cannbot/repo` 缓存 - 多工具支持：自动检测 OpenCode / Claude Code / Trae / Cursor / Copilot - Agent Skills 标准兼容：支持 `npx skills add` 开放标准，Skill 可安装到 70+ 种 AI 编程工具 - 安全改进：卸载时保护 AI 工具配置目录、统一缓存目录路径解析、`--tool` 和 `--level` 参数校验 #### 2. 新增顶层安装脚本（`install.sh`）支持 `curl -fsSL https://raw.gitcode.com/cann/cannbot-skills/raw/master/install.sh \| bash` 一键安装，自动检查 Node.js/npm 环境并全局安装 install-helper。 #### 3. README.md 全面优化 - 安装方式表格化：curl / npx / npm 三种方式一目了然 - 双轨制安装：完整插件安装（install-helper）与独立 Skill 安装（`npx skills add`，遵循 Agent Skills 开放标准）清晰分离 - Agent Skills 标准支持：新增 `npx skills add` 安装方式，支持 OpenCode / Claude Code / Trae / Cursor - 安装指南统一命名：消除"方式一/二/三"与"完整安装/独立 Skill 安装"的命名不一致 - 手动安装脚本增加具体示例：以 `ops-direct-invoke` 为例演示 `init.sh` 用法 - 目录树更新：`plugins-community/` 下新增 `install-helper/` 条目 - 最新动态更新*：基于已合入主线 commit 更新最近两周动态 #### 4. CHANGELOG.md 补充 - 新增【2026-06-25】install-helper CLI 工具、install.sh 脚本、README 优化 - 补充已合入主线缺失条目（06-18 ~ 06-24），按日期倒序排列 #### 5. 其他 - `AGENTS.md`：更新项目结构，`install-helper/` 归入 `plugins-community/` - `.gitignore`：排除外部克隆仓库（asc-devkit/cann-samples/tilelang-ascend/pypto），防止误提交 ### 文件变更统计 - 190 个文件变更，+19591 行 / -2392 行 - 新增 `plugins-community/install-helper/`（~4,400 行 TypeScript + 配置文件） - 新增 `install.sh`（124 行） - 修改 `README.md`、`CHANGELOG.md`、`AGENTS.md`、`.gitignore` ### 测试 - ✅ `npm run build` 构建通过 - ✅ `install-helper --version` 输出 `1.0.3` - ✅ `npx skills add https://gitcode.com/cann/cannbot-skills.git --list` 发现 88 个 Skill - ✅ `npx skills add ... --skill ascendc-tiling-design --agent opencode` 安装成功 - ✅ npm 发布成功（`@cannbot-ai/install-helper@1.0.3`） See merge request: cann/cannbot-skills!388	3 天前
CHANGELOG.md	feat: 新增 install-helper 交互式安装助手，支持双轨制安装（完整插件 + Agent Skills 标准） Co-authored-by: yanhf<yanhaifeng5@huawei.com> # message auto-generated for no-merge-commit merge: !388 merge fix_bug into master feat: 新增 install-helper 交互式安装助手，支持双轨制安装（完整插件 + Agent Skills 标准） Created-by: yanhf Commit-by: yanhf Merged-by: cann-robot Description: ### 概述本 PR 新增 `install-helper` 交互式安装助手 CLI 工具，并全面优化 README 安装文档和 CHANGELOG 记录，为 CANNBot Skills 提供一键式安装体验。 ### 主要变更 #### 1. 新增 install-helper CLI 工具（`plugins-community/install-helper/`）发布到 npm 为 `@cannbot-ai/install-helper@1.0.3`，提供完整的插件/Skill 安装生命周期管理： - 9 个命令：`init`（交互式向导）、`install`、`uninstall`、`update`、`list`、`status`、`info`、`doctor --fix`（健康检查+自动修复）、`lang`（语言切换） - i18n 国际化：支持中文（zh_CN）和英文（en_US），i18n 字符串外置为 JSON 文件 - 插件注册表：通过 `plugins.d/.yml` 声明式管理 10 个官方插件的元数据 - Skill 扫描器：运行时递归扫描 `SKILL.md` frontmatter，自动发现 88 个独立 Skill，支持 24 小时缓存 - 仓库管理：自动检测/克隆 cannbot-skills 仓库，支持 `CANNBOT_REPO_PATH` 环境变量和 `~/.cannbot/repo` 缓存 - 多工具支持：自动检测 OpenCode / Claude Code / Trae / Cursor / Copilot - Agent Skills 标准兼容：支持 `npx skills add` 开放标准，Skill 可安装到 70+ 种 AI 编程工具 - 安全改进：卸载时保护 AI 工具配置目录、统一缓存目录路径解析、`--tool` 和 `--level` 参数校验 #### 2. 新增顶层安装脚本（`install.sh`）支持 `curl -fsSL https://raw.gitcode.com/cann/cannbot-skills/raw/master/install.sh \| bash` 一键安装，自动检查 Node.js/npm 环境并全局安装 install-helper。 #### 3. README.md 全面优化 - 安装方式表格化：curl / npx / npm 三种方式一目了然 - 双轨制安装：完整插件安装（install-helper）与独立 Skill 安装（`npx skills add`，遵循 Agent Skills 开放标准）清晰分离 - Agent Skills 标准支持：新增 `npx skills add` 安装方式，支持 OpenCode / Claude Code / Trae / Cursor - 安装指南统一命名：消除"方式一/二/三"与"完整安装/独立 Skill 安装"的命名不一致 - 手动安装脚本增加具体示例：以 `ops-direct-invoke` 为例演示 `init.sh` 用法 - 目录树更新：`plugins-community/` 下新增 `install-helper/` 条目 - 最新动态更新*：基于已合入主线 commit 更新最近两周动态 #### 4. CHANGELOG.md 补充 - 新增【2026-06-25】install-helper CLI 工具、install.sh 脚本、README 优化 - 补充已合入主线缺失条目（06-18 ~ 06-24），按日期倒序排列 #### 5. 其他 - `AGENTS.md`：更新项目结构，`install-helper/` 归入 `plugins-community/` - `.gitignore`：排除外部克隆仓库（asc-devkit/cann-samples/tilelang-ascend/pypto），防止误提交 ### 文件变更统计 - 190 个文件变更，+19591 行 / -2392 行 - 新增 `plugins-community/install-helper/`（~4,400 行 TypeScript + 配置文件） - 新增 `install.sh`（124 行） - 修改 `README.md`、`CHANGELOG.md`、`AGENTS.md`、`.gitignore` ### 测试 - ✅ `npm run build` 构建通过 - ✅ `install-helper --version` 输出 `1.0.3` - ✅ `npx skills add https://gitcode.com/cann/cannbot-skills.git --list` 发现 88 个 Skill - ✅ `npx skills add ... --skill ascendc-tiling-design --agent opencode` 安装成功 - ✅ npm 发布成功（`@cannbot-ai/install-helper@1.0.3`） See merge request: cann/cannbot-skills!388	3 天前
LICENSE	Initial commit	3 个月前
OAT.xml	添加OAT开源合规头文件并优化交付件命名 Co-authored-by: Junren6415<joestranberg99@gmail.com> # message auto-generated for no-merge-commit merge: !148 merge feat_oat_header into master 添加OAT开源合规头文件并优化交付件命名 Created-by: Junren6415 Commit-by: Junren6415 Merged-by: cann-robot Description: 添加OAT开源合规头文件, 并优化代码检视交付件命名 See merge request: cann/skills!148	1 个月前
README.md	feat: 新增 install-helper 交互式安装助手，支持双轨制安装（完整插件 + Agent Skills 标准） Co-authored-by: yanhf<yanhaifeng5@huawei.com> # message auto-generated for no-merge-commit merge: !388 merge fix_bug into master feat: 新增 install-helper 交互式安装助手，支持双轨制安装（完整插件 + Agent Skills 标准） Created-by: yanhf Commit-by: yanhf Merged-by: cann-robot Description: ### 概述本 PR 新增 `install-helper` 交互式安装助手 CLI 工具，并全面优化 README 安装文档和 CHANGELOG 记录，为 CANNBot Skills 提供一键式安装体验。 ### 主要变更 #### 1. 新增 install-helper CLI 工具（`plugins-community/install-helper/`）发布到 npm 为 `@cannbot-ai/install-helper@1.0.3`，提供完整的插件/Skill 安装生命周期管理： - 9 个命令：`init`（交互式向导）、`install`、`uninstall`、`update`、`list`、`status`、`info`、`doctor --fix`（健康检查+自动修复）、`lang`（语言切换） - i18n 国际化：支持中文（zh_CN）和英文（en_US），i18n 字符串外置为 JSON 文件 - 插件注册表：通过 `plugins.d/.yml` 声明式管理 10 个官方插件的元数据 - Skill 扫描器：运行时递归扫描 `SKILL.md` frontmatter，自动发现 88 个独立 Skill，支持 24 小时缓存 - 仓库管理：自动检测/克隆 cannbot-skills 仓库，支持 `CANNBOT_REPO_PATH` 环境变量和 `~/.cannbot/repo` 缓存 - 多工具支持：自动检测 OpenCode / Claude Code / Trae / Cursor / Copilot - Agent Skills 标准兼容：支持 `npx skills add` 开放标准，Skill 可安装到 70+ 种 AI 编程工具 - 安全改进：卸载时保护 AI 工具配置目录、统一缓存目录路径解析、`--tool` 和 `--level` 参数校验 #### 2. 新增顶层安装脚本（`install.sh`）支持 `curl -fsSL https://raw.gitcode.com/cann/cannbot-skills/raw/master/install.sh \| bash` 一键安装，自动检查 Node.js/npm 环境并全局安装 install-helper。 #### 3. README.md 全面优化 - 安装方式表格化：curl / npx / npm 三种方式一目了然 - 双轨制安装：完整插件安装（install-helper）与独立 Skill 安装（`npx skills add`，遵循 Agent Skills 开放标准）清晰分离 - Agent Skills 标准支持：新增 `npx skills add` 安装方式，支持 OpenCode / Claude Code / Trae / Cursor - 安装指南统一命名：消除"方式一/二/三"与"完整安装/独立 Skill 安装"的命名不一致 - 手动安装脚本增加具体示例：以 `ops-direct-invoke` 为例演示 `init.sh` 用法 - 目录树更新：`plugins-community/` 下新增 `install-helper/` 条目 - 最新动态更新*：基于已合入主线 commit 更新最近两周动态 #### 4. CHANGELOG.md 补充 - 新增【2026-06-25】install-helper CLI 工具、install.sh 脚本、README 优化 - 补充已合入主线缺失条目（06-18 ~ 06-24），按日期倒序排列 #### 5. 其他 - `AGENTS.md`：更新项目结构，`install-helper/` 归入 `plugins-community/` - `.gitignore`：排除外部克隆仓库（asc-devkit/cann-samples/tilelang-ascend/pypto），防止误提交 ### 文件变更统计 - 190 个文件变更，+19591 行 / -2392 行 - 新增 `plugins-community/install-helper/`（~4,400 行 TypeScript + 配置文件） - 新增 `install.sh`（124 行） - 修改 `README.md`、`CHANGELOG.md`、`AGENTS.md`、`.gitignore` ### 测试 - ✅ `npm run build` 构建通过 - ✅ `install-helper --version` 输出 `1.0.3` - ✅ `npx skills add https://gitcode.com/cann/cannbot-skills.git --list` 发现 88 个 Skill - ✅ `npx skills add ... --skill ascendc-tiling-design --agent opencode` 安装成功 - ✅ npm 发布成功（`@cannbot-ai/install-helper@1.0.3`） See merge request: cann/cannbot-skills!388	3 天前
install.sh	feat: 新增 install-helper 交互式安装助手，支持双轨制安装（完整插件 + Agent Skills 标准） Co-authored-by: yanhf<yanhaifeng5@huawei.com> # message auto-generated for no-merge-commit merge: !388 merge fix_bug into master feat: 新增 install-helper 交互式安装助手，支持双轨制安装（完整插件 + Agent Skills 标准） Created-by: yanhf Commit-by: yanhf Merged-by: cann-robot Description: ### 概述本 PR 新增 `install-helper` 交互式安装助手 CLI 工具，并全面优化 README 安装文档和 CHANGELOG 记录，为 CANNBot Skills 提供一键式安装体验。 ### 主要变更 #### 1. 新增 install-helper CLI 工具（`plugins-community/install-helper/`）发布到 npm 为 `@cannbot-ai/install-helper@1.0.3`，提供完整的插件/Skill 安装生命周期管理： - 9 个命令：`init`（交互式向导）、`install`、`uninstall`、`update`、`list`、`status`、`info`、`doctor --fix`（健康检查+自动修复）、`lang`（语言切换） - i18n 国际化：支持中文（zh_CN）和英文（en_US），i18n 字符串外置为 JSON 文件 - 插件注册表：通过 `plugins.d/.yml` 声明式管理 10 个官方插件的元数据 - Skill 扫描器：运行时递归扫描 `SKILL.md` frontmatter，自动发现 88 个独立 Skill，支持 24 小时缓存 - 仓库管理：自动检测/克隆 cannbot-skills 仓库，支持 `CANNBOT_REPO_PATH` 环境变量和 `~/.cannbot/repo` 缓存 - 多工具支持：自动检测 OpenCode / Claude Code / Trae / Cursor / Copilot - Agent Skills 标准兼容：支持 `npx skills add` 开放标准，Skill 可安装到 70+ 种 AI 编程工具 - 安全改进：卸载时保护 AI 工具配置目录、统一缓存目录路径解析、`--tool` 和 `--level` 参数校验 #### 2. 新增顶层安装脚本（`install.sh`）支持 `curl -fsSL https://raw.gitcode.com/cann/cannbot-skills/raw/master/install.sh \| bash` 一键安装，自动检查 Node.js/npm 环境并全局安装 install-helper。 #### 3. README.md 全面优化 - 安装方式表格化：curl / npx / npm 三种方式一目了然 - 双轨制安装：完整插件安装（install-helper）与独立 Skill 安装（`npx skills add`，遵循 Agent Skills 开放标准）清晰分离 - Agent Skills 标准支持：新增 `npx skills add` 安装方式，支持 OpenCode / Claude Code / Trae / Cursor - 安装指南统一命名：消除"方式一/二/三"与"完整安装/独立 Skill 安装"的命名不一致 - 手动安装脚本增加具体示例：以 `ops-direct-invoke` 为例演示 `init.sh` 用法 - 目录树更新：`plugins-community/` 下新增 `install-helper/` 条目 - 最新动态更新*：基于已合入主线 commit 更新最近两周动态 #### 4. CHANGELOG.md 补充 - 新增【2026-06-25】install-helper CLI 工具、install.sh 脚本、README 优化 - 补充已合入主线缺失条目（06-18 ~ 06-24），按日期倒序排列 #### 5. 其他 - `AGENTS.md`：更新项目结构，`install-helper/` 归入 `plugins-community/` - `.gitignore`：排除外部克隆仓库（asc-devkit/cann-samples/tilelang-ascend/pypto），防止误提交 ### 文件变更统计 - 190 个文件变更，+19591 行 / -2392 行 - 新增 `plugins-community/install-helper/`（~4,400 行 TypeScript + 配置文件） - 新增 `install.sh`（124 行） - 修改 `README.md`、`CHANGELOG.md`、`AGENTS.md`、`.gitignore` ### 测试 - ✅ `npm run build` 构建通过 - ✅ `install-helper --version` 输出 `1.0.3` - ✅ `npx skills add https://gitcode.com/cann/cannbot-skills.git --list` 发现 88 个 Skill - ✅ `npx skills add ... --skill ascendc-tiling-design --agent opencode` 安装成功 - ✅ npm 发布成功（`@cannbot-ai/install-helper@1.0.3`） See merge request: cann/cannbot-skills!388	3 天前

CANNBot Skills

📢 项目概述

项目定位

CANNBot 是面向 CANN 开发的用于提升开发效率的系列智能体，本仓库为其提供可复用的 Skills 模块，目前已覆盖 Ascend C / PyPTO / TileLang / Triton 算子开发流程和 NPU 模型推理端到端优化。

目标用户

CANN 社区开发者
昇腾 NPU 平台 AI 应用开发者
Ascend C / PyPTO / TileLang / Triton 算子开发者
使用昇腾 NPU 进行模型推理优化的开发者
希望贡献 Skills / Agents 的社区贡献者

🚀 快速开始

前置条件

Node.js 18+（终端运行 node --version 检查，未安装请前往官网下载）
以下任一 AI 编程工具：OpenCode / Claude Code / Trae / Cursor
CANN 开发环境（仅算子编译/运行类 Skills 需要，知识检索类不受影响）

安装

完整安装（推荐）

通过 install-helper 安装完整插件内容（Skills + Agents + Workflows + 工具链）：

方式	命令	说明
curl	`curl -fsSL https://raw.gitcode.com/cann/cannbot-skills/raw/master/install.sh \| bash`	一键安装（推荐）
npx	`npx @cannbot-ai/install-helper`	免安装运行
npm	`npm install -g @cannbot-ai/install-helper`	全局安装

安装后在项目目录运行 install-helper 启动交互式向导：

自动检测已安装的 AI 编程工具
选择安装类型（完整插件或 Skill）
选择要安装的插件或Skill（空格选择，回车确认）
确认并自动安装

独立 Skill 安装

通过 Agent Skills 标准安装单个 Skill：

# 浏览可用 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-tiling-design

安装后直接在 AI 工具中即可使用，无需额外配置。

独立 Skill 不含 Agents/Workflows/工具链，如需完整插件内容请使用上方完整安装。

安装后使用

安装完成后，在项目目录中启动你的 AI 编程工具，直接用自然语言描述需求即可：

你想做什么	可以这样说	用到的能力
开发一个算子	"帮我开发一个 Abs 算子，输入 float16，输出 float16"	Plugin: `ops-direct-invoke`
调试精度问题	"我的 Add 算子精度不达标，帮我排查一下"	Skill: `ascendc-precision-debug`
查阅 API 文档	"aclnnAdd 接口的参数和返回值是什么"	Skill: `ascendc-docs-search`
检查开发环境	"帮我检查一下当前的 CANN 开发环境"	Skill: `ascendc-env-check`
代码检视	"帮我检视这段 Kernel 代码是否符合规范"	Plugin: `ops-code-reviewer`

更多示例详见 Skills 使用样例。

遇到问题？运行 install-helper doctor --fix 自动检测并修复常见问题。

📦 安装指南

完整安装

install-helper 命令参考

命令	说明
`install-helper`	交互式安装向导
`install-helper install <name>`	安装指定插件或 Skill（自动识别）
`install-helper install --list`	按类别列出所有可用 Skills
`install-helper update [plugin]`	更新已安装的插件
`install-helper uninstall <plugin>`	卸载指定插件
`install-helper list`	查看可用场景及安装状态
`install-helper doctor --fix`	健康检查 + 自动修复
`install-helper lang set en_US`	切换语言

完整命令参考和详细文档：install-helper README

手动执行安装脚本

如果不使用 install-helper，也可以进入对应插件目录手动执行 init.sh 安装脚本。以安装 AscendC Kernel 直调插件到 OpenCode 为例：

cd plugins-official/ops-direct-invoke
bash init.sh project opencode

<tool> 支持 opencode / claude / trae / cursor / copilot，各插件的详细安装步骤参见对应插件目录下的 quickstart.md 文档。

独立 Skill 安装

本仓库的 Skills 遵循 Agent Skills 开放标准，可通过开源 skills CLI 安装到 70+ 种 AI 编程工具（OpenCode、Claude Code、Cursor、Codex、Trae 等）。

# 浏览可用 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-tiling-design

# 安装 Skill 到指定工具（支持 opencode / claude-code / trae / cursor 等）
npx skills add https://gitcode.com/cann/cannbot-skills.git --skill ascendc-env-check --skill npu-arch --agent opencode

# 安装全部 Skill 到所有已检测到的工具（非交互式）
npx skills add https://gitcode.com/cann/cannbot-skills.git --skill '*' --agent '*' -y

# 查看已安装的 Skills
npx skills list

# 卸载
npx skills remove ascendc-tiling-design

此方式仅安装独立 Skills。如需完整插件内容（Skills + Agents + Workflows + 工具链），请使用 install-helper 或 init.sh 脚本。

安装遇到问题？

运行 install-helper doctor --fix 自动检测并修复常见问题。

问题	解决方法
`install-helper` 报错	确认 Node.js >= 18：`node --version`
AI 工具无法识别 Skills	重启工具或新开会话
软链接失效	`install-helper doctor --fix`
网络问题	配置 GitCode SSH Key 或设置代理
CANN 环境未配置	仅影响代码编译/运行类 Skills，知识检索类不受影响

更多故障排查详见各场景对应的 quickstart 文档。

🔍 项目架构设计

整体架构

cannbot-skills/
├── ops/                             # 算子 Skills（正式版）
├── ops-lab/                         # 算子 Skills（实验 / 非正式版）
├── model/                           # 模型推理优化 Skills
├── plugins-official/                # 官方应用 Plugin
│   ├── ops-direct-invoke/           # AscendC Kernel 直调开发
│   ├── ops-registry-invoke/         # AscendC 算子注册调用开发
│   ├── pypto-op-orchestrator/       # PyPTO 算子开发
│   ├── catlass-op-generator/        # Catlass 算子直调开发
│   ├── ops-code-reviewer/           # 代码检视
│   ├── torch-compile/               # torch.compile 图模式
│   ├── model-infer-optimize/        # NPU 推理端到端优化流程
│   ├── triton-op-generator/         # Triton 算子代码生成与优化
│   └── tilelang-op-orchestrator/    # TileLang 算子开发
├── plugins-community/               # 社区 Plugin
│   ├── install-helper/              # CANNBot Install Helper 工具
│   ├── ops-easyasc-dsl/             # EasyASC DSL 算子开发
│   └── ops-qa-suite/                # 算子测试套件
├── infra/                           # 基础设施维护 Skills
└── tests/                           # 自动化测试框架

逻辑架构视图

项目遵循三层架构：Teams 编排 Agents，Agents 绑定 Skills。以下视图展示各层组件及其关联关系。

Ascend C 算子开发

╔══════════════════════════════════════════════════════════════════════════════╗
║                              TEAMS（应用编排层）                              ║
╠══════════════════════════════════════════════════════════════════════════════╣
║                                                                              ║
║  ┌─────────────────────────────┐        ┌─────────────────────────────┐      ║
║  │  ops-direct-invoke          │        │  ops-registry-invoke        │      ║
║  │  Kernel 直调开发流程         │        │  算子注册调用开发流程         │      ║
║  └──────┬──────┬──────┬────────┘        └──────┬──────┬──────┬────────┘      ║
║         │      │      │                        │      │      │               ║
╚═════════╪══════╪══════╪════════════════════════╪══════╪══════╪═══════════════╝
          │      │      │                        │      │      │
          ▼      ▼      ▼                        ▼      ▼      ▼
╔══════════════════════════════════════════════════════════════════════════════╗
║                             AGENTS（角色执行层）                              ║
╠══════════════════════════════════════════════════════════════════════════════╣
║                                                                              ║
║  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      ║
║  │  architect   │  │  developer   │  │  reviewer    │  │  tester      │      ║
║  │   方案设计    │  │   代码开发   │   │   代码检视   │  │   代码测试    │      ║
║  └──────────────┘  └──────────────┘  └──────────────┘  └──────────────┘      ║
║                                                                              ║
╚══════════════════════════════════════════════════════════════════════════════╝
             │ │ │ │       │ │ │ │       │ │ │ │       │ │ │ │
             ▼ ▼ ▼ ▼       ▼ ▼ ▼ ▼       ▼ ▼ ▼ ▼       ▼ ▼ ▼ ▼
╔═══════════════════════════════════════════════════════════════════════════════╗
║                             SKILLS（知识能力层）                               ║
╠═══════════════════════════════════════════════════════════════════════════════╣
║                                                                               ║
║  ┌─ 知识库类 ──────────────────────────────────────────────────────────────┐   ║
║  │  npu-arch             NPU 架构知识与芯片映射                             │   ║
║  │  tiling-design        Tiling 设计方法论                                  │  ║
║  │  api-best-practices   API 使用最佳实践                                   │  ║
║  │  ops-precision-standard 算子精度标准                                     │  ║
║  └─────────────────────────────────────────────────────────────────────────┘  ║
║                                                                               ║
║  ┌─ 工程模板类 ────────────────────────────────────────────────────────────┐   ║
║  │  registry-invoke-to-direct-invoke  注册算子直调改造模板                  │   ║
║  │  direct-invoke-template            Kernel直调工程模板                   │   ║
║  └────────────────────────────────────────────────────────────────────────┘   ║
║                                                                               ║
║  ┌─ 调试与测试类 ──────────────────────────────────────────────────────────┐   ║
║  │  precision-debug      精度调试与症状速查                                 │  ║
║  │  runtime-debug        运行时错误码解析                                   │  ║
║  │  crash-debug          卡死/崩溃调试、Coredump 分析                       │  ║
║  │  env-check            NPU 设备查询与环境验证                             │  ║
║  └────────────────────────────────────────────────────────────────────────┘   ║ 
║                                                                               ║
║  ┌─ 测试开发类 ────────────────────────────────────────────────────────────┐   ║
║  │  st-design            ST 测试用例设计                                   │   ║
║  │  ut-develop           UT 开发与覆盖率增强                               │   ║
║  │  code-review          代码检视规则                                      │   ║
║  └────────────────────────────────────────────────────────────────────────┘   ║
║                                                                               ║
║  ┌─ 工具辅助类 ────────────────────────────────────────────────────────────┐   ║
║  │  ops-profiling        算子性能采集分析                                   │  ║
║  │  task-focus           长任务聚焦防迷失                                   │  ║
║  └─────────────────────────────────────────────────────────────────────────┘  ║
║                                                                               ║
╚═══════════════════════════════════════════════════════════════════════════════╝

PyPTO 算子开发

╔══════════════════════════════════════════════════════════════════════════════╗
║                              TEAMS（应用编排层）                              ║
╠══════════════════════════════════════════════════════════════════════════════╣
║                                                                              ║
║                    ┌─────────────────────────────────┐                       ║
║                    │      pypto-op-orchestrator      │                       ║
║                    │      PyPTO 算子开发流程          │                       ║
║                    └──────┬──────────┬──────────┬────┘                       ║
║                           │          │          │                            ║
╚═══════════════════════════╪══════════╪══════════╪════════════════════════════╝
                            │          │          │
                            ▼          ▼          ▼
╔══════════════════════════════════════════════════════════════════════════════╗
║                             AGENTS（角色执行层）                              ║
╠══════════════════════════════════════════════════════════════════════════════╣
║                                                                              ║
║             ┌──────────────┐  ┌──────────────┐  ┌──────────────┐             ║
║             │  analyst     │  │  developer   │  │  perf-tuner  │             ║
║             │  需求与设计   │  │  实现与精度   │  │  性能调优     │             ║
║             └──────────────┘  └──────────────┘  └──────────────┘             ║
║                                                                              ║
╚══════════════════════════════════════════════════════════════════════════════╝
                     │ │ │           │ │ │           │ │ │
                     ▼ ▼ ▼           ▼ ▼ ▼           ▼ ▼ ▼
╔═══════════════════════════════════════════════════════════════════════════════╗
║                             SKILLS（知识能力层）                               ║
╠═══════════════════════════════════════════════════════════════════════════════╣
║                                                                               ║
║  ┌─ 需求与设计 ────────────────────────────────────────────────────────────┐   ║
║  │  intent-understand    需求意图理解与规格生成                             │   ║
║  │  api-explore          API 可行性探索与分析                               │   ║
║  │  op-design            算子方案设计生成                                   │   ║
║  └─────────────────────────────────────────────────────────────────────────┘  ║
║                                                                               ║
║  ┌─ 实现与验证 ────────────────────────────────────────────────────────────┐   ║
║  │  golden-generate      Golden 参考实现生成                               │   ║
║  │  op-develop           算子代码实现与调试                                 |   ║
║  │  precision-debug      精度问题诊断                                      │   ║
║  │  precision-compare    精度对比分析                                      │   ║
║  └────────────────────────────────────────────────────────────────────────┘   ║
║                                                                               ║
║  ┌─ 性能调优 ──────────────────────────────────────────────────────────────┐   ║
║  │  op-perf-tune         算子性能分析与调优                                 │   ║
║  └─────────────────────────────────────────────────────────────────────────┘  ║
║                                                                               ║
╚═══════════════════════════════════════════════════════════════════════════════╝

TileLang 算子开发

╔══════════════════════════════════════════════════════════════════════════════╗
║                              TEAMS（应用编排层）                              ║
╠══════════════════════════════════════════════════════════════════════════════╣
║                                                                              ║
║                    ┌─────────────────────────────────┐                       ║
║                    │    tilelang-op-orchestrator     │                       ║
║                    │      TileLang 算子开发流程       │                       ║
║                    └──────┬──────────┬──────────┬────┘                       ║
║                           │          │          │                            ║
╚═══════════════════════════╪══════════╪══════════╪════════════════════════════╝
                            │          │          │
                            ▼          ▼          ▼
╔══════════════════════════════════════════════════════════════════════════════╗
║                             AGENTS（角色执行层）                              ║
╠══════════════════════════════════════════════════════════════════════════════╣
║                                                                              ║
║             ┌──────────────┐  ┌──────────────┐  ┌──────────────┐             ║
║             │  analyst     │  │  developer   │  │  perf-tuner  │             ║
║             │  需求与设计   │  │  实现与精度   │  │  性能调优     │             ║
║             └──────────────┘  └──────────────┘  └──────────────┘             ║
║                                                                              ║
╚══════════════════════════════════════════════════════════════════════════════╝
                     │ │ │           │ │ │           │ │ │
                     ▼ ▼ ▼           ▼ ▼ ▼           ▼ ▼ ▼
╔═══════════════════════════════════════════════════════════════════════════════╗
║                             SKILLS（知识能力层）                               ║
╠═══════════════════════════════════════════════════════════════════════════════╣
║                                                                               ║
║  ┌─ 环境与准备 ───────────────────────────────────────────────────────────┐   ║
║  │  env-check               环境检查与配置验证                            │   ║
║  │  submodule-pull          三方库与子模块拉取                            │   ║
║  └────────────────────────────────────────────────────────────────────────┘   ║
║                                                                               ║
║  ┌─ 需求与设计 ───────────────────────────────────────────────────────────┐   ║
║  │  op-design               算子设计文档生成                              │   ║
║  │  programming-model-guide 模式选型与配置                                │   ║
║  │  api-best-practices      API 使用最佳实践                              │   ║
║  └────────────────────────────────────────────────────────────────────────┘   ║
║                                                                               ║
║  ┌─ 实现与验证 ───────────────────────────────────────────────────────────┐   ║
║  │  op-develop              算子代码实现与测试                            │   ║
║  │  op-test-design          测试设计与覆盖率分析                          │   ║
║  │  review                  代码格式检查与修复                            │   ║
║  └────────────────────────────────────────────────────────────────────────┘   ║
║                                                                               ║
║  ┌─ 性能调优 ─────────────────────────────────────────────────────────────┐   ║
║  │  perf-optimization       性能调优与劣化模式检查                        │   ║
║  └────────────────────────────────────────────────────────────────────────┘   ║
║                                                                               ║
╚═══════════════════════════════════════════════════════════════════════════════╝

🚀 Skills 技能库

Ascend C 算子开发

Skill	功能	使用样例
ascendc-api-best-practices	API 使用最佳实践、参数限制	—
npu-arch	NPU 架构知识、芯片型号映射	—
ascendc-docs-search	API 文档索引 + 在线搜索	—
ascendc-env-check	NPU 设备查询、CANN 环境验证	—
ascendc-tiling-design	Tiling 和 Kernel 设计方法论，按算子类别分类	—
ascendc-precision-debug	精度调试，症状-原因速查、常见陷阱	—
ascendc-runtime-debug	运行时错误调试，错误码解析（161xxx/361xxx/561xxx）	—
ascendc-crash-debug	卡死/崩溃调试，Kernel 挂起、Coredump 分析	—
ascendc-ut-develop	UT 单元测试用例开发与覆盖率增强	—
ascendc-st-design	aclnn 接口测试用例设计、L0 / L1 测试用例生成	—
ascendc-code-review	代码检视方法论、5 大类别规范	—
ascendc-task-focus	任务聚焦，解决长任务“迷失在中间”的问题	—
ascendc-whitebox-design	白盒测试用例设计与生成	—
ascendc-registry-invoke-template	完整自定义算子工程模板，提供标准工程结构、代码模板、UT/ST 样例和多芯片架构参考	—
ascendc-registry-invoke-to-direct-invoke	注册调用算子转 `<<<>>>` kernel 直调	查看
ascendc-direct-invoke-to-registry-invoke	`<<<>>>` kernel 直调转注册调用算子	查看
ascendc-direct-invoke-template	Kernel 直调工程模板，提供验证过的样例工程和修改指南	—
ops-profiling	NPU 性能采集与分析，CSV 指标解读、瓶颈定位、优化建议	—
ops-precision-standard	算子精度标准，按 dtype 分类提供 atol/rtol 精度比对标准	—
ascendc-docs-gen	算子文档写作参考，支持需求分析、详细设计等多个标准模版	—
ops-simulator	NPU 仿真器技能。提供 CANN Simulator 的使用指导，包括精度仿真、性能仿真、流水线分析。	—
cuda2ascend-simt	CUDA 算子迁移到 Ascend C SIMT，支持 `standalone sample` / `torch_npu` / `pybind` 三类交付形态，根据原始工程形态自动选择。仅支持 Ascend 950 PR平台。当前不支持：native JIT（`nvrtc`、运行时编译、扩展 JIT 加载）、torch 复数 dtype、device 侧 `double`（FP64）、CUDA 生态库（cuBLAS / cuDNN / cuFFT / cuSPARSE / Thrust / CUB / NCCL 等）、协作组、Ascend C SIMD API、矢量编程 API	查看
ascendc-blaze-best-practice	Matmul/Cube/GEMM/BMM 单算子直调生成（Blaze/tensor_api 路径），覆盖模板选型、改造、Tiling 及排错	—
ascendc-performance-best-practices	按算子族组织的性能优化经验与参考代码总结	—
ascendc-regbase-best-practice	DAV_3510 RegBase 算子 API 约束、实现结构、常见陷阱及真实参考算子	—
cann-env-setup	昇腾 NPU CANN 安装与环境配置指导	—
aiss-tiling-solver	AISS-TilingSolver 工具自动求解最优 Tiling 参数，覆盖安装、输入构造、运行求解、结果解读	—

PyPTO 算子开发

Skill	功能
pypto-op-design	算子方案设计生成
pypto-op-develop	算子代码实现与测试
pypto-golden-generate	Golden 参考实现生成
pypto-intent-understand	需求意图理解与规格生成
pypto-api-explore	API 可行性探索与分析
pypto-precision-debug	精度问题代码层排查
pypto-precision-compare	精度中间结果对比分析
pypto-op-perf-tune	算子性能分析与自动调优

TileLang 算子开发

Skill	功能
tilelang-env-check	TileLang-Ascend 环境检查与配置验证
tilelang-submodule-pull	自动拉取 tilelang 仓库及其三方子模块代码
tilelang-op-design	算子设计文档生成
tilelang-op-develop	基于设计文档生成算子实现代码与测试
tilelang-op-test-design	算子测试设计与测试覆盖率分析
tilelang-api-best-practices	TileLang Ascend API 使用最佳实践
tilelang-programming-model-guide	Developer/Expert 模式选择与 pass_configs 配置指南
tilelang-perf-optimization	性能调优与性能劣化模式检查
tilelang-review	代码格式检查与自动修复

Triton 算子开发

Skill	功能
triton-task-extractor	从用户输入中提取算子，构建任务文件
triton-op-designer	设计高质量算法，指导代码生成
triton-op-coding	根据设计生成 Triton 内核代码
triton-op-verifier	验证算子精度和性能测试
triton-latency-optimizer	逐步优化 Triton 代码性能

NPU 模型推理优化

Skill	功能
model-infer-migrator	框架适配与部署基线建立
model-infer-parallel-analysis	并行策略分析（TP/EP/DP）
model-infer-parallel-impl	并行切分实施
model-infer-kvcache	KVCache 优化 + FA 替换
model-infer-fusion	torch_npu 融合算子分析与替换
model-infer-quantization	compressed-tensors 量化适配改造
model-infer-graph-mode	torch.compile 图模式适配
model-infer-precision-debug	NPU 推理精度诊断
model-infer-runtime-debug	NPU 运行时错误诊断
model-infer-multi-stream	多流并行优化
model-infer-prefetch	权重预取适配
model-infer-superkernel	SuperKernel 适配

Skill 治理工具

Skill	功能	使用样例
cannbot-skill-reviewer	审查新增或修改的 `SKILL.md` 是否符合 CANNBot 入库要求，输出自动门禁、九维评分、阻塞项和整改建议	查看

GitCode 协作工具

Skill	功能	使用样例
gitcode-pr-handler	根据 GitCode PR 代码变更重新生成标题（约定式提交）与描述（沿用仓库 PR 模板）并写回 PR	查看
gitcode-issue-gen	自动判断两条路径：(PR路径) 从 PR diff 生成关联 Issue 并完成双向关联；(手动路径) 交互式收集信息生成 Issue 草稿，经确认后提交	查看
gitcode-issue-handler	GitCode Issue 端到端处置，按内容自动选择 PR 代码变更路径或 Comment 答复路径	查看
gitcode-toolkit	GitCode API/Token/URL/日志/变更展示 + Git 克隆/diff/log/remote + PR 创建工作流共享参考（内部参考，不直接触发）	—

🚀 Agents 智能代理

Ascend C 算子开发

Agent	功能
ascendc-ops-architect	算子架构师，支持需求分析和方案设计两种场景
ascendc-ops-developer	算子开发者，支持代码实现、编译测试和精度验证
ascendc-ops-tester	算子测试者，支持ST/UT用例生成与执行
ascendc-ops-reviewer	代码检视专家，支持快速检视和全功能检视两种模式
ascendc-kernel-architect	Kernel直调架构师，支持需求分析、API验证、方案设计
ascendc-kernel-developer	Kernel直调开发者，支持代码实现、编译测试、性能采集、文档编写
ascendc-kernel-reviewer	Kernel直调审查者，支持独立构建验证、7维度评分、精度验证

PyPTO 算子开发

Agent	功能
pypto-op-analyst	需求分析与方案设计
pypto-op-developer	算子代码实现与精度调试
pypto-op-perf-tuner	性能分析与调优

TileLang 算子开发

Agent	功能
tilelang-op-analyst	需求理解与算子设计
tilelang-op-developer	代码生成、测试与精度调试
tilelang-op-perf-tuner	性能分析、瓶颈定位与调优

Triton 算子开发

Agent	功能
triton-op-generator	Triton 算子端到端生成与优化

NPU 模型推理优化

Agent	功能
model-infer-analyzer	模型分析、方案设计、并行策略推荐
model-infer-implementer	代码改造、调试修复
model-infer-reviewer	精度验证、性能对比

🛠️ 测试框架

自动化测试验证 Skills 和 Agents 的正确性，确保技能模块和智能代理的行为符合预期。详见 tests/README.md。

💬 相关信息

💖 免责声明

感谢您关注 CANNBot Skills 项目，我们希望这些技能和知识能帮助您更好地进行 CANN 开发 ^_^

在使用之前，请您了解：

关于功能满足度：由于技术快速更新迭代，部分内容可能无法完全适用于所有场景。本开源社区的功能和文档正在持续更新和完善中，如果想提出需求、发现问题、贡献想法，欢迎提 Issue 或参与讨论，共创共建。
关于自动生成：自动代码生成工具所产出的内容，其完整性、准确性、合规性受模型、Skills 能力、语料质量、输入指令等多种因素影响，无法保证完全精准。所有生成代码作为辅助研发使用，请开发者务必进行测试验证、安全审查后再投入使用。

🔥 最新动态

2026-06-25 — 新增 install-helper 交互式安装助手 CLI 工具；README 安装文档全面优化，支持双轨制安装。
2026-06-24 — ops-simulator 新增基于 summary.json 的性能瓶颈分析能力；ops-direct-invoke 拆分 Design Reviewer Agent。
2026-06-23 — ops-registry-invoke 集成 infra Skills；补充 CV 融合算子流水间同步知识。
2026-06-22 — 新增 model-infer-quantization 量化 Skill，主链 Skill 按 cann-recipes-infer 框架重写。
2026-06-18 — 为 graph/ 和 infra/ 共 10 个 Skill 添加 ST 测试用例；改进 triton GPU kernel 迁移策略。
2026-06-17 — 集成 infra Skills 到 ops-direct-invoke 和 ops-direct-invoke-flash；新增 MM/GMM Skill。
2026-06-16 — 新增 TileLang 插件，为 24 个 ops Skill 添加 ST 测试用例。
2026-06-15 — SWAT 算法更新策略并适配量化，新增参数分析能力。
2026-06-13 — ops-direct-invoke-flash 补充 init.sh 安装脚本与 README 文档。
2026-06-12 — blaze Skill 支持后融合能力。
2026-06-11 — 新增算子评测框架到 tests/benchmark。

更多历史记录详见 CHANGELOG.md。

🤝 社区交流

Issue 反馈：提交 Issue
社区讨论：参与讨论
微信交流：加入群聊

项目介绍

CANNBot 是面向 CANN 开发的用于提升开发效率的系列智能体，本仓库为其提供可复用的 Skills 模块。

cannbot-skills:基于 CANN 生态的 Agent 技能模块项目

CANNBot Skills

📢 项目概述

项目定位

目标用户

🚀 快速开始

前置条件

安装

完整安装（推荐）

独立 Skill 安装

安装后使用

📦 安装指南

完整安装

install-helper 命令参考

手动执行安装脚本

独立 Skill 安装

安装遇到问题？

🔍 项目架构设计

整体架构

逻辑架构视图

Ascend C 算子开发

PyPTO 算子开发

TileLang 算子开发

🚀 Skills 技能库

Ascend C 算子开发

PyPTO 算子开发

TileLang 算子开发

Triton 算子开发

NPU 模型推理优化

Skill 治理工具

GitCode 协作工具

🚀 Agents 智能代理

Ascend C 算子开发

PyPTO 算子开发

TileLang 算子开发

Triton 算子开发

NPU 模型推理优化

🛠️ 测试框架

💬 相关信息

💖 免责声明

🔥 最新动态

🤝 社区交流

项目介绍