Mitgelieferte Skills für externe Coding Agents

Mit dem Plugin ALBERT | AI Agents werden zusätzliche Skills ausgeliefert, die sich an externe KI-Programmierassistenten (Coding Agents wie zum Beispiel Claude Code oder Codex) richten. Diese Coding Agents arbeiten über MCP mit agorum core pro. Eine Übersicht aller mitgelieferten Skills und ihres Versionsstands finden Sie unter Mitgelieferte Skills verwenden. Wie Skills im Chat grundsätzlich funktionieren und wie Sie eigene Skills erstellen, beschreibt Skills im Chat verwenden.

Mitgelieferter Skill: agorum-core-ai-coding

Der Skill agorum-core-ai-coding unterstützt externe KI-Programmierassistenten (Coding Agents wie zum Beispiel Claude Code oder Codex) dabei, Konfigurationen und Erweiterungen innerhalb von agorum core pro zu entwickeln. 

Was leistet der Skill?

• Er trägt sich beim ersten Einsatz selbst in die Anweisungsdatei Ihres Arbeitsordners ein, damit er in künftigen Gesprächen zuverlässig geladen wird.
• Er besitzt eine eigene Versionsnummer und gleicht seinen lokalen Stand einmal pro Gespräch mit dem in agorum core pro gepflegten Stand ab. Dafür genügt der Vergleich der Versionsnummer; er läuft über die Skill-Liste und kostet keinen zusätzlichen Leseaufruf. Eine neuere Version wird automatisch übernommen, ein bereits höherer lokaler Stand bleibt unangetastet. 
• Möchten Sie eine Anwendung außerhalb von agorum core pro entwickeln, verweist der Skill auf den Skill agorum-core-ai-backend. Die Gründe für eine solche externe Anwendung müssen Sie selbst nennen oder bestätigen. Der Assistent beurteilt diese Entscheidung nicht eigenständig.

Empfehlungen zur Installation

• Installieren Sie den Skill agorum-core-ai-coding einmal für alle Ihre Projekte statt für jedes Projekt einzeln, damit nur eine Kopie zu pflegen ist.
• Zugriffstoken geheim halten: Hinterlegen Sie Ihr Zugriffstoken als Umgebungsvariable und verweisen Sie in der Konfiguration nur darauf. Wichtig: Die Umgebungsvariable muss in der Umgebung Ihres Coding Agents gesetzt sein, nicht in einer Projektdatei. Eine nicht gesetzte Variable erkennen Sie daran, dass sich die Konfiguration zwar weiterhin laden lässt, der Verweis jedoch als reiner Text stehen bleibt und die Serverübersicht auf die fehlende Variable hinweist.
• Name der Umgebungsvariablen: Er leitet sich vom Rechnernamen des Systems ab. Sprechen Sie ein System über seine IP-Adresse an, erhält der Name das Präfix IP_, denn ein Bezeichner darf nicht mit einer Ziffer beginnen.
• Zeitgrenzen bei langlaufenden MCP-Aufrufen: Neben der Gesamtlaufzeit gilt zusätzlich eine eigene Leerlaufgrenze, die unabhängig von der Einstellung MCP_TOOL_TIMEOUT greift und einen Aufruf abbricht, wenn sich der Server währenddessen nicht meldet. Wirksam abhelfen können Sie mit einem eigenen Zeitlimit je Server in der MCP-Konfiguration, das zugleich auch die Leerlaufgrenze anhebt.

Mitgelieferter Skill: agorum-core-ai-backend

Der Skill agorum-core-ai-backend richtet sich an externe KI-Programmierassistenten (wie beispielsweise Claude Code und Codex) und zeigt, wie eine eigenständige Anwendung agorum core pro als Grundlage (Backend) nutzen kann, statt eine eigene Datenverwaltung mitzubringen. Beispiele für eigenständige Anwendungen sind etwa eine Webanwendung, eine mobile App oder eine Desktop-Anwendung. 

Was leistet und vermittelt der Skill?

• Die Aufgabenteilung zwischen Ihrer Anwendung und agorum core pro.
• Die verschiedenen Zugriffswege. Ältere Zugriffswege sollten Sie prüfen, bevor Sie einen eigenen Dienst bauen.
• Die sichere Anmeldung: Technische Zugangsdaten dürfen niemals im ausgelieferten Programmcode stehen. Spricht eine Oberfläche im Browser agorum core pro direkt an, nutzt sie automatisch eine bereits bestehende Anmeldung im selben Browser mit. Die Anmeldekennung darf niemals als Teil der Internetadresse übergeben werden.
• Die Wahl des passenden Datenmodells sowie die Umsetzung eigener Dienste in JavaScript.
• Der Skill ordnet die rechtssichere Aufbewahrung von Dokumenten nach den GoBD-Vorgaben ein und stellt klar, dass sich eine entsprechende Prüfung auf die Software selbst bezieht und nicht automatisch auch Ihre konkrete Installation abdeckt.
• Der Skill enthält Erfahrungswerte, etwa zur Wahl eines Oberflächen-Baukastens, zu einem schlanken Aufbau, zu einer zentralen Stelle für alle Aufrufe an agorum core pro sowie zum sicheren Anzeigen fremder Inhalte. 
• Der Skill gleicht seinen lokalen Stand automatisch mit dem in agorum core gepflegten Stand ab und berücksichtigt bei der Versionspflege ausdrücklich auch Teilprojekte.

Mitgelieferter Skill: agorum-core-ai-use

Der Skill agorum-core-ai-use befähigt einen externen KI-Programmierassistenten, mit agorum core pro zu arbeiten – nicht, daran zu entwickeln.

Was leistet der Skill?

• Er beschreibt das Suchen, Lesen, Anlegen und Ablegen von Dokumenten und Ordnern, das Auswerten von Metadaten sowie das Laden von Wissen und Dokumentation.
• Er hält den Assistenten dazu an, zuerst die fachlichen Skills zu laden und zu befolgen, die in agorum core pro hinterlegt sind – statt eigene Wege zu erfinden.
• Er stellt klar, dass Ergebnisse in agorum core pro gehören und nicht in das örtliche Verzeichnis des Assistenten.
• Er beschreibt die Sandbox mit Shell und Browser.
• Er verwendet die Werkzeuggruppe für die externe Nutzung und gleicht sich selbständig gegen agorum core pro ab.

Mitgelieferter Skill: albert-ai-chat

Der Skill albert-ai-chat befähigt einen externen Coding Agent, einen Chat aus ALBERT | AI zu übernehmen und in seiner eigenen Umgebung weiterzuführen. Er greift, sobald ein Chat übergeben wurde.

Was leistet der Skill?

• Er beschreibt, wie der Chat über MCP gelesen wird und wie der Systemprompt des Chats zu behandeln ist: als Anweisung für diese Aufgabe.
• Er regelt die Rückmeldung: Der Coding Agent meldet sich zu Beginn, zwischendurch und am Ende in den Chat zurück.
• Er stellt klar, dass ein übergebener Chat beim Coding Agent bleibt, bis der Benutzer ihn über Kontrolle übernehmen zurückholt. Die Abschlussmeldung gibt den Chat nicht frei.
• Er weist den Coding Agent an anzuhalten, wenn der Chat nicht lesbar ist, und dem Benutzer Chat-ID, Arbeitsordner und verbundenes System zu nennen, statt auf einem fremden System zu arbeiten.

Unter welchem Namen der Coding Agent antwortet

Arbeitet ein Coding Agent über MCP mit agorum core pro, tritt er gegenüber dem Benutzer als ALBERT | AI auf. 

• Jede Antwort an den Benutzer beginnt mit der Überschrift ALBERT | AI und endet mit einer fett gesetzten Schlusszeile: ALBERT | AI fragt: … bei einer Rückfrage, sonst ALBERT | AI wartet auf deine Eingabe.
• Anrede und Sprache folgen dem Gespräch.

Erste Einrichtung der Skills im Programmierassistenten

Die zuvor beschriebenen Skills werden in einem externen KI-Programmierassistenten (Coding Agent) verwendet. Das folgende Beispiel zeigt die Einrichtung und Nutzung anhand von Claude Code. Für andere Coding Agents (zum Beispiel Codex) ist das Vorgehen sinngemäß gleich:

1. Erstellen Sie in Claude Code eine neue Sitzung.
2. Wählen Sie einen Arbeitsordner, der eindeutig für das Zielsystem steht. Es hat sich bewährt, pro Zielsystem, etwa pro Docker-Instanz, einen eigenen Arbeitsordner anzulegen. Beispiel: Für das System albert-ai-dev.docker.agorum.com legen Sie einen gleichnamigen Arbeitsordner an.
3. Laden Sie den gewünschten Skill aus agorum core herunter: Klicken Sie mit der rechten Maustaste auf den Skill-Ordner in der Administration unter customers > agorum.ai.dev > ai > skills und wählen Sie Download. Ziehen Sie die heruntergeladene ZIP-Datei anschließend in Claude Code in den Chat.
4. Geben Sie im Chat die folgende Anweisung ein:

   Installiere den Skill aus dem ZIP im Anhang.

   
   Ergebnis: Der Skill führt Sie anschließend vollständig durch die weitere Einrichtung.