Руководство по написанию
Это руководство — практическое дополнение к главам об архитектуре и к справочнику по языку. Если архитектура объясняет, почему Aggrega устроена именно так, а справочник определяет, что означает каждое поле, то это руководство учит, как сесть и написать файл: к какой сущности обратиться, в каком порядке и как CLI и ИИ-ассистент помогают получить корректный файл с наименьшими усилиями.
Руководство написано сразу для двух аудиторий: для человека, который пишет вручную в редакторе, и для ИИ-ассистента, который пишет от имени человека через сервер Model Context Protocol. Оба следуют одному и тому же циклу и читают одни и те же справочные материалы, поэтому страницы ниже подходят обоим.
Читайте в этом порядке
- Написание файлов Aggrega — полный цикл написания: выберите свою роль, изучите структуру, создайте заготовку, заполните, проверьте, соберите. Начните отсюда.
- Персоны — четыре взаимодействующие роли авторов (разработчик, архитектор, эксплуатация, оператор) и лежащий в их основе подход «рекомендации, а не принуждение».
- Сущности по ролям — каждый вид сущности сопоставлен с ролью, которая обычно им владеет, чтобы вы знали, в какой файл относится каждая задача.
- Установка — установка бинарного файла
aggrega, начиная с команд; раздел о подключении отсылает к странице Подключение MCP-сервера. - Использование Aggrega в Visual Studio Code — расширение Aggrega для Visual Studio Code: что ему нужно, страница приветствия, его панели и граф топологии, а также все настройки и команды.
Импорт начинает с проекта, который у вас уже есть в другом формате, и создаёт из него черновики этих файлов, чтобы вы их просмотрели и собрали.
Страница Изучение Aggrega помещает это руководство в маршрут по всей документации.
Работа с ИИ-ассистентом
- Настройка Aggrega с помощью ИИ-ассистента — один промпт, который нужно вставить в ассистента, умеющего выполнять команды, чтобы он установил Aggrega, добавил навык Aggrega и подключился к серверу.
- Подключение MCP-сервера — запись сервера для каждого клиента, где каждый клиент её хранит, сервер, доступный по HTTPS, и как проверить подключение.
- Навык Aggrega — инструкции, которые ассистент загружает для работы с Aggrega: их установка и поддержание в актуальном состоянии.
- Что ваш ассистент может делать с Aggrega — что подключённый сервер позволяет ассистенту читать, проверять, собирать и публиковать.
Как интерфейсы ассистента связаны с этим руководством
Сервер aggrega mcp предоставляет это руководство, справочник по языку и схемы JSON Schema как ресурсы, которые ассистент читает, прежде чем писать YAML, а также инструменты для создания заготовок и проверки сущностей. Встроенные промпты ассистента для написания ссылаются на эти страницы, а не пересказывают их, поэтому это руководство — единственное текстовое описание метода написания. Цикл описан в разделе Написание файлов Aggrega, а подключение — в разделе Подключение MCP-сервера.