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:

Revise los tutoriales de desarrollo asistido por IA para obtener instrucciones prácticas adicionales.

No dude en enviar un correo electrónico a aemcs-ai-ide-tools-feedback@adobe.com con comentarios para ayudar a dar forma al desarrollo del producto.

AGENTS.md agentsmd

AGENTS.md es un archivo de marcado en la raíz del proyecto de AEM. Las herramientas de codificación de IA cargan este archivo 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 con otras soluciones de AEM como AEM 6.5 o Edge Delivery Services).

AGENTS.md no es un archivo estático que usted copie. Se genera por la aptitud de ensure-agents-md descrita en la siguiente sección de este documento. 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 las aptitudes de AEM as a Cloud Service en el repositorio adobe/skills:

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. Consulte el tutorial Configurar aptitudes de agente de AEM para ver un tutorial concreto.

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

Aptitudes de NPX npx-skills

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

Actualizar (extensión CLI de GitHub) 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

Use la habilidad de Asegúrese de que los agentes estén listos para usar use-the-ensure-agents-md-skill

Después de instalar la aptitud, abra el asistente de IA en cualquier proyecto de AEM as a 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 Crear-componente 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, y le pide que confirme los valores detectados. Luego 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. El diseño puede provenir de varias fuentes, incluyendo una descripción textual, una imagen o una URL de diseño Figma usando el servidor MCP de Figma.

Obtenga más información siguiendo el desarrollo de componentes mediante el tutorial de aptitudes de agente de AEM.

Uso de la aptitud de migración use-the-migration-skill

La aptitud de migration guía al agente a través de la migración del código Java de AEM y las configuraciones de OSGi a AEM as a Cloud Service. Funciona de patrón en patrón: se le asigna un nombre al patrón (por ejemplo, scheduler o replication), se indica al agente los resultados del Analizador de prácticas recomendadas, se localizan los archivos afectados en el proyecto y se aplican las transformaciones correctas por lotes, pausando la revisión después de cada uno de ellos.

Los patrones admitidos son Planificador de Sling, ResourceChangeListener, API de replicación, OSGi EventListener y EventHandler, API de Assets, correcciones de lint de HTL y conversión de configuración OSGi con secretos de Cloud Manager y extracción de variables de entorno.

La aptitud se vincula con el MCP de migración en la nube para obtener resultados directamente de Cloud Acceleration Manager. Sin el MCP configurado, la aptitud vuelve a una exportación CSV local de BPA o puede apuntar a archivos específicos manualmente.

Para obtener instrucciones de configuración completas y referencias de patrones, consulte Migración de código con asistencia de IA a AEM as a Cloud Service.

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 en la sección siguiente, proporciona las siete herramientas de validación y tiempo de ejecución que la aptitud utiliza cuando necesita pruebas locales.

Uso de la aptitud para la evaluación de código (Beta) use-the-code-assessment-skill

Esta característica es beta. Adobe le recomienda que envíe sus comentarios por correo electrónico a aemcs-ai-ide-tools-feedback@adobe.com para dar forma al desarrollo de productos.

Las versiones de Beta pueden contener defectos y se proporcionan “TAL CUAL” sin garantía de ningún tipo. Adobe no tiene obligación de mantener, corregir, actualizar, cambiar, modificar o admitir de otro modo (mediante los Servicios de soporte de Adobe o de otro modo) las versiones beta. Adobe recomienda a los clientes tener cuidado y no depender del funcionamiento o el rendimiento correctos de las versiones beta, ni de la documentación o los materiales adjuntos. Las funciones y las API de la versión beta están sujetas a cambios sin previo aviso. Por lo tanto, cualquier uso de las versiones beta es totalmente bajo el propio riesgo del cliente.

La aptitud de code-assessment detecta, revisa y corrige los problemas de calidad de código y corrección de un proyecto de AEM as a Cloud Service en su totalidad en el espacio de trabajo local. Describa el problema y la aptitud dirigirá la solicitud al flujo de trabajo de remediación adecuado.

Las comprobaciones admitidas incluyen la modernización de la inyección de dependencias del modelo Sling, la actualización de dependencias Maven obsoletas, la adición de tiempos de espera que faltan a llamadas HTTP salientes, el límite de consultas ilimitadas, programadores Sling, detectores de cambios de recursos, las API de replicación y Assets y el control de eventos JCR u OSGi, además del análisis y la corrección del uso de API de AEM obsoletas y eliminadas, con más agregaciones a lo largo del tiempo. Según el problema, la habilidad aplica una corrección mecánica directamente o le guía a través de una que necesita una llamada de juicio.

Para una revisión amplia o por primera vez, pida a la habilidad que evalúe todo el proyecto: ejecuta cada detector, informa de todos los hallazgos y aplica correcciones de código de a un patrón a la vez.

Para empezar, abra un nuevo chat de agente en su proyecto de AEM as a Cloud Service.

1. Revise su proyecto. Pedir un informe. La aptitud ejecuta su analizador y devuelve los resultados en línea, agrupados por patrón y gravedad, con un plan de corrección sugerido. No se cambia ningún código en esta fase.

scan my AEM project and report any code-quality issues

Para una invocación más explícita, asigne un nombre a la aptitud directamente:

/code-assessment review my code for AEM as a Cloud Service issues

Para centrarse en un solo patrón, asígnele un nombre en la solicitud:

scan my project for unbounded queries

2. Aplicar correcciones, patrón a patrón. Pida a la aptitud que corrija un patrón específico. Realiza ediciones quirúrgicas y verifica que compilan. Las correcciones mecánicas se aplican directamente; las guiadas le guían a través de cada decisión.

apply unbounded-query

Nunca se confirma ni se inserta: se revisa la comparación de diferencias y la confirmación. Las correcciones grandes se ejecutan en lotes reanudables; responda apply <pattern> para continuar.

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.