Claude Code и постмортем ошибок: навык самообучения

Одна и та же ошибка — снова и снова

Вы объясняете Claude Code, что в проекте нужно использовать uv, а не pip. Claude кивает, соглашается — и в следующей сессии снова пишет pip install. Вы тратите время на правки, объяснения, итерации. А модель при каждом запуске начинает с чистого листа: прошлый разговор для неё не существует.

Это фундаментальное ограничение языковых моделей: они не помнят собственных ошибок. У Claude Code нет встроенного механизма рефлексии. Исправил — забыл.

Именно эту проблему решает открытый навык (skill), который появился на Reddit в r/ClaudeAI и быстро набрал популярность: postmortem-анализ собственных ошибок Claude. Инструмент заставляет модель самостоятельно изучить историю сессий, найти повторяющиеся сбои и предложить конкретные правки в конфигурацию — так, чтобы в следующий раз она уже не ошибалась.

Что такое навык (skill) для Claude Code

Прежде чем разбирать механику, напомним контекст. Claude Code поддерживает skills — переиспользуемые инструкции, сохранённые в директории .claude/skills/. Это markdown-файлы, которые содержат системные правила поведения для конкретного сценария.

Когда вы вызываете навык командой /имя-навыка, Claude Code загружает его содержимое в контекст сессии. Навык может задавать методологию работы, порядок шагов, ограничения, форматы ответов. Фактически — это «должностная инструкция» для конкретной задачи.

Navyk постмортема — из этой же экосистемы, но с интересной особенностью: он направлен на сам Claude, а не на внешнюю задачу.

Как работает постмортем-навык

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

flowchart LR
    A[Завершена рабочая сессия] --> B[Вызов /postmortem]
    B --> C[Claude читает историю разговора]
    C --> D[Поиск паттернов ошибок и трений]
    D --> E[Ранжирование по частоте]
    E --> F[Генерация CLAUDE_IMPROVEMENTS.md]
    F --> G[Разработчик применяет правки в CLAUDE.md]
    G --> H[Следующая сессия без повторных ошибок]

Конкретно, проект bokan/claude-skill-self-improvement работает так:

1. Вы завершаете сессию и вызываете навык
2. Claude анализирует историю переписки текущей или нескольких прошлых сессий
3. Выявляет паттерны трений: повторяющиеся исправления, недопонимания, моменты когда вы говорили «нет, не так», регрессии
4. Генерирует файл CLAUDE_IMPROVEMENTS.md с ранжированными рекомендациями
5. Вы применяете то, что считаете нужным, в CLAUDE.md своего проекта

Выходной файл содержит:

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

Принцип прост: один раз поправил — Claude больше не повторяет. Но для этого исправление нужно зафиксировать в памяти системы. Постмортем-навык автоматизирует этот процесс.

Установка и использование

Проект полностью открытый и бесплатный. Для установки навыка на уровне проекта:

# Скачайте репозиторий
git clone https://github.com/bokan/claude-skill-self-improvement

# Скопируйте навык в ваш проект
cp -r claude-skill-self-improvement/.claude/skills/postmortem .claude/skills/

# Или установите глобально (для всех проектов)
cp -r claude-skill-self-improvement/.claude/skills/postmortem ~/.claude/skills/

После установки навык доступен через слэш-команду:

# В конце рабочей сессии
/postmortem

# Или с указанием конкретной проблемы
/postmortem focus on API usage mistakes

Экосистема самообучающихся инструментов

Постмортем-навык — часть более широкого движения. В 2025–2026 годах сообщество Claude Code активно строит инфраструктуру для обучения модели на собственных ошибках. Вот ключевые проекты в этой нише:

Принципиальная разница между подходами: одни требуют явного вызова (ручной постмортем), другие перехватывают коррекции в реальном времени. Оба варианта ценны — первый даёт более глубокий анализ, второй более удобен в ежедневной работе.

Почему это работает: принцип постмортема

В инженерной культуре постмортем — это структурированный разбор инцидента без поиска виноватых. Цель: понять системные причины и предотвратить повторение.

Именно этот фреймворк перенесён на работу с ИИ. Вместо того чтобы просто исправить ошибку Claude и двигаться дальше, постмортем требует:

1. Описать, что пошло не так — конкретно, с примерами из диалога
2. Найти корневую причину — не симптом, а структурный сбой (неверное понимание задачи, отсутствие контекста, противоречивые инструкции)
3. Предложить системное решение — правило в CLAUDE.md, которое предотвратит повторение
4. Зафиксировать что работало — чтобы не сломать

Практический пример: разбор типичной сессии

Представьте: вы три раза за сессию поправляли Claude, объясняя что тесты нужно запускать через pytest -x, а не просто pytest. После сессии вызываете /postmortem. Навык анализирует историю и генерирует:

## Паттерны трений (по частоте)

### [ВЫСОКИЙ] Команда запуска тестов
Зафиксировано 3 случая. Claude использовал `pytest` вместо `pytest -x`.
Цитата: "No, always use pytest -x so we stop on first failure"

**Рекомендация для CLAUDE.md:**
Always run tests with `pytest -x` (stop on first failure).
Never use plain `pytest` — it wastes time on cascading failures.

### [СРЕДНИЙ] Импорты в тестах
Зафиксировано 2 случая. Claude добавлял прямые импорты вместо фикстур.
...

Вы берёте нужные рекомендации, добавляете в CLAUDE.md — и в следующей сессии Claude уже знает правило. Без повторных объяснений.

Вся сила — в системности

Отдельные правки в CLAUDE.md помогают, но постмортем-навык ценен именно системным подходом. Он заставляет:

• Не терять контекст между сессиями — каждое исправление фиксируется
• Ранжировать по значимости — не всё одинаково важно, частые ошибки исправляются первыми
• Строить базу знаний проекта — со временем CLAUDE.md превращается в точный портрет вашего кодовой базы и предпочтений
• Делиться с командой — CLAUDE.md хранится в git, все члены команды получают накопленный опыт

Хорошие CLAUDE.md-файлы не пишутся за один раз. Они выращиваются постепенно — как документация живого проекта. Постмортем — инструмент этого роста.

Заключение

Навык постмортема для Claude Code — элегантное решение реальной проблемы. ИИ-ассистенты мощны, но без механизмов памяти повторяют одни и те же ошибки снова и снова. Постмортем-подход заимствует лучшее из инженерной культуры: структурированный разбор, поиск системных причин, документирование.

Инструмент бесплатный и открытый. Установка занимает минуты. Результат — Claude Code, который с каждым проектом становится точнее настроен под ваши задачи.

Если вы уже используете Claude Code регулярно, добавить постмортем в рабочий процесс стоит хотя бы попробовать. Даже одна сессия анализа часто вскрывает паттерны, которые вы интуитивно чувствовали, но не формулировали явно.

Ссылки на упомянутые проекты:

• bokan/claude-skill-self-improvement
• aviadr1/claude-meta
• haddock-development/claude-reflect-system
• BayramAnnakov/claude-reflect