nemo-relay-debug-runtime-integration — скилл Claude Code: установка
Скилл nemo-relay-debug-runtime-integration для Claude Code ищет причины сбоев NeMo Relay на уровне загрузки, scope, событий и плагинов. Диагностирует неправильное поведение рантайма после установки интеграции.
Apache-2.0 197 установок ★ 4 106 обновлён 2026-10-23
npx skills add NVIDIA/skills --skill nemo-relay-debug-runtime-integration -a claude-codeЧто делает nemo-relay-debug-runtime-integration
Скилл проверяет, загружается ли native-компонент, есть ли активный scope во время вызова и проходит ли работа по ожидаемому стеку. Он также помогает выяснить, активны ли subscriber, exporter и plugin, зарегистрированы ли события и выбран ли правильный API-слой: managed execute, ручной lifecycle, typed wrappers или adaptive/plugins.
Внутри есть матрица для Python, Node.js, Go и Rust, диагностика пустого scope, утечек между запросами, пропущенных событий и проблем с ATIF. Отдельные ветки посвящены конвертации payload, проверке конфигурации plugin и экспорту OpenTelemetry/OpenInference для Relay 0.6 и 0.7. Если вызов выполняется вне активного scope, lifecycle-события не появятся.
Для Python-проверок используются uv sync и тест импорта из окружения приложения; для Go нужны release FFI-библиотека и путь загрузчика, а на macOS — DYLD_LIBRARY_PATH. Для Node.js native addon требуется переустановка и сборка из пакета binding.
Какие задачи решает
- найти причину сбоя загрузки native-компонента
- проверить активный
scopeи границы потоков или задач - восстановить пропущенные lifecycle-события
- проверить регистрацию subscriber, exporter и plugin
- разобрать сбой экспорта OpenTelemetry или OpenInference
Примеры запросов агенту
- Разбери, почему вызов NeMo Relay выполняется без активного
scope, и проверь границы задач. - Проверь, почему subscriber не получает события после запуска приложения.
- Сравни конфигурацию adaptive-компонента и путь вызова, если его поведение не меняется.
Как установить nemo-relay-debug-runtime-integration
1Через Skills CLI (Vercel)
npx skills add NVIDIA/skills --skill nemo-relay-debug-runtime-integration -a claude-code2Вручную: положить файлы
~/.claude/skills/nemo-relay-debug-runtime-integration/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/nemo-relay-debug-runtime-integration/
1Через Skills CLI (Vercel)
npx skills add NVIDIA/skills --skill nemo-relay-debug-runtime-integration -a codex2Вручную: положить файлы
.agents/skills/nemo-relay-debug-runtime-integration/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add NVIDIA/skills --skill nemo-relay-debug-runtime-integration -a cursor2Вручную: положить файлы
.cursor/skills/nemo-relay-debug-runtime-integration/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install NVIDIA/skills skills/nemo-relay-debug-runtime-integration2Вручную: положить файлы
.github/skills/nemo-relay-debug-runtime-integration/SKILL.md1Через Skills CLI (Vercel)
npx skills add NVIDIA/skills --skill nemo-relay-debug-runtime-integration -a gemini-cli2Командой платформы
gemini skills install https://github.com/NVIDIA/skills --path skills/nemo-relay-debug-runtime-integrationВручную: положить файлы
.devin/skills/nemo-relay-debug-runtime-integration/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add NVIDIA/skills --skill nemo-relay-debug-runtime-integration -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о nemo-relay-debug-runtime-integration
Как установить nemo-relay-debug-runtime-integration в Claude Code?
Выполните npx skills add NVIDIA/skills --skill nemo-relay-debug-runtime-integration -a claude-code, затем проверьте файл ~/.claude/skills/nemo-relay-debug-runtime-integration/SKILL.md.
Что делает nemo-relay-debug-runtime-integration?
Скилл разбирает сбои NeMo Relay в приложении: загрузку binding, активность scope, регистрацию событий, конфигурацию plugin и экспорт телеметрии.
Чем отличаются проверки экспорта для Relay 0.6 и 0.7?
Для 0.6 проверяются отдельный exporter, http_binary или grpc, endpoint, headers, поддержка target и активный Tokio runtime для native gRPC. Для 0.7 проверяются typed projection, endpoint, headers, TLS и поддержка target; native gRPC runtime контролирует subscriber.
Исходный текст
SKILL.md · Apache-2.0
--- name: nemo-relay-debug-runtime-integration description: Use this skill when NeMo Relay is installed or imported but application-side runtime behavior is missing or incorrect, including load failures, inactive scopes, missing events, and plugin or adaptive wiring problems. license: Apache-2.0 metadata: author: NVIDIA Corporation and Affiliates --- # Debug Runtime Integration Use this skill when NeMo Relay is present in the application but something is not working. Start by proving which runtime layer is failing before changing configuration. ## First Checks - Can the binding or native artifact load? - Is there an active scope when the failing call runs? - Is the work happening on the expected scope stack? - Is the subscriber/exporter/plugin configuration actually active? - Did the app choose the right public API layer: managed execute vs manual lifecycle vs typed wrappers vs adaptive/plugins? ## Common Failure Classes - Python native extension missing - Go dynamic library not on the loader path - Node native addon not built or not loading - Execute call outside a scope - Missing events because registration never happened - Concurrency causing the wrong scope stack to be active - Adaptive component never initialized or config validation ignored ## Embedded Troubleshooting Matrix - **Rust build failure**: run the narrowest core build first, then expand to the affected binding or workspace command. - **Python import failure**: rebuild the virtual environment and native extension with `uv sync`, then run a small Python test or import check from the same environment as the application. - **Node.js addon failure**: reinstall and rebuild the native addon from the Node binding package before debugging application code. - **Go loader failure**: build the release FFI shared library and point both the linker and runtime loader at the release output directory; use the macOS dynamic-library path variable (`DYLD_LIBRARY_PATH`) on macOS. - **Scope stack empty**: the work is outside an active scope or crossed a thread, task, goroutine, or worker boundary without the intended stack. - **Work leaks across requests**: separate requests are sharing one scope stack; create a fresh stack per independent request or agent. - **Middleware missing or ordered incorrectly**: check global vs scope-local registration, active scope ancestry, names, and priority values. - **Subscriber missing events**: register before the events are emitted; for scope-local subscribers, ensure the current scope is the owner or descendant. - **Event fields missing**: managed helpers populate semantic fields; manual lifecycle calls require explicit params for input, output, model names, and tool call IDs. - **ATIF empty or mixed**: register before work starts, use one exporter per run or clear between runs, and separate concurrent agents by root scope. - **Provider payload conversion failure**: convert non-JSON provider objects, SDK handles, callbacks, streams, or class instances with explicit codecs. - **Plugin validation failure**: validate config independently from runtime registration and check required fields, value types, defaults, and config source. - **Adaptive behavior unchanged**: confirm instrumentation emits events, the adaptive component is enabled, policy allows the behavior, and the call path reaches the configured component. - **OpenTelemetry or OpenInference export failure**: first identify the Relay version. For 0.6, check the separate exporter, `http_binary` versus `grpc`, endpoint, headers, target support, and an active Tokio runtime for native gRPC. For 0.7, check the typed projection, endpoint, headers, TLS, and target support; the subscriber owns the native gRPC runtime. - **Callback succeeded but no lifecycle events appear**: confirm the integration uses managed execute helpers or balanced manual start/end APIs, not only the underlying business callback. ## Related Skills - `nemo-relay-get-started` - `nemo-relay-instrument-context-isolation` - `nemo-relay-plugin-adaptive-tuning` - `nemo-relay-plugin-build`
© NVIDIA Corporation and Affiliates · Apache-2.0 · NVIDIA/skills