# sync-debug

Скилл разбирает сбои синхронизации по логам и коду, а затем предлагает исправление и проверку. Пригодится, когда запуск завершился ошибкой или вернул неверные данные.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 220
- Автор: makenotion
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/makenotion/notion-cookbook/tree/HEAD/workers/agents/skills/sync-debug/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/sync-debug

## Что делает

Скилл проверяет состояние синхронизаций и последние запуски через `ntn workers`, получает логи и сопоставляет ошибки с кодом в `src/index.ts` и импортируемых модулях. Он помогает разбирать ошибки авторизации и лимитов запросов, проблемы состояния и схемы, пустые результаты, тайм-ауты и зацикливание.

После диагностики скилл может внести правку в код, предложить проверить типы командой `npm run check`, а затем проверить синхронизацию через preview или повторный запуск. Для работы нужны команда `ntn` и доступ к проекту с кодом синхронизации. Сброс состояния запускает полную повторную загрузку данных, поэтому перед ним проверьте, что это допустимо для проекта.

## Требования
- Работает с: Notion

## Установка

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

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

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add makenotion/notion-cookbook --skill sync-debug -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add makenotion/notion-cookbook --skill sync-debug -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install makenotion/notion-cookbook sync-debug
```

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

### Gemini CLI

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

2. **Командой платформы**
```bash
gemini skills install https://github.com/makenotion/notion-cookbook --path workers/agents/skills/sync-debug
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add makenotion/notion-cookbook --skill sync-debug -a opencode
```

### Claude.ai

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

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

## Когда брать
- найти причину сбоя по логам запуска
- сопоставить ошибку API с кодом синхронизации
- разобраться, почему синхронизация возвращает пустой результат
- проверить, почему курсор не продвигается
- подготовить исправление и проверить типы

## Примеры запросов агенту
- Разбери последний неудачный запуск синхронизации и найди причину ошибки.
- Проверь, почему синхронизация возвращает пустые данные, и сопоставь логи с кодом.
- Найди причину зацикливания синхронизации и предложи исправление с проверкой.

## Похожие
- [mcp-builder](https://affpapa.org/nevibecode/skills/mcp-builder.md) — скилл · 130949 установок
- [claude-api](https://affpapa.org/nevibecode/skills/claude-api.md) — скилл · 74198 установок
- [lark-im](https://affpapa.org/nevibecode/skills/lark-im.md) — скилл · 472900 установок
- [lark-event](https://affpapa.org/nevibecode/skills/lark-event.md) — скилл · 466800 установок
- [caveman-discover](https://affpapa.org/nevibecode/skills/caveman-discover.md) — скилл · 104400 установок
- [migration](https://affpapa.org/nevibecode/skills/migration.md) — скилл · 103900 установок

Из того же набора: [makenotion/notion-cookbook](https://affpapa.org/nevibecode/by/makenotion/notion-cookbook.md) — 20 карточек

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

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