Перейти к содержимому
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.
  • Нет выдуманных файлов, версий и путей без пометки допущения.

По категории, тегам и близкому сценарию применения.

  • AI-разработкаПремиумПродвинутый

    Улучшение типизации и структуры проекта

    Предлагает порядок в модулях, баррели, границы доменов и строгие типы без «any» — как дорожная карта для Cursor или Codex.

    АрхитектураCodexCursorРефакторингTypeScript

    Модели

    • Cursor
    • Codex
    • Claude Code
    • ChatGPT
    • Claude
    Открыть описание
  • AI-разработкаПремиумСредний

    Очистка технического мусора после серии правок

    Собирает хвосты после спринта с AI: мёртвый код, временные костыли, несогласованные имена и план безопасной зачистки.

    РефакторингTypeScriptCodexCursorРефакторинг

    Модели

    • Cursor
    • Codex
    • Claude Code
    • ChatGPT
    • Claude
    • Gemini
    Открыть описание
  • AI-разработкаПремиумСредний

    Ревью кода с конкретными правками

    Разбор диффа или фрагмента для Cursor или Codex: риски, стиль, производительность и список правок с приоритетом — универсальное ревью перед merge, а не чек-лист вопросов специально к ветке после GitHub Copilot.

    Качество и релизTypeScriptCodexCursorРевью кода

    Модели

    • Cursor
    • Codex
    • Claude Code
    • ChatGPT
    • Claude
    Открыть описание