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

package/assets/ops-direct-invoke/skills/ascendc-ut-develop/assets/question.json

@@ -0,0 +1,100 @@
+{
+  "questions": [
+    {
+      "header": "op_name",
+      "question": "请确认算子名称：",
+      "options": [
+        {
+          "label": "{{opname}}",
+          "description": "使用推断的算子名称"
+        }
+      ]
+    },
+    {
+      "header": "repo_type",
+      "question": "请确认仓库类型：",
+      "options": [
+        {
+          "label": "ops-transformer",
+          "description": "https://gitcode.com/cann/ops-transformer"
+        },
+        {
+          "label": "ops-math",
+          "description": "https://gitcode.com/cann/ops-math"
+        },
+        {
+          "label": "ops-nn",
+          "description": "https://gitcode.com/cann/ops-nn"
+        },
+        {
+          "label": "ops-cv",
+          "description": "https://gitcode.com/cann/ops-cv"
+        },
+        {
+          "label": "custom",
+          "description": "自定义工程"
+        }
+      ],
+      "default": "{{推测结果}}"
+    },
+    {
+      "header": "soc_type",
+      "question": "请确认目标芯片架构（可多选）：",
+      "multiselect": true,
+      "options": [
+        {
+          "label": "ascend310p",
+          "description": "arch20"
+        },
+        {
+          "label": "ascend910b",
+          "description": "arch32"
+        },
+        {
+          "label": "ascend910_93",
+          "description": "arch32"
+        },
+        {
+          "label": "ascend950",
+          "description": "arch35"
+        }
+      ],
+      "default": ["{{推测结果，all代表全选}}"]
+    },
+    {
+      "header": "test_model",
+      "question": "请确认测试模块（可多选）：",
+      "multiselect": true,
+      "options": [
+        {
+          "label": "ophost",
+          "description": "tiling、infer_shape、infer_datatype"
+        },
+        {
+          "label": "opapi",
+          "description": "aclnn"
+        },
+        {
+          "label": "opkernel",
+          "description": "kernel"
+        }
+      ],
+      "default": ["{{推测结果，all代表全选}}"]
+    },
+    {
+      "header": "interactive_mode",
+      "question": "请选择使用模式：",
+      "options": [
+        {
+          "label": "auto",
+          "description": "自动模式，后续不向用户问询（默认）"
+        },
+        {
+          "label": "interactive",
+          "description": "交互模式，允许后续向用户问询"
+        }
+      ],
+      "default": "auto"
+    }
+  ]
+}

package/assets/ops-direct-invoke/skills/ascendc-ut-develop/assets/template_report.md

@@ -0,0 +1,112 @@
+# UT 开发总结报告
+
+## 基本信息
+
+| 项目 | 内容 |
+|------|------|
+| 算子名称 | `<op>` |
+| 算子仓 | `<repo>` (ops-math/ops-nn/ops-transformer/ops-cv) |
+| 算子类别 | `<category>` |
+| SoC版本 | `<soc>` |
+| 支持的dtype | FLOAT16, FLOAT, ... |
+| 支持的format | ND, NCHW, ... |
+
+---
+
+## 层支持情况
+
+| 层级 | 支持 | 说明 |
+|------|------|------|
+| op_host | ✓ / ✗ | AICPU算子可能没有 |
+| op_api | ✓ / ✗ | |
+| op_kernel | ✓ AscendC / ✓ AICPU / ✗ | |
+
+---
+
+## UT 文件路径
+
+```
+<repo>/<category>/<op>/tests/ut/
+├── op_api/
+│   ├── CMakeLists.txt
+│   └── test_aclnn_<op>.cpp
+├── op_host/
+│   ├── CMakeLists.txt
+│   ├── test_<op>_tiling.cpp
+│   └── test_<op>_infershape.cpp
+└── op_kernel/
+    ├── CMakeLists.txt
+    └── test_<op>.cpp
+```
+
+---
+
+## 用例统计
+
+### op_api 层
+
+| 类型 | 数量 | 说明 |
+|------|------|------|
+| 异常用例 | N | nullptr、无效dtype、shape不匹配 |
+| 正常用例 | N | 每个支持的dtype |
+| 边界用例 | N | 空tensor、0维、8维 |
+
+### op_host 层
+
+| 类型 | 数量 | 说明 |
+|------|------|------|
+| Tiling失败场景 | N | 不支持的dtype、空tensor |
+| Tiling成功场景 | N | 各dtype正常输入 |
+| InferShape场景 | N | Shape推导验证 |
+
+### op_kernel 层
+
+| 类型 | 数量 | 说明 |
+|------|------|------|
+| 正常用例 | N | 各dtype计算验证 |
+
+---
+
+## 覆盖率统计
+
+覆盖率类型：`全局覆盖率` / `单算子覆盖率`
+
+| 覆盖率类型 | 值 | 目标 | 状态 |
+|-----------|-----|------|------|
+| 行覆盖率 | xx% | ≥80%（必需） | ✓/✗ |
+| 函数覆盖率 | xx% | ≥80%（必需） | ✓/✗ |
+| 分支覆盖率 | xx% | ≥80%（推荐） | ✓/✗ |
+
+---
+
+## 遇到的问题及解决方案
+
+| 问题 | 原因 | 解决方案 |
+|------|------|---------|
+| `<错误信息>` | `<问题原因>` | `<修复方法>` |
+
+---
+
+## 编译命令记录
+
+```bash
+<填写实际执行的命令>
+```
+
+---
+
+## 最终状态
+
+- [ ] 编译通过
+- [ ] 所有测试用例通过
+- [ ] 已判断覆盖率类型（全局 vs 单算子）
+- [ ] 如为全局覆盖率，已提取单算子覆盖率
+- [ ] 行覆盖率 ≥ 80% 且 函数覆盖率 ≥ 80%
+- [ ] TDD流程遵循（异常用例先行）
+- [ ] 最终报告生成完成
+
+---
+
+## 备注
+
+`<其他需要记录的信息>`

package/assets/ops-direct-invoke/skills/ascendc-ut-develop/assets/todo.json

@@ -0,0 +1,24 @@
+[
+  {"id": "0", "content": "Step 0 前置步骤", "status": "pending", "priority": "high"},
+  {"id": "0.3", "content": "0.1 发送问卷确认入口参数", "status": "pending", "priority": "high"},
+  {"id": "0.1", "content": "0.2 创建 TODO.md", "status": "pending", "priority": "high"},
+  {"id": "0.2", "content": "0.3 创建 tmp 目录", "status": "pending", "priority": "high"},
+  {"id": "1", "content": "Step 1 了解当前仓库信息", "status": "pending", "priority": "high"},
+  {"id": "1.1", "content": "1.1 阅读基础知识文档", "status": "pending", "priority": "high"},
+  {"id": "1.2", "content": "1.2 提取支持的 SoC 列表", "status": "pending", "priority": "high"},
+  {"id": "1.3", "content": "1.3 学习编译命令", "status": "pending", "priority": "high"},
+  {"id": "2", "content": "Step 2 检查算子现有 UT 框架", "status": "pending", "priority": "high"},
+  {"id": "2.1", "content": "2.1 查看算子目录结构", "status": "pending", "priority": "high"},
+  {"id": "2.2", "content": "2.2 编译运行现有用例", "status": "pending", "priority": "high"},
+  {"id": "3", "content": "Step 3 重构 UT 框架", "status": "pending", "priority": "high"},
+  {"id": "3.1", "content": "3.1 备份旧框架代码", "status": "pending", "priority": "high"},
+  {"id": "3.2", "content": "3.2 搭建新框架，确保编译通过", "status": "pending", "priority": "high"},
+  {"id": "3.3", "content": "3.3 迁移所有旧用例", "status": "pending", "priority": "high"},
+  {"id": "4", "content": "Step 4 补全用例，提升覆盖率", "status": "pending", "priority": "high"},
+  {"id": "4.1", "content": "4.1 获取当前覆盖率", "status": "pending", "priority": "high"},
+  {"id": "4.2", "content": "4.2 阅读算子文档", "status": "pending", "priority": "high"},
+  {"id": "4.3", "content": "4.3 判断覆盖率类型", "status": "pending", "priority": "high"},
+  {"id": "4.4", "content": "4.4 分析未覆盖代码", "status": "pending", "priority": "high"},
+  {"id": "4.5", "content": "4.5 迭代补充用例", "status": "pending", "priority": "high"},
+  {"id": "5", "content": "Step 5 生成总结报告", "status": "pending", "priority": "high"}
+]

package/assets/ops-direct-invoke/skills/ascendc-ut-develop/evals/evals.json

@@ -0,0 +1,198 @@
+{
+  "eval_mode": "text",
+  "evals": [
+    {
+      "id": 1,
+      "title": "为 Add 算子开发 op_api 层 UT",
+      "config": {
+        "max_tokens": 200000,
+        "max_tokens_by_model": {
+          "deepseek-v4-flash": 240000,
+          "glm-5": 220000
+        },
+        "ascend_platforms": [
+          "A2"
+        ],
+        "eval_mode": "text"
+      },
+      "prompt": "请介绍 ascendc-ut-develop 技能为 ops-math 仓的 Add 算子开发 op_api 层单元测试的完整工作流程。请依次介绍以下 6 个方面：\n1. 入口参数有哪些（算子名称、仓库类型、芯片架构、测试模块、使用模式）\n2. 强制前置步骤（问卷确认参数、创建 TODO.md、创建临时目录）\n3. 主流程 Step 1 到 Step 5 各步骤概述\n4. op_api 层 UT 使用的核心组件（如 TensorDesc、ScalarDesc、OP_API_UT 宏）\n5. 用例的 TDD 编写顺序（异常用例、正常用例、边界用例）\n6. 覆盖率目标（行覆盖率和函数覆盖率的具体数值）\n不需要执行任何操作，只需要介绍知识。",
+      "expected_output": "回复应体现 ascendc-ut-develop skill 的核心工作流，包含以下要点：\n- 首先确认入口参数：算子名称(add)、仓库类型(ops-math)、芯片架构(ascend910b/arch32)、测试模块(opapi)、使用模式(auto)\n- 说明强制前置步骤：发送问卷确认参数、创建 TODO.md、创建 /tmp/cannbot_add/ 临时目录\n- 说明主流程 Step 1-5：了解仓库信息（阅读基础知识文档、提取 SoC 列表、学习 build.sh 编译命令）→ 检查现有 UT 框架 → （跳过重构）→ 补全用例提升覆盖率 → 生成总结报告\n- 说明 op_api 层 UT 的核心组件：TensorDesc、ScalarDesc、OP_API_UT 宏\n- 说明 TDD 编写顺序：异常用例（nullptr/无效dtype/shape不匹配）→ 正常用例（各 dtype）→ 边界用例（空tensor/0维）\n- 说明覆盖率目标：行覆盖率 ≥ 80%、函数覆盖率 ≥ 80%",
+      "files": [],
+      "expectations": []
+    },
+    {
+      "id": 2,
+      "title": "覆盖率提升分析与补测策略",
+      "config": {
+        "max_tokens": 200000,
+        "max_tokens_by_model": {
+          "deepseek-v4-flash": 240000,
+          "glm-5": 220000
+        },
+        "ascend_platforms": [
+          "A2"
+        ],
+        "eval_mode": "text"
+      },
+      "prompt": "我需要为 ops-nn 仓的 Softmax 算子提升 op_host 层 UT 覆盖率，目标芯片 ascend910b，自动模式。当前行覆盖率 65%，函数覆盖率 70%，需要提升到 80% 以上。\n\n入口参数已确认：op_name=softmax, repo_type=ops-nn, soc_type=ascend910b, test_model=ophost, interactive_mode=auto。\n\n请直接告诉我 Step 4 补全用例提升覆盖率的完整流程：如何获取覆盖率、如何分析未覆盖代码、如何设计补测用例。",
+      "expected_output": "回复应基于 skill 的 Step 4 覆盖率提升流程，包含以下要点：\n- 获取覆盖率：使用 `bash build.sh -u --ophost --ops=softmax --soc=ascend910b --cov` 编译并生成覆盖率\n- 判断覆盖率类型：区分全局覆盖率和单算子覆盖率，全局覆盖率需用 `lcov --extract` 提取\n- 分析未覆盖代码：使用 `lcov --list ops.info_filtered | grep \":0\"` 获取未覆盖行\n- 按缺口类型补充策略：异常分支（ACLNN_ERR_*/GRAPH_FAILED）、dtype 分支（分析 tiling 实现中的 dtype 分支逻辑）、边界条件（空 tensor、大 shape）\n- op_host 层特有关注点：Tiling 测试（CompileInfo 类型检测、TilingContextPara）、InferShape 测试（NodeAttrs 配置）\n- 完成检查标准：行覆盖率 ≥ 80%、函数覆盖率 ≥ 80%",
+      "files": [],
+      "expectations": []
+    },
+    {
+      "id": 3,
+      "title": "op_api 层 dtype 排列组合校验",
+      "config": {
+        "max_tokens": 200000,
+        "max_tokens_by_model": {
+          "deepseek-v4-flash": 240000,
+          "glm-5": 220000
+        },
+        "ascend_platforms": [
+          "A2"
+        ],
+        "eval_mode": "text"
+      },
+      "prompt": "我需要为 ops-transformer 仓的 FlashAttention 算子确保 op_api 层 UT 覆盖所有合法 dtype 组合，目标芯片全选，自动模式。听说有脚本可以自动提取 dtype 组合。\n\n入口参数已确认：op_name=flash_attention, repo_type=ops-transformer, soc_type=all, test_model=opapi, interactive_mode=auto。\n\n请直接告诉我 dtype 排列组合校验的完整流程：如何定位 def 文件、如何使用脚本提取 dtype 组合、校验步骤和异常组合构造方法。",
+      "expected_output": "回复应基于 skill 的 Dtype 排列组合校验流程，包含以下要点：\n- 定位算子定义文件：`find ${op_path}/op_host -name \"*_def.cpp\"`\n- 使用脚本提取 dtype 组合：`python scripts/extract_dtype_combinations.py ${def_file}`，输出到 `/tmp/${op_name}_dtype_combinations.json`\n- 5 步校验流程：脚本提取 → 补充用例 → 覆盖率分析（lcov 检查 dtype 分支无 `:0`）→ 实际测试（build.sh 全部 PASS）→ 异常校验（构造 3 种非法组合返回 ACLNN_ERR_PARAM_INVALID）\n- 异常组合构造方法：跨位置组合、未定义 dtype、dtype 不一致\n- 判定标准：5 步全部通过则 dtype 校验完整",
+      "files": [],
+      "expectations": []
+    },
+    {
+      "id": 4,
+      "title": "入口参数问卷与强制前置步骤",
+      "config": {
+        "max_tokens": 100000,
+        "max_tokens_by_model": {
+          "deepseek-v4-flash": 120000,
+          "glm-5": 110000
+        },
+        "ascend_platforms": [
+          "A2"
+        ],
+        "eval_mode": "text"
+      },
+      "prompt": "我想给 ops-transformer 仓的 Mul 算子写 UT，芯片是 ascend950，测试 ophost 和 opapi 两个模块。请告诉我 skill 的入口参数有哪些，以及执行前必须完成哪些前置步骤（只需说明，不需要实际执行这些步骤）。",
+      "expected_output": "1. 回复应列出 skill 的 5 个入口参数及其取值：op_name（算子名，驼峰命名自动转为下划线命名）、repo_type（枚举 ops-math/ops-nn/ops-transformer/ops-cv/custom）、soc_type（枚举 ascend310p/ascend910b/ascend910_93/ascend950）、test_model（枚举 opapi/ophost/opkernel，可多选）、interactive_mode（auto 为默认、interactive 为交互模式）。\n2. 回复应说明 0.1 问卷确认步骤的两种分支：路径中存在完全等于标准仓名的目录段时走 0.1.1，用 question 工具按 assets/question.json 发送问卷，并在推断选项的 label 后加\"【推荐】\"；路径未匹配标准仓名时判定 repo_type=custom、interactive_mode=auto，走 0.1.2 自定义工程快速通道，跳过问卷且禁止使用 question 工具。\n3. 回复应说明 0.2/0.3 前置步骤（三个子步骤须逐一执行、不可跳过）：用 todowrite 工具按 assets/todo.json 创建 TODO.md（不允许任何修改）；创建 /tmp/cannbot_${op_name}/ 目录，将入口参数存入该目录下的 params.json，中间文件均放该目录。",
+      "files": [],
+      "expectations": []
+    },
+    {
+      "id": 5,
+      "title": "UT 框架重构流程",
+      "config": {
+        "max_tokens": 200000,
+        "max_tokens_by_model": {
+          "deepseek-v4-flash": 240000,
+          "glm-5": 220000
+        },
+        "ascend_platforms": [
+          "A2"
+        ],
+        "eval_mode": "text"
+      },
+      "prompt": "请介绍 ascendc-ut-develop 技能中 Step 3（重构 UT 框架）的详细步骤。我特别想了解：备份旧代码怎么做、搭建新框架要注意什么、ops-transformer 仓的 CSV 格式整改怎么走、迁移旧用例有什么规则、子 Agent 完成后要检查什么。不需要执行任何操作，只需要介绍知识。",
+      "expected_output": "回复应基于 skill 的 Step 3 重构流程，包含以下要点：\n- Step 3.1 备份旧框架代码：将 ut/${test_model} 下的 .cpp/.h 文件备份到 /tmp/cannbot_${op_name}/backup/，然后删除原文件\n- Step 3.2 搭建新框架：使用 Task 工具调用子 Agent，仅迁移一条预期成功的旧用例验证框架，UT 代码放在算子目录下而非仓库根目录的 test 目录\n- CSV 格式重构特殊路径：当 repo_type 为 ops-transformer 且用户提及 CSV 时，参考 ops-transformer.md 和 csv-refactor-workflow.md，使用 assets/csv-refactor/ 下的模板文件，查看详细规范 csv-format-spec.md\n- Step 3.3 迁移所有旧用例：每 5 条一组确保编译运行通过后再迁移下一组，不得更改已迁移用例和公共代码\n- 子 Agent 完成后必须检查：编译通过 + 运行测试全部 PASS + 用例数量与重构前一致",
+      "files": [],
+      "expectations": []
+    },
+    {
+      "id": 6,
+      "title": "op_host 层 Tiling 和 InferShape 测试要点",
+      "config": {
+        "max_tokens": 250000,
+        "max_tokens_by_model": {
+          "deepseek-v4-flash": 300000,
+          "glm-5": 275000
+        },
+        "ascend_platforms": [
+          "A2"
+        ],
+        "eval_mode": "text"
+      },
+      "prompt": "请简洁介绍 ascendc-ut-develop 技能中 op_host 层 UT 测试返回 GRAPH_FAILED 的常见原因和解决方法。请依次简要说明以下 5 个要点（每个要点 1-2 句话即可，不要写大段代码示例）：\n1. 最常见原因是什么（NodeAttrs 未配置）\n2. 如何配置 NodeAttrs（InferShape 和 Tiling 分别用什么 API）\n3. MatMul 系列算子有哪些常见属性\n4. CompileInfo 类型检测方法（如何确定命名空间）\n5. 如何确定需要哪些属性（查看什么宏、搜索什么函数调用）",
+      "expected_output": "回复应基于 skill 的 op-host-ut-guide 知识，简要包含以下要点：\n- 最常见原因：未配置 NodeAttrs。大部分算子的 InferShape/Tiling 函数会调用 context->GetAttr() 读取算子属性，未配置则返回 GRAPH_FAILED\n- 解决方案：InferShape 测试使用 InferShapeContextFaker().NodeAttrs() 配置属性，Tiling 测试使用 TilingContextFaker().NodeAttrs() + NodeInputTd()\n- MatMul 系列算子常见属性：adj_x1、adj_x2、offset_x、opImplMode（命名空间 Ops::NN）\n- CompileInfo 类型检测：必须先检测 TilingParse<TYPE> 的类型（BroadcastCompileInfo 用 Ops::Base:: 命名空间，自定义 CompileInfo 用 optiling:: 命名空间）\n- 如何确定需要哪些属性：查看 INFER_SHAPE_FUNC/TILING_FUNC 宏、搜索 GetAttr()/GetAttrValue() 调用",
+      "files": [],
+      "expectations": []
+    },
+    {
+      "id": 7,
+      "title": "正向看护-多 skill 环境下正确触发目标 skill",
+      "config": {
+        "max_tokens": 200000,
+        "ascend_platforms": [
+          "A2"
+        ],
+        "distractor_skills": [
+          "ascendc-st-design",
+          "ascendc-code-review",
+          "ascendc-whitebox-design",
+          "ascendc-api-best-practices"
+        ],
+        "eval_mode": "text"
+      },
+      "prompt": "请介绍 ascendc-ut-develop 技能中补全用例提升覆盖率的完整方法。请依次介绍以下 5 个方面：\n1. 如何获取覆盖率数据（具体编译命令，如 build.sh 的 --cov 参数）\n2. 如何分析未覆盖代码（具体工具，如 lcov 命令）\n3. 按哪些缺口类型补充用例（如异常分支、dtype 分支、边界条件等）\n4. op_api 层 UT 使用哪些核心组件（如 OP_API_UT 宏、TensorDesc 等）\n5. 覆盖率目标的具体数值（行覆盖率和函数覆盖率分别要达到多少）\n不需要执行任何操作，只需要介绍知识。",
+      "expected_output": "回复应正确激活 ascendc-ut-develop skill，基于其工作流给出指导。应说明：\n- 使用 build.sh --cov 获取覆盖率数据\n- 使用 lcov 分析未覆盖代码\n- 按缺口类型（异常分支/dtype 分支/边界条件）补充用例\n- op_api 层使用 OP_API_UT 宏、TensorDesc 等组件\n- 覆盖率目标：行覆盖率和函数覆盖率均 ≥ 80%\n即使在 ascendc-st-design、ascendc-code-review 等相似 skill 共存的环境下，也应正确选择 ascendc-ut-develop。",
+      "files": [],
+      "expectations": []
+    },
+    {
+      "id": 8,
+      "title": "UT 开发总结报告结构",
+      "config": {
+        "max_tokens": 100000,
+        "max_tokens_by_model": {
+          "deepseek-v4-flash": 120000,
+          "glm-5": 110000
+        },
+        "ascend_platforms": [
+          "A2"
+        ],
+        "eval_mode": "text"
+      },
+      "prompt": "ascendc-ut-develop 的 UT 开发总结报告（Step 5）包含哪些章节？每个章节需要记录什么信息？",
+      "expected_output": "回复应基于 skill 的 assets/template_report.md 模板，列出报告的完整结构：\n- 基本信息：算子名称、算子仓、算子类别、SoC 版本、支持的 dtype 和 format\n- 层支持情况：op_host/op_api/op_kernel 各层是否支持\n- UT 文件路径：展示 ut/ 目录下 op_api/op_host/op_kernel 的文件树\n- 用例统计：按层分别统计异常用例、正常用例、边界用例的数量\n- 覆盖率统计：覆盖率类型（全局/单算子）、行覆盖率/函数覆盖率/分支覆盖率的值和目标（≥80%）\n- 遇到的问题及解决方案\n- 编译命令记录\n- 最终状态检查清单：编译通过、测试通过、覆盖率类型判断、覆盖率达标、TDD 流程遵循、报告生成",
+      "files": [],
+      "expectations": []
+    },
+    {
+      "id": 9,
+      "title": "信息不足时主动追问",
+      "config": {
+        "max_tokens": 1000000,
+        "max_tokens_by_model": {
+          "deepseek-v4-flash": 1000000,
+          "glm-5": 1000000
+        },
+        "ascend_platforms": [
+          "A2"
+        ],
+        "eval_mode": "text"
+      },
+      "prompt": "帮我写 UT",
+      "expected_output": "回复应主动追问关键信息，而不是直接开始编写 UT。应至少询问以下信息中的一项或多项：算子名称、仓库类型（ops-math/ops-nn/ops-transformer/ops-cv/custom）、目标芯片架构（ascend310p/ascend910b/ascend910_93/ascend950）、测试模块（opapi/ophost/opkernel）。不应在缺乏算子规格的情况下直接生成测试代码。",
+      "files": [],
+      "expectations": []
+    },
+    {
+      "id": 10,
+      "title": "build.sh 编译命令与 --noexec 注意事项",
+      "config": {
+        "max_tokens": 160000,
+        "max_tokens_by_model": {
+          "deepseek-v4-flash": 192000,
+          "glm-5": 176000
+        },
+        "ascend_platforms": [
+          "A2"
+        ],
+        "eval_mode": "text"
+      },
+      "prompt": "在 ascendc-ut-develop 的工作流中，build.sh 的 --noexec 参数有什么作用？使用时需要注意什么？获取覆盖率的编译命令是什么？",
+      "expected_output": "回复应基于 skill 的 Step 1.3 知识，包含以下要点：\n- 不带 --noexec：编译 + 运行一步完成，推荐日常使用，能发现 CSV 格式等运行时错误\n- 带 --noexec：仅编译不运行，仅用于快速验证语法错误\n- 常见错误：加了 --noexec 后忘记运行测试，导致 CSV 格式错误未被发现\n- 编译通过后必须再运行测试\n- 获取覆盖率的命令：`bash build.sh -u --ops=${op_name} --soc=${soc_type} --cov`\n- 按模块编译：`--opapi`、`--ophost`、`--opkernel`",
+      "files": [],
+      "expectations": []
+    }
+  ],
+  "skill_name": "ascendc-ut-develop"
+}

package/assets/ops-direct-invoke/skills/ascendc-ut-develop/references/coverage-guide/coverage-extraction.md

@@ -0,0 +1,78 @@
+# 覆盖率提取指南
+
+## 判断覆盖率类型
+
+编译后需要先判断是**全局覆盖率**还是**单算子覆盖率**：
+
+```bash
+# 进入覆盖率目录
+cd <repo>/build/tests/ut/cov_report/cpp_utest
+
+# 查看覆盖率报告包含的文件路径
+lcov --list ops.info_filtered | head -50
+```
+
+| 覆盖率类型 | 文件路径特征 | 处理方式 |
+|-----------|-------------|---------|
+| **单算子覆盖率** | 仅包含当前算子路径（如 `*/math/abs/*`） | 直接使用，无需提取 |
+| **全局覆盖率** | 包含多个算子路径（如 `*/math/abs/*`, `*/math/add/*`） | 需要使用 `lcov --extract` 提取 |
+
+---
+
+## 提取单算子覆盖率
+
+如果编译输出的是全局覆盖率，执行以下命令提取：
+
+```bash
+lcov --extract ops.info_filtered \
+    "*/<category>/<op>/op_api/*" \
+    "*/<category>/<op>/op_host/*" \
+    "*/<category>/<op>/op_kernel/*" \
+    "*/<category>/<op>/op_kernel_aicpu/*" \
+    "*/<category>/<op>/op_tiling/*" \
+    -o /tmp/<op>_cov.info
+
+# 查看摘要
+lcov --summary /tmp/<op>_cov.info
+```
+
+> **注意**：根据算子实际支持的层级选择对应的路径，不需要的层级可以省略。
+
+---
+
+## 覆盖率目标
+
+| 场景 | 行覆盖率 | 函数覆盖率 | 分支覆盖率 |
+|------|---------|-----------|-----------|
+| 最低标准 | ≥ 80% | ≥ 80% | ≥ 80%（推荐） |
+| 推荐标准 | ≥ 90% | ≥ 90% | ≥ 85% |
+
+---
+
+## 常见问题
+
+| 问题 | 原因 | 解决方案 |
+|------|------|---------|
+| 覆盖率很低（<10%） | 看的是全局覆盖率 | 判断类型后使用 `lcov --extract` 提取 |
+| 某文件覆盖率 0% | cmake或链接问题 | 检查 CMakeLists.txt，用 `lcov --list` 查看详情 |
+| InferDataType 覆盖率 0% | infershape 测试不调用 infer_data_type | 创建单独测试或接受该部分为 0% |
+| 提取后覆盖率仍为 0% | 路径模式不匹配 | 检查路径是否正确，确保层级目录存在 |
+
+---
+
+## 生成 HTML 报告
+
+```bash
+genhtml /tmp/<op>_cov.info -o /tmp/<op>_cov_html --title "<op> Operator Coverage"
+```
+
+---
+
+## 覆盖率提升策略
+
+| 缺口类型 | 补充策略 |
+|---------|---------|
+| 异常分支 | 添加 ACLNN_ERR_*/GRAPH_FAILED 用例 |
+| dtype分支 | 确保每个 dtype 都有测试 |
+| 边界条件 | 添加空tensor、大shape用例 |
+| 格式分支 | 添加各 format 的测试用例 |

package/assets/ops-direct-invoke/skills/ascendc-ut-develop/references/coverage-guide/test-implementation.md

@@ -0,0 +1,136 @@
+# 测试用例实现指南
+
+## 任务描述
+
+为未覆盖的代码分支设计并实现具体的测试用例。
+
+---
+
+## 输入参数
+
+| 参数 | 说明 |
+|------|------|
+| uncovered_lines | 未覆盖代码的文件和行号列表 |
+| coverage_report | 当前覆盖率报告 |
+| operator_info | 算子信息（名称、类型、数据类型等） |
+| existing_tests | 已有测试用例列表 |
+| soc_version | SOC版本列表 |
+| output_dir | 输出目录 |
+
+---
+
+## 执行步骤
+
+### 1. 分析未覆盖代码
+
+对于每个未覆盖的代码区域：
+
+1. **读取代码实现**：找到对应的源文件，理解代码逻辑
+2. **分析分支条件**：识别进入该分支需要的参数组合
+3. **确定进入条件**：
+   - 数据类型要求（FP16/FP32/INT8等）
+   - 张量形状要求（M, N, K维度）
+   - 特殊参数要求（quantScale, antiQuantScale等）
+
+### 2. 设计测试用例
+
+根据 AscendC UT 规范设计测试用例。
+
+**测试文件位置**：`{repo}/{category}/{operator_name}/tests/ut/op_host/{test_file}.cpp`
+
+**测试用例模板**：
+
+```cpp
+// 测试用例命名规范：Test{OperatorName}{Scenario}
+TEST_F({OperatorName}Test, TestScenario_{description}) {
+    // 1. 准备输入参数
+    int param1 = value1;
+    int param2 = value2;
+
+    // 2. 创建输入tensor
+    auto x1 = CreateTensor({M, K}, dtype1);
+    auto x2 = CreateTensor({K, N}, dtype2);
+
+    // 3. 设置特殊参数（如有）
+    // quantScale = xxx;
+
+    // 4. 执行算子
+    auto output = ExecuteOperator(x1, x2, param1, param2);
+
+    // 5. 验证结果
+    EXPECT_EQ(output.shape(), expected_shape);
+}
+```
+
+### 3. 常见进入条件及参数设置
+
+| 条件类型 | 示例 | 参数设置 |
+|---------|------|---------|
+| 数据类型分支 | if (dtype == INT8) | dtype=INT8 |
+| 形状条件 | if (M >= 16 && K >= 64) | M=16, K=64 |
+| 特殊参数 | if (hasQuantScale) | 提供quantScale参数 |
+| 场景检测 | if (IsCapable(...)) | 满足IsCapable条件的参数 |
+
+### 4. 验证覆盖效果
+
+执行编译测试命令验证：
+
+```bash
+cd {PROJECT_DIR} && bash build.sh -u --ophost --ops='{operator_name}' --soc='{soc_version}' --cov 2>&1 | tee {output_dir}/log/round_N.log
+```
+
+**验证步骤**：
+1. 确认编译成功
+2. 确认所有测试通过
+3. 对比覆盖率变化
+4. 更新覆盖率报告
+
+---
+
+## 处理无法覆盖的代码
+
+如果某些代码确实无法覆盖，分析原因：
+
+| 类型 | 说明 | 示例 |
+|------|------|------|
+| 死代码 | 条件永远为真/假 | useMmOutputAsX1Input硬编码为true |
+| 不参与UT | fallback实现 | fallback.cpp不在ophost测试范围 |
+| 条件不可能满足 | 参数组合冲突 | 需要同时满足A和B，但A和B互斥 |
+
+---
+
+## 输出结果
+
+输出以下信息供主智能体评估：
+
+```markdown
+# 测试用例实现报告
+
+## 新增测试用例
+- TestXxxScenario_1: 覆盖 xxx.cpp:123-145
+- TestXxxScenario_2: 覆盖 xxx.cpp:200-210
+
+## 覆盖率变化
+- 调用前覆盖率：XX.XX%
+- 调用后覆盖率：XX.XX%
+- 提升：+X.XX%
+
+## 测试结果
+- 新增测例数：X
+- 通过测例数：X
+- 失败测例数：X（如有，说明原因）
+
+## 无法覆盖代码（如有）
+| 文件:行号 | 类型 | 原因 |
+|-----------|------|------|
+| xxx.cpp:789 | 死代码 | ... |
+```
+
+---
+
+## 注意事项
+
+- 测试用例必须符合项目规范
+- 避免与现有测试用例重复
+- 确保测试用例可维护性
+- 保存所有修改到指定输出目录

package/assets/ops-direct-invoke/skills/ascendc-ut-develop/references/custom/custom.md

@@ -0,0 +1,5 @@
+# 自定义算子仓 UT 开发最佳实践
+
+> **适用范围**：不属于标准算子仓（ops-math/ops-nn/ops-transformer/ops-cv）的自定义算子仓
+
+参考 Skill `ascendc-registry-invoke-template` references/add_example 中的模板进行搭建。