导管导航氟透视冒烟测试
在无 GPU 环境中快速验证导管导航工作流的基础功能。
技能明确为CPU-only并声明无需GPU、未识别凭据,也将写入范围限制在工作流runs目录;但会在缺失时直接从外部GitHub克隆到环境路径,未固定提交、未要求用户确认、未披露网络供应链风险,且缺少失败回滚说明,因此扣分。
命令、测试目标、日志保存和Ran/OK核验路径清楚,且有外部评估报告与任务定义;但依赖外部工作流和未锁定依赖,命令未启用pipefail,unittest失败可能被tee的成功状态掩盖,异常输入和诊断反馈有限,因此限制在静态上限10以内并扣分。
名称、描述和正负触发场景较明确,明确区分CPU smoke与GPU渲染,并列出不覆盖GPU viewport的边界;但未清楚定义输入输出契约、非适用范围仍有限,且缺失工作流时核心恢复依赖GitHub,可能受中国大陆网络可达性影响,因此扣分。
文档有目的、运行、预期输出、验证、前置条件、限制、故障排查和最终响应,版本、作者及Apache-2.0声明也存在;但评估报告指出version放在错误的frontmatter位置,缺少推荐的Instructions和Examples章节,仓库级NOASSERTION元数据与技能声明存在治理不确定性,维护更新责任和变更路径不够清晰,因此扣分。
技能直接提供可复用的CPU smoke测试命令、时间戳日志和结果报告要求,评估任务覆盖导入、预处理、解析器及负向触发;但静态审查不能确认实际测试结果,报告仅给出有限样本且整体效果指标并非关键路径的独立证明,输出仍需人工判断日志,因此按静态上限7并扣分。
SKILL.md给出可审计命令和明确核验字符串,BENCHMARK.md及evals.json提供有限的第三方评估记录;但没有提交的该技能专属测试套件或CI复现证据,评估结果无法仅凭这些文件独立重现,因此静态评为4并扣分。
- 执行前应确认允许联网并从指定仓库获取代码;最好固定并校验工作流提交或发布版本。
- 为避免掩盖测试失败,应使用set -o pipefail并检查unittest退出状态,而不只检查日志中的Ran和OK。
- 该技能只验证CPU smoke路径,不验证GPU Slang渲染或交互viewport;缺失依赖时可能受GitHub在中国大陆的网络可达性影响。
- 建议修正version元数据位置并补充Instructions、Examples、依赖版本、维护责任和更新路径。
这个 Skill 能做什么,适合哪些场景?
该技能为 Isaac for Healthcare 的导管导航氟透视组件提供仅使用 CPU 的单元冒烟测试。它检查模块导入、CT 到衰减系数的预处理、命令行解析器以及条件式视口导入。测试适合在 CI 或没有 GPU 的环境中运行。它不覆盖 GPU Slang 渲染或交互式视口,因此通过后仍需单独进行 GPU 验证。
定位或克隆 i4h-workflows 仓库,进入 catheter_navigation 工作流目录,创建带时间戳的 smoke 运行目录和日志目录,并更新 .latest 符号链接。随后运行 workflows/catheter_navigation/tests/test_fluorosim_smoke.py,使用 Python unittest 执行测试并将输出写入 smoke.log。最后通过 grep 检查测试数量和 OK 状态;负面 CLI 测试产生的解析器错误行属于预期输出。
- 负责 CI 的开发者想在没有 NVIDIA GPU 的构建环境中检查导管导航代码的基础导入和解析器行为。
- 维护氟透视模拟组件的工程师需要快速验证 CT 到衰减系数预处理是否仍可运行。
- 在提交或分支变更后,测试人员需要确认基础 smoke 测试通过,并保留带时间戳的日志。
- 排查导入失败的开发者需要确认当前虚拟环境是否安装了导管导航工作流依赖。
这个 Skill 有哪些优点和局限?
- 不需要 GPU,适合 CI 和 CPU-only 环境。
- 覆盖导入、CT 到衰减系数预处理、CLI 解析器和条件式视口导入检查。
- 自动创建带时间戳的运行目录并保存日志。
- 不测试 GPU Slang 渲染或交互式视口。
- 要求 Python 3、Git 以及已安装的导管导航工作流依赖。
- 源材料没有提供固定测试数量,也没有列出受支持的平台矩阵。
- 如果本地找不到工作流目录,脚本会尝试从 GitHub 克隆仓库,需要网络访问。
如何安装这个 Skill?
使用 NVIDIA/skills 仓库的 skills CLI 安装:
npx skills add nvidia/skills --skill i4h-catheter-navigation-smoke --yes
也可以运行 npx skills add nvidia/skills 后按提示选择技能和安装目标。README 未规定该技能在具体客户端中的手动目录路径。
如何使用这个 Skill?
向已加载该技能的代理提出类似“在 CI 中对 catheter navigation 运行 CPU-only fluorosim smoke tests”的请求。技能会使用以下测试命令:
python3 -m unittest workflows/catheter_navigation/tests/test_fluorosim_smoke.py 2>&1 | tee "${RUN_DIR}/logs/smoke.log"
通过条件是日志包含“Ran N tests”以及“OK”。完成后报告通过或失败、测试数量和日志路径;即使通过,也要说明 GPU 阶段仍需单独验证。
这个 Skill 与同类方案有什么区别?
与 i4h-catheter-navigation-render-drr 互补:本技能用于无 GPU 的基础 smoke 测试,而 GPU 验证应使用该渲染技能。源材料未提供其他替代方案的详细比较。