aggrega get-schema
Imprimir el JSON Schema de un tipo de entidad o de contrato
Sinopsis
aggrega get-schema [kind] [flags]Descripción
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.Flags
| Flag | Predeterminado | Descripción |
|---|---|---|
--list | false | Enumerar cada tipo de esquema, uno por línea. |
Qué hace
aggrega get-schema <kind> imprime en la salida estándar el JSON Schema canónico de un tipo de entidad o de contrato. El esquema es el contrato estructural de referencia: los campos obligatorios, los valores permitidos y el anidamiento que el compilador acepta para ese tipo. Se sirve a partir de los esquemas integrados en el binario, así que la salida siempre coincide con la versión de aggrega que estás ejecutando.
aggrega get-schema --list imprime el nombre de cada tipo que puedes solicitar, uno por línea — los tipos de entidad que escribe un autor (aggregate, component, feature, recipe, featurerecipe, manifest, release, plugin, schemalibrary, mappinglibrary, workloadlibrary, artifactlibrary, workload) junto con los esquemas de contrato internos que usa el compilador. Ejecútalo primero cuando no estés seguro del token exacto que debes pasar.
Cuándo usarlo
Recurre a get-schema cuando necesites la forma exacta de un tipo mientras escribes — qué campos son obligatorios, qué puede ser un valor, cómo se anida un bloque. Es la referencia con la que comprobar un archivo escrito a mano, y el punto de partida para aprender un tipo que no conoces. Como imprime JSON Schema legible por máquina, también puedes pasárselo a un editor compatible con esquemas o a una herramienta de validación.
Un asistente de IA conectado a través de aggrega mcp lee los mismos bytes del recurso schema://<kind>, así que el esquema sobre el que escribe un asistente y el esquema que obtienes en la línea de comandos son idénticos. Esta página documenta el comando; no reproduce el contenido de ningún esquema — ejecuta el comando, o abre la página correspondiente de la referencia de entidades para la explicación campo por campo de lo que significa cada campo.
Ejemplos
Imprimir el esquema de un Component:
aggrega get-schema componentEnumerar cada tipo que puedes solicitar:
aggrega get-schema --listObtener un esquema e inspeccionar un único campo con una herramienta JSON:
aggrega get-schema recipe | jq '.properties.spec'Para el ciclo de autoría al que alimenta este comando — aprender la forma, generar el esqueleto, rellenar, validar —, consulta Escribir archivos de Aggrega.