Local Development with AI Tools local-development-with-ai-tools

AI-kodningsagenter (Claude Code, Cursor, GitHub Copilot och liknande verktyg) har goda kunskaper om AEM underliggande tekniker (Java, OSGi, Sling, JCR, HTL), men vet inte nödvändigtvis bästa sättet att generera kod och konfiguration eller hur man felsöker vanliga AEM-utvecklingsproblem.

Fyra kompletterande komponenter åtgärdar detta:

Granska AI-assisterade självstudiekurser för utveckling om du vill ha mer instruktioner.

AGENTS.md agentsmd

AGENTS.md är en markeringsfil i roten av ditt AEM-projekt. Med AI-kodningsverktygen läses den här filen in automatiskt i början av varje session för att få bas med grundläggande Java-stackdomänexpertis i AEM Cloud-tjänsten (och inte andra AEM-lösningar som AEM 6.5 eller Edge Delivery Services).

AGENTS.md är inte en statisk fil som du kopierar. Den genereras av kompetensen ensure-agents-md som beskrivs i nästa avsnitt i det här dokumentet. Kunskapen läser din pom.xml för att lösa projektnamnet, identifiera moduler och identifiera installerade tillägg, vilket skapar en fil som är anpassad till ditt specifika projekt.

Agentfärdigheter agent-skills

Kompetens är instruktionsuppsättningar som kodar arbetsflöden för utveckling i flera steg. När den anropas följer den artificiella intelligensen färdighetens procedur i stället för att förlita sig enbart på allmän kunskap, vilket ger konsekventa, konventionella resultat.

Adobe publicerar AEM as a Cloud Service-kunskaper i databasen adobe/skills:

Installera färdigheter install-skills

Välj den metod som matchar ditt AI-kodningsverktyg. Genom att installera kunskaper en gång blir de tillgängliga för alla projekt på den datorn. Se självstudiekursen Konfigurera AEM Agent Skills för en konkret genomgång.

Claude Code claude-code

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

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

Npx Skills npx-skills

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

Uppgradering (GitHub CLI-tillägg) upskill-github-cli-extension

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

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

Använda kompetens för säkra agenter-md use-the-ensure-agents-md-skill

När du har installerat kompetensen öppnar du AI-assistenten i ett AEM as a Cloud Service-projekt som ännu inte har ett AGENTS.md. Kunskapen körs automatiskt innan din första begäran bearbetas och båda filerna skapas i projektets rot utan att explicit anrop krävs.

Använda Kompetens för att skapa komponenter use-the-create-component-skill

Vid första användningen identifieras project, package och group från pom.xml och befintliga komponenter automatiskt av kompetensen och du uppmanas att bekräfta de identifierade värdena. Sedan skapas .aem-skills-config.yaml vid projektets rot. Ingen manuell konfiguration krävs före första användningen.

Om du föredrar att skapa filen i förväg placerar du .aem-skills-config.yaml i projektroten med följande 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

Filen finns utanför kompetenskatalogen och skrivs aldrig över när kompetensen uppdateras.

Beskriv komponenten i din AI-chatt:

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

Agenten kopierar fältspecifikationen för bekräftelse och genererar sedan alla komponentfiler. Mönster som stöds är multifält med sammansatta kapslade objekt, villkorsstyrd logik för att visa/dölja, Core Component-tillägg via Sling Resource Merger och JUnit 5-tester med AEM Mocks. Designen kan komma från olika källor, bland annat en textbeskrivning, en bild eller en Figma-URL med Figmas MCP-server.

Lär dig mer genom att följa självstudiekursen Komponentutveckling med AEM Agent Skills.

Använda migreringskunskaper use-the-migration-skill

migration-kompetensen guidar agenten genom att migrera AEM Java-kod och OSGi-konfigurationer till AEM as a Cloud Service. Ett mönster i taget fungerar: Om du namnger mönstret (till exempel scheduler eller replication) pekar du agenten på dina Best Practices Analyzer-resultat och letar upp de filer som påverkas i projektet och tillämpar de korrekta omformningarna gruppvis, och pausar för granskning efter varje.

Mönster som stöds är bland annat Sling Scheduler, ResourceChangeListener, Replication API, OSGi EventListener och EventHandler, Assets API, HTML-kodkorrigeringar och OSGi-konfigurationskonvertering med Cloud Manager hemligheter och miljövariabelextrahering.

Kompetensparen med molnmigrerings-MCP för att hämta resultat direkt från Cloud Acceleration Manager. Om MCP inte är konfigurerat återställs färdigheterna till en lokal CSV-export för BPA eller så kan du peka på specifika filer manuellt.

Fullständiga konfigurationsinstruktioner och mönsterreferenser finns i AI-assisterad kodmigrering till AEM as a Cloud Service.

Använda Dispatcher-kompetens use-the-dispatcher-skill

Anropa skickligheten för alla Dispatcher- och Apache HTTPD-konfigurationer. Färdighetsvägarna begär en av sex specialistunderkunskaper beroende på vilken typ av begäran det gäller:

För breda eller förstagångsbegäranden börjar du med underkompetensen workflow-orchestrator. Beskriv det särskilda problemet och färdighetsvägarna till lämplig specialist när det gäller riktat arbete.

Avsändarens skicklighet hanterar orkestrering och rådgivande vägledning. Dispatcher MCP-server, som beskrivs i följande avsnitt, innehåller de sju validerings- och körningsverktyg som kompetensen använder när den behöver lokala bevis.

AEM Quickstart MCP Server aem-quickstart-mcp-server

MCP (Model Context Protocol) är en öppen standard som tillåter AI-kodningsverktyg att ansluta till externa datakällor och tjänster. AEM Quickstart MCP-servern är ett innehållspaket som, när det har installerats i en lokal instans av AEM SDK, exponerar körningsdata direkt för anslutna AI-verktyg, gör det möjligt för agenter att hämta loggar, diagnostisera OSGi-fel och inspektera förfrågningsbearbetning utan att lämna utvecklingsmiljön.

Installera innehållspaketet install-the-content-package

Hämta innehållspaketet från Software Distribution Portal och installera com.adobe.aem:com.adobe.aem.mcp-server-contribs-content i din lokala QuickStart med hjälp av Package Manager på /crx/packmgr.

Kompatibilitet: Verifierad med AEM SDK 2026.2.24678.20260226T154829Z-260200 och senare.

Tillgängliga verktyg available-tools

Konfigurera din IDE configure-your-ide

Markör cursor

Lägg till en ny anpassad MCP-server i Markörinställningarna:

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

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

Navigera till Verktyg > GitHub-kompilering > MCP (Model Context Protocol) och klicka på Konfigurera. Lägg till:

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

Andra IDE other-ides

Alla MCP-klienter kan ansluta genom att peka på http://localhost:4502/bin/mcp med ett Authorization: Basic YWRtaW46YWRtaW4=-huvud. Konfigurera anpassade rubriker med hjälp av de MCP-inställningar du har angett för IDE.

Dispatcher MCP Server dispatcher-mcp-server

Dispatcher MCP-servern medföljer AEM Dispatcher SDK. Med AI-verktygen kan du validera konfigurationen av Dispatcher och Apache HTTPD, hantera spårningsbegäranden och inspektera cachebeteendet mot en Dispatcher-instans som körs lokalt i Docker.

Till skillnad från skickligheten visar Dispatcher MCP-servern endast verktyg: sju MCP-verktyg och inga uppmaningar eller resurser.

Förutsättningar prerequisites

Installera Dispatcher SDK install-the-dispatcher-sdk

macOS och 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

Kör ./bin/docker_run_mcp.sh help för att hämta IDE-konfigurationen för kopiera och klistra in och ./bin/docker_run_mcp.sh version för att bekräfta den paketerade MCP- och SDK-versionen. Använd ./bin/docker_run_mcp.sh diagnose för att undersöka anslutningsproblem.

Konfigurera markör configure-cursor

Lägg till en aem-dispatcher-mcp-post i ~/.cursor/mcp.json:

{
  "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>"
      }
    }
  }
}

Ersätt <path_to_dispatcher_sdk> med den extraherade Dispatcher SDK-platsen och <path_to_dispatcher_src> med projektets dispatcher src-katalog. Ange DISPATCHER_CONFIG_PATH till den config root som innehåller de filer där /docroot har definierats. MCP_LOG_LEVEL och MCP_LOG_FILE är valfria felsökningsinställningar. Om du ser client version 1.43 is too new anger du DOCKER_API_VERSION till 1.41. Om andra MCP-servrar redan har konfigurerats lägger du till posten aem-dispatcher-mcp utan att ersätta dem. Starta om markören när du har sparat.

Andra utvecklingsmiljöer kan konfigureras på liknande sätt. SDK docs/DispatcherMCP.md innehåller fullständiga exempel för Claude Desktop och VS Code.

Tillgängliga verktyg available-tools-dispatcher

MCP-ytan visar endast dessa sju verktyg avsiktligt. uppmaningar och resurser finns kvar i kunskapsskiktet. Fullständig referensdokumentation finns i docs/DispatcherMCP.md i den extraherade Dispatcher SDK.