使用人工智能工具进行本地开发 local-development-with-ai-tools

AI编码代理（Claude Code、Cursor、GitHub Copilot和类似工具）对AEM的底层技术(Java、OSGi、Sling、JCR、HTL)具有广泛的了解，但不一定了解生成代码和配置或如何调试常见AEM开发问题的最佳实践。

有四个互补组件解决了这个问题：

查看AI辅助开发教程，以获取其他动手操作说明。

请随时发送电子邮件至aemcs-ai-ide-tools-feedback@adobe.com，并提供反馈以帮助制定产品开发。

AGENTS.md agentsmd

AGENTS.md是一个位于AEM项目根目录中的Markdown文件。 AI编码工具会在每个会话开始时自动加载此文件，以便通过基本的AEM Cloud Service Java栈栈域专业知识（而非AEM 6.5或Edge Delivery Services等其他AEM解决方案）置于基础。

AGENTS.md不是您复制的静态文件。 它由本文档下一部分中描述的ensure-agents-md技能生成。 该技能读取您的pom.xml以解析项目名称、发现模块并检测已安装的加载项，从而生成针对您的特定项目定制的文件。

座席技能 agent-skills

技能是用于对多步骤开发工作流进行编码的说明集。 在调用时，人工智能遵循该技能的程序，而不是仅依赖一般知识，产生一致、符合公约的结果。

Adobe在​ adobe/skills ​存储库中发布AEM as a Cloud Service技能：

安装技能 install-skills

选择与您的AI编码工具匹配的方法。 一旦安装技能，这些技能即可用于该计算机上的所有项目。 有关具体演练，请参阅设置AEM代理技能教程。

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

NPX技能 npx-skills

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

Upskill（GitHub CLI扩展） 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

使用Secure-agents-md技能 use-the-ensure-agents-md-skill

安装该技能后，在尚未具有AGENTS.md的任何AEM as a Cloud Service项目中打开您的AI助手。 该技能将在处理您的第一个请求之前自动运行，在项目根目录下创建这两个文件，而无需显式调用。

使用创建组件技能 use-the-create-component-skill

首次使用时，该技能将自动从pom.xml和现有组件中检测project、package和group，并要求您确认检测到的值。 然后在项目根目录下创建.aem-skills-config.yaml。 首次使用前无需手动配置。

如果您希望预创建文件，请将.aem-skills-config.yaml置于具有以下结构的项目根目录下：

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

文件位于技能目录之外，技能更新时永远不会覆盖该文件。

在AI聊天中描述组件：

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

代理会响应字段说明进行确认，然后生成所有组件文件。 支持的模式包括带有复合嵌套项的多字段、条件显示/隐藏逻辑、通过Sling资源合并器进行的核心组件扩展以及使用AEM Mocks的JUnit 5测试。 设计可以来自各种来源，包括文本描述、图像或使用Figma的MCP服务器的Figma设计URL。

按照使用AEM代理技能进行组件开发教程了解更多信息。

使用迁移技能 use-the-migration-skill

“migration”技能可指导代理将AEM Java代码和OSGi配置迁移到AEM as a Cloud Service。 它每次只处理一种模式：命名该模式（例如，scheduler或replication），将代理指向最佳实践分析器查找结果，并在项目中查找受影响的文件并批量应用正确的转换，在每次转换后暂停以供审阅。

支持的模式包括Sling Scheduler、ResourceChangeListener、Replication API、OSGi EventListener和EventHandler、Assets API、HTL lint修复以及使用Cloud Manager密钥和环境变量提取的OSGi配置转换。

技能与Cloud Migration MCP配对，以直接从Cloud Acceleration Manager获取调查结果。 如果未配置MCP，技能将回退到本地BPA CSV导出，或者您可以手动将其指向特定文件。

有关完整的设置说明和模式参考，请参阅AI辅助代码迁移到AEM as a Cloud Service。

使用Dispatcher技能 use-the-dispatcher-skill

调用任何Dispatcher或Apache HTTPD配置工作的Dispatcher技能。 该技能根据请求的性质将请求路由到六个专业子技能中的一个：

对于广泛或首次请求，从workflow-orchestrator子技能开始。 对于有针对性的工作，请向相应的专家描述具体的关切事项和技能途径。

Dispatcher技能处理编排和咨询指导。 下节中介绍的Dispatcher MCP服务器提供了该技能在需要本地证据时所使用的七种验证和运行时工具。

使用代码评估技能(Beta) use-the-code-assessment-skill

此功能是​测试版。 Adobe鼓励您通过电子邮件发送aemcs-ai-ide-tools-feedback@adobe.com来提出反馈，以影响产品开发。

Beta版本可能包含缺陷，并“按原样”提供，无任何类型的担保。 Adobe没有义务维护、更正、更新、更改、修改或以其他方式支持（通过Adobe支持服务或其他方式）Beta版。 Adobe建议客户谨慎使用，不要依赖测试版或随附的任何文档或材料的正确功能或性能。 Beta版中的功能和API如有更改，恕不另行通知。 因此，使用测试版完全由客户自行承担风险。

该code-assessment技能可完全在本地工作区中检测、查看和修复AEM as a Cloud Service项目中的代码质量和正确性问题。 描述问题，然后技能将请求路由到相应的修正工作流。

支持的检查包括更新Sling模型依赖项注入、更新过期的Maven依赖项、向出站HTTP调用添加缺失超时、边界无界查询、Sling调度程序、资源更改侦听器、复制和Assets API、JCR或OSGi事件处理，以及扫描和修复已弃用和已删除的AEM API的使用，并随着时间添加更多内容。 根据问题而定，该技能要么直接应用机械修复，要么指导您完成需要判断呼叫的修复。

对于广泛或首次审查，请要求技能人员评估整个项目：它运行每个检测器，报告所有调查结果，并一次应用一种代码修复模式。

要开始配置，请在AEM as a Cloud Service项目中打开一个新的代理聊天。

1. 审阅您的项目。 要求报告。 该技能运行其分析器并返回内联的调查结果（按模式和严重性分组），同时提供建议的补救计划。 此阶段不更改任何代码。

scan my AEM project and report any code-quality issues

要获得更明确的调用，请直接命名技能：

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

要关注单个模式，请在提示符下将其命名为：

scan my project for unbounded queries

2. 应用修复，一次一个模式。 要求技能人员固定特定模式。 它会进行外科手术编辑并验证其编译。 机械修复直接应用；引导式修复会指导您完成每个决策。

apply unbounded-query

它从不提交或推送 — 您查看差异并提交。 大型修复在可恢复的批次中运行；回复apply <pattern>以继续。

AEM快速入门MCP服务器 aem-quickstart-mcp-server

模型上下文协议(MCP)是一个开放标准，它允许AI编码工具连接到外部数据源和服务。 AEM快速入门MCP服务器是一个内容包，一旦安装在本地AEM SDK实例中，就会将运行时数据直接公开给连接的AI工具，使代理能够检索日志、诊断OSGi故障以及检查请求处理，而无需离开IDE。

安装内容包 install-the-content-package

从软件分发门户下载内容包，然后使用位于/crx/packmgr的包管理器将com.adobe.aem:com.adobe.aem.mcp-server-contribs-content安装到本地快速入门中。

兼容性：​已与AEM SDK 2026.2.24678.20260226T154829Z-260200及更高版本一起验证。

可用工具 available-tools

配置IDE configure-your-ide

光标 cursor

在光标设置中，添加新的自定义MCP服务器：

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

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

导航到​工具> GitHub Copilot >模型上下文协议(MCP)，然后单击​配置。 添加：

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

其他IDE other-ides

任何MCP客户端都可以指向带有Authorization: Basic YWRtaW46YWRtaW4=标头的http://localhost:4502/bin/mcp来连接。 使用IDE的MCP设置配置自定义标头。

Dispatcher MCP服务器 dispatcher-mcp-server

Dispatcher MCP服务器与AEM Dispatcher SDK捆绑在一起。 它使AI工具能够针对Docker中本地运行的Dispatcher实例验证Dispatcher和Apache HTTPD配置、跟踪请求处理和检查缓存行为。

与Dispatcher技能不同， Dispatcher MCP服务器仅公开工具：七个MCP工具，无提示或资源。

先决条件 prerequisites

安装Dispatcher SDK install-the-dispatcher-sdk

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

运行./bin/docker_run_mcp.sh help以检索复制粘贴IDE配置，运行./bin/docker_run_mcp.sh version以确认捆绑的MCP和SDK版本。 使用./bin/docker_run_mcp.sh diagnose调查连接问题。

配置光标 configure-cursor

将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>"
      }
    }
  }
}

将<path_to_dispatcher_sdk>替换为提取的Dispatcher SDK位置，将<path_to_dispatcher_src>替换为项目的调度程序src目录。 将DISPATCHER_CONFIG_PATH设置为包含定义/docroot的文件的配置根。 MCP_LOG_LEVEL和MCP_LOG_FILE是可选的调试设置。 如果您看到client version 1.43 is too new，请将DOCKER_API_VERSION设置为1.41。 如果已配置其他MCP服务器，请添加aem-dispatcher-mcp项而不替换它们。 保存后重新启动光标。

其他IDE也可以以类似的方式进行配置。 SDK的docs/DispatcherMCP.md包含Claude Desktop和VS代码的完整示例。

可用工具 available-tools-dispatcher

MCP表面仅有意公开这七种工具；提示和资源保留在技能层中。 在提取的Dispatcher SDK中的docs/DispatcherMCP.md中提供了完整的参考文档。