Eigene Agenten

Reviewer im Projekt erstellen

Custom Agents erhalten einen eigenen Systemprompt und führen eine abgegrenzte Aufgabe aus. Sie sind nicht dasselbe wie Commandvorlagen oder interne Orchestratorrollen. Voraussetzung: ein Projekt, eine CLI-Sitzung und lesbarer Projektcode.

Legen Sie .lurus/agents/reviewer.md an:

---
name: Reviewer
description: Inspect correctness and tests without modifying the project
tools:
  - Read
  - Grep
  - Glob
  - GitInspect
maxTurns: 12
---

Inspect the requested code. Report only concrete correctness and test-coverage findings with file references. Do not modify files.

Global verwenden Sie denselben Inhalt unter ~/.lurus/agents/reviewer.md. Starten Sie nach Erstellung oder Bearbeitung eine neue CLI-Sitzung. Projektagenten überschreiben gleichnamige globale Agenten. Der kleingeschriebene, aus Pfad und Dateinamen abgeleitete Key lautet reviewer; name: Reviewer ist nur der Anzeigename.

Aufrufen und Vertrauen verwalten

Prüfen Sie die Agentdatei vor der Freigabe. „Trust and run once“ speichert das Vertrauen dauerhaft, obwohl die Beschriftung einen einmaligen Vorgang nahelegt. Der Aufruf kann Modellkosten verursachen.

/agents list
/agents show reviewer
/agents trust reviewer
/agents run reviewer Review the current changes and their tests.
/agents untrust reviewer

Ohne Aufgabe zeigt run die Verwendung; ein unbekannter Key startet keinen Agenten. Bei einer unvertrauten Quelle erfolgt ein Trustdialog. „Trust and run once“ speichert hier tatsächlich Vertrauen – die Beschriftung bedeutet nicht flüchtiges Vertrauen. Wird die dauerhafte Speicherung nicht erfolgreich abgeschlossen, kann trotz Freigabe für den aktuellen Lauf eine Warnung erscheinen. Prüfen Sie die Freigabe nach dem Neustart erneut.

Ein Abbruch oder erreichtes Rundenlimit kann ein Teilresultat liefern. Eigene Agenten berichten Ergebnisse und erhalten dadurch keine Schreibrechte. Sie können den Hauptagenten auch ausdrücklich bitten, einen eigenen Agenten aufzurufen; das ist ein anderer Einstieg als der direkte Slashbefehl. /reviewer … wird nicht automatisch als Alias registriert.

Frontmatter und Turnlimits

Ein Rundenlimit ist keine feste Laufzeit- oder Kostenreservierung. Ein Modell- oder Toolfehler kann die Aufgabe früher beenden. Ein zusätzliches mode, isolation oder beliebiges Permissionfeld schaltet keine Agentfähigkeiten frei.

Feste Toolobergrenze

Custom Agents können ausschließlich folgende eingebauten Werkzeuge erhalten:

Read
Glob
Grep
ListDirectory
SemanticSearch
RepoMap
GetMemory
GitInspect

• tools fehlt: die gesamte obige Liste ist die Ausgangsliste.
• tools: []: keine Tools.
• tools: [Read, Bash, Write]: nur die mit der Rolle vereinbaren Werkzeuge, hier Read.
• Bash, Exec, Write, Edit, MultiEdit, Delete, Webtools und MCP werden durch Agentfrontmatter nicht freigeschaltet.
• Modus-, Policy- und Permissionprüfungen gelten zusätzlich zur Toolliste. Eine Liste ist keine allgemeine Zugriffsgenehmigung auf Secrets oder externe Pfade.

Eigene Agenten sind nicht die schreibenden Rollen der Orchestrierung. Für einen lesenden Reviewer ist die feste Toolgrenze nützlich. Um Tests auszuführen oder Dateien zu verändern, verwenden Sie einen anderen Workflow mit ausdrücklicher Freigabe für den Hauptagenten.

Trust ist an Quelle und Inhalt gebunden

Die Freigabe gilt für den Namen, die Quelle, den aufgelösten Pfad und den Inhalt der gesamten Datei. Globale und Projektdateien sind unterschiedliche Quellen. Auch Frontmatter-Änderungen erfordern deshalb eine erneute Prüfung.

Der bereits geladene Agentprompt und Hash werden nicht automatisch bei jedem Aufruf von Platte aktualisiert. Nach einer Bearbeitung:

1. Neue CLI-Sitzung starten.
2. /agents show reviewer und Quelle prüfen.
3. Dateiinhalt prüfen und bei Bedarf /agents trust reviewer erneut ausführen.
4. Aufgabe mit /agents run reviewer … starten.

Es gibt keine /agents create, reload oder remove-Unterkommandos. Entfernen Sie eine eigene Agentdatei bei Bedarf manuell und starten Sie neu. Verwalten Sie Vertrauen über die CLI statt durch Änderungen gespeicherter Verwaltungsdaten.

Fortgeschritten: reiner Gitreview

Erstellen Sie .lurus/agents/git-reviewer.md:

---
name: Git reviewer
description: Review tracked changes using read-only Git inspection
tools:
  - GitInspect
  - Read
maxTurns: 8
---

Inspect the current diff and read relevant files. Separate confirmed problems from suggestions. Do not change files or run commands.

/agents show git-reviewer
/agents trust git-reviewer
/agents run git-reviewer Check the current diff for regressions.

Erwartung: begrenzter lesender Reviewbericht, kein Gitcommit und kein Shelltestlauf. Der Key ist git-reviewer, nicht Git reviewer.

Fehlersuche

Weiter: Berechtigungen, Skills, Orchestrierung.