Développement local avec les outils d’IA local-development-with-ai-tools

Les agents de codage d’IA (Claude Code, Cursor, GitHub Copilot et outils similaires) disposent d’une connaissance approfondie des technologies sous-jacentes d’AEM (Java, OSGi, Sling, JCR, HTL), mais ne connaissent pas nécessairement les bonnes pratiques pour générer le code et la configuration, ni comment déboguer les problèmes de développement courants d’AEM.

Quatre composantes complémentaires abordent ce problème :

AGENTS.md agentsmd

AGENTS.md fichier Markdown se trouve à la racine de votre projet AEM et est chargé automatiquement par les outils de codage de l’IA au début de chaque session afin de reposer sur l’expertise essentielle du domaine Java-stack AEM Cloud Service (et non sur d’autres solutions AEM telles qu’AEM 6.5 ou Edge Delivery Services).

AGENTS.md n’est pas un fichier statique que vous copiez : il est généré par les compétences ensure-agents-md décrites dans la section suivante. Cette compétence lit votre pom.xml pour résoudre le nom du projet, découvrir des modules et détecter les modules complémentaires installés, afin de produire un fichier adapté à votre projet spécifique.

Compétences de l’agent agent-skills

Les compétences sont des ensembles d’instructions qui codent des workflows de développement à plusieurs étapes. Lorsqu’elle est invoquée, l’IA suit la procédure de la compétence plutôt que de se fier uniquement aux connaissances générales, produisant des résultats cohérents et conformes à la convention.

Adobe publie les compétences AEM as a Cloud Service dans le référentiel adobe/skills sur la branche beta, car cette fonctionnalité n’est pas encore disponible pour tous :

Installation des compétences install-skills

Sélectionnez la méthode qui correspond à votre outil de codage d’IA. L’installation des compétences les rend disponibles pour tous les projets sur cette machine.

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

Compétences Npx npx-skills

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

Compétences supérieures (extension de ligne de commande 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

Utiliser la compétence ensure-agents-md use-the-ensure-agents-md-skill

Après avoir installé la compétence, ouvrez votre assistant d’IA dans tout projet AEM Cloud Service qui n’a pas encore de AGENTS.md. La compétence s’exécute automatiquement avant le traitement de votre première requête, créant les deux fichiers à la racine du projet sans nécessiter d’appel explicite.

Utilisation de la compétence create-component use-the-create-component-skill

Lors de la première utilisation, la compétence détecte automatiquement les project, les package et les group des composants pom.xml et existants, vous demande de confirmer les valeurs détectées, puis crée des .aem-skills-config.yaml à la racine du projet. Aucune configuration manuelle n’est nécessaire avant la première utilisation.

Si vous préférez pré-créer le fichier, placez .aem-skills-config.yaml à la racine du projet avec la structure suivante :

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

Le fichier se trouve en dehors du répertoire des compétences et n’est jamais remplacé lorsque la compétence est mise à jour.

Décrivez le composant dans votre conversation avec l’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’agent fait écho à la spécification du champ pour confirmation, puis génère tous les fichiers de composant. Les modèles pris en charge comprennent les champs multiples avec des éléments imbriqués composites, la logique d’affichage/masquage conditionnel, l’extension des composants principaux via Sling Resource Merger et les tests JUnit 5 à l’aide de simulations AEM.

Utilisation des compétences Dispatcher use-the-dispatcher-skill

Appelez les compétences du Dispatcher pour toute tâche de configuration Dispatcher ou Apache HTTPD. Les compétences acheminent les requêtes vers l’une des six sous-compétences spécialisées selon la nature de la requête :

Pour les requêtes générales ou de première utilisation, commencez par la sous-compétence workflow-orchestrator. Pour un travail ciblé, décrivez le problème spécifique et les parcours d’acquisition des compétences au spécialiste approprié.

Les compétences du Dispatcher permettent de gérer l’orchestration et les conseils. Le serveur Dispatcher MCP, décrit ci-dessous, fournit les sept outils de validation et d’exécution que la compétence utilise lorsqu’elle a besoin de preuves locales.

Serveur MCP Quickstart AEM aem-quickstart-mcp-server

Le protocole MCP (Model Context Protocol) est une norme ouverte qui permet aux outils de codage de l’IA de se connecter à des sources de données et à des services externes. Le serveur AEM Quickstart MCP est un package de contenu qui, une fois installé dans une instance AEM SDK locale, expose directement les données d’exécution aux outils d’IA connectés. Les agents peuvent ainsi récupérer les journaux, diagnostiquer les échecs OSGi et inspecter le traitement des demandes sans quitter l’IDE.

Installation du package de contenu install-the-content-package

Téléchargez le package de contenu à partir du Portail de distribution logicielle et installez-com.adobe.aem:com.adobe.aem.mcp-server-contribs-content dans votre démarrage rapide local à l’aide du gestionnaire de packages sur /crx/packmgr.

Compatibilité : validée avec AEM SDK 2026.2.24678.20260226T154829Z-260200 et version ultérieure.

Outils disponibles available-tools

Configuration de votre IDE configure-your-ide

Curseur cursor

Dans les paramètres du curseur, ajoutez un nouveau serveur MCP personnalisé :

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

Copilote GitHub avec IntelliJ IDEA github-copilot-with-ihtellij-idea

Accédez à Outils > Copilote GitHub > Modèle de protocole contextuel (MCP) puis cliquez sur Configurer. Ajouter :

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

Autres IDE other-ides

Tout client MCP peut se connecter en pointant vers http://localhost:4502/bin/mcp avec un en-tête Authorization: Basic YWRtaW46YWRtaW4=. Configurez des en-têtes personnalisés à l’aide des paramètres MCP de votre IDE.

Serveur MCP Dispatcher dispatcher-mcp-server

Le serveur Dispatcher MCP est fourni avec AEM Dispatcher SDK. Il permet aux outils d’IA de valider la configuration Dispatcher et Apache HTTPD, de suivre la gestion des requêtes et d’inspecter le comportement du cache par rapport à une instance Dispatcher s’exécutant localement dans Docker.

Contrairement aux compétences du Dispatcher, le serveur MCP Dispatcher n’expose que les outils suivants : sept outils MCP et aucune invite ni ressource.

Conditions préalables prerequisites

Installation du SDK Dispatcher install-the-dispatcher-sdk

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

Exécutez ./bin/docker_run_mcp.sh help pour récupérer la configuration de l’IDE de copier-coller et ./bin/docker_run_mcp.sh version pour confirmer la version MCP et SDK groupées. Utilisez ./bin/docker_run_mcp.sh diagnose pour examiner les problèmes de connectivité.

Configurer le curseur configure-cursor

Ajoutez une entrée aem-dispatcher-mcp à ~/.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>"
      }
    }
  }
}

Remplacez <path_to_dispatcher_sdk> par l’emplacement du SDK Dispatcher extrait et <path_to_dispatcher_src> par le répertoire de src du Dispatcher du projet. Définissez DISPATCHER_CONFIG_PATH sur la racine de configuration qui inclut les fichiers dans lesquels /docroot est défini. MCP_LOG_LEVEL et MCP_LOG_FILE sont des paramètres de débogage facultatifs. Si vous voyez client version 1.43 is too new, définissez DOCKER_API_VERSION sur 1.41. Si d’autres serveurs MCP sont déjà configurés, ajoutez l’entrée aem-dispatcher-mcp sans les remplacer. Redémarrez le curseur après l'enregistrement.

D’autres IDE peuvent être configurés de la même manière. Le docs/DispatcherMCP.md SDK comprend des exemples complets pour Claude Desktop et VS Code.

Outils disponibles available-tools-dispatcher

La surface MCP n’expose intentionnellement que ces sept outils ; les invites et les ressources restent dans la couche de compétences. La documentation de référence complète est disponible en docs/DispatcherMCP.md dans le SDK Dispatcher extrait.