AI-разработкаБесплатноСреднийПоиск причины сбояv1.2.0
Диагностика причины сбоя и план исправления
Code-agent playbook для Cursor/Codex/Claude Code: структурный аудит репозитория, минимальный патч причины бага, проверки и безопасный rollback.
Кейс применения
Используйте, когда баг уже воспроизводится и нужно не 'чинить всё подряд', а локализовать корневую причину и внести минимальные изменения с проверками.
Совместимость с моделями
- Cursor
- Codex
- Claude Code
- ChatGPT
Пример формулировки
Разбери инцидент: симптом «{{SYMPTOM}}», окружение «{{ENV}}», последние изменения «{{RECENT_CHANGES}}», стек «{{STACK}}», ограничения «{{CONSTRAINTS}}».Текст промта целиком
## Repository context
Стек и точки входа: {{STACK}}. Где в репозитории вероятнее всего связана зона симптома — опиши кратко, без выдуманных путей.
## Symptom
{{SYMPTOM}}
## Environment
{{ENV}}
## Recent changes
{{RECENT_CHANGES}}
## Stack
{{STACK}}
## Constraints
{{CONSTRAINTS}}
## Files to inspect first
Назови 5–8 конкретных файлов/директорий для первого открытия (из структуры репозитория и симптома, без фантазийных путей).
## Hypotheses
2–5 проверяемых гипотез root cause с кратким обоснованием и чем каждая гипотеза опровергается.
## Diagnostic steps
Пошаговый порядок проверки (логи, точки останова, диффы, изоляция слоя). Не переходи к патчу, пока нет сужения до одной главной гипотезы.
## Minimal fix plan
Минимальный патч только вокруг подтверждённой причины: какие строки/функции меняются и почему альтернативы шире не нужны.
## Step-by-step implementation plan
1) inspect current structure
2) list affected files
3) files to change
4) propose minimal changes
5) implement
6) add checks/tests
7) report changed files
## Tests/checks to run
Команды и ручные проверки, подтверждающие фикс и отсутствие регрессии в смежной зоне.
## Expected output
- Подтверждённая root cause (одна формулировка)
- Список изменённых файлов и краткий diff-план
- Команды проверки и ожидаемый сигнал успеха
- Остаточные риски
## Rollback notes
Как откатить патч и вернуть стабильное состояние, если регрессия проявится.
## Additional guardrail
do not rewrite working parts; keep minimal changes; не придумывай файлы и модули, которых нет в репозитории.Примеры использования
Реалистичные сценарии входных данных и ожидаемого результата.
Пример 1
Входные данные
- ENV
- stage, Next 16, Node 22, Chromium
- STACK
- Next.js App Router, Prisma, PostgreSQL
- SYMPTOM
- После сохранения профиля не обновляется список пользователей в админке
- CONSTRAINTS
- Не менять контракты API и не трогать auth; только минимальный патч
- RECENT_CHANGES
- Вчера правили серверный action и кэш revalidatePath
Ожидаемый результат
Примечание
В ответе должны быть реальные пути из репозитория или явные допущения.
Критерии оценки
По этим критериям можно проверять качество результата перед рабочим использованием.
Code-agent root cause discipline
Критерии
- Сначала гипотезы и диагностический порядок, не сразу широкий патч.
- Есть явный minimal fix plan и связь с подтверждённой причиной.
- Указаны files to inspect first и итоговый list affected files / report changed files.
- Есть tests/checks с ожидаемым сигналом успеха и rollback notes.
- Нет выдуманных файлов, версий и путей без пометки допущения.
Похожие промты
По категории, тегам и близкому сценарию применения.