Lokale ontwikkeling met AI-tools local-development-with-ai-tools

AI de coderingsagenten (de Code van Claude, Cursor, Kopilot GitHub, en gelijkaardige hulpmiddelen) hebben brede kennis van AEM onderliggende technologieën (Java, OSGi, Sling, JCR, HTL), maar niet noodzakelijk kennen beste praktijken voor het produceren van code en configuratie of hoe te om gemeenschappelijke de ontwikkelingskwesties van AEM te zuiveren.

Vier complementaire componenten zijn hierop gericht:

Herzie de ​ AI-Gesteunde ontwikkelingstuzelfstudies ​ voor extra, hands-on instructie.

AGENTS.md agentsmd

AGENTS.md is een opmaakbestand dat aan de basis van uw AEM-project ligt. Met de AI-coderingsprogramma’s wordt dit bestand automatisch geladen aan het begin van elke sessie om te kunnen worden gebaseerd op essentiële Java-stack domeinexpertise van AEM Cloud Service (en niet op andere AEM-oplossingen zoals AEM 6.5 of Edge Delivery Services).

AGENTS.md is geen statisch bestand dat u kopieert. Deze wordt gegenereerd door de ensure-agents-md -vaardigheid die wordt beschreven in de volgende sectie van dit document. De vaardigheid leest uw pom.xml om de projectnaam op te lossen, modules te ontdekken, en geïnstalleerde toe:voegen-ons te ontdekken, die tot een dossier leiden dat aan uw specifiek project wordt aangepast.

Agent Skills agent-skills

De vaardigheden zijn instructiesets die multi-step ontwikkelingswerkschema’s coderen. Wanneer opgeroepen, volgt AI de procedure van de vaardigheid eerder dan het baseren uitsluitend op algemene kennis, die verenigbare, conventie-volgzame resultaten veroorzaakt.

Adobe publiceert de vaardigheden van AEM as a Cloud Service in de adobe/skills ​ bewaarplaats:

Vaardigheden installeren install-skills

Kies de methode die overeenkomt met uw AI-codeergereedschap. Wanneer u vaardigheden installeert, worden deze beschikbaar voor alle projecten op die computer. Zie het ​ leerprogramma van de Vaardigheden van de Agent van de Opstelling AEM ​ voor een betonnen analyse.

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-vaardigheden npx-skills

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

UpVaardigheid (uitbreiding GitHub CLI) 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

Gebruik zeker-agenten-md Vaardigheid use-the-ensure-agents-md-skill

Na het installeren van de vaardigheid, open uw AI medewerker in om het even welk project van AEM as a Cloud Service dat nog geen AGENTS.md heeft. De vaardigheid loopt automatisch alvorens uw eerste verzoek te verwerken, creërend beide dossiers bij de projectwortel zonder expliciete aanroeping te vereisen.

Gebruik creeer-componentVaardigheid use-the-create-component-skill

Bij het eerste gebruik detecteert de vaardigheid automatisch project , package en group van pom.xml en bestaande componenten en wordt u gevraagd de gedetecteerde waarden te bevestigen. Vervolgens wordt .aem-skills-config.yaml gemaakt in de hoofdmap van het project. Voor het eerste gebruik is geen handmatige configuratie vereist.

Als u het bestand liever vooraf wilt maken, plaatst u .aem-skills-config.yaml in de hoofdmap van het project met de volgende structuur:

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

Het dossier leeft buiten de vaardigheidsfolder en wordt nooit beschreven wanneer de vaardigheid wordt bijgewerkt.

Beschrijf de component in uw AI praatje:

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

De agent bevestigt de veldspecificatie voor bevestiging, dan produceert alle componentendossiers. Ondersteunde patronen zijn onder andere multifield met samengestelde geneste items, voorwaardelijke show/hide-logica, de uitbreiding van de Core-component via Sling Resource Merger en JUnit 5-tests met AEM Mocks. Het ontwerp kan uit diverse bronnen, met inbegrip van een tekstbeschrijving, een beeld, of een het ontwerpurl van Figma voortkomen gebruikend de server MCP van Figma.

Leer meer door de ​ ontwikkeling van de Component te volgen gebruikend het leerprogramma van de Vaardigheden van de Agent van AEM.

De Vaardigheid van Dispatcher gebruiken use-the-dispatcher-skill

Roep de verzendervaardigheid aan voor Dispatcher- of Apache HTTPD-configuratiewerk. De vaardigheidsroutes verzoeken aan één van zes specialistische subvaardigheden afhankelijk van de aard van het verzoek:

Voor globale of eerste verzoeken, begin met de workflow-orchestrator sub-vaardigheid. Voor gerichte werkzaamheden, beschrijf de specifieke zorg en de vaardigheidsroutes aan de aangewezen specialist.

De vaardigheid van de verzender handelt organisatie en adviserende begeleiding af. De server van Dispatcher MCP, die in de volgende sectie wordt beschreven, verstrekt de zeven validatie en runtime hulpmiddelen de vaardigheid gebruikt wanneer het lokaal bewijsmateriaal vereist.

AEM Quickstart MCP Server aem-quickstart-mcp-server

Het ModelContextprotocol (MCP) is een open norm die AI codeerhulpmiddelen toestaat om met externe gegevensbronnen en de diensten te verbinden. De AEM Quickstart MCP-server is een inhoudspakket dat, zodra deze in een lokale AEM SDK-instantie is geïnstalleerd, runtimegegevens rechtstreeks beschikbaar maakt voor verbonden AI-gereedschappen, zodat agents logbestanden kunnen ophalen, OSGi-fouten kunnen opsporen en aanvraagverwerking kunnen inspecteren zonder de IDE te verlaten.

Het inhoudspakket installeren install-the-content-package

Download het inhoudspakket van het ​ Portaal van de Distributie van de Software ​ en installeer com.adobe.aem:com.adobe.aem.mcp-server-contribs-content in uw lokale Quickstart gebruikend de Manager van het Pakket bij /crx/packmgr.

Verenigbaarheid: Bevalideerd met AEM SDK 2026.2.24678.20260226T154829Z-260200 en nieuwer.

Beschikbare gereedschappen available-tools

Uw IDE configureren configure-your-ide

Cursor cursor

Voeg bij Cursorinstellingen een nieuwe aangepaste MCP-server toe:

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

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

Navigeer aan Hulpmiddelen > Kopiëren GitHub > ModelContext Protocol (MCP) en klik vormen. Toevoegen:

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

Overige IDE’s other-ides

Elke MCP-client kan verbinding maken door naar http://localhost:4502/bin/mcp te wijzen met een Authorization: Basic YWRtaW46YWRtaW4= -header. Vorm douanekopballen gebruikend de montages MCP van uw winde.

Dispatcher MCP Server dispatcher-mcp-server

De Dispatcher MCP-server wordt meegeleverd bij de AEM Dispatcher SDK. Het laat AI hulpmiddelen toe om de configuratie van Dispatcher en Apache HTTPD te bevestigen, verzoek behandeling te vinden, en geheim voorgeheugengedrag tegen een instantie te inspecteren die van Dispatcher plaatselijk in Docker loopt.

In tegenstelling tot de verzendervaardigheid stelt de Dispatcher MCP-server alleen gereedschappen beschikbaar: zeven hulpmiddelen MCP en geen herinneringen of middelen.

Vereisten prerequisites

De Dispatcher SDK installeren install-the-dispatcher-sdk

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

Vensters:

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

Voer ./bin/docker_run_mcp.sh help uit om de kopiëren-plakken configuratie van winde en ./bin/docker_run_mcp.sh version terug te winnen om de gebundelde versie MCP en SDK te bevestigen. Gebruik ./bin/docker_run_mcp.sh diagnose om connectiviteitsproblemen te onderzoeken.

Cursor configureren configure-cursor

Voeg een aem-dispatcher-mcp -item toe aan ~/.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>"
      }
    }
  }
}

Vervang <path_to_dispatcher_sdk> door de geëxtraheerde Dispatcher SDK-locatie en <path_to_dispatcher_src> door de verzendmap van het project src . Stel DISPATCHER_CONFIG_PATH in op de configuratiegrootte die de bestanden bevat waarin /docroot is gedefinieerd. MCP_LOG_LEVEL en MCP_LOG_FILE zijn optionele instellingen voor foutopsporing. Als u client version 1.43 is too new ziet, stelt u DOCKER_API_VERSION in op 1.41 . Als andere MCP servers reeds worden gevormd, voeg de aem-dispatcher-mcp ingang toe zonder hen te vervangen. Start de cursor opnieuw na het opslaan.

Andere IDEs kan op een gelijkaardige manier worden gevormd. De SDK docs/DispatcherMCP.md bevat volledige voorbeelden voor Claude Desktop en VS Code.

Beschikbare gereedschappen available-tools-dispatcher

Het MCP-oppervlak stelt alleen deze zeven gereedschappen opzettelijk bloot; de herinneringen en de middelen blijven in de vaardigheidslaag. De volledige naslagdocumentatie is beschikbaar in docs/DispatcherMCP.md in de geëxtraheerde Dispatcher SDK.