# zig-debugging

Скилл для ИИ-агента: разбирает паники Zig, error return traces и сессии GDB/LLDB. Пригодится, когда программа падает, а стек нечитаемый.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 511 установок · ★ 267
- Автор: mohitmishra786
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/mohitmishra786/low-level-dev-skills/tree/HEAD/skills/zig/zig-debugging/SKILL.md
- Обновлён: 2026-06-27
- HTML: https://affpapa.org/nevibecode/skills/zig-debugging

## Что делает

Скилл ведёт агента по отладке программ на Zig. Внутри — разбор паник с указанием файла и строки, чтение error return traces снизу вверх по цепочке `try`, трассировка через `std.debug.print` и настройка уровней `std.log`. Отдельный блок про сборку: `zig build-exe src/main.zig -O Debug` даёт полную отладочную информацию и проверки безопасности.

Для GDB и LLDB расписаны готовые сессии: точки останова, шаг с заходом и без, печать переменных, бэктрейс. Есть приёмы остановки прямо на панике — `break __zig_panic_start` в GDB и `b __zig_panic` в LLDB. Для VS Code приведены `launch.json` и `tasks.json` с расширением `zig.vscode-zig` и CodeLLDB.

Одна деталь: error return traces в релизных сборках по умолчанию выключены. Чтобы они работали в `ReleaseFast`, в `build.zig` нужно выставить `.error_tracing = true` — иначе на релизной сборке вы увидите только голый код ошибки без цепочки вызовов. Скилл ссылается на смежные: `zig-compiler` для режимов сборки, `gdb` и `lldb` для основ отладчиков, `zig-cinterop` для смешанного кода Zig и C.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mohitmishra786/low-level-dev-skills --skill zig-debugging -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mohitmishra786/low-level-dev-skills --skill zig-debugging -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mohitmishra786/low-level-dev-skills --skill zig-debugging -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install mohitmishra786/low-level-dev-skills zig-debugging
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mohitmishra786/low-level-dev-skills --skill zig-debugging -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/mohitmishra786/low-level-dev-skills --path skills/zig/zig-debugging
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add mohitmishra786/low-level-dev-skills --skill zig-debugging -a opencode
```

### Claude.ai

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

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

## Когда брать
- разобрать текст паники Zig и найти упавшую строку
- прочитать error return trace и понять, где ошибка всплыла наверх
- запустить сессию GDB или LLDB на бинарнике Zig
- включить трассировку через std.debug.print в нужном месте
- настроить отладку Zig в VS Code с CodeLLDB

## Примеры запросов агенту
- Собери проект в Debug и покажи, как поставить breakpoint на панике в GDB
- Вот текст паники Zig — объясни, что именно сломалось
- Почему error return trace пустой в ReleaseFast и как его включить

## Похожие
- [debugging-instruments](https://affpapa.org/nevibecode/skills/debugging-instruments.md) — скилл · 4100 установок
- [cli-anything-lldb](https://affpapa.org/nevibecode/skills/cli-anything-lldb.md) — скилл · 405 установок
- [dbg](https://affpapa.org/nevibecode/skills/dbg.md) — скилл · 620 установок
- [anti-debugging-techniques](https://affpapa.org/nevibecode/skills/anti-debugging-techniques.md) — скилл · 3700 установок
- [java-debugging](https://affpapa.org/nevibecode/skills/java-debugging.md) — скилл · 1 установка
- [debugging-and-error-recovery](https://affpapa.org/nevibecode/skills/debugging-and-error-recovery.md) — скилл · 62800 установок

Из того же набора: [mohitmishra786/low-level-dev-skills](https://affpapa.org/nevibecode/by/mohitmishra786/low-level-dev-skills.md) — 62 карточки

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

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