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 het weten 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:

AGENTS.md agentsmd

AGENTS.md is een Markeringen-bestand aan de basis van uw AEM-project dat door AI-coderingsprogramma's automatisch wordt geladen aan het begin van elke sessie om te kunnen worden gebaseerd op essentiële Java-Stapeldomeinexpertise 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. Het wordt gegenereerd door de ensure-agents-md -vaardigheid die in de volgende sectie wordt beschreven. 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 op de beta tak aangezien deze eigenschap nog niet algemeen beschikbaar is:

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.

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

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

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

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 de Dienst van de Wolk AEM 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 bij 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.

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 Dispatcher MCP-server, die hieronder wordt beschreven, biedt de zeven validatie- en runtimeprogramma's die de vaardigheid gebruikt wanneer lokaal bewijs nodig is.

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 direct beschikbaar maakt voor verbonden AI-gereedschappen. Hierdoor kunnen agents logbestanden ophalen, fouten met OSGi opsporen en de verwerking van aanvragen controleren 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 verdienervaardigheid, stelt de server van Dispatcher MCP slechts hulpmiddelen bloot: 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 oppervlak MCP stelt opzettelijk slechts deze zeven hulpmiddelen bloot; herinneringen en middelen blijven in de vaardigheidslaag. De volledige naslagdocumentatie is beschikbaar in docs/DispatcherMCP.md in de geëxtraheerde Dispatcher SDK.