Plugins

📚 Lernnotizen: Plugins und Setup-Verpackung

**I. Grundlagen von Plugins**

• Definition: Ein Plugin ist eine installierbare Einheit, die eine komplette Konfiguration (Setup) bündelt und zwischen Benutzern austauscht.
• Zweck: Ermöglicht das Teilen und Verschieben von funktionierenden Setups (z. B. . cloud-Verzeichnissen) statt manuellen Kopierens.
• Funktionsweise: Plugins führen Code auf Ihrem Gerät mit Ihren Rechten aus und reagieren auf Tool-Aufrufe durch Hooks.
• Hooks: Umfassen Pre-Tool-Use- und Stop-Hooks. Sie können externe Systeme (z. B. Netzwerkadministratoren) aufrufen.

**II. Installation und Sicherheit**

• Installation: Die Installationsmethode wird durch den Standort bestimmt (z. B. /plugin install [Organisation] [Name]).
• Marketplace: Ein privater Marketplace ermöglicht zentrales Discovery, Versionsverfolgung und Updates.
• Sicherheit: Installieren Sie Plugins nur aus vertrauenswürdigen Quellen. Überprüfen Sie immer alle hinzugefügten Hooks, Agenten und MCP-Server.
• Konfliktvermeidung: Plugins überschreiben Ihre Konfiguration nicht; Komponenten laufen parallel. Hooks stapeln sich.
• Namespacing: Skills, Agenten und Befehle werden unter dem Plugin-Namen benannt, um Kollisionen zu verhindern.

**III. Plugin-Struktur und Konfiguration**

• Einstellungen: Ein Plugin kann eine begrenzte settings. json mitbringen. Das Schlüsselwort agent kann einen Sub-Agenten zu einem Hauptthread befördern.
• Paketinhalt: Ein Plugin bündelt alles: Skills, Sub-Agenten, Hooks, MCP-Server-Konfigurationen, LSP-Server, Hintergrundmonitore, Themes und einen Teil der settings. json.
• Manifest: Die Datei cloudplugin. json enthält Name, Version, Beschreibung und Autor.
• Struktur: Die interne Struktur folgt dem bestehenden . cloud-Schema (ein Ordner pro Skill, eine Markdown-Datei pro Sub-Agent).
• Skill-Namespaces: Skills werden benannt als Firmenname. Skillname.

**IV. Best Practices**

• Prüfen vor der Installation: Lesen Sie immer die Details eines Plugins, bevor Sie es installieren.
• Sofort verpacken: Verpacken Sie Ihr funktionierendes . cloud-Verzeichnis sofort als Plugin.
• Ziel: Ein Plugin ermöglicht es dem vertrauenswürdigen Setup, das gesamte Team zu erreichen.

Takeaways

• Ein Plugin ist eine installierbare Einheit, die ein komplettes Setup bündelt und über Hooks (z. B. Pre-Tool-Use) Code auf dem Gerät ausführt.
• Plugins ermöglichen das einfache Teilen und Verschieben funktionierender Setups (wie . cloud-Verzeichnisse) zwischen Benutzern.
• Sicherheit ist essenziell: Plugins müssen nur aus vertrauenswürdigen Quellen installiert werden, und alle Hooks sowie Agenten müssen geprüft werden.
• Konflikte werden durch Namespacing gelöst, wobei Skills unter dem Format Firmenname. Skillname benannt werden.