Инициализация проекта: создание первого впечатления

Что вы сможете сделать после изучения

• Быстро ознакомиться с проектом: Позвольте Agent как новому сотруднику активно изучать и понимать всю кодовую базу.
• Создать долгосрочную память: Автоматически извлечь технологический стек, архитектурные шаблоны и стандарты кодирования проекта и сохранить в Supermemory.
• Устранить повторные объяснения: Больше не нужно повторять "мы используем Bun" или "все компоненты должны быть протестированы" в начале каждой сессии.

Ваша текущая проблема

Сталкивались ли вы с этими ситуациями:

• Повторяющаяся работа: В каждой новой сессии нужно много рассказывать Agent о базовой информации проекта.
• Забывание контекста: Agent часто забывает специфичную структуру каталогов проекта и создает файлы в неправильных местах.
• Несогласованные стандарты: Стиль кода, который пишет Agent, нестабилен — то использует interface, то type.

Когда использовать этот метод

• После установки плагина: Это первый шаг использования opencode-supermemory.
• При принятии нового проекта: Быстро создать базу памяти для этого проекта.
• После значительного рефакторинга: Когда архитектура проекта изменяется, нужно обновить знания Agent.

🎒 Подготовка перед началом

Предварительная проверка

Убедитесь, что вы выполнили шаги установки и настройки из Быстрый старт и SUPERMEMORY_API_KEY правильно настроен.

Основная идея

Команда /supermemory-init по сути не является двоичной программой, а тщательно разработанным Prompt (подсказкой).

Когда вы запускаете эту команду, она отправляет Agent подробное "руководство для новых сотрудников", указывающее Agent:

1. Глубокое исследование: Активно читать README.md, package.json, записи коммитов Git и т. д.
2. Структурный анализ: Определять технологический стек, архитектурные шаблоны, неявные соглашения проекта.
3. Постоянное хранение: Использовать инструмент supermemory для сохранения этих знаний в облачной базе данных.

Область действия памяти

Процесс инициализации различает два типа памяти:

• Project Scope: Действует только для текущего проекта (например: команды сборки, структура каталогов).
• User Scope: Действует для всех ваших проектов (например: предпочитаемый стиль кодирования).

Следуйте моему примеру

Шаг 1: Запуск команды инициализации

В поле ввода OpenCode введите следующую команду и отправьте:

/supermemory-init

Почему Это загрузит предопределенный Prompt и запустит режим исследования Agent.

Что вы должны увидеть Agent начинает отвечать, указывая, что он понимает задачу и начинает планировать шаги исследования. Он может сказать: "I will start by exploring the codebase structure and configuration files..."

Шаг 2: Наблюдение за процессом исследования Agent

Agent автоматически выполнит серию операций, вам просто нужно смотреть. Обычно он:

1. Чтение файлов конфигурации: Читает package.json, tsconfig.json и т. д., чтобы понять технологический стек.
2. Просмотр истории Git: Запускает git log, чтобы понять стандарты коммитов и активных участников.
3. Исследование структуры каталогов: Использует ls или list_files для просмотра макета проекта.

Пример вывода:

[Agent] Reading package.json to identify dependencies...
[Agent] Running git log to understand commit conventions...

Совет по потреблению

Этот процесс представляет собой глубокое исследование, которое может потребовать много токенов (обычно выполняется 50+ вызовов инструментов). Пожалуйста, подождите, пока Agent сообщит о завершении.

Шаг 3: Проверка сгенерированной памяти

Когда Agent сообщает, что инициализация завершена, вы можете проверить, что именно он запомнил. Введите:

/ask Список памяти текущего проекта

Или напрямую вызовите инструмент (если вы хотите просмотреть исходные данные):

supermemory(mode: "list", scope: "project")

Что вы должны увидеть Agent перечисляет серию структурированной памяти, например:

Тип	Пример содержимого
project-config	"Использует Bun runtime. Команда сборки: bun run build"
architecture	"Маршруты API находятся в src/routes/, используется фреймворк Hono"
preference	"Строгое использование TypeScript: тип 'any' не разрешен"

Шаг 4: Добавление пропущенного (по желанию)

Если Agent пропустил определенную ключевую информацию (например, определенное специальное правило, которое только устно согласовано), вы можете вручную добавить:

Запомните: в этом проекте вся обработка дат должна использовать библиотеку dayjs, использование нативного Date запрещено.

Что вы должны увидеть Agent отвечает подтверждением и вызывает supermemory(mode: "add") для сохранения этого нового правила.

Контрольная точка ✅

• [ ] После запуска /supermemory-init Agent автоматически выполняет задачи исследования?
• [ ] Можно ли просмотреть новую память с помощью команды list?
• [ ] Точно ли содержимое памяти отражает фактическую ситуацию текущего проекта?

Предупреждения о типичных ошибках

Не запускайте часто

Инициализация — это длительный и затратный по токенам процесс. Обычно для каждого проекта нужно запустить только один раз. Пересоздание нужно только тогда, когда в проекте происходят значительные изменения.

Внимание к конфиденциальности

Хотя плагин автоматически удаляет чувствительные данные в тегах <private>, во время инициализации Agent читает множество файлов. Убедитесь, что в вашей кодовой базе нет жестко закодированных чувствительных ключей (например, AWS Secret Key), иначе они могут быть сохранены в памяти как "конфигурация проекта".

Итог урока

С помощью /supermemory-init мы завершили переход от "незнакомца" к "опытному сотруднику". Теперь Agent запомнил основную архитектуру и стандарты проекта, и в следующих задачах кодирования он автоматически будет использовать этот контекст, чтобы предоставлять более точную помощь.

Предпросмотр следующего урока

В следующем уроке мы изучим Механизм автоматического внедрения контекста.

Вы узнаете:

• Как Agent "вспоминает" эту память в начале сессии.
• Как с помощью ключевых слов триггерировать вызов определенной памяти.

---

Приложение: справочник по исходному коду

Нажмите, чтобы просмотреть расположение исходного кода

Время обновления: 2026-01-23

Функция	Путь к файлу	Номер строки
Определение Prompt инициализации	src/cli.ts	13-163
Реализация инструмента памяти	src/index.ts	183-485

Ключевые константы:

• SUPERMEMORY_INIT_COMMAND: Определяет конкретное содержимое Prompt команды /supermemory-init, указывая Agent, как проводить исследования и запоминать.