project-memory MCP — Сценарии использования, Установка & Живое демо

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

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

Четырехфайловый канон: bugs.md, Decisions.md, key_facts.md, Issues.md.
Клод читает их, прежде чем предлагать архитектурные изменения.
Три области установки: глобальная (~/.claude/skills), проект (.claude/skills), рабочая область.
Устанавливается через Skilz (pip) или обычную копию.
Никакой базы данных — только Markdown, вы можете сравнивать и просматривать

Живое демо

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

project-memory-skill.replay ▶ готово

0/0

Установка

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

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

{
  "mcpServers": {
    "project-memory-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ],
      "_inferred": false
    }
  }
}

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

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

{
  "mcpServers": {
    "project-memory-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ],
      "_inferred": false
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "project-memory-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ],
      "_inferred": false
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "project-memory-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ],
      "_inferred": false
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "project-memory-skill",
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "project-memory-skill": {
      "command": {
        "path": "pip",
        "args": [
          "install",
          "skilz",
          "&&",
          "skilz",
          "install",
          "SpillwaveSolutions_project-memory/project-memory"
        ]
      }
    }
  }
}

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

claude mcp add project-memory-skill -- pip install skilz && skilz install SpillwaveSolutions_project-memory/project-memory

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

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

Реальные сценарии: project-memory

Загрузите память проекта в существующую кодовую базу.

👤 Команды устали заново объяснять один и тот же контекст своему агенту ⏱ ~15 min beginner

Когда использовать: Вы использовали Claude Code в этом репозитории, но контекст сбрасывается при каждом сеансе.

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

Python 3.10+ для установщика Skilz — pyenv или системный Python

Поток

Установить в рамках проекта

pip install Skilz && Skilz install SpillwaveSolutions_project-memory/project-memory --scope project✓ Скопировано

→ Появится .claude/skills/project-memory/SKILL.md
Запустите команду начальной загрузки

/project-memory — инициализировать четыре файла для этого репозитория.✓ Скопировано

→ docs/project_notes/, созданный с помощью четырех канонических файлов
Посев решения.md с 2–3 известными вариантами

Добавьте ADR для нашего выбора ORM, нашего соглашения об обработке ошибок и нашего средства запуска CI.✓ Скопировано

→ Три аккуратных записи ADR

Итог: Теперь у Клода есть настойчивый и проверяемый мозг для этого репозитория.

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

Коммит key_facts.md с секретами — Навык явно помечает файл key_facts.md как «неконфиденциальный» — никогда не помещайте туда учетные данные.

Сочетать с: memory-bank-mcp

Выявите основную причину ошибки, чтобы она никогда не вернулась

👤 Дежурные инженеры тушат пожар ⏱ ~5 min beginner

Когда использовать: Вы только что исправили что-то сложное и хотите, чтобы урок был долговечным.

Поток

Попросите Клода записать это.

Добавьте это в bugs.md — ошибка NoneType в billing.retry; основная причина: устаревший кеш ключей идемпотентности; предотвращение: TTL в кеше.✓ Скопировано

→ Новая запись в bugs.md с основной причиной и профилактикой.

Итог: Каталог ошибок, который принесет дивиденды в следующий раз, когда появится подобный симптом.

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

Пишем симптом вместо причины — Обязательно включите в запись разделы «Основная причина» и «Профилактика», а не только «то, что я исправил».

Сочетать с: github

Прежде чем предлагать рефакторинг, позвольте Клоду проконсультироваться на сайте Decisions.md.

👤 Команды, которые ненавидят повторно обсуждать принятые решения со своим агентом ⏱ ~10 min beginner

Когда использовать: Ваш агент продолжает предлагать фреймворки/шаблоны, от которых команда уже отказалась.

Поток

Убедитесь, что решение находится в решениях.md

Запись: «Мы используем шаблон репозитория, а не Active Record. Обоснование: <x>.'✓ Скопировано

→ Очистить ADR в Decisions.md
Запросить рефакторинг

Предложите рефакторинг src/billing/ — уважайте наши решения.md.✓ Скопировано

→ Предложение ссылается на решение репозитория и не предполагает активную запись.

Итог: Меньше тупиковых предложений, которые отклоняются при рассмотрении.

Сочетать с: git

Комбинации

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

project-memory-skill + memory-bank-mcp

Используйте project-memory для курируемых канонических четырех файлов, а Memory-bank-mcp для рабочей памяти свободной формы в проектах.

Записывайте структурированные ADR в Decisions.md; сбрасывать необработанные записи сеанса в банк памяти.✓ Скопировано

project-memory-skill + github

После объединения PR обновите решения.md и Issues.md как часть описания PR.

Откройте PR и включите в описание diff решения.md.✓ Скопировано

project-memory-skill + git

Прежде чем брать на себя обязательства, просмотрите различия в памяти, чтобы они были честными.

git diff docs/project_notes/ — прочитать перед фиксацией; исправить что-либо вводящее в заблуждение.✓ Скопировано

Инструменты

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

Инструмент	Входные данные	Когда вызывать	Стоимость
/project-memory	subcommand: init\|add-bug\|add-decision\|add-fact\|log-issue	Загрузите файлы и запишите новые записи.	0

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

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

Квота API: Никто
Токенов на вызов: Зависит от того, сколько из четырех файлов загружает Клод; делайте записи короткими
Деньги: Бесплатно
Совет: Отдавайте предпочтение коротким, датированным записям, а не длинным повествованиям — Клод просматривает их каждый сеанс, поэтому размер имеет значение.

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

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

Хранение учётных данных: Явно: key_facts.md предназначен только для неконфиденциальной конфигурации. Храните секреты в локации или хранилище, а не здесь.

Исходящий трафик: Локальные файлы; нет сетевой активности самого навыка

Если вы фиксируете docs/project_notes/ в общедоступном репозитории, помните, что Клод, возможно, записал внутренние данные — просмотрите их перед отправкой.
Не позволяйте агентам автоматически добавлять данные в Decisions.md без проверки; именно здесь устаревший или неправильный контекст разъедает всю систему.

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

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

Команда /project-memory не распознана

Навык не установлен в ожидаемом объеме. Переустановите с помощью Skilz и перезапустите Клода.

Проверить: ls ~/.claude/skills/project-memory/ or .claude/skills/project-memory/

Клод игнорирует решения.md

Убедитесь, что в файле решения.md есть четкие записи в стиле ADR с заголовками «Решение» и «Обоснование»; расплывчатые пункты списка пропускаются.

Проверить: head docs/project_notes/decisions.md

Файлы продолжают расти

Архивировать ежеквартально — перемещайте старые записи в docs/project_notes/archive/, чтобы активные файлы оставались доступными для сканирования.

Проверить: wc -l docs/project_notes/*.md

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

project-memory в сравнении

Альтернатива	Когда использовать	Компромисс
memory-bank-mcp	Вам нужна межпроектная память, доступная с помощью инструмента, а не файлов.	Больше гибкости, менее заметно в PR-обзорах
codebase-memory	Вам нужен граф символов кода, а не повествовательные примечания.	Другой слой памяти
marm-systems	Вам нужна более сложная структура памяти	Более тяжелая установка

Ещё

Ресурсы

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

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

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