Desenvolvimento local com ferramentas de IA local-development-with-ai-tools

Os agentes de codificação de IA (Claude Code, Cursor, GitHub Copilot e ferramentas semelhantes) têm amplo conhecimento das tecnologias subjacentes da AEM (Java, OSGi, Sling, JCR, HTL), mas não conhecem necessariamente as práticas recomendadas para gerar código e configuração ou como depurar problemas comuns de desenvolvimento do AEM.

Quatro componentes complementares abordam esta questão:

Revise os tutoriais de desenvolvimento assistido por IA para obter instruções adicionais e práticas.

Sinta-se à vontade para enviar um email para aemcs-ai-ide-tools-feedback@adobe.com com feedback para ajudar a moldar o desenvolvimento do produto.

AGENTS.md agentsmd

AGENTS.md é um arquivo de marcação na raiz do projeto do AEM. As ferramentas de codificação de IA carregam esse arquivo automaticamente no início de cada sessão para que ele se baseie no conhecimento essencial de domínio da pilha de Java do AEM Cloud Service (e não em outras soluções da AEM, como o AEM 6.5 ou o Edge Delivery Services).

AGENTS.md não é um arquivo estático copiado. É gerado pela habilidade ensure-agents-md descrita na próxima seção deste documento. A habilidade lê o pom.xml para resolver o nome do projeto, descobrir módulos e detectar complementos instalados, produzindo um arquivo adaptado ao seu projeto específico.

Habilidades do agente agent-skills

Habilidades são conjuntos de instruções que codificam fluxos de trabalho de desenvolvimento de várias etapas. Quando invocada, a IA segue o procedimento da habilidade, em vez de depender apenas do conhecimento geral, produzindo resultados consistentes e compatíveis com a convenção.

A Adobe publica habilidades do AEM as a Cloud Service no adobe/skills repositório:

Instalar habilidades install-skills

Escolha o método que corresponde à ferramenta de codificação de IA. Instalar as habilidades uma vez as disponibiliza para todos os projetos nessa máquina. Consulte o Tutorial Configurar habilidades do agente do AEM para obter uma apresentação concreta.

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

Habilidades NPX npx-skills

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

Aprimoramento (extensão CLI do 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

Usar a habilidade sure-agents-md use-the-ensure-agents-md-skill

Após instalar a habilidade, abra o assistente de IA em qualquer projeto do AEM as a Cloud Service que ainda não tenha um AGENTS.md. A habilidade é executada automaticamente antes do processamento da primeira solicitação, criando ambos os arquivos na raiz do projeto sem a necessidade de chamada explícita.

Usar a habilidade Criar componente use-the-create-component-skill

Na primeira utilização, a habilidade detecta automaticamente project, package e group de pom.xml e componentes existentes e solicita que você confirme os valores detectados. Em seguida, ele cria .aem-skills-config.yaml na raiz do projeto. Nenhuma configuração manual é necessária antes da primeira utilização.

Se preferir pré-criar o arquivo, coloque .aem-skills-config.yaml na raiz do projeto com a seguinte estrutura:

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

O arquivo fica fora do diretório de habilidades e nunca é substituído quando a habilidade é atualizada.

Descreva o componente no bate-papo 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

O agente ecoa a especificação do campo para confirmação e, em seguida, gera todos os arquivos de componente. Os padrões compatíveis incluem vários campos com itens aninhados compostos, lógica condicional de mostrar/ocultar, extensão do Componente principal por meio do Sling Resource Merger e testes JUnit 5 usando AEM Mocks. O design pode vir de várias fontes, incluindo uma descrição de texto, uma imagem ou um URL de design do Figma usando o servidor MCP do Figma.

Saiba mais seguindo o tutorial de desenvolvimento de Componentes usando Habilidades do Agente do AEM.

Usar a habilidade de migração use-the-migration-skill

A habilidade migration orienta o agente por meio da migração do código Java da AEM e das configurações de OSGi para o AEM as a Cloud Service. Ela funciona com um padrão de cada vez: você nomeia o padrão (por exemplo, scheduler ou replication), aponta o agente para as descobertas do Analisador de práticas recomendadas e localiza os arquivos afetados no projeto e aplica as transformações corretas em lotes, pausando para a revisão após cada um.

Os padrões compatíveis incluem Sling Scheduler, ResourceChangeListener, API de replicação, OSGi EventListener e EventHandler, API do Assets, correções de linha HTL e conversão de configuração OSGi com extração de segredos e variáveis de ambiente do Cloud Manager.

A habilidade é pareada ao MCP de migração na nuvem para buscar descobertas diretamente do Cloud Acceleration Manager. Sem o MCP configurado, a habilidade retorna a uma exportação de CSV BPA local ou você pode apontá-la manualmente para arquivos específicos.

Para obter instruções completas de configuração e referência de padrão, consulte Migração de código assistida por IA para o AEM as a Cloud Service.

Usar a habilidade do Dispatcher use-the-dispatcher-skill

Chame a habilidade do dispatcher para qualquer trabalho de configuração HTTPD do Dispatcher ou Apache. As solicitações de rotas de habilidades para uma das seis sub-habilidades especializadas, dependendo da natureza da solicitação:

Para solicitações amplas ou iniciadas, comece com a subhabilidade workflow-orchestrator. Para trabalho direcionado, descreva a preocupação específica e as rotas de habilidades para o especialista apropriado.

A habilidade do dispatcher lida com orquestração e orientação de consultoria. O servidor MCP do Dispatcher, descrito na seção a seguir, fornece as sete ferramentas de validação e de tempo de execução que a habilidade usa quando precisa de evidências locais.

Usar a habilidade de avaliação de código (Beta) use-the-code-assessment-skill

Este recurso é beta. A Adobe incentiva você a fornecer feedback, enviando um email para aemcs-ai-ide-tools-feedback@adobe.com para formatar o desenvolvimento do produto.

As versões do Beta podem conter defeitos e são fornecidas “NO ESTADO EM QUE SE ENCONTRAM” sem garantias de nenhum tipo. A Adobe não tem nenhuma obrigação de manter, corrigir, atualizar, alterar, modificar ou oferecer suporte (por meio dos Serviços de suporte da Adobe ou de outra forma) às versões beta. A Adobe recomenda que os clientes tenham cuidado e não dependam do funcionamento ou do desempenho correto das versões beta, nem de qualquer documentação ou material que as acompanhe. Os recursos e as APIs na versão beta estão sujeitos a alterações sem aviso prévio. Portanto, qualquer uso das versões beta é de inteira responsabilidade do cliente.

A habilidade code-assessment detecta, revisa e corrige problemas de qualidade e correção de código em um projeto do AEM as a Cloud Service inteiramente no espaço de trabalho local. Descreva o problema e a habilidade encaminha a solicitação para o fluxo de trabalho de remediação apropriado.

As verificações compatíveis incluem modernizar a injeção de dependência do Modelo do Sling, atualizar dependências do Maven desatualizadas, adicionar tempos limite ausentes a chamadas HTTP de saída, delimitar consultas não vinculadas, schedulers do Sling, ouvintes de alteração de recursos, APIs de Replicação e Assets e manipulação de eventos JCR ou OSGi, além de verificar e corrigir o uso de APIs do AEM descontinuadas e removidas, com mais detalhes adicionados ao longo do tempo. Dependendo do problema, a habilidade aplica uma correção mecânica diretamente ou o orienta por uma que precisa de uma chamada de avaliação.

Para uma revisão ampla ou pela primeira vez, peça à habilidade que avalie todo o projeto: ele executa cada detector, relata todas as descobertas e aplica correções de código um padrão por vez.

Para começar, abra um novo bate-papo do agente no projeto do AEM as a Cloud Service.

1. Examine seu projeto. Solicitar um relatório. A habilidade executa seu analisador e retorna as descobertas em linha, agrupadas por padrão e gravidade, com um plano de remediação sugerido. Nenhum código foi alterado nesse estágio.

scan my AEM project and report any code-quality issues

Para uma invocação mais explícita, nomeie a habilidade diretamente:

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

Para se concentrar em um único padrão, nomeie-o no prompt:

scan my project for unbounded queries

2. Aplique correções, um padrão por vez. Peça à habilidade para corrigir um padrão específico. Ele faz edições cirúrgicas e verifica se elas são compiladas. Correções mecânicas se aplicam diretamente; correções guiadas o orientam em cada decisão.

apply unbounded-query

Ele nunca confirma ou envia — você revisa o diferencial e confirma. Correções grandes são executadas em lotes retomáveis; responda apply <pattern> para continuar.

AEM Quickstart MCP Server aem-quickstart-mcp-server

O Protocolo de contexto de modelo (MCP) é um padrão aberto que permite que as ferramentas de codificação de IA se conectem a fontes de dados e serviços externos. O servidor MCP AEM Quickstart é um pacote de conteúdo que, uma vez instalado em uma instância local do AEM SDK, expõe os dados de tempo de execução diretamente às ferramentas de IA conectadas, permitindo que os agentes recuperem registros, diagnostiquem falhas de OSGi e inspecionem o processamento de solicitações sem sair do IDE.

Instalar o pacote de conteúdo install-the-content-package

Baixe o pacote de conteúdo do Portal de Distribuição de Software e instale o com.adobe.aem:com.adobe.aem.mcp-server-contribs-content no Quickstart local usando o Gerenciador de Pacotes em /crx/packmgr.

Compatibilidade: validada com AEM SDK 2026.2.24678.20260226T154829Z-260200 e mais recente.

Ferramentas disponíveis available-tools

Configurar o IDE configure-your-ide

Cursor cursor

Em Configurações do Cursor, adicione um novo servidor MCP personalizado:

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

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

Navegue até Ferramentas > GitHub Copilot > Protocolo de Contexto de Modelo (MCP) e clique em Configurar. Adicionar:

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

Outras IDEs other-ides

Qualquer cliente MCP pode se conectar apontando para http://localhost:4502/bin/mcp com um cabeçalho Authorization: Basic YWRtaW46YWRtaW4=. Configure cabeçalhos personalizados usando as configurações de MCP do IDE.

Dispatcher MCP Server dispatcher-mcp-server

O servidor Dispatcher MCP é fornecido com o AEM Dispatcher SDK. Ela permite que as ferramentas de IA validem a configuração HTTPD do Dispatcher e do Apache, rastreiem a manipulação de solicitações e inspecionem o comportamento do cache em relação a uma instância do Dispatcher executada localmente no Docker.

Ao contrário da habilidade do dispatcher, o servidor MCP do Dispatcher expõe apenas ferramentas: sete ferramentas MCP e nenhum prompt ou recurso.

Pré-requisitos prerequisites

Instalar o 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

Janelas:

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

Execute ./bin/docker_run_mcp.sh help para recuperar a configuração do IDE de copiar e colar e ./bin/docker_run_mcp.sh version para confirmar a versão do MCP e do SDK agrupados. Use ./bin/docker_run_mcp.sh diagnose para investigar problemas de conectividade.

Configurar o cursor configure-cursor

Adicionar uma 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>"
      }
    }
  }
}

Substitua <path_to_dispatcher_sdk> pelo local extraído do Dispatcher SDK e <path_to_dispatcher_src> pelo diretório src do Dispatcher do projeto. Defina DISPATCHER_CONFIG_PATH para a raiz de configuração que inclui os arquivos em que /docroot está definido. MCP_LOG_LEVEL e MCP_LOG_FILE são configurações opcionais de depuração. Se você vir client version 1.43 is too new, defina DOCKER_API_VERSION como 1.41. Se outros servidores MCP já estiverem configurados, adicione a entrada aem-dispatcher-mcp sem substituí-los. Reiniciar o cursor após salvar.

Outros IDEs podem ser configurados de maneira semelhante. O docs/DispatcherMCP.md do SDK inclui exemplos completos para Claude Desktop e o Código VS.

Ferramentas disponíveis available-tools-dispatcher

A superfície MCP expõe intencionalmente apenas essas sete ferramentas; as instruções e os recursos permanecem na camada de habilidade. A documentação de referência completa está disponível em docs/DispatcherMCP.md dentro do SDK extraído do Dispatcher.