Lokale Entwicklung mit KI-Tools local-development-with-ai-tools

KI-Codierungs-Agenten (Claude Code, Cursor, GitHub, Copilot und ähnliche Tools) verfügen über umfassende Kenntnisse der zugrunde liegenden Technologien von AEM (Java, OSGi, Sling, JCR, HTL), kennen jedoch nicht unbedingt die Best Practices für die Code- und Konfigurationserstellung oder die Fehlerbehebung bei häufigen AEM-Entwicklungsproblemen.

Vier einander ergänzende Komponenten befassen sich damit:

AGENTS.md agentsmd

AGENTS.md ist eine Markdown-Datei im Stammverzeichnis Ihres AEM-Projekts, die KI-Kodierungs-Tools automatisch zu Beginn jeder Sitzung laden, um die Grundlagen für die grundlegende Java-Stack-Domain-Kompetenz von AEM Cloud Service zu schaffen (und nicht für andere AEM-Lösungen wie AEM 6.5 oder Edge Delivery Services).

AGENTS.md ist keine statische Datei, die Sie kopieren - sie wird durch die im nächsten Abschnitt beschriebene ensure-agents-md generiert. Die Kenntnis liest Ihre pom.xml, um den Projektnamen aufzulösen, Module zu entdecken und installierte Add-ons zu erkennen, wodurch eine auf Ihr spezifisches Projekt zugeschnittene Datei erstellt wird.

Agent-Kenntnisse agent-skills

Kenntnisse sind Befehlssätze, die mehrstufige Entwicklungs-Workflows kodieren. Wenn die KI aufgerufen wird, folgt sie dem Verfahren der Qualifikation, anstatt sich ausschließlich auf allgemeine Kenntnisse zu verlassen, was konsistente, konforme Ergebnisse liefert.

Adobe veröffentlicht AEM as a Cloud Service-Kenntnisse im Adobe/Skills-Repository auf der beta Verzweigung, da diese Funktion noch nicht allgemein verfügbar ist:

Kenntnisse installieren install-skills

Wählen Sie die Methode aus, die Ihrem KI-Kodierungstool entspricht. Durch das Installieren von Kenntnissen werden diese für alle Projekte auf diesem Computer verfügbar.

Claude Code claude-code

# Add the Adobe Skills marketplace (one-time setup)
/plugin marketplace add adobe/skills#beta

# Install all available skills
/plugin install aem-cloud-service@adobe-skills

NPX-Kenntnisse npx-skills

# Install all available skills
npx skills add https://github.com/adobe/skills/tree/beta/skills/aem/cloud-service --all

Kenntnisse erweitern (GitHub-CLI-Erweiterung) upskill-github-cli-extension

# Install the gh-upskill extension (one-time setup)
gh extension install trieloff/gh-upskill

# Install all available skills
gh upskill adobe/skills --branch beta --path skills/aem/cloud-service --all

Use the Ensure-agents-md SKILL use-the-ensure-agents-md-skill

Öffnen Sie nach der Installation der Kenntnisse Ihren KI-Assistenten in jedem AEM Cloud Service-Projekt, das noch keine AGENTS.md hat. Die Kenntnisse werden automatisch vor der Verarbeitung Ihrer ersten Anfrage ausgeführt, sodass beide Dateien im Projektstamm erstellt werden, ohne dass ein expliziter Aufruf erforderlich ist.

Verwenden der Create-component Skill use-the-create-component-skill

Bei der ersten Verwendung erkennt die Kenntnis automatisch project, package und group aus pom.xml und vorhandenen Komponenten, fordert Sie auf, die erkannten Werte zu bestätigen, und erstellt dann .aem-skills-config.yaml im Projektstamm. Vor der ersten Verwendung ist keine manuelle Konfiguration erforderlich.

Wenn Sie die Datei lieber vorab erstellen möchten, platzieren Sie .aem-skills-config.yaml im Projektstamm mit der folgenden Struktur:

configured: true

project: "wknd"                                    # Check /apps/{project}/ or pom.xml
package: "com.adobe.aem.guides.wknd.core"          # Check core/pom.xml
group: "WKND Components"                           # Check existing component .content.xml files

Die Datei befindet sich außerhalb des Kenntnisverzeichnisses und wird nie überschrieben, wenn die Kenntnis aktualisiert wird.

Beschreiben Sie die Komponente in Ihrem KI-Chat:

Create an AEM component called "Hero Banner"

Dialog specification:
Title (title) - Textfield, mandatory
Subtitle (subtitle) - Textfield
Background Image (backgroundImage) - Fileupload
CTA Text (ctaText) - Textfield
CTA Link (ctaLink) - Pathfield

Der Agent wiederholt die Feldspezifikation zur Bestätigung und generiert dann alle Komponentendateien. Zu den unterstützten Mustern gehören Mehrfachfeld- mit zusammengesetzten verschachtelten Elementen, bedingte Einblenden-/Ausblenden-Logik, Kernkomponenten-Erweiterung über Sling Resource Merger und JUnit 5-Tests mit AEM Mocks.

Dispatcher-Kenntnisse verwenden use-the-dispatcher-skill

Rufen Sie die Dispatcher-Kenntnisse für alle Dispatcher- oder Apache HTTPD-Konfigurationsaufgaben auf. Die Qualifikation leitet Anfragen je nach Art der Anfrage an eine von sechs spezialisierten Unterqualifikationen weiter:

Bei allgemeinen oder erstmaligen Anfragen beginnen Sie mit der workflow-orchestrator Unterqualifikation. Beschreiben Sie für zielgerichtete Arbeiten das spezifische Anliegen und die Qualifikationswege zum entsprechenden Spezialisten.

Die Dispatcher-Kenntnisse umfassen die Orchestrierung und Beratung. Der Dispatcher MCP-Server, wie unten beschrieben, stellt die sieben Validierungs- und Laufzeitwerkzeuge bereit, die die Qualifikation verwendet, wenn sie lokale Beweise benötigt.

AEM QuickStart MCP-Server aem-quickstart-mcp-server

Das Model Context Protocol (MCP) ist ein offener Standard, der es KI-Kodierungstools ermöglicht, eine Verbindung zu externen Datenquellen und Services herzustellen. Der AEM Quickstart-MCP-Server ist ein Inhaltspaket, das nach der Installation in einer lokalen AEM SDK-Instanz Laufzeitdaten direkt mit verbundenen KI-Tools bereitstellt. Dadurch können Agenten Protokolle abrufen, OSGi-Fehler diagnostizieren und die Anforderungsverarbeitung überprüfen, ohne die IDE verlassen zu müssen.

Installieren des Inhaltspakets install-the-content-package

Laden Sie das Inhaltspaket vom Software Distribution-Portal herunter und installieren Sie com.adobe.aem:com.adobe.aem.mcp-server-contribs-content mithilfe von Package Manager unter /crx/packmgr in Ihren lokalen Schnellstart.

Kompatibilität: mit AEM SDK 2026.2.24678.20260226T154829Z-260200 und höher validiert.

Verfügbare Tools available-tools

Konfigurieren der IDE configure-your-ide

Mauszeiger cursor

Fügen Sie in den Cursoreinstellungen einen neuen benutzerdefinierten MCP-Server hinzu:

"aem-cs-sdk": {
  "type": "streamable-http",
  "url": "http://localhost:4502/bin/mcp",
  "headers": {
    "Authorization": "Basic YWRtaW46YWRtaW4="
  }
}

GitHub Copilot mit IntelliJ IDEA github-copilot-with-ihtellij-idea

Navigieren Sie zu Tools > GitHub-Kopilot > Model Context Protocol (MCP) und klicken Sie auf Konfigurieren. Hinzufügen:

"aem-cs-sdk": {
  "url": "http://localhost:4502/bin/mcp",
  "requestInit": {
    "headers": {
      "Authorization": "Basic YWRtaW46YWRtaW4="
    }
  }
}

Andere IDEs other-ides

Jeder MCP-Client kann eine Verbindung herstellen, indem er mit einem http://localhost:4502/bin/mcp auf Authorization: Basic YWRtaW46YWRtaW4= verweist. Konfigurieren Sie benutzerdefinierte Header mithilfe der MCP-Einstellungen Ihrer IDE.

Dispatcher MCP-Server dispatcher-mcp-server

Der Dispatcher MCP-Server ist im Paket mit dem AEM Dispatcher SDK enthalten. Dadurch können KI-Tools die Dispatcher- und Apache-HTTPD-Konfiguration überprüfen, die Verarbeitung von Trace-Anfragen verfolgen und das Cacheverhalten mit einer Dispatcher-Instanz überprüfen, die lokal in Docker ausgeführt wird.

Anders als die Dispatcher-Kenntnisse stellt der Dispatcher MCP-Server nur Tools bereit: sieben MCP-Tools und keine Eingabeaufforderungen oder Ressourcen.

Voraussetzungen prerequisites

Installieren von Dispatcher SDK install-the-dispatcher-sdk

macOS und Linux:

chmod +x aem-sdk-dispatcher-tools-<version>-unix.sh
./aem-sdk-dispatcher-tools-<version>-unix.sh
cd dispatcher-sdk-<version>
chmod +x ./bin/docker_run_mcp.sh
./bin/docker_run_mcp.sh test

Windows:

Expand-Archive aem-sdk-dispatcher-tools-<version>-windows.zip

Führen Sie ./bin/docker_run_mcp.sh help aus, um die IDE-Konfiguration zum Kopieren und Einfügen abzurufen und die gebündelte MCP- und SDK-Version zu ./bin/docker_run_mcp.sh version. Verwenden Sie ./bin/docker_run_mcp.sh diagnose, um Konnektivitätsprobleme zu untersuchen.

Cursor konfigurieren configure-cursor

Fügen Sie einen aem-dispatcher-mcp Eintrag zu ~/.cursor/mcp.json hinzu:

{
  "mcpServers": {
    "aem-dispatcher-mcp": {
      "command": "<path_to_dispatcher_sdk>/bin/docker_run_mcp.sh",
      "env": {
        "DOCKER_API_VERSION": "1.43",
        "AEM_DEPLOYMENT_MODE": "cloud",
        "MCP_LOG_LEVEL": "trace",
        "MCP_LOG_FILE": "/tmp/dispatcher-mcp.log",
        "DISPATCHER_CONFIG_PATH": "<path_to_dispatcher_src>"
      }
    }
  }
}

Ersetzen Sie <path_to_dispatcher_sdk> durch den extrahierten Speicherort für Dispatcher SDK und <path_to_dispatcher_src> Sie mit dem Dispatcher-src des Projekts. Legen Sie DISPATCHER_CONFIG_PATH auf den Konfigurationsstamm fest, der die Dateien enthält, in denen /docroot definiert ist. MCP_LOG_LEVEL und MCP_LOG_FILE sind optionale Debugging-Einstellungen. Wenn Sie client version 1.43 is too new sehen, setzen Sie DOCKER_API_VERSION auf 1.41. Wenn bereits andere MCP-Server konfiguriert sind, fügen Sie den aem-dispatcher-mcp hinzu, ohne sie zu ersetzen. Cursor nach dem Speichern neu starten.

Andere IDEs können auf ähnliche Weise konfiguriert werden. Die docs/DispatcherMCP.md von SDK enthält vollständige Beispiele für Claude Desktop und VS Code.

Verfügbare Tools available-tools-dispatcher

Die MCP-Oberfläche legt absichtlich nur diese sieben Tools offen. Eingabeaufforderungen und Ressourcen verbleiben in der Kompetenzschicht. Die vollständige Referenzdokumentation finden Sie in der docs/DispatcherMCP.md im extrahierten Dispatcher SDK.