aggrega get-schema
Afficher le JSON Schema d’un type d’entité ou de contrat
Synopsis
aggrega get-schema [kind] [flags]Description
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.Options
| Option | Par défaut | Description |
|---|---|---|
--list | false | Lister chaque type de schéma, un par ligne. |
Fonctionnement
aggrega get-schema <kind> affiche sur la sortie standard le JSON Schema canonique d’un type d’entité ou de contrat. Le schéma est le contrat structurel de référence : les champs obligatoires, les valeurs autorisées et l’imbrication que le compilateur accepte pour ce type. Il est servi à partir des schémas intégrés au binaire, de sorte que la sortie correspond toujours à la version d’aggrega que vous exécutez.
aggrega get-schema --list affiche le nom de chaque type que vous pouvez demander, un par ligne — les types d’entités qu’un auteur rédige (aggregate, component, feature, recipe, featurerecipe, manifest, release, plugin, schemalibrary, mappinglibrary, workloadlibrary, artifactlibrary, workload) ainsi que les schémas de contrat internes qu’utilise le compilateur. Exécutez-la d’abord lorsque vous n’êtes pas sûr du jeton exact à passer.
Quand l’utiliser
Utilisez get-schema lorsque vous avez besoin de la forme exacte d’un type pendant la rédaction — quels champs sont obligatoires, ce que peut être une valeur, comment un bloc s’imbrique. C’est la référence par rapport à laquelle vérifier un fichier écrit à la main, et le point de départ pour découvrir un type peu familier. Comme elle affiche du JSON Schema lisible par une machine, vous pouvez aussi la transmettre à un éditeur compatible avec les schémas ou à un outil de validation.
Un assistant IA connecté via aggrega mcp lit les mêmes octets depuis la ressource schema://<kind>, de sorte que le schéma sur lequel un assistant rédige et celui que vous récupérez en ligne de commande sont identiques. Cette page documente la commande ; elle ne reproduit le contenu d’aucun schéma — exécutez la commande, ou ouvrez la page correspondante de la référence des entités pour l’explication champ par champ de ce que signifie chaque champ.
Exemples
Afficher le schéma d’un Component :
aggrega get-schema componentLister chaque type que vous pouvez demander :
aggrega get-schema --listRécupérer un schéma et inspecter un seul champ avec un outil JSON :
aggrega get-schema recipe | jq '.properties.spec'Pour la boucle de rédaction qu’alimente cette commande — apprendre la forme, créer le squelette, remplir, valider — consultez Rédiger des fichiers Aggrega.