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

debug — правило для Claude Code и Cline: рутина отладки

Правило debug задаёт порядок отладки: сначала собрать наблюдения и контекст, затем объяснить причину и править код. Включается, когда ошибка не сдаётся или фикс неполный.

лицензия не указана ★ 1 054 обновлён 2025-07-17

Установить в Cursor · Вручную: положить файлы Все способы и платформы ↓
.cursor/rules/debug.mdc
Открыть на GitHub

Что делает debug

Правило debug описывает порядок работы, когда ошибка не сдалась с первого раза или исправление вышло половинчатым. Пока агент не застрял, оно не применяется: в описании прямо сказано включать его только в тупике.

Сначала собираются сообщения об ошибке, логи и симптомы, к ним добавляется контекст из файлов. Архитектура проекта, план и текущая задача подтягиваются из @memory.mdc. Дальше агент перечисляет наблюдения и объясняет, почему причина именно эта, а не соседняя. Если фактов мало, он добирает их и может попросить уточнение.

Правка идёт последней. Сперва разбор кода через <ANALYZE CODE> и поиск похожих решённых случаев в @error-documentation.mdc, затем фикс через <SYSTEMATIC CODE PROTOCOL> и <TESTING>. Оба блока живут в implement.mdc из того же репозитория, поэтому без этого файла часть шагов рутины останется без определения.

Какие задачи решает

  • разобрать тест, который падает который раз подряд, вместо латания наугад
  • собрать логи, симптомы и контекст файлов до правки
  • отличить архитектурную ошибку от обычного бага
  • найти в проекте уже решённый похожий случай
  • показать рассуждение раньше, чем агент тронет код

Примеры запросов агенту

  • Тест test_cart.py падает третий раз, включи рутину debug и сначала собери наблюдения.
  • Не правь код наугад: пройди по шагам и объясни, почему падает сборка.
  • Посмотри @error-documentation.mdc, может там уже был такой случай, и только потом предлагай фикс.

Как установить debug

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

.cursor/rules/debug.mdc

Во frontmatter: description, globs, alwaysApply

По шагам, с командами для каждой платформы: Cursor rules: файлы .mdc, четыре режима и замена .cursorrules

Вопросы о debug

Как установить debug в Claude Code?

Скопируй файл правила в .claude/rules/debug.md в корне проекта. Дальше Claude берёт его оттуда сам.

Что делает debug?

Включает рутину для застрявших ошибок и неполных фиксов: собрать наблюдения, объяснить причину, проверить похожие случаи, и только затем менять код.

Нужны ли другие файлы правил?

Да. Шаги ссылаются на implement.mdc (<ANALYZE CODE>, <SYSTEMATIC CODE PROTOCOL>, <TESTING>), на @error-documentation.mdc и на @memory.mdc с архитектурой и текущей задачей. Без них часть рутины останется без определения.

Похожие правила IDE

Все правила IDE по теме «Настройка агента: память, контекст, субагенты» →
debug-my-harness zernie Скилл debug-my-harness для Claude Code. Разбирает сбои в агентной обвязке по локальному журналу .vigiles/runs.jsonl: показывает, какие хуки заблокировали или пропустили действие, где субагент вышел за пределы контракта. CX Codex +1 1 500установок debug-issue tirth8205 Скилл debug-issue для Claude Code отслеживает ошибку по графу связей в коде. Запускается при поиске причины бага и оценке того, какие файлы затронет исправление. CX Codex +1 1 100установок gjalla-debug gjalla Скилл gjalla-debug для поиска первопричины бага с доказательствами до того, как агент предложит исправление. Работает с Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 357установок vue-debug-guides github.com/vuejs-ai Скилл vue-debug-guides для диагностики ошибок Vue 3: реактивность, watchers, компоненты, шаблоны и hydration. Когда агент видит баг во Vue-проекте, он находит причину по каталогу типовых проблем. CX Codex +1 28 400установок no-workarounds Pedro Nauck Скилл no-workarounds помогает проверить исправление, которое скрывает ошибку или её проявления. Подключайте его, когда подозреваете обходной приём или разбираете внешнюю неисправность. CX Codex +1 593установок debug-mantra thananon Скилл debug-mantra для Claude Code задаёт порядок отладки: воспроизвести сбой, найти путь ошибки, проверить гипотезы и сверить результаты. Запускается по /debug-mantra и при сообщениях об ошибках или поломках. CX Codex +1 5 100установок

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

Весь набор →
directory-structure Правило directory-structure задаёт для ИИ-помощника единое дерево каталогов проекта: исходный код, тесты, конфигурацию и служебные папки. CX Codex +1 ★ 1 054звёзд репо architecture-understanding Правило architecture-understanding заставляет агента прочитать docs/architecture.md и сверять изменения с описанной архитектурой. Пригодится перед правками в проекте с Mermaid-диаграммой. CX Codex +1 ★ 1 054звёзд репо cursor-rules-location Правило cursor-rules-location запрещает сохранять файлы правил с расширением .mdc в случайных папках проекта и требует складывать их в .cursor/rules. CX Codex +1 ★ 1 054звёзд репо develop-mcp-server Правило develop-mcp-server задаёт порядок разработки MCP-серверов: планирование, реализация, настройка и обязательная проверка каждого инструмента. CX Codex +1 ★ 1 054звёзд репо plan Правило plan заставляет агента перед планированием прочитать docs/, tasks/ и код, задать уточняющие вопросы и только потом предложить решение. CX Codex +1 ★ 1 054звёзд репо implement Правило implement задаёт строгий регламент написания кода и тестов: анализ зависимостей перед правками, пошаговые изменения и обязательное обновление документации. CX Codex +1 ★ 1 054звёзд репо memory Правило memory раскладывает память проекта по файлам docs/, tasks/ и .cursor/rules/. Оно помогает агенту сохранять контекст, планы и выводы между задачами. CX Codex +1 ★ 1 054звёзд репо memory Правило memory заставляет агента вести память проекта в файлах: PRD, архитектура, стек, план задач, текущий контекст. Помогает не терять решения между сессиями. CX Codex +1 ★ 1 054звёзд репо

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

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