使用AI工具進行本機開發 local-development-with-ai-tools

AI編碼代理程式（Claude Code、Cursor、GitHub Copilot和類似工具）對AEM的基礎技術(Java、OSGi、Sling、JCR、HTL)有廣泛的瞭解，但不一定知道產生程式碼和設定的最佳實務，或如何偵錯常見的AEM開發問題。

有四個補充元件可解決此問題：

AGENTS.md agentsmd

AGENTS.md是位於AEM專案根目錄的Markdown檔案，AI編碼工具會在每個工作階段開始時自動載入，以便以基本的AEM Cloud Service Java棧疊網域專業知識為基礎（而不是其他AEM解決方案，例如AEM 6.5或Edge Delivery Services）。

AGENTS.md不是您複製的靜態檔案 — 它是由下一節中說明的ensure-agents-md技能產生的。 此技能會讀取您的pom.xml來解析專案名稱、探索模組，以及偵測已安裝的附加元件，產生針對您特定專案量身打造的檔案。

代理程式技能 agent-skills

技能是編碼多步驟開發工作流程的指示集。 經叫用時，AI會遵循技能的程式，而非僅依賴一般知識，以產生一致、符合慣例的結果。

Adobe已在​分支上的adobe/skillsbeta存放庫中發佈AEM as a Cloud Service技能，因為此功能尚未普遍可用：

安裝技能 install-skills

選擇與您的AI編碼工具相符的方法。 一旦安裝技能，即可供該電腦上的所有專案使用。

克勞德程式碼 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

Npx技能 npx-skills

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

提升技能（GitHub CLI擴充功能） 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

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

安裝技能後，在尚未有AGENTS.md的任何AEM Cloud Service專案中開啟您的AI助理。 此技能會在處理您的第一個要求之前自動執行，在專案根目錄建立兩個檔案時不需要明確叫用。

使用建立元件技能 use-the-create-component-skill

第一次使用時，技能會自動從project和現有元件中偵測package、group和pom.xml，要求您確認偵測到的值，然後在專案根目錄中建立.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 Resource Merger的核心元件擴充功能，以及使用AEM Mocks的JUnit 5測試。

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

叫用任何Dispatcher或Apache HTTPD設定工作的Dispatcher技能。 此技能會根據請求的性質，將請求路由到六個專業子技能中的一個：

若是廣泛或首次要求，請從workflow-orchestrator子技能開始。 針對鎖定目標工作，請向適當的專員說明特定的關注事項和技能路線。

Dispatcher技能可處理協調和建議指導。 Dispatcher MCP伺服器（如下所述）提供技能在需要本機證據時所使用的七項驗證和執行階段工具。

AEM快速入門MCP伺服器 aem-quickstart-mcp-server

模型上下文通訊協定(MCP)是一種開放標準，允許AI編碼工具連線到外部資料來源和服務。 AEM Quickstart MCP伺服器是一個內容套件，一旦安裝在本機AEM SDK執行個體中，就會將執行階段資料直接公開給連線的AI工具，讓代理程式能夠擷取記錄、診斷OSGi失敗並在不離開IDE的情況下檢查請求處理。

安裝內容封裝 install-the-content-package

從軟體發佈入口網站下載內容封裝，並在com.adobe.aem:com.adobe.aem.mcp-server-contribs-content使用封裝管理員將/crx/packmgr安裝至您的本機Quickstart。

相容性：​已透過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使用者端都可以指向帶有http://localhost:4502/bin/mcp標頭的Authorization: Basic YWRtaW46YWRtaW4=來連線。 使用IDE的MCP設定來設定自訂標頭。

Dispatcher MCP伺服器 dispatcher-mcp-server

Dispatcher MCP伺服器與AEM Dispatcher SDK搭配。 它可讓AI工具驗證Dispatcher和Apache HTTPD設定、追蹤請求處理，以及針對Docker中本機執行的Dispatcher執行個體檢查快取行為。

不像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>"
      }
    }
  }
}

以擷取的Dispatcher SDK位置取代<path_to_dispatcher_sdk>，並以專案的Dispatcher <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 Code的完整範例。

可用工具 available-tools-dispatcher

MCP表面僅會刻意公開這七種工具；提示和資源會保留在技能層中。 擷取的Dispatcher SDK內的docs/DispatcherMCP.md中有完整的參考檔案。