Przewodnik tworzenia
Ten przewodnik jest praktycznym uzupełnieniem rozdziałów o architekturze i dokumentacji języka. Podczas gdy architektura wyjaśnia, dlaczego Aggrega ma taki kształt, a dokumentacja języka określa, co oznacza każde pole, ten przewodnik uczy, jak usiąść i tworzyć — po którą encję sięgnąć, w jakiej kolejności oraz jak CLI i asystent AI pomagają uzyskać poprawny plik przy jak najmniejszym wysiłku.
Przewodnik jest pisany jednocześnie dla dwóch grup odbiorców: osoby tworzącej pliki ręcznie w edytorze oraz asystenta AI tworzącego je w imieniu osoby za pośrednictwem serwera Model Context Protocol. Obie strony stosują tę samą pętlę i korzystają z tych samych materiałów referencyjnych, więc poniższe strony służą obu.
Kolejność czytania
- Tworzenie plików Aggrega — pełna pętla tworzenia: wybór roli, poznanie struktury, wygenerowanie szkieletu, uzupełnienie, walidacja, budowanie. Od tego należy zacząć.
- Persony — cztery współpracujące role autorskie (programista, architekt, zespół operacyjny, operator) oraz stojące za nimi podejście oparte na wskazówkach, a nie na wymuszaniu.
- Encje według ról — każdy rodzaj encji przypisany do roli, która zwykle za nią odpowiada, aby było wiadomo, w którym pliku umieścić daną kwestię.
- Instalacja — instalacja pliku binarnego
aggrega, z poleceniami na początku; sekcja o połączeniu odsyła do strony Połączenie z serwerem MCP. - Korzystanie z Aggrega w Visual Studio Code — rozszerzenie Aggrega dla Visual Studio Code: czego wymaga, strona powitalna, jego panele i graf topologii oraz wszystkie ustawienia i polecenia.
Import wychodzi od istniejącego już projektu w innym formacie i tworzy na jego podstawie wersje robocze tych plików do przejrzenia i skompilowania.
Strona Poznaj Aggrega umieszcza ten przewodnik na ścieżce prowadzącej przez całą dokumentację.
Praca z asystentem AI
- Konfiguracja Aggrega za pomocą asystenta AI — jeden prompt do wklejenia w asystenta, który potrafi uruchamiać polecenia, aby zainstalował Aggrega, dodał umiejętność Aggrega i połączył się z serwerem.
- Połączenie z serwerem MCP — wpis serwera dla kolejnych klientów, miejsce, w którym każdy klient go przechowuje, serwer dostępny przez HTTPS oraz sposób sprawdzenia połączenia.
- Umiejętność Aggrega — instrukcje, które asystent wczytuje na potrzeby Aggrega: ich instalacja i utrzymywanie w aktualnej wersji.
- Co asystent może zrobić z Aggrega — co podłączony serwer pozwala asystentowi czytać, sprawdzać, budować i publikować.
Jak materiały asystenta odnoszą się do tego przewodnika
Serwer aggrega mcp udostępnia ten przewodnik, dokumentację języka i schematy JSON Schema jako zasoby, które asystent czyta przed napisaniem YAML, a także narzędzia do generowania szkieletów i walidacji encji. Wbudowane prompty asystenta odsyłają do tych stron, zamiast powtarzać ich treść, dzięki czemu ten przewodnik jest jedynym tekstowym źródłem opisu metody tworzenia. Pętla jest opisana na stronie Tworzenie plików Aggrega, a połączenie na stronie Połączenie z serwerem MCP.