Desarrollo local con herramientas de IA local-development-with-ai-tools

Los agentes de codificación de IA (Claude Code, Cursor, GitHub Copilot y herramientas similares) tienen un amplio conocimiento de las tecnologías subyacentes de AEM (Java, OSGi, Sling, JCR, HTL), pero no necesariamente conocen las prácticas recomendadas para generar código y configuración o cómo depurar problemas comunes de desarrollo de AEM.

Cuatro componentes complementarios se ocupan de esto:

AGENTS.md agentsmd

AGENTS.md es un archivo Markdown en la raíz del proyecto de AEM que las herramientas de codificación de IA cargan automáticamente al principio de cada sesión para conectarse a tierra con la experiencia esencial del dominio de pila Java de AEM Cloud Service (y no otras soluciones de AEM como AEM 6.5 o Edge Delivery Services).

AGENTS.md no es un archivo estático que usted copia, sino que se genera por la aptitud de ensure-agents-md descrita en la siguiente sección. La aptitud lee su pom.xml para resolver el nombre del proyecto, descubrir módulos y detectar complementos instalados, lo que produce un archivo adaptado a su proyecto específico.

Aptitudes de agente agent-skills

Las habilidades son conjuntos de instrucciones que codifican flujos de trabajo de desarrollo de varios pasos. Cuando se invoca, la IA sigue el procedimiento de la aptitud en lugar de basarse únicamente en el conocimiento general, lo que produce resultados coherentes y compatibles con la convención.

Adobe publica aptitudes de AEM as a Cloud Service en el repositorio adobe/skills de la rama beta, ya que esta característica aún no está disponible de forma general:

Instalar aptitudes install-skills

Elija el método que coincida con la herramienta de codificación de IA. La instalación de habilidades una vez las pone a disposición de todos los proyectos de ese equipo.

Código Claude 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

Aptitudes Npx npx-skills

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

Actualización (extensión CLI de 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

Use la habilidad de secure-agents-md use-the-ensure-agents-md-skill

Después de instalar la aptitud, abra el asistente de IA en cualquier proyecto de AEM Cloud Service que aún no tenga AGENTS.md. La aptitud se ejecuta automáticamente antes de procesar la primera solicitud, lo que crea ambos archivos en la raíz del proyecto sin requerir una invocación explícita.

Uso de la aptitud create-component use-the-create-component-skill

En el primer uso, la aptitud detecta automáticamente project, package y group de pom.xml y de los componentes existentes, le pide que confirme los valores detectados y, a continuación, crea .aem-skills-config.yaml en la raíz del proyecto. No se requiere ninguna configuración manual antes del primer uso.

Si prefiere crear previamente el archivo, coloque .aem-skills-config.yaml en la raíz del proyecto con la siguiente estructura:

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

El archivo se encuentra fuera del directorio de aptitudes y nunca se sobrescribe cuando se actualiza la aptitud.

Describa el componente en su chat de 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

El agente hace eco de la especificación del campo para la confirmación y, a continuación, genera todos los archivos de componente. Los patrones admitidos son varios campos con elementos anidados compuestos, lógica condicional de mostrar/ocultar, extensión de componente principal mediante fusión de recursos de Sling y pruebas JUnit 5 con AEM Mocks.

Uso de la aptitud de Dispatcher use-the-dispatcher-skill

Invoque la aptitud de Dispatcher para cualquier trabajo de configuración HTTPD de Dispatcher o Apache. La aptitud dirige las solicitudes a una de las seis subaptitudes especializadas según la naturaleza de la solicitud:

Para solicitudes amplias o iniciales, empiece con la subaptitud workflow-orchestrator. Para un trabajo específico, describa la preocupación específica y las rutas de aptitudes al especialista adecuado.

La habilidad del despachante gestiona la orquestación y la orientación consultiva. El servidor MCP de Dispatcher, que se describe a continuación, proporciona las siete herramientas de validación y tiempo de ejecución que la aptitud utiliza cuando necesita pruebas locales.

Servidor MCP de Quickstart de AEM aem-quickstart-mcp-server

El Protocolo de contexto de modelo (MCP) es un estándar abierto que permite a las herramientas de codificación de IA conectarse a fuentes de datos y servicios externos. El servidor AEM Quickstart MCP es un paquete de contenido que, una vez instalado en una instancia local de AEM SDK, expone los datos de tiempo de ejecución directamente a las herramientas de IA conectadas, lo que permite a los agentes recuperar registros, diagnosticar errores de OSGi e inspeccionar el procesamiento de solicitudes sin salir del IDE.

Instalación del paquete de contenido install-the-content-package

Descargue el paquete de contenido del Portal de distribución de software e instale com.adobe.aem:com.adobe.aem.mcp-server-contribs-content en su Quickstart local mediante el Administrador de paquetes en /crx/packmgr.

Compatibilidad: Validada con AEM SDK 2026.2.24678.20260226T154829Z-260200 y posterior.

Herramientas disponibles available-tools

Configurar el IDE configure-your-ide

Cursor cursor

En Configuración de cursor, agregue un nuevo servidor MCP personalizado:

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

Copiloto de GitHub con IntelliJ IDEA github-copilot-with-ihtellij-idea

Vaya a Herramientas > GitHub Copilot > Protocolo de contexto de modelo (MCP) y haga clic en Configurar. Agregar:

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

Otros IDE other-ides

Cualquier cliente MCP puede conectarse señalando http://localhost:4502/bin/mcp con un encabezado Authorization: Basic YWRtaW46YWRtaW4=. Configure encabezados personalizados mediante la configuración de MCP del IDE.

Servidor MCP de Dispatcher dispatcher-mcp-server

El servidor MCP de Dispatcher está empaquetado con AEM Dispatcher SDK. Permite a las herramientas de IA validar la configuración de HTTPD de Dispatcher y Apache, rastrear la administración de solicitudes e inspeccionar el comportamiento de la caché con una instancia de Dispatcher que se ejecuta localmente en Docker.

A diferencia de la aptitud de Dispatcher, el servidor MCP de Dispatcher expone solo herramientas: siete herramientas MCP y sin peticiones de datos ni recursos.

Requisitos previos prerequisites

Instalación de Dispatcher SDK install-the-dispatcher-sdk

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

Ejecute ./bin/docker_run_mcp.sh help para recuperar la configuración del IDE de copiar y pegar y ./bin/docker_run_mcp.sh version para confirmar la versión del MCP y SDK agrupados. Use ./bin/docker_run_mcp.sh diagnose para investigar los problemas de conectividad.

Configurar cursor configure-cursor

Agregar una entrada 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>"
      }
    }
  }
}

Reemplace <path_to_dispatcher_sdk> por la ubicación de Dispatcher SDK extraída y <path_to_dispatcher_src> por el directorio de Dispatcher src del proyecto. Establezca DISPATCHER_CONFIG_PATH en la raíz de configuración que incluye los archivos donde se define /docroot. MCP_LOG_LEVEL y MCP_LOG_FILE son opciones de depuración opcionales. Si ve client version 1.43 is too new, establezca DOCKER_API_VERSION en 1.41. Si ya se han configurado otros servidores MCP, agregue la entrada aem-dispatcher-mcp sin reemplazarlos. Reinicie Cursor después de guardar.

Otros IDE se pueden configurar de manera similar. docs/DispatcherMCP.md de SDK incluye ejemplos completos de Claude Desktop y código VS.

Herramientas disponibles available-tools-dispatcher

La superficie de MCP expone intencionadamente solo estas siete herramientas; los indicadores y los recursos permanecen en la capa de habilidad. La documentación de referencia completa está disponible en docs/DispatcherMCP.md dentro del SDK de Dispatcher extraído.