Sviluppo locale con strumenti AI local-development-with-ai-tools

Gli agenti di codifica IA (Claude Code, Cursor, GitHub Copilot e strumenti simili) hanno un’ampia conoscenza delle tecnologie sottostanti di AEM (Java, OSGi, Sling, JCR, HTL), ma non conoscono necessariamente le best practice per la generazione di codice e configurazione, o come eseguire il debug dei problemi comuni di sviluppo di AEM.

Quattro componenti complementari affrontano questo problema:

AGENTS.md agentsmd

AGENTS.md è un file Markdown nella directory principale del progetto AEM, in cui gli strumenti di codifica AI vengono caricati automaticamente all'inizio di ogni sessione per essere basati sulle competenze essenziali del dominio Java stack di AEM Cloud Service (e non su altre soluzioni AEM come AEM 6.5 o Edge Delivery Services).

AGENTS.md non è un file statico copiato. Viene generato dall'abilità ensure-agents-md descritta nella sezione successiva. L'abilità legge pom.xml per risolvere il nome del progetto, individuare i moduli e rilevare i componenti aggiuntivi installati, producendo un file personalizzato per il progetto specifico.

Abilità agente agent-skills

Le abilità sono set di istruzioni che codificano flussi di lavoro di sviluppo in più passaggi. Quando invocata, l’intelligenza artificiale segue la procedura dell’abilità anziché affidarsi esclusivamente alla conoscenza generale, producendo risultati coerenti e conformi alle convenzioni.

Adobe pubblica AEM as a Cloud Service skills nell'archivio adobe/skills nel ramo beta poiché questa funzione non è ancora disponibile a livello generale:

Installa abilità install-skills

Scegli il metodo che corrisponde allo strumento di codifica AI. L’installazione delle abilità una volta le rende disponibili per tutti i progetti su quel 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

Abilità Npx npx-skills

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

Aggiornamento (estensione CLI GitHub) 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

Utilizzare l’abilità make-agents-md use-the-ensure-agents-md-skill

Dopo aver installato l’abilità, apri l’assistente AI in qualsiasi progetto AEM Cloud Service che non dispone ancora di AGENTS.md. L’abilità viene eseguita automaticamente prima di elaborare la prima richiesta, creando entrambi i file nella directory principale del progetto senza richiedere una chiamata esplicita.

Utilizzare l’abilità di creazione dei componenti use-the-create-component-skill

Al primo utilizzo, l'abilità rileva automaticamente project, package e group da pom.xml e dai componenti esistenti, richiede di confermare i valori rilevati, quindi crea .aem-skills-config.yaml nella directory principale del progetto. Non è richiesta alcuna configurazione manuale prima del primo utilizzo.

Se preferisci creare il file in anticipo, inserisci .aem-skills-config.yaml nella directory principale del progetto con la seguente struttura:

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

Il file si trova all’esterno della directory delle abilità e non viene mai sovrascritto quando l’abilità viene aggiornata.

Descrivi il componente nella chat di IA:

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

L’agente fa eco alle specifiche del campo per la conferma, quindi genera tutti i file dei componenti. I pattern supportati includono multicampo con elementi compositi nidificati, logica condizionale di visualizzazione/nascondere, estensione dei componenti core tramite Sling Resource Merger e test JUnit 5 con AEM Mocks.

Utilizzare l’abilità Dispatcher use-the-dispatcher-skill

Richiama l’abilità del dispatcher per qualsiasi lavoro di configurazione Dispatcher o Apache HTTPD. L’abilità indirizza le richieste a una delle sei sottocompetenze specialistiche in base alla natura della richiesta:

Per richieste ampie o nuove, inizia con la sottoabilità workflow-orchestrator. Per un lavoro mirato, descrivi la preoccupazione specifica e gli itinerari di competenze allo specialista appropriato.

L’abilità del dispatcher gestisce l’orchestrazione e le linee guida per gli advisory. Il server MCP di Dispatcher, descritto di seguito, fornisce i sette strumenti di convalida e runtime utilizzati dall’abilità quando necessita di prove locali.

Server AEM Quickstart MCP aem-quickstart-mcp-server

Model Context Protocol (MCP) è uno standard aperto che consente agli strumenti di codifica IA di connettersi a origini dati e servizi esterni. Il server MCP Quickstart di AEM è un pacchetto di contenuti che, una volta installato in un’istanza AEM SDK locale, espone i dati di runtime direttamente agli strumenti di intelligenza artificiale connessi, consentendo agli agenti di recuperare i registri, diagnosticare gli errori OSGi e controllare l’elaborazione delle richieste senza uscire dall’IDE.

Installare il pacchetto dei contenuti install-the-content-package

Scarica il pacchetto di contenuti dal portale di distribuzione software e installa com.adobe.aem:com.adobe.aem.mcp-server-contribs-content nel tuo Quickstart locale utilizzando Gestione pacchetti in /crx/packmgr.

Compatibilità: convalidata con AEM SDK 2026.2.24678.20260226T154829Z-260200 e versioni successive.

Strumenti disponibili available-tools

Configurare l’IDE configure-your-ide

Cursore cursor

In Impostazioni cursore, aggiungi un nuovo server MCP personalizzato:

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

Copilota GitHub con IntelliJ IDEA github-copilot-with-ihtellij-idea

Passa a Strumenti > Copilota GitHub > MCP (Model Context Protocol) e fai clic su Configura. Aggiungi:

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

Altri IDE other-ides

Qualsiasi client MCP può connettersi puntando a http://localhost:4502/bin/mcp con intestazione Authorization: Basic YWRtaW46YWRtaW4=. Configura le intestazioni personalizzate utilizzando le impostazioni MCP dell’IDE.

Server Dispatcher MCP dispatcher-mcp-server

Il server Dispatcher MCP è fornito in bundle con AEM Dispatcher SDK. Consente agli strumenti di intelligenza artificiale di convalidare la configurazione Dispatcher e Apache HTTPD, la gestione delle richieste di traccia e il comportamento della cache rispetto a un’istanza Dispatcher in esecuzione localmente in Docker.

A differenza dell’abilità del dispatcher, il server MCP di Dispatcher espone solo strumenti: sette strumenti MCP e nessun prompt o risorsa.

Prerequisiti prerequisites

Installare Dispatcher SDK install-the-dispatcher-sdk

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

Eseguire ./bin/docker_run_mcp.sh help per recuperare la configurazione IDE di copia e incolla e ./bin/docker_run_mcp.sh version per confermare la versione MCP e SDK nel bundle. Utilizza ./bin/docker_run_mcp.sh diagnose per analizzare i problemi di connettività.

Configura cursore configure-cursor

Aggiungi una voce aem-dispatcher-mcp a ~/.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>"
      }
    }
  }
}

Sostituisci <path_to_dispatcher_sdk> con il percorso di Dispatcher SDK estratto e <path_to_dispatcher_src> con la directory del dispatcher del progetto src. Impostare DISPATCHER_CONFIG_PATH sulla radice di configurazione che include i file in cui è definito /docroot. MCP_LOG_LEVEL e MCP_LOG_FILE sono impostazioni di debug facoltative. Se vedi client version 1.43 is too new, imposta DOCKER_API_VERSION su 1.41. Se altri server MCP sono già configurati, aggiungere la voce aem-dispatcher-mcp senza sostituirli. Riavvia cursore dopo il salvataggio.

Altri IDE possono essere configurati in modo simile. Il SDK docs/DispatcherMCP.md include esempi completi per Claude Desktop e VS Code.

Strumenti disponibili available-tools-dispatcher

La superficie MCP espone intenzionalmente solo questi sette strumenti; i prompt e le risorse rimangono nel livello abilità. La documentazione completa di riferimento è disponibile in docs/DispatcherMCP.md all'interno del SDK Dispatcher estratto.