Leitfaden zum Verfassen
Dieser Leitfaden ist der praktische Begleiter zu den Architekturkapiteln und der Sprachreferenz. Wo die Architektur erklärt, warum Aggrega so gestaltet ist, wie es ist, und die Referenz festlegt, was jedes Feld bedeutet, lehrt dieser Leitfaden, wie man sich hinsetzt und verfasst — zu welcher Entität Sie greifen, in welcher Reihenfolge und wie die CLI und ein KI-Assistent Ihnen helfen, mit möglichst wenig Reibung eine korrekte Datei zu erhalten.
Der Leitfaden ist für zwei Zielgruppen zugleich geschrieben: eine Person, die in einem Editor von Hand verfasst, und einen KI-Assistenten, der über den Model-Context-Protocol-Server im Auftrag einer Person verfasst. Beide folgen derselben Schleife und lesen dieselben Referenzquellen, daher dienen die folgenden Seiten beiden.
In dieser Reihenfolge lesen
- Aggrega-Dateien verfassen — die durchgängige Authoring-Schleife: Rolle wählen, Form kennenlernen, Gerüst erzeugen, ausfüllen, validieren, bauen. Beginnen Sie hier.
- Personas — die vier zusammenarbeitenden Authoring-Rollen (Entwickler, Architekt, Operations, Operator) und das Prinzip „Orientierung statt Durchsetzung“, das ihnen zugrunde liegt.
- Entitäten nach Rolle — jede Entitätsart der Rolle zugeordnet, der sie typischerweise gehört, damit Sie wissen, in welche Datei jedes Anliegen gehört.
- Installation — die Binärdatei
aggregainstallieren, mit den Befehlen zuerst; ihr Abschnitt zum Verbinden verweist auf Den MCP-Server verbinden. - Aggrega in Visual Studio Code verwenden — die Aggrega-Erweiterung für Visual Studio Code: was sie benötigt, die Willkommensseite, ihre Panels und der Topologiegraph sowie jede Einstellung und jeder Befehl.
Import geht von einem Projekt aus, das Sie bereits in einem anderen Format haben, und erstellt daraus Entwürfe dieser Dateien, die Sie prüfen und bauen.
Aggrega lernen ordnet diesen Leitfaden in einen Weg durch die gesamte Dokumentation ein.
Mit einem KI-Assistenten arbeiten
- Aggrega mit Ihrem KI-Assistenten einrichten — ein einziger Prompt zum Einfügen in einen Assistenten, der Befehle ausführen kann, damit er Aggrega installiert, den Aggrega-Skill hinzufügt und sich selbst mit dem Server verbindet.
- Den MCP-Server verbinden — der Servereintrag Client für Client, wo jeder Client ihn ablegt, ein über HTTPS erreichter Server und wie Sie die Verbindung prüfen.
- Der Aggrega-Skill — die Anweisungen, die ein Assistent für Aggrega lädt: sie installieren und aktuell halten.
- Was Ihr Assistent mit Aggrega tun kann — was der verbundene Server einen Assistenten lesen, prüfen, bauen und veröffentlichen lässt.
Wie die Oberflächen des Assistenten mit diesem Leitfaden zusammenhängen
Der Server aggrega mcp stellt diesen Leitfaden, die Sprachreferenz und die JSON Schemas als Ressourcen bereit, die ein Assistent liest, bevor er YAML schreibt, dazu Werkzeuge, die Gerüste für Entitäten erzeugen und sie validieren. Die eingebauten Authoring-Prompts des Assistenten verweisen auf diese Seiten zurück, statt sie zu wiederholen, sodass dieser Leitfaden der einzige Ort in Prosa für die Authoring-Methode ist. Siehe Aggrega-Dateien verfassen für die Schleife und Den MCP-Server verbinden für die Verbindung.