skill_tree

Hinweise:

Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins ALBERT | AI Agents. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.
Wie Sie die KI-Tools in Ihren KI-Voreinstellungen verwenden, erfahren Sie hier: ALBERT | AI agents tools einrichten

Anzeigename: Returns the directory tree of a Claude skill

Technischer Name: agorum_ai_agents_library_basic_skill_tree

Was macht das Tool?

Dieses Tool gibt die Verzeichnisstruktur eines in agorum core installierten Skills zurück. Es funktioniert analog zum allgemeinen directory_tree-Tool, ist jedoch zwingend auf den Bereich eines Skill-Ordners begrenzt. Ein Skill-Ordner ist ein Ordner, der eine SKILL.md-Datei als direktes Kind enthält. Aufrufe außerhalb eines Skills werden mit einem Fehler abgewiesen.

Empfohlener Einsatzzweck

Übersicht über die Dateien und Unterordner eines installierten Skills
Ermittlung der verfügbaren Dateien, bevor diese mit skill_get_content gelesen werden
Analyse der Skill-Struktur durch die KI

Funktionsbeschreibung

Parameter	Beschreibung
id (Pflicht)	ID, UUID oder Pfad eines agorum core Objekts innerhalb eines Skill-Ordners. Der Verzeichnisbaum wird ab diesem Objekt dargestellt. Wenn das Objekt eine Datei ist, wird der übergeordnete Ordner als Startpunkt verwendet.
depth (Pflicht)	Tiefe der Ordnerstruktur, die abgerufen wird. Minimum: 1 Maximum: 8
withFiles (Optional)	Wenn `true`, werden auch Dateien innerhalb der Ordner aufgelistet. Skills enthalten typischerweise Dateien, daher ist der Standard `true`. Standard: `true`
basePathIds (Optional)	Schränkt ein, dass der umschließende Skill-Ordner unterhalb eines der angegebenen Pfade liegen muss. Format: Array von IDs, UUIDs oder Pfaden.

Rückgabewerte

Die Rückgabe hat dieselbe Struktur wie das allgemeine directory_tree-Tool, ergänzt um Skill-spezifische Informationen:

Feld	Beschreibung
tree	Hierarchische Baumstruktur. Der Wurzelknoten enthält zusätzlich: `uuid` – UUID des Startordners `name` – Name des Startordners `objectLink` – Link zum Startordner `skillFolderUuid` – UUID des umschließenden Skill-Ordners `skillFolderName` – Name des umschließenden Skill-Ordners `items` – Unterordner und Dateien

Sicherheitseinschränkung

Hinweis: Dieses Tool kann nur innerhalb eines Skill-Ordners verwendet werden. Wenn das angegebene Objekt nicht innerhalb eines Skill-Ordners liegt (d. h. kein Vorfahren-Ordner eine SKILL.md enthält), gibt das Tool einen Fehler zurück. Diese Einschränkung stellt sicher, dass das Tool nicht für den Zugriff auf beliebige Verzeichnisse in agorum core missbraucht werden kann.

Tipps und Tricks

Tipps:

Verwenden Sie dieses Tool, um die Struktur eines Skills zu erkunden, bevor Sie einzelne Dateien mit skill_get_content lesen.
Geben Sie als id die UUID des Skill-Ordners an, um den gesamten Skill-Baum zu sehen.
Im Gegensatz zum allgemeinen directory_tree listet dieses Tool standardmäßig auch Dateien auf (withFiles: true), da Skills typischerweise aus mehreren Dateien bestehen.