/ Каталог / Песочница / claude-reflect
← Все серверы ↗ GitHub
● Сообщество BayramAnnakov ⚡ Сразу

claude-reflect

автор BayramAnnakov · BayramAnnakov/claude-reflect

Claude Code, тихо обучающийся на ваших исправлениях — фиксирует правила, предпочтения и похвалы, затем записывает их в CLAUDE.md / AGENTS.md.

claude-reflect работает в фоне сессий Claude Code, отслеживая моменты, когда вы исправляете, хвалите или повторяете предпочтения. Перегоняет их в долгосрочные правила и обновляет CLAUDE.md и AGENTS.md, чтобы будущие сессии их наследовали. Лёгкая альтернатива ручному ведению файла инструкций.

▶ Смотреть демо 📦 Установить 💡 Сценарии

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

готово

Установка

Репозиторий автора · Официальная документация Claude Skills

Сценарии использования

Реальные сценарии: claude-reflect

Развитие CLAUDE.md без ручного ведения

👤 Соло-разработчики, ненавидящие поддерживать документы ⏱ ~5 min beginner

Когда использовать: Хотите, чтобы CLAUDE.md поспевал за вашими предпочтениями без труда на написание.

Поток
  1. Работать в обычном режиме
    Just code with Claude as usual. Correct it when wrong, praise it when right.✓ Скопировано
    → Скилл тихо фиксирует — вы этого не замечаете
  2. Ревью в конце дня
    Use claude-reflect. Show me today's drafted rule additions. Approve or skip each.✓ Скопировано
    → 5–10 правил-кандидатов с провенанцем (сессия, prompt)
  3. Закоммитить diff
    Apply approved rules and commit CLAUDE.md.✓ Скопировано
    → Чистый git diff; правила вступают в силу

Итог: CLAUDE.md, растущий вместе с вами без ручного обслуживания.

Подводные камни
  • Скилл фиксирует разовый контекст как долгосрочные правила — Всегда проверяйте ежедневных кандидатов; отклоняйте ситуативное
Сочетать с: filesystem

Формирование командных AI-конвенций из коллективных исправлений

👤 Технические лиды, стандартизирующие AI-воркфлоу ⏱ ~60 min intermediate

Когда использовать: Несколько разработчиков исправляют Claude в схожих вещах; хотите общий набор правил.

Поток
  1. Собрать черновики от каждого разработчика
    Each dev runs claude-reflect daily and pushes their candidate rules to a shared review branch.✓ Скопировано
    → Ветка с N черновиками, ожидающими ревью
  2. Объединить сессии
    Use claude-reflect consolidate. Find rules captured by ≥2 people; promote those to AGENTS.md.✓ Скопировано
    → Набор правил, основанный на общем знаменателе
  3. Раскатить
    Merge to main. New AGENTS.md applies to everyone.✓ Скопировано
    → Команда использует единую базу; личные правила остаются у каждого

Итог: Стандартизация снизу вверх без комитета по процессам.

Подводные камни
  • Громкие разработчики доминируют; паттерны тихих не замечаются — Убедитесь, что все запускают скилл; взвешивайте по событиям рефлексии, а не по правкам файлов
Сочетать с: github

Аудит и удаление устаревших правил в CLAUDE.md

👤 Долгосрочные пользователи CLAUDE.md ⏱ ~25 min intermediate

Когда использовать: Ваш CLAUDE.md теперь 600 строк, и контекст Claude раздут.

Поток
  1. Оценить релевантность
    Use claude-reflect. Score each rule by recency-of-last-application and current-codebase-fit.✓ Скопировано
    → Оценка по каждому правилу
  2. Предложить удаления
    Suggest 30 rules to remove (stale or obsolete).✓ Скопировано
    → Список удалений с обоснованием
  3. Diff + коммит
    Apply approved removals; commit with message 'reflect: prune stale rules'.✓ Скопировано
    → CLAUDE.md стал стройнее

Итог: CLAUDE.md, который реально читают, а не пролистывают.

Подводные камни
  • Удалили правило, которое не применялось, потому что Claude его соблюдал — Если сомневаетесь — оставьте, но пометьте 'last verified' для перепроверки в следующем квартале

Комбинации

Сочетайте с другими MCP — эффект x10

claude-reflect-skill + pro-workflow-skill

pro-workflow для явного захвата, claude-reflect для пассивного — двухканальное обучение

Use pro-workflow when you say 'remember this'; let claude-reflect catch the rest in the background.✓ Скопировано
claude-reflect-skill + github

Проверяемые изменения правил через PR

Each Friday, claude-reflect opens a PR with proposed CLAUDE.md edits for human review.✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
watch_session — Всегда активный фоновый процесс 0
review_candidates since? Ежедневный / еженедельный цикл одобрения 0
consolidate scope? Периодическая дедупликация / разрешение противоречий 0
score_rules — Аудит перед удалением 0
apply_to_files approved_ids[], files[] Применить одобренных кандидатов в CLAUDE.md / AGENTS.md 0

Стоимость и лимиты

Во что обходится

Квота API
Нет — локально
Токенов на вызов
Фоновый захват бесплатный; review/consolidate использует локальный LLM при настройке
Деньги
Бесплатно
Совет
Одобряйте кандидатов консервативно — качество важнее количества

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: filesystem-write
Хранение учётных данных: Состояние скилла в .claude/reflect/; коммитьте в репозиторий при необходимости общего доступа
Исходящий трафик: Нет по умолчанию

Устранение неполадок

Частые ошибки и исправления

Кандидаты не захватываются

Убедитесь, что скилл вызывается в преамбуле CLAUDE.md; проверьте .claude/reflect/log на наличие записей

Кандидаты — шум

Ужесточьте чувствительность триггера; захватывайте только из явных исправлений, а не из общего чата

AGENTS.md дрейфует относительно CLAUDE.md

Периодически запускайте consolidate; инструмент предназначен для синхронизации, но ручные правки разводят их

Prompt одобрения перегружает

Запускайте review с --limit 5 ежедневно; сформируйте привычку вместо разовой обработки 50 штук

Альтернативы

claude-reflect в сравнении

АльтернативаКогда использоватьКомпромисс
pro-workflow-skillПредпочитаете явный захват и оркестрацию worktreeБолее ручной; более мощный для параллельной работы
Manual CLAUDE.md curationДостаточно дисциплинированы, чтобы писать правила самостоятельноЧасто забрасывается; держится на силе воли

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills