Dokumentation / Der Agent
Gedächtnis, Skills und Regeln
Wie du dem Agenten mit Projektgedächtnis, Skills, Prompts, Hooks und Regeln dauerhaften Kontext gibst und wie er aus seinen Fehlern lernt.
Der Agent fängt nicht in jeder Unterhaltung bei null an. Er erinnert sich an das Wichtige im Projekt, lädt Verfahren je nach Aufgabe und befolgt die Regeln deines Teams.
Verwaltet wird alles im Projekt-Panel, Tab Agent, mit den Unter-Tabs Skills, Prompts, Hooks, Regeln und Installieren. Oben wählst du den Geltungsbereich: Platform (der Agent von Yuli) oder Abonnements (Claude Code, Kiro, Codex und Antigravity).
Projektgedächtnis
Was sich der Agent merken soll: Anweisungen, Entscheidungen, Konventionen und Projektdaten.
- Speichern: Sag im Chat „merk dir, dass …“ oder füge es manuell hinzu.
- Ansehen und bearbeiten: Kopfbereich des Chats → Weitere Aktionen → Projektgedächtnis.
- Speicherort:
.ai/memory/, versionierbar mit dem Projekt.
| Gruppe | Beispiel |
|---|---|
| Anweisungen | „Antworte immer mit Beispielen in Java 17.“ |
| Entscheidungen | „Im Zahlungsmodul verwenden wir hexagonale Architektur.“ |
| Konventionen | „DTOs enden auf Dto und liegen in api/dto.“ |
| Projektdaten | „Das lokale Profil nutzt die Datenbank orders_dev.“ |
Einträge, die mit dem Repository kommen, erscheinen als „aus dem Repository — unbestätigt“ und werden erst an das Modell gesendet, wenn du sie bestätigst. So kann ein fremdes Repository dem Agenten keine Anweisungen geben.
Teamgedächtnis
Das gemeinsame Gedächtnis des Teams liegt in .ai/team.json, versioniert mit dem Projekt. Du siehst es unter Globale Optionen → Team.
Skills
Ein Skill ist ein Verfahren, das der Agent nur lädt, wenn die Aufgabe es erfordert. Yuli bringt 19 mit:
| Bereich | Skills |
|---|---|
| Code | Code erklären, Funktion implementieren, Sicheres Refactoring, refactor-or-evolve |
| Tests | Unit-Tests schreiben, Teststrategie |
| Qualität und Review | Code-Review, Sicherheits-Review, Integrations-Review |
| Diagnose | Bis zur Grundursache debuggen, Kompilierfehler beheben, gradle-java-build |
| Design | Anforderungsanalyse, Architekturdesign, ui-ux-design |
| Daten | Datenbank-Explorer |
| Dokumentation | document-system (das System auf Anfrage dokumentieren), sdlc-documentation |
| Git | Commit-Nachricht |
Die mitgelieferten Skills sind Schreibgeschützt und werden mit der App aktualisiert. Um einen anzupassen, nutze Zum Anpassen duplizieren.
Eigene Skills
Erstelle deine eigenen im Unter-Tab Skills oder importiere sie mit Skills, Prompts und Hooks importieren. Yuli akzeptiert SKILL.md, PROMPT.md, Befehle von Claude Code, .prompt.md von Copilot und hooks.json.
Deine Skills, Prompts und Hooks werden in deinem Benutzerordner gespeichert (unter Windows %APPDATA%\.yulicode\), damit sie dich in all deine Projekte begleiten.
Wie sie kombiniert werden
In der Agent-Konfiguration:
| Modus | Was verwendet wird |
|---|---|
| Automatisch | Nur das von Yuli. |
| Benutzerdefiniert | Nur deine eigenen. |
| Empfohlen + eigene (Standard) | Beides. Bei gleichem Namen gewinnt deiner. |
Prompts
Prompts sind die Grundanweisungen des Agenten: Identität, Lebenszyklus großer Aufgaben, Teamleitung, Sub-Agent … Yuli liefert sie fertig kalibriert. Du kannst sie duplizieren und anpassen.
Die internen Prompts sind auf Englisch, für mehr Präzision und weniger Tokens. Die Antwort kommt immer in der Sprache der Person, die schreibt.
Hooks
Ein Hook fängt eine Aktion des Agenten ab: zum Beispiel, um Geändertes zu formatieren oder einen Vorschlag vor dem Anwenden zu validieren. Die Skripte sind Node.js, erhalten das Ereignis als JSON, und ein Exit-Code ungleich null blockiert die Aktion. Der Grund für die Blockierung geht an den Agenten, damit er seinen Plan anpasst.
| Ereignis | Wann |
|---|---|
| Vor der Nutzung eines Werkzeugs | Vor jedem Werkzeug. |
| Nach der Nutzung eines Werkzeugs | Nach jedem Werkzeug. |
| Am Ende eines Vorschlags | Wenn der Agent einen Änderungsvorschlag fertig hat. |
| Vor der Freigabe | Bevor du freigibst. |
| Nach dem Anwenden von Änderungen | Wenn die Änderung auf der Festplatte angekommen ist. |
Yuli bringt fertige Hooks mit: Gefährliche Befehle blockieren, Keine Secrets lesen, Sensible Dateien schützen, Keine Secrets im Code, Keine Konfliktmarker und Keine riesigen Dateien.
Projektregeln
Regeln sind Anweisungen, die der Agent in diesem Projekt immer befolgt.
| Datei | Geltungsbereich |
|---|---|
.agentrules, yuli.md oder .cursorrules im Stammverzeichnis |
Das ganze Projekt. |
.agentrules in einem Unterordner |
Dieser Ordner. Die nächstgelegene Datei gewinnt. |
.ai/rules/*.md |
Teamregeln. |
Im Unter-Tab Regeln: + .agentrules erstellen, Empfohlene Regeln und Paket importieren (.zip).
Gelernte Regeln
Yuli lernt aus wiederholten Fehlern. Taucht derselbe Befund 3-mal oder öfter in mindestens 2 Aufgaben innerhalb von 30 Tagen auf, wird er zu einer Regel in .ai/rules/learned.md.
Prüfe sie im Governance-Center unter Agenten → Lernen. Du kannst einen Kandidaten ablehnen; er wird nur erneut vorgeschlagen, wenn sich seine Belege verdoppeln.
Für deinen Abo-Agenten
Im Geltungsbereich Abonnements hat jeder Agent seinen eigenen Abschnitt mit der Regeldatei, die Yuli ihm übergibt, ihrem Status und „Was Yuli an den Agenten übergibt“: die Regeln der Sitzung und jeden Skill von Yuli mit seinen Kosten in Tokens.