Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

aggrega get-schema

Вивести JSON Schema для виду сутності або контракту

Синтаксис

aggrega get-schema [kind] [flags]

Опис

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.

Прапорці

ПрапорецьЗа замовчуваннямОпис
--listfalseВивести всі види схем, по одному на рядок.

Що вона робить

aggrega get-schema <kind> виводить канонічну JSON Schema для одного виду сутності або контракту у стандартний вивід. Схема — це авторитетний структурний контракт: обов’язкові поля, допустимі значення та вкладеність, які компілятор приймає для цього виду. Її беруть зі схем, вбудованих у бінарний файл, тому вивід завжди відповідає версії aggrega, яку ви запускаєте.

aggrega get-schema --list виводить назву кожного виду, який можна запитати, по одній на рядок, — види сутностей, які пише автор (aggregate, component, feature, recipe, featurerecipe, manifest, release, plugin, schemalibrary, mappinglibrary, workloadlibrary, artifactlibrary, workload), разом із внутрішніми схемами контрактів, які використовує компілятор. Запустіть її спочатку, якщо ви не впевнені, який саме токен передати.

Коли її використовувати

Звертайтеся до get-schema, коли під час написання вам потрібна точна форма виду: які поля обов’язкові, яким може бути значення, як вкладається блок. Це еталон, з яким можна звірити написаний вручну файл, і відправна точка для вивчення незнайомого виду. Оскільки команда виводить машиночитну JSON Schema, її також можна передати редактору з підтримкою схем або інструменту валідації.

AI-асистент, підключений через aggrega mcp, читає ті самі байти з ресурсу schema://<kind>, тому схема, за якою пише асистент, і схема, яку ви отримуєте в командному рядку, ідентичні. Ця сторінка документує команду; вона не відтворює вміст жодної схеми — запустіть команду або відкрийте відповідну сторінку довідника сутностей, щоб отримати пояснення значення кожного поля.

Приклади

Вивести схему для сутності Component:

Terminal window
aggrega get-schema component

Вивести всі види, які можна запитати:

Terminal window
aggrega get-schema --list

Отримати схему й переглянути окреме поле за допомогою інструмента для JSON:

Terminal window
aggrega get-schema recipe | jq '.properties.spec'

Про цикл написання, якому слугує ця команда, — вивчити форму, створити заготовку, заповнити, перевірити — див. Написання файлів Aggrega.