К основному содержанию
скилл CX Codex

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

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add NVIDIA/skills --skill nemo-relay-debug-runtime-integration -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/nemo-relay-debug-runtime-integration/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/nemo-relay-debug-runtime-integration/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «ИИ и ML» →
debug-zoom-integration официальный anthropics Скилл debug-zoom-integration для Claude Code помогает найти слой, на котором ломается интеграция с Zoom. Запускается при сбоях авторизации, вебхуков, SDK, MCP-транспорта или медиа. CX Codex +1 2 200установок distributed-debugging-debug-trace sickn33 Скилл distributed-debugging-debug-trace помогает настроить отладку и распределённую трассировку: границы трейсов, ключевые спаны, корреляционные ID и проверка покрытия запроса. CX Codex +1 ★ 50 109звёзд репо dart-use-ffigen flutter Скилл dart-use-ffigen для Claude Code настраивает генерацию FFI-привязок через package:ffigen. Он подключается к задачам с новыми привязками или интеграциями C, Objective-C и Swift. CX Codex +1 16 800установок nemo-evaluator-sdk Orchestra Research Скилл nemo-evaluator-sdk для Claude Code и ещё пяти агентных сред. Оценивает языковые модели на 100+ бенчмарках из 18+ харнессов через контейнеры и несколько бэкендов. CX Codex +1 1 100установок mapbox-mcp-runtime-patterns mapbox Скилл mapbox-mcp-runtime-patterns учит агента подключать Mapbox MCP Server к ИИ-приложениям. Он помогает модели выбирать между расчётами Turf.js и сетевыми API маршрутизации. CX Codex +1 1 400установок twilio-voice-conversation-relay официальный Twilio Скилл twilio-voice-conversation-relay для построения голосовых AI-агентов на Twilio с обработкой речи в реальном времени. CX Codex GP ChatGPT +1 1установок

Из того же набора312

Весь набор →
nemo-relay-install Скилл nemo-relay-install помогает выбрать и установить NeMo Relay для агента, фреймворка или приложения. Разбирается в целевой платформе и подтягивает актуальный стабильный релиз с проверкой доступности. CX Codex +1 227установок nemo-relay-instrument-calls Скилл nemo-relay-instrument-calls оборачивает вызовы инструментов и LLM-провайдеров в скоупы NeMo Relay. Помогает внедрить мидлвары, гардрейлы и перехват событий жизненного цикла без изменения бизнес-логики. CX Codex +1 224установок nemo-relay-instrument-context-isolation Скилл nemo-relay-instrument-context-isolation разделяет стеки контекста NeMo Relay между параллельными задачами и сохраняет правильную иерархию scope. CX Codex +1 211установок nemotron-asr-finetune Скилл nemotron-asr-finetune оркеструет адаптацию моделей распознавания речи NVIDIA Nemotron Speech и Riva под предметную область или язык, подбирая путь от бустинга слов до файнтюнинга. CX Codex +1 210установок nemo-relay-instrument-typed-wrappers Скилл nemo-relay-instrument-typed-wrappers помогает настроить типизированные обёртки и кодеки провайдеров в NeMo Relay, сохраняя сериализацию в JSON для промежуточного слоя. CX Codex +1 182установок nemo-relay-plugin-build Скилл nemo-relay-plugin-build для Claude Code упаковывает переиспользуемое поведение NeMo Relay в конфиг-компонент или динамический плагин с валидацией и откатом. Создаёт плагины для нескольких приложений или команд. CX Codex +1 181установок nemo-relay-plugin-adaptive-tuning Скилл nemo-relay-plugin-adaptive-tuning для Claude Code настраивает и проверяет адаптивное поведение NeMo Relay по телеметрии. Поэтапно настраивает параллелизм, подсказки и prompt-cache. CX Codex +1 178установок nemo-relay-migrate-from-flow Скилл nemo-relay-migrate-from-flow для механической миграции кода, документации и конфигов с NeMo Flow на NeMo Relay. Работает с Python, Rust, Node.js, Go, C FFI, CLI и параметрами наблюдаемости. CX Codex +1 171установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой