NeMo Relay 运行时集成调试
定位 NeMo Relay 已安装但运行时行为异常的应用集成问题。
技能范围限定为 NeMo Relay 运行时集成诊断,未要求凭据或广泛访问;skill-card 明确禁止在提示、日志和输出中包含秘密,且建议最小权限。但 uv sync、重建原生组件、修改加载器路径和导出配置可能产生外部或环境影响,缺少用户确认、回滚方案、数据流说明和逐步安全边界,因此扣分。
故障分类与排查矩阵内部一致,覆盖 Python、Node、Go、Rust、作用域、并发、插件和导出路径,并提供若干可诊断检查。缺少具体命令、版本前置条件、异常输入处理和失败后的明确分支;静态审查且无针对该技能关键路径的提交测试,因此不超过静态上限并扣分。
描述清楚了目标用户和触发场景,包括加载失败、作用域、事件、插件及自适应问题,也列出 managed/manual/typed/adaptive API 层选择。未明确非适用边界、输入输出契约、触发排除条件或中文使用支持;未证明依赖中国大陆可达服务,但核心功能也未声明完全依赖海外服务,因此扣分。
SKILL.md 简短分层,包含元数据、首次检查、故障类别、矩阵和相关技能;skill-card 补充了许可证、依赖和风险。缺少 Instructions、Examples,且静态校验报告明确指出这些缺项;没有清晰的版本策略、变更记录、维护责任人和更新路径,作者格式也不符合报告要求,因此扣分。
矩阵直接覆盖三个评测正例:Python 原生扩展导入、Node 生命周期事件、Go 跨请求作用域隔离;提交的评测报告显示正向任务整体结果较好,并包含负向触发任务。但建议多为方向性步骤,缺少可直接复制的命令、版本/平台分支和完整验证输出;评测报告不能替代本次静态复现,因此按静态上限保守扣分。
SKILL.md、评测报告和 evals.json 提供了可审计的故障映射、预期行为和有限评测证据,且报告披露了静态校验发现。评测仅四个任务、每任务一次尝试,未提供独立复现日志、提交测试套件或多源交叉验证;因此低置信度且不超过静态上限。
- 执行 uv sync、原生扩展重建、动态库路径修改或导出配置前,应确认环境范围、权限和可回滚方案。
- 矩阵缺少具体版本、命令参数和失败分支;应结合实际 NeMo Relay 版本及平台文档验证,不要将方向性建议视为已验证修复。
- 技能未定义明确的非适用场景、中文输出约定或中国大陆网络可达性。
这个 Skill 能做什么,适合哪些场景?
该技能面向 NeMo Relay 已导入或安装、但应用侧运行行为缺失或不正确的场景。它要求先确认失败的运行时层,再调整配置。覆盖原生扩展加载、作用域栈、事件与订阅者、插件和自适应组件、提供商负载转换,以及 OpenTelemetry 或 OpenInference 导出等问题。它适合需要排查集成故障的开发者,但不是完整的安装指南或自动化修复工具。
引导用户检查 Python、Node.js 和 Go 原生组件是否能够加载,确认活动作用域和作用域栈,核对订阅者、导出器、中间件、插件及自适应配置是否生效,并检查事件注册时机、并发边界、生命周期调用和提供商对象转换。它还给出 Rust 构建、Python 环境重建、Node 原生插件重建、Go FFI 动态库加载、ATIF、OpenTelemetry/OpenInference 导出和配置验证的故障排查步骤。
- NeMo Relay 已安装,但 Python 应用导入原生扩展失败的开发者。
- Node.js 应用中的原生插件未构建或无法加载时,需要定位绑定层问题的开发者。
- 执行调用没有处于活动作用域,或跨线程、任务、goroutine 后作用域栈异常的开发者。
- 订阅者没有收到事件、ATIF 为空或多个并发 agent 数据混合时,需要检查注册和作用域隔离的开发者。
- 插件或自适应组件配置看似生效但运行行为不变时,需要核对初始化、策略和调用路径的开发者。
这个 Skill 有哪些优点和局限?
- 按运行时层逐步缩小问题范围,覆盖多种语言绑定和集成路径。
- 包含作用域隔离、事件注册、并发、插件、自适应行为和导出的具体检查点。
- 明确区分 managed execute、手动生命周期、typed wrappers 与 adaptive/plugins API 层。
- 没有提供可直接运行的诊断脚本或完整修复代码。
- 未给出各绑定的版本兼容矩阵或经过验证的平台清单。
- 部分建议依赖具体应用、构建系统和运行环境,使用者仍需自行执行和解释检查结果。
如何安装这个 Skill?
按 NVIDIA 技能集合的 README 使用默认 skills CLI 安装指定技能:
npx skills add nvidia/skills --skill nemo-relay-debug-runtime-integration --yes
也可以先运行 npx skills add nvidia/skills --list 查看目录。README 未提供该单个技能的其他安装依赖或版本要求。
如何使用这个 Skill?
将技能目录安装到 agent 可加载的技能位置,并在遇到 NeMo Relay 运行时集成故障时触发,例如:"排查 NeMo Relay 已安装但应用没有产生生命周期事件的问题,先确认失败的运行时层。" 具体的应用代码、绑定版本和平台配置需要由使用者提供;SKILL.md 未定义专用命令或自动化脚本。