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

claude-reflect

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

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

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

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

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

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

Живое демо

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

готово

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "claude-reflect-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json
{
  "context_servers": {
    "claude-reflect-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/BayramAnnakov/claude-reflect",
          "~/.claude/skills/claude-reflect"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add claude-reflect-skill -- git clone https://github.com/BayramAnnakov/claude-reflect ~/.claude/skills/claude-reflect

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

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

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

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

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

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

Предварительные требования
  • Установленный скилл — git clone https://github.com/BayramAnnakov/claude-reflect ~/.claude/skills/claude-reflect
  • Рефлексия включена — Добавьте use claude-reflect в преамбулу 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