mex (Claude Skill) — Сценарии использования, Установка & Живое демо

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

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

Структурированный скаффолд памяти: архитектура / конвенции / текущие задачи / блокеры
Drift CLI сравнивает утверждения памяти с фактическим кодом/тестами
Маркеры свежести по разделам (дата последней проверки)
Разработан для совместного использования людьми и агентами; оба читают одни файлы
Хорошо совместим с CLAUDE.md / AGENTS.md

Живое демо

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

готово

Установка

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

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mex-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/theDakshJaitly/mex",
        "~/.claude/skills/mex"
      ],
      "_inferred": true
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mex-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/theDakshJaitly/mex",
        "~/.claude/skills/mex"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mex-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/theDakshJaitly/mex",
        "~/.claude/skills/mex"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mex-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/theDakshJaitly/mex",
        "~/.claude/skills/mex"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mex-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/theDakshJaitly/mex",
        "~/.claude/skills/mex"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "mex-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/theDakshJaitly/mex",
          "~/.claude/skills/mex"
        ]
      }
    }
  }
}

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

claude mcp add mex-skill -- git clone https://github.com/theDakshJaitly/mex ~/.claude/skills/mex

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

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

Реальные сценарии: mex

Настройка памяти проекта в начале проекта

👤 Владельцы новых репозиториев ⏱ ~25 min beginner

Когда использовать: День 1 проекта; хотите, чтобы агенты быстро входили в курс.

Предварительные требования

Установленный скилл — git clone https://github.com/theDakshJaitly/mex ~/.claude/skills/mex

Поток

Инициализировать

Use mex. Initialize project memory with sections: architecture, conventions, in-flight, blockers.✓ Скопировано

→ Скаффолд /.mex/ создан с шаблонами
Заполнить начальные данные

Auto-extract architecture from existing code and a starter convention list.✓ Скопировано

→ Разделы заполнены стартовым контентом
Установить маркеры свежести

Mark each section verified today.✓ Скопировано

→ Маркеры свежести установлены

Итог: Новый проект начинается с общим контекстом для агентов.

Подводные камни

Авто-извлечение захватывает нерелевантные детали — Безжалостно обрезайте — память для принципов, не для grep

Сочетать с: filesystem

Нахождение расхождений между памятью проекта и кодом

👤 Владельцы долгоживущих проектов ⏱ ~30 min intermediate

Когда использовать: Память создана месяцы назад; неясно, насколько она устарела.

Поток

Запустить drift

Use mex. Run drift detection. Report claims that no longer match reality.✓ Скопировано

→ Отчёт о дрейфе: утверждение ↔ свидетельство
Обновить или удалить

For each drift, decide: update memory or fix the code (claim was right and reality drifted).✓ Скопировано

→ Решение по каждому пункту; PR открыты для исправлений на стороне кода
Повторно верифицировать

After resolving, mark sections verified today.✓ Скопировано

→ Память снова выровнена

Итог: Память остаётся надёжным контрактом, а не фольклором.

Подводные камни

Детектор дрейфа слишком агрессивен — Настройте --strictness; используйте 'medium' для живых проектов

Сочетать с: github

Передача текущих задач между членами команды

👤 Разработчики, уходящие в отпуск / увольняющиеся ⏱ ~20 min beginner

Когда использовать: У вас 3 фичи в работе и кто-то другой должен их подхватить.

Поток

Зафиксировать текущие задачи

Use mex. For each open branch, write an in-flight entry: goal, current state, next steps, gotchas.✓ Скопировано

→ Записи в /.mex/in-flight/
Проверить через CLI

Run drift on in-flight; ensure entries reflect actual branch state.✓ Скопировано

→ Дрейф отсутствует
Передать

Generate a teammate-ready summary linking each entry to its branch.✓ Скопировано

→ Краткое описание для передачи в Slack/email

Итог: Плавный подхват; без археологических раскопок.

Подводные камни

Записи текущих задач расплывчаты («работаю над X») — Требуйте заполнения поля 'next steps' из шаблона; конкретно или это не помогает

Комбинации

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

mex-skill + filesystem

Память хранится в репозитории; коммитьте её

Commit /.mex/ to git so memory travels with the codebase.✓ Скопировано

mex-skill + github

Проверка дрейфа в CI на PR

On every PR, run mex drift and post the report as a PR comment.✓ Скопировано

Инструменты

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

Инструмент	Входные данные	Когда вызывать	Стоимость
init	scaffold_options	Один раз на проект	0
drift	section?, strictness?	Еженедельно / перед слиянием долгоживущих веток	0 (использует локальные проверки + LLM для нечётких утверждений)
verify	section	После обновления памяти для соответствия реальности	0
in_flight_add	branch, goal, next_steps	При создании ветки для фичи	0
summary	format	Передача задач / статус-отчёт	0

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

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

Квота API: Нет — локально
Токенов на вызов: Drift использует LLM для нечётких утверждений; ограничен на запуск
Деньги: Бесплатно
Совет: Используйте strict=high в CI для поиска реального дрейфа; medium для ежедневных локальных проверок

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

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

Минимальные скоупы: filesystem-write

Хранение учётных данных: Нет

Исходящий трафик: Нет, если LLM для drift не настроен на удалённый провайдер

Память содержит детали архитектуры — добавьте /.mex/ в .gitignore если репозиторий приватный, но зеркалируется в публичные форки

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

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

Drift сообщает о ложных срабатываниях

Снизьте strictness; или переформулируйте утверждение более проверяемым образом

Память растёт бесконтрольно

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

CLI не может найти /.mex/

Запускайте из корня репозитория; или передайте --root <path>

Авто-извлечение пропускает ключевые инварианты

Авто-извлечение — стартовая точка; пишите несущие инварианты вручную

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

mex в сравнении

Альтернатива	Когда использовать	Компромисс
claude-mem-skill	Нужна непрерывность сессий, а не памяти проекта	Разные задачи; mex для инвариантов уровня проекта
Plain CLAUDE.md	Маленький проект, детектор дрейфа не нужен	Нет структуры; нет автоматических проверок свежести
pilot-shell-skill	Хотите spec/план/gate плюс персистентность знаний	Больший охват воркфлоу; больше мнений

Ещё

Ресурсы

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

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

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