| name | ge-dt-runner |
| description | 编译和运行 GE (Graph Engine) 项目的单元测试(UT)和系统测试(ST)。当用户需要编译或运行 GE 项目的 UT/ST 用例时使用此 skill。适用场景包括编译特定的测试目标、运行特定的测试用例、处理测试相关的依赖和环境配置，用户的指令可能是编译并运行测试，运行用例，执行用例，测试用例等，优先使用该skill |
GE 单元测试(UT)和系统测试(ST)测试执行
工作流程
步骤 1: 制定计划
步骤 2: 配置 toolkit 环境变量
2.1 检查已保存的路径配置
配置文件路径：~/.config/ge-dt-runner/config.json
首先检查配置文件是否存在并读取已保存的路径：
cat ~/.config/ge-dt-runner/config.json 2>/dev/null
如果存在已保存的路径，直接使用该路径，跳过路径选择流程。
如果不存在已保存的路径，进入路径选择流程，不要自作主张选择默认路径
2.2 路径选择流程
询问用户选择 toolkit 包安装路径：
问题：您的 cann-toolkit 包安装路径？
- 选项：默认路径 —
${HOME}/Ascend
- 选项：自定义路径 — 输入完整路径
根据选择拼接完整路径：
- 默认路径：
ASCEND_INSTALL_PATH=${HOME}/Ascend/ascend-toolkit/latest/
- 自定义路径：
ASCEND_INSTALL_PATH=<用户输入>/ascend-toolkit/latest/
验证路径是否存在：
ls ${ASCEND_INSTALL_PATH}
2.3 询问是否记住选择
路径确认后，询问用户：
是否记住此路径配置？
- 选项：仅本次使用 — 不保存
- 选项：记住我的选择 — 保存到配置文件
如果用户选择"记住我的选择"，保存配置：
mkdir -p ~/.config/ge-dt-runner
cat > ~/.config/ge-dt-runner/config.json << 'EOF'
{
"cann_toolkit_base_path": "<用户输入的基础路径，例如 /home/ge/Ascend>",
"cann_toolkit_path": "<完整路径，例如 /home/ge/Ascend/ascend-toolkit/latest/>"
}
EOF
2.4 设置环境变量
最后执行：
source ${ASCEND_INSTALL_PATH}/bin/setenv.bash
步骤 3: 执行 CMake
触发条件：
CRITICAL: 构建目录唯一性规则
- 构建目录必须且只能使用
cmake-build-gcov
- 禁止使用
build_ut、build_st 或其他任何目录，即使这些目录已存在
build_ut 是 tests/run_test.sh 全量测试脚本的产物，与本 skill 无关- 编译和执行测试的根目录始终是
cmake-build-gcov
BASEPATH=$PWD
BUILD_DIR=${BASEPATH}/cmake-build-gcov
ASCEND_INSTALL_PATH=<从步骤2获取的路径>
cmake -DCMAKE_BUILD_TYPE=GCOV \
-DENABLE_OPEN_SRC=True \
-DENABLE_GE_UT=ON \
-DENABLE_GE_ST=ON \
-DENABLE_TEST=True \
-DENABLE_PKG=ON \
-DASCEND_INSTALL_PATH=${ASCEND_INSTALL_PATH} \
-DCANN_3RD_LIB_PATH=${CANN_3RD_LIB_PATH} \
-S ${BASEPATH} \
-B ${BUILD_DIR}
步骤 4: 编译受影响的 target
根据修改的或新增的 tests/ 目录下的 .cc 文件，识别影响到哪个 target。
重要规则：
步骤 5: 执行测试
unset LD_LIBRARY_PATH; unset ASCEND_OPP_PATH，执行用例前需要执行这两条unset命令，原因是用例执行需要首先在同目录下寻找依赖的so- 测试可执行文件位于
cmake-build-gcov/ 目录下，绝对路径为 ${BASEPATH}/cmake-build-gcov/<target>
- 使用
--gtest_filter 单独运行指定的测试用例。
- 输出较多，注意不要直接读取输出
- 如需要，可通过设置
ASCEND_GLOBAL_LOG_LEVEL=0/1/2/3开启日志，分别是debug/info/warning/error级别日志，默认3 error级别．
变量说明
BASEPATH: 项目根目录（.claude 所在路径）ASCEND_INSTALL_PATH: toolkit 安装路径CANN_3RD_LIB_PATH: 第三方依赖库路径
注意
- 一般ut和st文件比较大，在读取前先使用wc -l查看文件行，如果太大了不要全读
- 新增加用例需要注意文件结尾的namespace结尾的}，增加用例需要放到}的上方
- 任何cmake, make, gcc命令，或者"输出较多"的任务，都不能直接读取输出，否则会导致token和上下文空间消耗过多，需要先输出到临时文件，然后过滤查看是否有错误。成功后需要清理临时我文件
- ASCEND_INSTALL_PATH 目录下的是cann toolkit包中的安装文件，不能修改
- graph_metadef 目录下定义的是基础数据结构，除非是需求中新增加类型定义，否则不要修改
- 第三方库路径下的文件也不能修改
- 更新toolkit包之后，需要清理缓存重新camke和make
- 由于从头编译时间太长，所以除非SKILL中特意说明，否则尽量不要清理缓存重新编译
常见问题
常见编译错误
- 如果是rt或者aclrt开头的接口编译报错，需要主动使用skill更新cann toolkit包，如果更新后还未解决，就不要再次尝试了，报告错误停止进一步重试。
比如rtGetRtCapability
In function ‘rtError_t rtGetRtCapability(rtFeatureType_t, int32_t, int64_t*)’:
runtime_stub.cc:1492:23: error: ‘FEATURE_TYPE_PERSISTENT_STREAM_UNLIMITED_DEPTH’ was not declared in this scope
- 编译代码如果报缺少下面的软件，需要执行
sudo apt-get install cmake ccache bash lcov libasan4 autoconf automake libtool gperf libgraph-easy-perl patch安装
- 如果缺少python相关包，执行
pip3 install -r requirements.txt
常见运行错误
