이 페이지는 기계 번역되었습니다. 영어 원문 읽기.
작성 가이드
이 가이드는 아키텍처 장과 언어 레퍼런스를 보완하는 실습 안내서입니다. 아키텍처가 Aggrega가 지금의 모습을 갖춘 이유를 설명하고 레퍼런스가 각 필드가 무엇을 의미하는지 규정한다면, 이 가이드는 실제로 앉아서 작성하는 방법을 가르칩니다. 즉 어떤 엔터티를 어떤 순서로 사용하는지, 그리고 CLI와 AI 어시스턴트가 최소한의 수고로 올바른 파일을 얻도록 어떻게 돕는지를 다룹니다.
이 가이드는 두 독자를 동시에 대상으로 합니다. 하나는 편집기에서 직접 작성하는 사람이고, 다른 하나는 Model Context Protocol 서버를 통해 사람을 대신해 작성하는 AI 어시스턴트입니다. 둘 다 같은 루프를 따르고 같은 레퍼런스를 읽으므로, 아래 페이지는 양쪽 모두에 도움이 됩니다.
읽는 순서
- Aggrega 파일 작성 — 처음부터 끝까지의 작성 루프입니다. 역할을 고르고, 구조를 익히고, 스캐폴딩하고, 내용을 채우고, 검증하고, 빌드합니다. 여기서 시작하십시오.
- 페르소나 — 서로 협력하는 네 가지 작성 역할(개발자, 아키텍트, 운영, 오퍼레이터)과 그 바탕에 있는 강제가 아닌 안내라는 관점을 설명합니다.
- 역할별 엔터티 — 모든 엔터티 종류를 일반적으로 그것을 담당하는 역할에 대응시켜, 각 관심사가 어느 파일에 속하는지 알 수 있게 합니다.
- 설치 —
aggrega바이너리를 설치합니다. 명령을 먼저 보여 주며, 연결 섹션은 MCP 서버 연결로 안내합니다. - Visual Studio Code에서 Aggrega 사용하기 — Visual Studio Code용 Aggrega 확장: 필요한 것, 시작 페이지, 패널과 토폴로지 그래프, 그리고 모든 설정과 명령.
가져오기는 다른 형식으로 이미 가지고 있는 프로젝트에서 시작하여 이 파일들의 초안을 작성하며, 초안은 검토한 뒤 빌드합니다.
Aggrega 배우기는 전체 문서를 따라가는 경로 안에 이 가이드를 배치합니다.
AI 어시스턴트와 함께 작업하기
- AI 어시스턴트로 Aggrega 설정하기 — 명령을 실행할 수 있는 어시스턴트에 붙여 넣는 프롬프트 하나로, 어시스턴트가 Aggrega를 설치하고 Aggrega 스킬을 추가하며 스스로 서버에 연결합니다.
- MCP 서버 연결 — 클라이언트별 서버 항목, 각 클라이언트가 항목을 보관하는 위치, HTTPS로 접속하는 서버, 연결 확인 방법을 다룹니다.
- Aggrega 스킬 — 어시스턴트가 Aggrega를 위해 불러오는 지침입니다. 지침을 설치하고 최신 상태로 유지하는 방법을 다룹니다.
- 어시스턴트가 Aggrega로 할 수 있는 일 — 연결된 서버를 통해 어시스턴트가 읽고, 확인하고, 빌드하고, 게시할 수 있는 것을 다룹니다.
어시스턴트 기능과 이 가이드의 관계
aggrega mcp 서버는 이 가이드, 언어 레퍼런스, JSON Schema를 어시스턴트가 YAML을 작성하기 전에 읽는 리소스로 제공하며, 엔터티를 스캐폴딩하고 검증하는 도구도 함께 제공합니다. 어시스턴트에 내장된 작성 프롬프트는 이 페이지의 내용을 다시 서술하지 않고 이 페이지를 가리키므로, 이 가이드가 작성 방법을 설명하는 유일한 문서입니다. 루프는 Aggrega 파일 작성을, 연결은 MCP 서버 연결을 참조하십시오.