菜单
Ascend C 算子 UT 开发与覆盖率增强，支持 ops-math/ops-nn/ops-transformer/ops-cv。**主动触发场景**：用户提及"UT"、"单元测试"、"覆盖率"、"测试用例"、"未覆盖代码"、"测试补充"、"提升覆盖率"等关键词时自动触发。当需要生成 UT、补充测试用例、提升覆盖率、分析未覆盖代码时使用。注意：ST 测试不适用。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Profile PyPTO kernels in-core with the Ascend msprof op-simulator — cycle-accurate per-kernel traces. Use when the user wants to profile a built case, inspect kernel timing or instruction streams, or generate MindStudio Insight traces.
Tune cube/matmul tile sizes (row tile, N fragment, K fragment) for a PyPTO kernel — analytic hints, an on-chip buffer constraint model, and an empirical device sweep. Use when optimizing a matmul/cube's throughput, sizing the row / N / K tiles, resolving Mat (L1) / L0C / UB buffer overflows, or trading one tile dim for another.
Locate which pypto commit introduced a precision regression. Only pypto and its corresponding simpler (submodule) are tracked — ptoas and pto-isa versions are not part of the bisect. If the culprit is a simpler submodule bump, performs a second-level bisect within simpler.
Reproduce a reported problem, collect dependency versions, and create a GitHub issue. Use when the user wants to file a bug, request a feature, or create any GitHub issue.
Ascend C 开发资源索引（本地+在线）。提供：(1) 本地 API 文档索引、示例代码映射，(2) 在线文档搜索功能，(3) 资源查找优先级，(4) Explore Agent 使用指南。优先使用本地资源，仅在本地检索不到时使用在线搜索。
Complete git commit workflow including pre-commit checks, staging, message generation, and verification. Use when creating commits or preparing changes for commit.
| name | ascendc-ut-develop |
| description | Ascend C 算子 UT 开发与覆盖率增强，支持 ops-math/ops-nn/ops-transformer/ops-cv。**主动触发场景**：用户提及"UT"、"单元测试"、"覆盖率"、"测试用例"、"未覆盖代码"、"测试补充"、"提升覆盖率"等关键词时自动触发。当需要生成 UT、补充测试用例、提升覆盖率、分析未覆盖代码时使用。注意：ST 测试不适用。 |
本技能提供 Ascend C 算子 UT 开发的完整工作流程，支持从零创建 UT 和覆盖率增强两种模式。
UT 生成遵循四步节奏：理解 → 规划 → 实现 → 验证。
适用：算子开发完成后生成 UT、补充测试用例、提升覆盖率、验证算子正确性
不适用：算子功能尚未实现、编译错误未解决、环境配置问题
进入主流程前，必须先判断走哪条路径。这是整个技能的核心决策点。
# 检查 tests/ut 目录下是否有测试文件
find <repo>/<category>/<op>/tests/ut -name "test_*.cpp" 2>/dev/null | head -5
[UT 存在性检测] tests/ut/ 目录下是否有 test_*.cpp 测试文件？
│
├─ 是 → 【覆盖率增强模式】
│ │
│ └─ UT 已存在，跳转到"覆盖率增强流程"
│ 目标：提升现有覆盖率至 90%+
│
└─ 否 → 【UT 生成模式】
│
└─ UT 不存在，继续"UT 生成流程"
目标：从零创建 UT，覆盖率 80%+
| 模式 | 触发条件 | 目标 | 流程 |
|---|---|---|---|
| 覆盖率增强模式 | tests/ut/ 下存在 test_*.cpp 文件 | 覆盖率 90%+ | 跳转到 覆盖率增强流程 |
| UT 生成模式 | tests/ut/ 下不存在 test_*.cpp 文件 | 覆盖率 80%+ | 继续 UT 生成完整流程 |
适用场景：算子 tests/ut/ 目录下不存在 test_*.cpp 文件，需要从零创建 UT。
完整流程（Phase UT-1 至 UT-6）详见 ut-generator-workflow.md
| Phase | 任务 | 输出 |
|---|---|---|
| UT-1 | 信息收集与自动探索 | 层级支持、SoC、dtype/format、编译命令 |
| UT-2 | op_host UT 编写（P0） | Tiling 测试、InferShape 测试 |
| UT-3 | op_api UT 编写（P1） | 参数校验测试 |
| UT-4 | op_kernel UT 编写（P2） | Kernel 计算逻辑测试 |
| UT-5 | 覆盖率验证 | 覆盖率报告、达标状态 |
| UT-6 | 生成最终报告 | UT 生成总结报告 |
适用场景：算子 UT 代码已存在，需要提升覆盖率。
完整流程（Phase CE-1 至 CE-6）详见 coverage-enhancement-workflow.md
| Phase | 任务 | 输出 |
|---|---|---|
| CE-1 | 收集算子基本信息 | 层级、算子名、输出路径 |
| CE-2 | 获取初始覆盖率 | 覆盖率基线报告 |
| CE-3 | 分析与实现测例 | 新增测试用例 |
| CE-4 | 持续迭代优化 | 覆盖率提升报告 |
| CE-5 | 生成最终报告 | 可覆盖/无法覆盖代码清单 |
| CE-6 | 输出进入条件清单 | 参数配置指南 |
覆盖率增强流程通过 Task 工具调用子智能体执行（因迭代分析需要较大上下文空间）：
尝试次数 = 0
每层编译失败 → 查看错误日志 → 尝试修复 → 尝试次数+1
编译产物的覆盖率可能是全局的（包含多个算子），需要先判断类型再决定是否提取：
1. 编译后先判断覆盖率类型：
- 查看覆盖率报告中的文件路径
- 如果包含多个算子路径 → 全局覆盖率，需提取
- 如果仅包含当前算子路径 → 单算子覆盖率，可直接使用
2. 全局覆盖率处理（如需要）：
- 使用 lcov --extract 提取单算子覆盖率
- 详见 [coverage-extraction-guide.md](references/coverage-enhancement/coverage-extraction-guide.md)
3. 验证标准：行覆盖率 >= 80% 且函数覆盖率 >= 80%（分支覆盖率 >= 80% 推荐但非必须）