# doca-debug

Скилл doca-debug для Claude Code разбирает сбои DOCA по слоям: установка, сборка, линковка, запуск и драйвер. Разбирает ошибки символов, DOCAERROR и пустой вывод инструментов.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 162 установки · ★ 4106 у репозитория
- Автор: NVIDIA
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/NVIDIA/skills/tree/HEAD/skills/doca-debug/SKILL.md
- Обновлён: 2026-10-23
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/doca-debug

## Что делает

Скилл помогает определить слой сбоя DOCA: установка, версия, сборка, линковка, выполнение, программа или драйвер. Он разбирает ошибки вроде `undefined reference to doca`, возврат `DOCAERROR`, пустой вывод инструментов, stack trace, valgrind и core dump.

Для диагностики используются уровни логирования `--sdk-log-level`, `DOCA_LOG_LEVEL` и вариант `doca-{lib}-trace`. Скилл также подсказывает, какие данные собрать для Developer Forum, и учитывает ограничения отладки в контейнере. Для проверки нужен работающий DOCA по пути `/opt/mellanox/doca`, поэтому без установленного SDK валидационные шаги не запустятся.

Скилл не ведёт библиотечную отладку Flow pipe, RDMA QP и Comch stats. Отдельно маршрутизируются симптомы `pkg-config`, hugepages, трактовка `DOCA_ERROR_*`, вопросы производительности и incident response.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill doca-debug -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/doca-debug/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/doca-debug/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill doca-debug -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/doca-debug/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill doca-debug -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/doca-debug/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install NVIDIA/skills skills/doca-debug
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/doca-debug/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill doca-debug -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/NVIDIA/skills --path skills/doca-debug
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/doca-debug/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill doca-debug -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/NVIDIA/skills/tree/HEAD/skills/doca-debug/SKILL.md

## Когда брать
- определить слой сбоя DOCA
- разобрать ошибку `undefined reference to doca`
- включить подробные логи библиотеки или инструмента
- собрать состояние для вопроса на Developer Forum
- отделить контейнерную проблему от ошибки выполнения

## Примеры запросов агенту
- Разбери ошибку `undefined reference to doca_flow_init` по слоям и сначала запроси нужные наблюдения.
- Покажи, как включить `--sdk-log-level`, `DOCA_LOG_LEVEL` или `doca-{lib}-trace` для тихой программы DOCA.
- Подскажи, что собрать для воспроизводимого вопроса на Developer Forum, если `doca_caps` ничего не выводит.

## Похожие
- [debug](https://affpapa.org/nevibecode/commands/anthropic-debug.md) — команда · ★ 41441 у репозитория
- [debug-openshell-cluster](https://affpapa.org/nevibecode/skills/debug-openshell-cluster.md) — скилл · 739 установок
- [cmux-debugging](https://affpapa.org/nevibecode/skills/cmux-debugging.md) — скилл · 5000 установок
- [ccam-devtools](https://affpapa.org/nevibecode/plugins/ccam-devtools.md) — плагин · ★ 1198 у репозитория
- [smart-fix](https://affpapa.org/nevibecode/commands/seth-hobson-smart-fix.md) — команда · ★ 126 у репозитория
- [deployment](https://affpapa.org/nevibecode/skills/deployment.md) — скилл · 69 установок

Из того же набора: [nvidia/skills](https://affpapa.org/nevibecode/by/nvidia/skills.md) — 312 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
