claude-reflect
BayramAnnakov/claude-reflectПерехватывает исправления, позитивную обратную связь и предпочтения из сессий Claude Code, синхронизирует их в CLAUDE.md и AGENTS.md. Обнаруживает повторяющиеся паттерны и превращает их в переиспользуемые команды.
Установка
git clone https://github.com/BayramAnnakov/claude-reflect.gitREADME
claude-reflect
Система самообучения для Claude Code, которая фиксирует исправления и обнаруживает паттерны рабочего процесса — превращая их в постоянную память и переиспользуемые навыки.
Что делает
1. Обучение на исправлениях
Когда вы поправляете Claude («нет, используй gpt-5.1, а не gpt-5»), он запоминает это навсегда.
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Вы исправляете │ ──► │ Хук помещает │ ──► │ /reflect │
│ Claude Code │ │ в очередь │ │ пишет CLAUDE.md│
└─────────────────┘ └─────────────────┘ └─────────────────┘
(автоматически) (автоматически) (ручная проверка)
2. Обнаружение паттернов рабочего процесса (новое в v2)
Анализирует историю сессий, находит повторяющиеся задачи и превращает их в переиспользуемые команды.
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Ваши прошлые │ ──► │ /reflect-skills │ ──► │ Генерирует │
│ сессии │ │ ищет паттерны │ │ /команды │
└─────────────────┘ └─────────────────┘ └─────────────────┘
(68 сессий) (на базе AI) (вы подтверждаете)
Пример: вы 12 раз спрашивали «проверь мою продуктивность» → предлагается создать /daily-review.
Ключевые возможности
| Возможность | Описание |
|---|---|
| Постоянная память | Исправления синхронизируются в CLAUDE.md — Claude помнит их между сессиями |
| Обнаружение навыков | Находит повторяющиеся паттерны в истории → генерирует команды |
| Мультиязычность | AI понимает исправления на любом языке |
| Улучшение навыков | Исправления во время /deploy совершенствуют сам навык deploy |
Установка
# Добавить маркетплейс
claude plugin marketplace add bayramannakov/claude-reflect
# Установить плагин
claude plugin install claude-reflect@claude-reflect-marketplace
# ВАЖНО: перезапустите Claude Code для активации плагинаПосле установки перезапустите Claude Code (закройте и откройте заново). Хуки настроятся автоматически, команды будут готовы к использованию.
Первый запуск? При первом вызове
/reflectбудет предложено просканировать прошлые сессии на предмет накопленных знаний.
Требования
- Установленный CLI Claude Code
- Python 3.6+ (входит в большинство систем)
Поддерживаемые платформы
- macOS: полная поддержка
- Linux: полная поддержка
- Windows: полная поддержка (нативный Python, WSL не требуется)
Команды
| Команда | Описание |
|---|---|
/reflect | Обработать очередь знаний с ручной проверкой |
/reflect --scan-history | Просканировать ВСЕ прошлые сессии на пропущенные знания |
/reflect --dry-run | Предпросмотр изменений без применения |
/reflect --targets | Показать обнаруженные конфигурационные файлы (CLAUDE.md, AGENTS.md) |
/reflect --review | Показать очередь с оценками уверенности и статусом устаревания |
/reflect --dedupe | Найти и объединить похожие записи в CLAUDE.md |
/reflect --include-tool-errors | Включить ошибки выполнения инструментов в сканирование |
/reflect-skills | Обнаружить кандидатов в навыки по повторяющимся паттернам |
/reflect-skills --days N | Анализировать последние N дней (по умолчанию: 14) |
/reflect-skills --project <path> | Анализировать конкретный проект |
/reflect-skills --all-projects | Сканировать все проекты на межпроектные паттерны |
/reflect-skills --dry-run | Предпросмотр паттернов без генерации файлов навыков |
/skip-reflect | Удалить все знания из очереди |
/view-queue | Просмотреть ожидающие знания без обработки |
Как работает
Двухэтапный процесс
Этап 1: Захват (автоматический)
Хуки запускаются автоматически для обнаружения и постановки исправлений в очередь:
| Хук | Триггер | Назначение |
|---|---|---|
session_start_reminder.py | Начало сессии | Показывает напоминание об ожидающих знаниях |
capture_learning.py | Каждый промпт | Обнаруживает паттерны исправлений и ставит их в очередь |
check_learnings.py | Перед компакцией | Создаёт резервную копию очереди и уведомляет пользователя |
post_commit_reminder.py | После git commit | Напоминает запустить /reflect после завершения работы |
Этап 2: Обработка (ручная)
Запустите /reflect, чтобы проверить и применить накопленные знания к CLAUDE.md.
Методы обнаружения
Claude-reflect использует гибридный подход к обнаружению:
1. Regex-паттерны (захват в реальном времени)
Быстрое сопоставление паттернов во время сессий обнаруживает:
- Исправления:
«нет, используй X»/«не используй Y»/«на самом деле...»/«это неверно» - Позитивная обратная связь:
«Отлично!»/«Именно так»/«Хороший подход» - Явные маркеры:
«запомни:»— наивысшая уверенность
2. Семантическая AI-валидация (во время /reflect)
При запуске /reflect семантический AI-фильтр:
- Поддерживает несколько языков — понимает исправления на любом языке
- Повышает точность — отфильтровывает ложные срабатывания regex
- Формирует чистые знания — извлекает лаконичные, применимые утверждения
Пример: исправление на испанском «no, usa Python» корректно распознаётся, даже если не совпадает с английскими паттернами.
Каждое захваченное знание имеет оценку уверенности (0.60–0.95). Итоговая оценка — наибольшее из значений regex и семантической уверенности.
Ручная проверка
При запуске /reflect Claude показывает сводную таблицу с вариантами действий:
- Применить — принять знание и добавить в CLAUDE.md
- Редактировать перед применением — скорректировать формулировку
- Пропустить — отклонить знание
- Пропустить всё — очистить очередь