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.