Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Руководство по написанию

Это руководство — практическое дополнение к главам об архитектуре и к справочнику по языку. Если архитектура объясняет, почему Aggrega устроена именно так, а справочник определяет, что означает каждое поле, то это руководство учит, как сесть и написать файл: к какой сущности обратиться, в каком порядке и как CLI и ИИ-ассистент помогают получить корректный файл с наименьшими усилиями.

Руководство написано сразу для двух аудиторий: для человека, который пишет вручную в редакторе, и для ИИ-ассистента, который пишет от имени человека через сервер Model Context Protocol. Оба следуют одному и тому же циклу и читают одни и те же справочные материалы, поэтому страницы ниже подходят обоим.

Читайте в этом порядке

  1. Написание файлов Aggrega — полный цикл написания: выберите свою роль, изучите структуру, создайте заготовку, заполните, проверьте, соберите. Начните отсюда.
  2. Персоны — четыре взаимодействующие роли авторов (разработчик, архитектор, эксплуатация, оператор) и лежащий в их основе подход «рекомендации, а не принуждение».
  3. Сущности по ролям — каждый вид сущности сопоставлен с ролью, которая обычно им владеет, чтобы вы знали, в какой файл относится каждая задача.
  4. Установка — установка бинарного файла aggrega, начиная с команд; раздел о подключении отсылает к странице Подключение MCP-сервера.
  5. Использование Aggrega в Visual Studio Code — расширение Aggrega для Visual Studio Code: что ему нужно, страница приветствия, его панели и граф топологии, а также все настройки и команды.

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

Страница Изучение Aggrega помещает это руководство в маршрут по всей документации.

Работа с ИИ-ассистентом

  1. Настройка Aggrega с помощью ИИ-ассистента — один промпт, который нужно вставить в ассистента, умеющего выполнять команды, чтобы он установил Aggrega, добавил навык Aggrega и подключился к серверу.
  2. Подключение MCP-сервера — запись сервера для каждого клиента, где каждый клиент её хранит, сервер, доступный по HTTPS, и как проверить подключение.
  3. Навык Aggrega — инструкции, которые ассистент загружает для работы с Aggrega: их установка и поддержание в актуальном состоянии.
  4. Что ваш ассистент может делать с Aggrega — что подключённый сервер позволяет ассистенту читать, проверять, собирать и публиковать.

Как интерфейсы ассистента связаны с этим руководством

Сервер aggrega mcp предоставляет это руководство, справочник по языку и схемы JSON Schema как ресурсы, которые ассистент читает, прежде чем писать YAML, а также инструменты для создания заготовок и проверки сущностей. Встроенные промпты ассистента для написания ссылаются на эти страницы, а не пересказывают их, поэтому это руководство — единственное текстовое описание метода написания. Цикл описан в разделе Написание файлов Aggrega, а подключение — в разделе Подключение MCP-сервера.