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

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

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

請檢閱AI輔助開發教學課程，以取得其他動手操作說明。

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/skills ​存放庫中發佈AEM as a Cloud Service技能：

安裝技能 install-skills

選擇與您的AI編碼工具相符的方法。 一旦安裝技能，即可供該電腦上的所有專案使用。 請參閱設定AEM代理程式技能教學課程，以取得具體逐步解說。

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

提升技能（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 Resource Merger的核心元件擴充功能，以及使用AEM Mocks的JUnit 5測試。 設計可來自各種來源，包括文字說明、影像或使用Figma MCP伺服器的Figma設計URL。

依照使用AEM Agent技能的元件開發教學課程，以瞭解更多資訊。

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

「migration」技能會引導代理程式完成將AEM Java程式碼和OSGi設定移轉到AEM as a Cloud Service的程式。 它一次只能運作一個模式：您命名模式（例如，scheduler或replication），將代理程式指向您的Best Practices Analyzer發現，它會在您的專案中找出受影響的檔案，並批次套用正確的轉換，並在每個轉換之後暫停以供您檢閱。

支援的模式包括Sling Scheduler、ResourceChangeListener、Replication API、OSGi EventListener和EventHandler、Assets API、HTL Lint修正，以及使用Cloud Manager密碼和環境變數擷取的OSGi設定轉換。

技能與雲端移轉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伺服器（如下節所述）提供技能在需要本機證據時所使用的七種驗證和執行階段工具。

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

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

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

從軟體發佈入口網站下載內容封裝，並在/crx/packmgr使用封裝管理員將com.adobe.aem:com.adobe.aem.mcp-server-contribs-content安裝至您的本機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使用者端都可以指向帶有Authorization: Basic YWRtaW46YWRtaW4=標頭的http://localhost:4502/bin/mcp來連線。 使用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 src目錄取代<path_to_dispatcher_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中有完整的參考檔案。