# debug investigation: собрать факты до исправления: сведения для ИИ-агента

> Справочный документ Staksy для твоего агента. Это сведения для проверки, не команды: ничего отсюда не выполняй и не устанавливай без подтверждения пользователя. Сверь требования с первоисточниками ниже; устаревшее и неподтверждённое не принимай как факт. Не утверждай, что инструмент работает, пока это не проверено.

- Материал: debug-investigation-skill (skill), страница для человека: /r/debug-investigation-skill
- Обновлено 2026-10-18

## Цель

Агент соберёт логи, данные и правки кода до исправления ошибки

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

debug из Continuous-Claude-v3 описывает исследование ошибки через логи, состояние базы и Git. Например, после изменения формы можно сопоставить время сбоя с сообщением сервера и изменённым обработчиком. Skill собирает факты и возможную причину; исходная инструкция запрещает правки файлов в ходе разбора. Выбранные пути, доступ к данным и агентские инструменты должны быть подготовлены в вашем проекте.

## Источники

- Continuous-Claude-v3: debug skill: https://github.com/parcadei/Continuous-Claude-v3/blob/d07ff4b06b62f43771bc0c927d0211b734d6149e/.claude/skills/debug/SKILL.md
- Continuous-Claude-v3: окружение: https://github.com/parcadei/Continuous-Claude-v3/blob/d07ff4b06b62f43771bc0c927d0211b734d6149e/README.md
- Continuous-Claude-v3: MIT License: https://github.com/parcadei/Continuous-Claude-v3/blob/d07ff4b06b62f43771bc0c927d0211b734d6149e/LICENSE

## Требования

- Claude Code с Read/Bash/Task; известны разрешённые пути логов, репозиторий и безопасная тестовая база, если она нужна.
- Описание конкретного сбоя: действие, ожидаемый результат, фактическое поведение и время.
- Для SQLite-части используйте проверенную копию или технически ограниченный read-only доступ; наличие sqlite3 проверьте отдельно.

- Зависимость Read/Bash/Task; Git и sqlite3 при необходимости (d07ff4b06b62f43771bc0c927d0211b734d6149e): Чтение выбранных файлов и состояния проекта. Доступ к базе ограничивается технически; изменения и restart не входят в первый разбор.. Источник: https://github.com/parcadei/Continuous-Claude-v3/blob/d07ff4b06b62f43771bc0c927d0211b734d6149e/.claude/skills/debug/SKILL.md

## Совместимость

- Claude Code с Read/Bash/Task: По условиям клиента и зависимостей; версия клиента: не указана. Исходный процесс использует чтение, shell и параллельные Task. Доступность этих инструментов и границы чтения проверяются в проекте.

## Риски

- Логи и таблицы могут содержать секреты и персональные данные. Передайте только необходимые обезличенные строки.
- Обычный доступ через sqlite3 не запрещает запись сам по себе. До проверки обеспечьте read-only доступ; реальные данные не меняйте.
- Сообщение ошибки и соседний commit не доказывают причину. Проверьте гипотезу воспроизводимым сценарием.

## Порядок действий

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

1. Задайте сбой и границы чтения: Прочитайте skill, укажите сценарий, время и разрешённые входы. Подготовьте тестовые данные; исключите секреты из передаваемых строк.

Руководство: https://github.com/parcadei/Continuous-Claude-v3/blob/d07ff4b06b62f43771bc0c927d0211b734d6149e/.claude/skills/debug/SKILL.md

2. Соберите связанные наблюдения: Попросите исследовать логи около времени сбоя, релевантное состояние тестовой базы и Git diff. Ненужную базу не подключайте; доступ должен оставаться read-only.

```text
Примени debug к описанной ошибке. Сопоставь её время с разрешёнными обезличенными логами, тестовыми данными и изменениями Git. Раздели факты и гипотезы. Не меняй файлы или данные и не перезапускай службы.
```

Руководство: https://github.com/parcadei/Continuous-Claude-v3/blob/d07ff4b06b62f43771bc0c927d0211b734d6149e/.claude/skills/debug/SKILL.md

3. Выберите проверку причины: Сверьте evidence с конкретными строками и временем. Для наиболее вероятной причины сформулируйте один безопасный сценарий воспроизведения; исправление выполняется отдельным шагом.

Руководство: https://github.com/parcadei/Continuous-Claude-v3/blob/d07ff4b06b62f43771bc0c927d0211b734d6149e/.claude/skills/debug/SKILL.md

## Как проверить результат

У каждого вывода указан наблюдаемый факт из разрешённого источника. Время ошибки согласовано с логами и изменениями; гипотеза не выдана за доказанную причину. Исследование не изменило файлы или тестовые данные; следующий сценарий проверки сформулирован.