콘텐츠로 이동
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를 출력하므로 스키마를 인식하는 편집기나 검증 도구에 입력으로 제공할 수도 있습니다.

aggrega mcp를 통해 연결된 AI 어시스턴트는 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 파일 작성을 참조하십시오.