aggrega get-schema
Wypisuje JSON Schema dla rodzaju encji lub kontraktu
Składnia
aggrega get-schema [kind] [flags]Opis
Print the canonical JSON Schema for an embedded kind.
The kind is the lowercase-hyphenated schema name — for example component, aggregate, ir, or template-context. Entity kinds, the intermediate-representation and wire-format contracts, and the wasm-* plugin socket contracts are all addressable. The emitted bytes are identical to the distributed schema file.
Use --list to enumerate every available kind, one per line.Flagi
| Flaga | Domyślnie | Opis |
|---|---|---|
--list | false | Wyświetla listę wszystkich rodzajów schematów, po jednym w wierszu. |
Działanie
aggrega get-schema <kind> wypisuje na standardowe wyjście kanoniczny JSON Schema dla jednego rodzaju encji lub kontraktu. Schemat jest wiążącym kontraktem strukturalnym: określa wymagane pola, dozwolone wartości oraz zagnieżdżenie, które kompilator akceptuje dla danego rodzaju. Jest udostępniany ze schematów wbudowanych w plik binarny, dlatego wynik zawsze odpowiada uruchomionej wersji aggrega.
aggrega get-schema --list wypisuje nazwę każdego rodzaju, o który można zapytać, po jednej w wierszu — rodzaje encji pisane przez autorów (aggregate, component, feature, recipe, featurerecipe, manifest, release, plugin, schemalibrary, mappinglibrary, workloadlibrary, artifactlibrary, workload) obok wewnętrznych schematów kontraktów używanych przez kompilator. Warto uruchomić to polecenie najpierw, gdy nie ma pewności co do dokładnego tokenu do przekazania.
Kiedy używać
Po get-schema należy sięgnąć, gdy podczas tworzenia potrzebny jest dokładny kształt rodzaju — które pola są wymagane, jaka może być wartość, jak zagnieżdża się blok. Jest to punkt odniesienia do sprawdzania ręcznie napisanego pliku i punkt wyjścia przy poznawaniu nieznanego rodzaju. Ponieważ polecenie wypisuje JSON Schema w formie czytelnej maszynowo, można go też przekazać do edytora obsługującego schematy lub narzędzia walidującego.
Asystent AI połączony przez aggrega mcp odczytuje te same bajty z zasobu schema://<kind>, więc schemat, według którego tworzy asystent, i schemat pobrany w wierszu poleceń są identyczne. Ta strona dokumentuje polecenie; nie odtwarza zawartości żadnego schematu — należy uruchomić polecenie lub otworzyć odpowiednią stronę dokumentacji encji, aby poznać objaśnienie znaczenia każdego pola.
Przykłady
Wypisanie schematu dla encji Component:
aggrega get-schema componentLista wszystkich rodzajów, o które można zapytać:
aggrega get-schema --listPobranie schematu i sprawdzenie pojedynczego pola narzędziem JSON:
aggrega get-schema recipe | jq '.properties.spec'Cykl tworzenia, któremu służy to polecenie — poznanie kształtu, szkielet, wypełnienie, walidacja — opisano na stronie Tworzenie plików Aggrega.