@cannbot-plugin/cannbot-harness 0.0.0-stage → 0.1.5

package/assets/ops-direct-invoke/skills/ascendc-docs-gen/references/operator-readme-template_bak.md

@@ -0,0 +1,165 @@
+# {算子名称}
+
+> 本模板用于编写开源算子 README 文档（gitcode 仓）。
+> 文档存放路径：`operators/{operator_name}/README.md`
+> 在线参考：https://gitcode.com/cann/ops-math/blob/master/math/add/README.md
+
+## 产品支持情况
+
+> [!NOTE]
+>
+> **写作规范**：推荐表格形式，罗列支持的产品型号并打 √。
+> - 按产品实际支持情况填写
+> - 产品顺序不要改变
+> - 若新增产品，需所有算子全量适配
+> - 产品形态介绍参见[昇腾产品形态说明](https://www.hiascend.com/document/redirect/CannCommunityProductForm)
+> - 仅算子支持麒麟芯片，aclnn 不涉及
+
+| 产品 | 是否支持 |
+| :----------------------------------------- | :------:|
+| <term>Ascend 950PR/Ascend 950DT</term> | √ |
+| <term>Atlas A3 训练系列产品/Atlas A3 推理系列产品</term> | √ |
+| <term>Atlas A2 训练系列产品/Atlas A2 推理系列产品</term> | √ |
+| <term>Atlas 200I/500 A2 推理产品</term> | × |
+| <term>Atlas 推理系列产品</term> | × |
+| <term>Atlas 训练系列产品</term> | √ |
+| <term>Kirin xxx</term> | √ |
+
+## 功能说明
+
+> [!NOTE]
+>
+> **写作目标**：阐明算子功能、计算原理、参数规格、使用场景等。
+>
+> **写作规范**：推荐无序列表形式，一般包括如下维度：
+> - 算子功能（必选）：以一句话形式简洁明了阐述功能
+> - 计算公式（可选）：复杂功能可借助公式介绍实现原理或不同场景下的计算过程
+> - 其他维度（可选）：支持无序列表拓展，如计算示例、流程图等
+
+- 算子功能：完成加法计算。
+- 计算公式：
+
+  $$
+  y = x1 + alpha \times x2
+  $$
+
+## 参数说明
+
+> [!NOTE]
+>
+> **写作目标**：阐明算子定义的参数含义、作用、规格等信息。
+>
+> **写作规范**：采用表格形式，一般包括如下维度：
+> - 参数名：解释算子定义文件中的参数，顺序保持一致（如 `op_host/{op}_def.cpp` 或 `op_graph/{op}_proto.h`）
+> - 输入/输出/属性：明确参数定位，默认是必选，若为可选一般为可选输入/可选输出/可选属性
+> - 描述：提供参数含义、功能、使用场景等介绍，包括与公式变量的映射关系
+> - 数据类型：参数支持的 data type，可不带 `DT_` 前缀
+> - 数据格式：参数支持的数据排布方式，可不带 `FORMAT_` 前缀
+> - 其他维度（可选）：支持表格字段扩展，如 shape 规格等
+>
+> **芯片差异**：表格里罗列所有芯片描述的并集，差异化描述在表格外以"产品1、产品2：xx描述"形式组织
+
+<table style="table-layout: fixed; width: 1576px"><colgroup>
+<col style="width: 170px">
+<col style="width: 170px">
+<col style="width: 200px">
+<col style="width: 200px">
+<col style="width: 170px">
+</colgroup>
+<thead>
+  <tr>
+    <th>参数名</th>
+    <th>输入/输出/属性</th>
+    <th>描述</th>
+    <th>数据类型</th>
+    <th>数据格式</th>
+  </tr></thead>
+<tbody>
+  <tr>
+    <td>x1</td>
+    <td>输入</td>
+    <td>公式中的输入x1。</td>
+    <td>FLOAT、FLOAT16、INT32、INT64、INT16、INT8、UINT8、BOOL、COMPLEX128、COMPLEX64、BFLOAT16</td>
+    <td>ND</td>
+  </tr>
+  <tr>
+    <td>x2</td>
+    <td>输入</td>
+    <td>公式中的输入x2。</td>
+    <td>FLOAT、FLOAT16、INT32、INT64、INT16、INT8、UINT8、BOOL、COMPLEX128、COMPLEX64、BFLOAT16</td>
+    <td>ND</td>
+  </tr>
+  <tr>
+    <td>alpha</td>
+    <td>可选属性</td>
+    <td><ul><li>alpha的描述xxx。</li><li>默认值为1.0。</li></ul></td>
+    <td>FLOAT</td>
+    <td>-</td>
+  </tr>
+  <tr>
+    <td>y</td>
+    <td>输出</td>
+    <td>公式中的y。</td>
+    <td>FLOAT、FLOAT16、INT32、INT64、INT16、INT8、UINT8、BOOL、COMPLEX128、COMPLEX64、BFLOAT16</td>
+    <td>ND</td>
+  </tr>
+</tbody></table>
+
+- <term>Atlas 训练系列产品</term>：不支持BFLOAT16。
+
+## 约束说明（可选）
+
+> [!NOTE]
+>
+> **写作目标**：阐明算子使用过程中的注意事项，例如参数组合约束、适用场景、对业务影响、算子性能或精度等。
+>
+> **写作规范**：
+> - 本章为可选，若无约束可不呈现本章内容；若有请采用无序列表形式
+> - 算子原生语义的通用约束不写
+> - 从使用场景、硬件/软件资源、对系统/网络性能或精度影响等角度说明
+> - 列出该算子在昇腾硬件上实现时的特有限制
+
+无
+
+## 调用说明
+
+> [!NOTE]
+>
+> **写作目标**：提供算子调用方法，尽量是可直接拷贝运行的示例代码，方便快速验证。
+>
+> **写作规范**：推荐表格形式，如果内容复杂可采用其他形式。
+> - 调用方式：支持 aclnn、图模式等方式调用算子，请提供至少一种方式
+> - 样例代码：请在算子 `examples` 目录提供调用示例代码，文件命名规则为 `test_${invoke_mode}_${op_name}`
+> - 说明：针对不同调用方式提供补充介绍
+>
+> **注意**：只要样例代码 `examples/cpp` 有变化，请同步修改算子 README
+
+<table><thead>
+  <tr>
+    <th>调用方式</th>
+    <th>调用样例</th>
+    <th>说明</th>
+  </tr></thead>
+<tbody>
+  <tr>
+    <td>aclnn调用</td>
+    <td><a href="../examples/{op_name}/examples/test_aclnn_{op_name}.cpp">test_aclnn_{op_name}</a></td>
+    <td rowspan="2">参见<a href="./zh/invocation/quick_op_invocation.md">算子调用</a>完成算子编译和验证。</td>
+  </tr>
+  <tr>
+    <td>图模式调用</td>
+    <td><a href="../examples/{op_name}/examples/test_geir_{op_name}.cpp">test_geir_{op_name}</a></td>
+  </tr>
+</tbody></table>
+
+## 参考资源（可选）
+
+> [!NOTE]
+>
+> **写作目标**：提供除算子功能、规格、调用外的其他补充介绍，如算子设计文档（Tiling/Kernel 设计）、参考文献等。
+>
+> **写作规范**：本章为可选，若无参考资源可不呈现本章内容；若有请采用无序列表形式。
+> - 文档位置：放在与 aclnn md 同层级目录下，`docs/xxx算子设计文档.md`
+> - 图片建议放在最外仓 `docs/zh/figures` 目录下
+
+* [算子设计原理](./docs/{算子名称}设计文档.md) <!-- 待开发阶段补充 -->

package/assets/ops-direct-invoke/skills/ascendc-docs-gen/references/requirement-analysis-template.md

@@ -0,0 +1,131 @@
+# {算子名称} 需求文档
+
+## 修订记录
+
+| 版本 | 修订内容 | 修订时间 | 修订人(gitId) |
+|-----|---------|---------|-------|
+| v1.0 | 初始版本 | YYYY-MM-DD | [gitId] |
+
+## 1. 需求背景
+
+- **需求来源**: [描述需求产生的原因和场景]
+- **基线对齐**:
+  - [ ] 框架 API(如 PyTorch, 版本:)
+  - [ ] 论文公式(论文标题:)
+  - [ ] 用户给定公式(公式:)
+
+### 模型结构分析(可选)
+
+**适用场景**: 融合算子场景(涉及多个算子组合)
+- **模型结构分析**: [描述涉及的模型架构和算子组合]
+- **设计演进趋势**: [描述算子设计的发展方向和优化路径]
+
+## 2. 运行环境
+
+- **服务器型号**: [目标服务器产品系列]
+- **芯片号**: [具体芯片型号]
+- **编译宏架构**: [DAV_*]
+
+## 3. 调用方式
+
+| 调用方式 | 是否支持 |
+|---------|---------|
+| ACLNN 调用 | [ ] |
+| torch_npu 单算子 | [ ] |
+| torch.compile 入图 | [ ] |
+| GE 图模式-静态 shape | [ ] |
+| GE 图模式-动态 shape | [ ] |
+
+## 4. 算子规格
+
+### 4.1 基本信息
+- **算子名称**: 
+- **数学公式**: 
+- **仓规划**: 
+
+### 4.2 输入输出规格
+
+#### 输入
+- x: [shape], dtype
+
+#### 输出
+- y: [shape], dtype
+
+### 4.3 数据类型支持
+- [ ] fp16
+- [ ] fp32
+- [ ] bfloat16
+- [ ] int8
+
+### 4.4 精度要求
+- fp16: 双千分之一
+- fp32: 双万分之一
+
+## 5. ACLNN API 接口定义
+
+### 5.1 接口声明
+```cpp
+// GetWorkspaceSize
+aclnnStatus aclnn{OperatorName}GetWorkspaceSize(
+    [参数列表],
+    uint64_t* workspaceSize, aclOpExecutor** executor);
+
+// 执行接口
+aclnnStatus aclnn{OperatorName}(
+    void* workspace, uint64_t workspaceSize,
+    aclOpExecutor* executor, aclrtStream stream);
+```
+
+### 5.2 参数说明
+| 参数名 | 类型 | 说明 |
+|-------|------|------|
+| [参数1] | const aclTensor* | [说明] |
+| [参数2] | aclTensor* | [说明] |
+
+### 5.3 约束与限制
+- [类型推导规则]
+- [shape 约束]
+- [广播规则]
+- [边界情况处理，如空 tensor、0 元素等]
+
+## 6. 图模式 IR 定义(可选)
+
+- **IR 算子名称**: [算子标识]
+- **输入输出规格**: [IR 层面的 tensor 规格]
+- **属性定义**: [算子属性列表]
+- **动态 shape 支持**: [是/否]
+
+## 7. 性能要求(可选)
+
+- **利用率**: [AI Core 利用率]
+- **带宽**: [内存带宽利用率]
+- **延迟**: [算子执行时间，ms 或 us]
+- **性能基线**: [对标参考]
+
+## 8. 约束与要求
+
+### 8.1 计算约束
+- [计算过程限制，如中间结果不能溢出]
+
+### 8.2 资源约束(可选)
+- [内存使用限制，如 workspace 大小限制]
+- [AI Core 数量限制]
+- [内存对齐要求]
+- [其他资源限制]
+
+### 8.3 确定性计算(可选)
+**适用场景**: 含 Reduce 操作或矩阵运算时需要考虑
+- **默认支持**: 是/否
+- **累加顺序**: [是否需要保证并行累加顺序一致]
+- **数值精度**: [确定性计算对精度的影响]
+- **性能影响**: [确定性计算对性能的影响]
+- **实现策略**: [并行计算策略、累加顺序保证方法]
+
+### 8.4 特殊约束(可选)
+- [其他特殊约束]
+
+> **注意**: 输入 shape、dtype、广播规则、边界情况等约束已在 ACLNN API 接口定义中说明，此处不重复
+
+
+
+

package/assets/ops-direct-invoke/skills/ascendc-docs-search/SKILL.md

@@ -0,0 +1,163 @@
+---
+name: ascendc-docs-search
+description: Ascend C 开发资源检索技能。通过本地 API 文档索引、示例代码映射和在线文档兜底搜索定位开发资料，优先查本地、缺失时再查在线。当需要查询 API 用法、示例代码、兼容性信息、官方资料入口或定位文档来源时使用。
+permission:
+  external_directory: allow
+---
+
+# Ascend C 开发资源
+
+## 概述
+
+本技能提供"本地优先，在线兜底"的文档搜索能力：
+- **本地资源**：API 文档（docs/zh/api/）、示例代码（examples/）、实现参考（impl/）
+- **在线搜索**：华为昇腾社区文档搜索（仅在本地资源不足时使用）
+
+## 官方资源路径
+
+| 资源类型 | 路径 | 说明 |
+|---------|------|------|
+| API 文档 | 通过 `find "$ASC_DEVKIT_DIR/docs/zh/api/" -name "*.md"` 智能搜索 | API 文档（不依赖具体子目录） |
+| 高性能模板 | `$ASC_DEVKIT_DIR/examples/01_simd_cpp_api/05_best_practices/00_vector_compute/add_high_performance/` | Add 多级性能调优（双缓冲、L2Cache bypass、Bank Conflict 优化） |
+| 各类示例 | `$ASC_DEVKIT_DIR/examples/01_simd_cpp_api/00_introduction/` | 入门示例（加法、矩阵乘法、融合算子等） |
+| 完整文档 | `$ASC_DEVKIT_DIR/docs/` | 完整开发文档 |
+| Tiling 实现 | `$ASC_DEVKIT_DIR/impl/adv_api/tiling/` | Tiling 参数配置参考 |
+| 矢量计算 | `$ASC_DEVKIT_DIR/examples/01_simd_cpp_api/03_basic_api/01_memory_vector_compute/` | 矢量 API 使用 |
+| 调试示例 | `$ASC_DEVKIT_DIR/examples/01_simd_cpp_api/01_utilities/00_printf/simple_printf/printf.asc` | printf 调试方法 |
+| HCCL 通信 API 头文件 | `$ASC_DEVKIT_DIR/include/adv_api/hccl/` | HCCL 集合通信头文件（hccl.h、hccl_tiling.h 等），API 文档在 `docs/zh/api/SIMD-API/adv_api/HCCL_communication/` |
+
+## 资料查找优先级
+
+```
+0. 先查 [api-index.md](references/api-index.md) 定位 API 所属大类和子目录路径
+         ↓
+1. $ASC_DEVKIT_DIR/docs/zh/api/ 下的所有 .md 文档（按定位的子目录 find 搜索）
+         ↓ 找不到
+2. $ASC_DEVKIT_DIR/examples/ (示例代码)
+         ↓ 找不到
+3. $ASC_DEVKIT_DIR/impl/ (实现代码)
+         ↓ 找不到
+4. 在线搜索（华为昇腾社区）
+   使用 scripts/ 中的 Python 脚本
+   推荐版本：8.5.0（与当前环境一致）
+```
+
+## ⚠️ API 变体搜索指南（重要）
+
+**问题**：Ascend C 存在**大量带数字后缀的 API 变体**（如 `Add-25.md`），同名 API 的不同变体功能可能完全不同。
+
+**典型案例**：
+- `Add.md` - 基础版本
+- `Add-25.md` - 变体版本（支持更多功能）
+
+### 强制搜索步骤
+
+1. **列出所有变体**：
+   ```bash
+   # 搜索某个 API 的所有变体（将 APIName 替换为实际 API 名称）
+   find "$ASC_DEVKIT_DIR/docs/zh/api/" -name "${APIName}*.md"
+
+   # 示例：
+   # APIName.md        ← 基础版本
+   # APIName-25.md     ← 变体版本
+   # APIName-91.md     ← 变体版本
+   ```
+
+2. **逐一确认功能**：每个变体的函数签名、参数、功能可能完全不同
+
+### 变体命名规律
+
+| 后缀 | 含义 | 示例 |
+|------|------|------|
+| 无后缀 | 基础版本 | `Add.md` |
+| `-数字` | 变体版本（数字无语义，功能可能完全不同） | `Add-25.md` |
+
+### 变体检测命令
+
+```bash
+# 查找某个 API 的所有变体（强制，将 APIName 替换为实际名称）
+find "$ASC_DEVKIT_DIR/docs/zh/api/" -name "${APIName}*.md"
+
+# 在所有变体中搜索特定关键词
+grep -rl "关键词" "$ASC_DEVKIT_DIR/docs/zh/api/" --include="*.md"
+```
+
+## 环境兼容性
+
+**当前环境**：A3 服务器，CANN 8.5.0
+
+查阅资料时必须确认 API/方法适用于当前环境。
+
+## Explore Agent 使用
+
+**何时使用**：
+1. 查找 API 文档或实现示例
+2. 了解某个技术点的实现方式
+3. 搜索类似算子的参考实现
+4. 遇到错误时查找相关解决方案
+5. 方案走通后探索更优实现
+
+**使用方式**：
+```
+使用 Task 工具，subagent_type=Explore
+提供明确的搜索目标和范围
+```
+
+**示例提示词**：
+- "搜索 $ASC_DEVKIT_DIR 中 Exp API 的使用示例"
+- "查找双缓冲的实现参考"
+- "搜索类似的三角函数算子实现"
+
+## 示例代码索引
+
+| 示例名称 | 路径 | 用途 |
+|---------|------|------|
+| 高性能模板 | `$ASC_DEVKIT_DIR/examples/01_simd_cpp_api/05_best_practices/00_vector_compute/add_high_performance/` | Add 多级性能调优（双缓冲、L2Cache bypass、Bank Conflict） |
+| 矢量计算 | `$ASC_DEVKIT_DIR/examples/01_simd_cpp_api/03_basic_api/01_memory_vector_compute/` | Memory 矢量计算接口（reduce、sort、transpose 等） |
+| 复合计算 | `$ASC_DEVKIT_DIR/examples/01_simd_cpp_api/03_basic_api/01_memory_vector_compute/element_wise_compound_compute/` | 复合计算接口（AddRelu/Axpy） |
+| 基础算术 | `$ASC_DEVKIT_DIR/examples/01_simd_cpp_api/03_basic_api/01_memory_vector_compute/element_wise_arithmetic/` | 基础算术类接口（基于 LeakyRelu 演示） |
+| 调试打印 | `$ASC_DEVKIT_DIR/examples/01_simd_cpp_api/01_utilities/00_printf/simple_printf/printf.asc` | printf 调试 |
+| 断言使用 | `$ASC_DEVKIT_DIR/examples/01_simd_cpp_api/01_utilities/01_assert/assert.asc` | 断言示例 |
+| 高阶 API 数学库 | `$ASC_DEVKIT_DIR/examples/01_simd_cpp_api/04_advanced_api/10_math/` | 高阶 API 数学算子（acosh、axpy、exp、fma 等） |
+
+## 在线搜索
+
+**适用情况**：
+- 本地 $ASC_DEVKIT_DIR 文档未覆盖相关 API
+- 需要更详细的官方说明或最新版本信息
+- 本地文档版本过旧或不完整
+
+**快速搜索**：
+```bash
+# 基础搜索（推荐使用中文关键词）
+python skills/ascendc-docs-search/scripts/ascend_search_client.py "Ascend C 临时内存申请" --max_results 5
+
+# 搜索 API 文档
+python skills/ascendc-docs-search/scripts/ascend_search_client.py "AscendC::Add 接口原型" --max_results 8
+
+# 带版本过滤（推荐使用 8.5.0）
+python skills/ascendc-docs-search/scripts/ascend_search_client.py "Ascend C API" --version "8.5.0"
+```
+
+**获取详细内容**：
+```bash
+python skills/ascendc-docs-search/scripts/ascend_content_fetcher.py <URL>
+```
+
+**参数说明**：
+- `keyword`：搜索关键词（必需），建议使用中文
+- `--max_results`：返回结果数量（1-10，默认 10）
+- `--lang`：语言设置（zh/en，默认 zh）
+- `--version`：版本过滤字符串（如 "8.5.0"）
+- `--doc_type`：文档类型（DOC/API，默认 DOC）
+
+**依赖安装**：
+```bash
+pip install -r skills/ascendc-docs-search/requirements.txt
+```
+
+## 参考资料
+
+- [API 文档索引](references/api-index.md)
+- [示例代码目录](references/example-catalog.md)
+- [环境兼容性表](references/compatibility.md)

package/assets/ops-direct-invoke/skills/ascendc-docs-search/evals/evals.json

@@ -0,0 +1,197 @@
+{
+  "eval_mode": "text",
+  "evals": [
+    {
+      "id": 1,
+      "title": "API 变体搜索（关键能力）",
+      "config": {
+        "max_tokens": 160000,
+        "ascend_platforms": [
+          "A2"
+        ],
+        "eval_mode": "text"
+      },
+      "prompt": "我在写一个用 ReduceMax 归约的算子，在 $ASC_DEVKIT_DIR/docs/zh/api/ 下发现可能存在多个带数字后缀的 ReduceMax 变体文档，每个变体的函数签名和功能可能都不同。我该怎么系统性地列出所有变体并逐一确认功能差异，才能选对版本？",
+      "expected_output": "1. 回复应说明同一 API 可能存在多个带数字后缀的变体文档，且变体之间的函数签名、参数与功能可能完全不同\n2. 回复应说明要先把所有变体列全（如按 `ReduceMax*.md` 匹配列出目录下全部变体），再逐一核对每个变体的签名与参数说明，不能只读单个文件就下结论\n3. 回复应给出选型结论（按需求维度如是否需要索引、按轴归约还是块内求 max 选择对应变体）",
+      "expectations": [],
+      "files": []
+    },
+    {
+      "id": 2,
+      "title": "搜索示例代码",
+      "config": {
+        "disabled": true,
+        "max_tokens": 160000,
+        "ascend_platforms": [
+          "A2"
+        ],
+        "eval_mode": "text"
+      },
+      "prompt": "我想找一个双缓冲（double buffer）+ 流水线的 Ascend C 实现参考，应该去哪里找？",
+      "expected_output": "回复应推荐查看 `$ASC_DEVKIT_DIR/examples/01_simd_cpp_api/05_best_practices/00_vector_compute/add_high_performance/` 目录，这是官方的高性能模板示例，以加法为例展示多级性能调优路径，逐步引入双缓冲、L2Cache bypass、避免 Bank Conflict 等优化。应说明该示例位于示例代码目录的 `05_best_practices` 分类下，是入门高性能算子开发的推荐参考。",
+      "expectations": [],
+      "files": []
+    },
+    {
+      "id": 3,
+      "title": "本地资源不足时使用在线搜索兜底",
+      "config": {
+        "timeout": 1800,
+        "max_tokens": 160000,
+        "ascend_platforms": [
+          "A2"
+        ],
+        "eval_mode": "text"
+      },
+      "prompt": "我在本地文档里找不到关于 Ascend C 临时内存申请（TempTensor）的详细说明，想从华为昇腾社区在线搜索更详细的官方资料。请告诉我应该运行什么命令来在线搜索，以及如何获取搜索结果的详细内容。",
+      "expected_output": "1. 回复应说明当本地 `$ASC_DEVKIT_DIR` 文档未覆盖相关内容时，可以使用在线搜索兜底；应推荐使用 `ascend_search_client.py` 脚本搜索华为昇腾社区文档，并给出示例命令，如 `python skills/ascendc-docs-search/scripts/ascend_search_client.py \"Ascend C 临时内存申请\" --max_results 5`。\n2. 回复应提及在线检索推荐使用中文关键词搜索，并说明版本过滤建议使用与技能声明的当前环境（CANN 8.5.0）一致的 `--version \"8.5.0\"`。\n3. 回复应说明可使用 `ascend_content_fetcher.py` 获取搜索结果的详细内容。",
+      "expectations": [],
+      "files": []
+    },
+    {
+      "id": 4,
+      "title": "正向看护-多 skill 环境下正确触发目标 skill",
+      "config": {
+        "max_tokens": 160000,
+        "ascend_platforms": [
+          "A2"
+        ],
+        "distractor_skills": [
+          "ascendc-docs-gen",
+          "ascendc-api-best-practices",
+          "ascendc-tiling-design",
+          "ascendc-env-check"
+        ],
+        "eval_mode": "text"
+      },
+      "prompt": "我想查一下 Ascend C 中 Exp 和 Log API 的参数说明和使用示例，应该用什么工具搜索？",
+      "expected_output": "回复应正确激活 ascendc-docs-search skill，说明通过 `$ASC_DEVKIT_DIR/docs/zh/api/` 搜索 Exp 和 Log 的 API 文档，使用 `find` 命令查找所有变体，并在 `$ASC_DEVKIT_DIR/examples/` 中搜索使用示例。即使在 ascendc-docs-gen、ascendc-api-best-practices 等相似 skill 共存的环境下，也应正确选择 ascendc-docs-search。",
+      "expectations": [],
+      "files": []
+    },
+    {
+      "id": 5,
+      "title": "边界场景-模糊查询时主动追问",
+      "config": {
+        "max_tokens": 160000,
+        "ascend_platforms": [
+          "A2"
+        ],
+        "eval_mode": "text"
+      },
+      "prompt": "帮我找个 API",
+      "expected_output": "回复应识别到用户查询过于模糊，主动追问具体需要查找哪个 API、想了解什么信息（函数签名、参数说明、使用示例、兼容性等）。不应在缺少具体 API 名称或搜索目标的情况下直接执行搜索或输出大量无关文档列表。",
+      "expectations": [],
+      "files": []
+    },
+    {
+      "id": 6,
+      "title": "HCCL 通信 API 文档定位",
+      "config": {
+        "disabled": true,
+        "max_tokens": 160000,
+        "ascend_platforms": [
+          "A2"
+        ],
+        "eval_mode": "text"
+      },
+      "prompt": "我想在算子里调用 hccl.alltoallv，HCCL 通信类的 API 文档在哪个目录下？",
+      "expected_output": "回复应说明 HCCL 通信 API 文档位于 `$ASC_DEVKIT_DIR/docs/zh/api/SIMD-API/adv_api/HCCL_communication/`（总览 `HCCL_communication.md`），子目录如下：HCCL_Kernel、HCCL_Tiling、HCCL-Context。应建议先读使用说明获取完整调用流程和代码示例（Tiling 侧使用说明为 `HCCL_Tiling/HCCL_Tiling_usage.md`），再按需查阅单个 API 文档。应提供 find 命令示例。",
+      "expectations": [],
+      "files": []
+    },
+    {
+      "id": 7,
+      "title": "HCCL Kernel 侧调用流程",
+      "config": {
+        "max_tokens": 160000,
+        "ascend_platforms": [
+          "A2"
+        ],
+        "eval_mode": "text"
+      },
+      "prompt": "HCCL Kernel 侧的完整调用流程是什么？InitV2、SetCcTilingV2、AlltoAllV、Wait、Finalize 怎么配合使用？这些内容应该查哪个文档？",
+      "expected_output": "1. 回复应说明 HCCL Kernel 侧的标准调用流程：创建 `Hccl` 对象并调用 `InitV2` 初始化 → 调用 `SetCcTilingV2` 设置通信算法 Tiling 地址 → 调用 `AlltoAllV` 等 Prepare 接口异步下发通信任务获取 handleId → 调用 `Commit` 通知服务端执行 → 调用 `Wait` 等待通信完成 → 调用 `Finalize` 通知服务端退出。\n2. 回复应说明可以通过 `GetHcclContext` 获取通信上下文。\n3. 回复应指出 Kernel 侧使用说明文档（skill 索引登记的 `HCCL_Kernel/HCCL_usage.md`，含标准调用流程与完整 Kernel 代码示例）作为获取完整代码示例的出处。",
+      "expectations": [],
+      "files": []
+    },
+    {
+      "id": 8,
+      "title": "资料查找优先级链路（多级检索）",
+      "config": {
+        "max_tokens": 160000,
+        "ascend_platforms": [
+          "A2"
+        ],
+        "eval_mode": "text"
+      },
+      "prompt": "我要开发一个 Ascend C 算子，需要先定位某个 API（比如 Add）的完整文档、示例代码和实现参考，按照什么顺序去检索资料最合理？",
+      "expected_output": "回复应说明按本技能的「资料查找优先级」执行多级检索：0 先查 references/api-index.md 定位 API 所属大类和子目录路径；1 再到 $ASC_DEVKIT_DIR/docs/zh/api/ 下按定位的子目录用 find 搜索 .md 文档；2 找不到再到 $ASC_DEVKIT_DIR/examples/ 示例代码中查找；3 仍找不到则到 $ASC_DEVKIT_DIR/impl/ 实现代码中查找；4 最后才用在线搜索（华为昇腾社区）兜底。应强调本地优先、在线兜底，先文档后示例再实现。",
+      "expectations": [],
+      "files": []
+    },
+    {
+      "id": 9,
+      "title": "环境兼容性确认（CANN 8.5.0 / A3）",
+      "config": {
+        "max_tokens": 160000,
+        "ascend_platforms": [
+          "A2"
+        ],
+        "eval_mode": "text"
+      },
+      "prompt": "我在 A3 服务器上用 CANN 8.5.0 开发算子，查到某个新 API 的文档，想确认它是否兼容当前环境。项目里有哪些可参考的兼容性资料？确认 API 是否支持当前 NPU 架构、对齐要求以及 CANN 版本要求的具体步骤是什么？",
+      "expected_output": "回复应说明当前项目环境为 A3 服务器、CANN 8.5.0，可参考 references/compatibility.md 环境兼容性表；查阅资料时必须确认 API/方法适用于当前环境。应建议查看 API 文档的 Restriction 章节确认支持的 NPU 架构与对齐要求（如 DataCopy 512 字节对齐），并核对 CANN 版本要求——部分新 API 可能需要更高版本（如 asc-devkit 9.0.0）支持，使用前需在当前环境验证兼容性。",
+      "expectations": [],
+      "files": []
+    },
+    {
+      "id": 10,
+      "title": "Explore Agent 检索参考实现（关键能力）",
+      "config": {
+        "max_tokens": 160000,
+        "ascend_platforms": [
+          "A2"
+        ],
+        "eval_mode": "text"
+      },
+      "prompt": "我要写一个 Sin 三角函数算子，想借助 Explore 子代理高效检索类似算子的参考实现和实现方式。请问应该使用 Task 工具的哪种 subagent 类型来检索，并如何组织搜索目标？",
+      "expected_output": "回复应说明可使用 Task 工具并指定 subagent_type=Explore，提供明确的搜索目标和范围来检索；适用场景包括查找 API 文档/实现示例、了解某个技术点的实现方式、搜索类似算子的参考实现、遇到错误时查找相关解决方案、方案走通后探索更优实现。可给出示例提示词如『搜索 $ASC_DEVKIT_DIR 中 Exp API 的使用示例』、『查找双缓冲的实现参考』、『搜索类似的三角函数算子实现』。",
+      "expectations": [],
+      "files": []
+    },
+    {
+      "id": 11,
+      "title": "库函数/矢量计算示例代码定位",
+      "config": {
+        "disabled": true,
+        "max_tokens": 160000,
+        "ascend_platforms": [
+          "A2"
+        ],
+        "eval_mode": "text"
+      },
+      "prompt": "我想在算子中参考官方示例，看看库函数（addcdiv）和矢量计算（vector add）怎么用，应该去哪个目录找？",
+      "expected_output": "回复应说明高阶 API 数学库示例位于 $ASC_DEVKIT_DIR/examples/01_simd_cpp_api/04_advanced_api/10_math/（acosh、axpy、exp、fma 等高阶 API 算子），矢量计算示例位于 $ASC_DEVKIT_DIR/examples/01_simd_cpp_api/03_basic_api/01_memory_vector_compute/（含 element_wise_arithmetic 基础算术、element_wise_compound_compute 复合计算等子示例）。可参考 SKILL.md 的示例代码索引，还包括 printf 调试、assert 断言等示例（位于 01_utilities/ 下）；更多内容可查阅 references/example-catalog.md。",
+      "expectations": [],
+      "files": []
+    },
+    {
+      "id": 12,
+      "title": "在线搜索版本过滤与文档类型",
+      "config": {
+        "max_tokens": 160000,
+        "ascend_platforms": [
+          "A2"
+        ],
+        "eval_mode": "text",
+        "timeout": 900
+      },
+      "prompt": "我想在线搜索 Ascend C 的 API 文档（比如 Add 接口原型），并且希望限定在 CANN 8.5.0 版本，应该怎么操作？请基于技能文档说明操作步骤和相关参数，不需要实际执行工具。",
+      "expected_output": "1. 应说明在线搜索使用 scripts/ascend_search_client.py 搜索华为昇腾社区文档，并给出带版本过滤的示例命令（用 --version 过滤版本，技能推荐使用与当前环境一致的 8.5.0）。\n2. 应说明 --doc_type 指定文档类型（DOC/API，默认 DOC）、--lang 设置语言（zh/en，默认 zh）、--max_results 控制返回结果数量（1-10，默认 10）。\n3. 应说明在线搜索是「本地优先、在线兜底」链路的最后一级（本地 $ASC_DEVKIT_DIR/docs/zh/api/ 不足时才使用），并说明获取文档详细内容用 scripts/ascend_content_fetcher.py。",
+      "expectations": [],
+      "files": []
+    }
+  ],
+  "skill_name": "ascendc-docs-search"
+}