Holoscan Sensor Bridge 应用运行器
在连接的开发套件上筛选、运行并调试 HSB 示例应用。
技能要求显式调用、阶段确认、代码修改前确认,并说明 SSH、Docker、设备映射和清理流程;但允许 Bash、sudo 变量、--privileged、--net host、/dev 挂载、xhost 和远程写入,且会打印解析后的环境变量,缺少最小权限、敏感值保护、完整数据流披露和可靠回滚,因此扣分。
阶段化流程、超时看门狗、日志摘要、失败分类、重验证和容器清理较完整;但仅有静态文档,未见覆盖关键路径的提交测试,且 heredoc、变量插值、远程路径和容器运行条件存在未验证假设,按静态上限保守评分。
目标用户、硬件类型、传感器筛选、显式触发和非适用平台约束描述清楚;但未提供中文交互或中国大陆网络可达性说明,且依赖已配置的远程 devkit、SSH、Docker、GPU runtime 和硬件,边界证据有限。
具备 frontmatter、Apache-2.0 标注、版本 1.0.0、作者、引用的阶段文档、帮助和示例;但缺少独立 Instructions/Examples/Purpose 章节,基准报告指出缺少先决条件说明,未提供 changelog,维护责任和更新路径仅能从仓库级说明间接推断。
工作流覆盖发现、筛选、运行、故障分析、迭代和报告,并包含有限的评估结果,表明核心任务具有实用价值;但静态审查无法验证实际输出、硬件兼容性或修复有效性,且输出仍依赖用户环境和人工选择,因此不超过静态上限。
提供了固定版本、具体命令、评估任务、基准指标和阶段步骤,具备一定审计线索;但没有可核验的 CI、提交测试或第三方复现实验,基准结果属于随附报告而非独立复核,跨来源佐证不足。
- 执行会涉及远程 SSH、Docker --privileged、主机网络、/dev 挂载、GPU 和图形显示权限;运行前应人工核对目标主机、镜像、设备和命令范围。
- 环境变量解析值可能包含敏感 SSH 选项或路径信息,不应未经筛选直接展示或写入报告。
- 容器停止和会话 teardown 使用宽泛名称过滤及远程 rm -rf;应确认目标仅限本技能创建的资源,并准备外部恢复方案。
- 核心功能依赖已配置的 NVIDIA/HSB devkit、硬件、Docker runtime 和本地网络,未证明在中国大陆网络环境或中文交互下可用。
这个 Skill 能做什么,适合哪些场景?
hsb-app 面向已完成配置的 Holoscan Sensor Bridge 开发套件,用于发现并运行兼容的示例应用。它会根据平台、HSB 软件版本、板卡类型和传感器筛选应用,并在演示容器中执行。技能支持定时运行、失败分析、代码或环境修改建议以及迭代重跑。它要求用户显式调用,并在首次运行时通过 SSH 验证开发套件、板卡和容器状态。
读取并显示 SSH_TARGET、REMOTE_ROOT、REMOTE_SUDO、REMOTE_SSH_OPTS 和 HSB_PLATFORM 等环境变量;通过 SSH 检查远程会话状态、开发套件连通性、HSB 板卡响应、FPGA 版本、板卡身份和演示容器;读取用户指南与 examples/,按用户的平台、HSB 版本、板卡和传感器筛选应用;在 Docker 演示容器中运行选定应用,Python 示例使用 python3;监控输出并分析失败,提出代码或环境编辑建议,支持重跑;生成会话报告并提供保存选项。
- Holoscan Sensor Bridge 开发者已连接板卡,想从 examples/ 中找到与当前平台和传感器匹配的示例。
- 硬件工程师需要在远程开发套件上验证 HSB 板卡、FPGA 版本和演示容器是否可用。
- 应用开发者运行 HSB 示例失败,希望根据日志获得根因分析、修改建议和再次运行流程。
- 测试人员需要以指定秒数运行示例并获得包含问题、修复和结果的会话报告。
这个 Skill 有哪些优点和局限?
- 覆盖从远程连通性、板卡识别到示例运行和报告生成的完整流程。
- 按平台、HSB 版本、板卡类型和传感器筛选应用,减少选择不匹配示例的风险。
- 支持超时监控、失败分析、修改建议和迭代重跑。
- 支持 Claude Code 和 Codex 元数据目标,并使用通用 shell、文件和文本搜索工具。
- 要求开发套件、HSB 板卡、SSH、演示容器和主机配置事先就绪。
- 工作流依赖远程 SSH、Docker 和具体硬件,不能作为纯本地或无硬件示例运行器使用。
- 技能包含 Claude Code 风格的禁用自动调用、斜杠命令参数和会话状态路径;迁移到其他客户端需要适配。
- 源材料未提供该单项技能的测试覆盖或独立基准证据。
如何安装这个 Skill?
使用仓库 README 中的 Skills CLI 安装指定技能:
npx skills add nvidia/skills --skill hsb-app --yes
也可以指定客户端:
npx skills add nvidia/skills --skill hsb-app --agent codex
源材料没有规定手动复制后的具体目录。技能本身标注为 Apache-2.0;仓库 README 声明仓库采用 Apache 2.0 与 CC BY 4.0 双许可证,而仓库元数据列出为 NOASSERTION。
如何使用这个 Skill?
确保开发套件已完成 SSH、演示容器、主机和板卡配置,并设置 SSH_TARGET 与 REMOTE_ROOT;未完成配置时先运行 /hsb-setup。然后显式调用:
/hsb-app
可选参数包括 /hsb-app --timeout 60、/hsb-app --verbose、/hsb-app --full 和 /hsb-app --help。首次运行必须先查看环境变量并确认 Phase 0;各阶段通常需要用户确认。未提供 SSH_TARGET 或 REMOTE_ROOT 时,技能会要求补充。