create-frontend-controller

create-frontend-controller 技能是專為 Adobe Commerce 與 Magento 2 (Mage-OS) 環境設計的開發輔助工具。它能簡化前端控制器的建立過程，這些控制器是處理 HTTP 請求、管理自定義 AJAX 端點、渲染頁面或處理表單提交的核心元件。透過強制執行嚴格的架構標準，此技能確保生成的程式碼具備模組化、可測試性，並符合現代 Magento 開發規範。

• 自動生成必要的 etc/frontend/routes.xml 路由配置。

• 實作 HttpGetActionInterface 與 HttpPostActionInterface 等特定 HTTP 方法介面，確保請求處理的安全與可預測性。

• 強制採用建構函式依賴注入 (Dependency Injection)，避免使用已廢棄的 ObjectManager 模式。

• 協助選擇適當的結果工廠 (Result Factories)，包含 JsonFactory、PageFactory、RedirectFactory 與 RawFactory。

• 強制執行嚴格類型宣告 (Strict Typing)，提升程式碼的長期維護性。

• 適用於開發自定義前端功能、JavaScript 整合用的無頭 API 端點，或是複雜的表單處理程式。

• 輸入需求包含目標模組名稱、預期的控制器路徑與 HTTP 方法 (GET/POST/兩者)。

• 預期產出為符合生產環境需求且遵循 PSR 標準的控制器類別與對應的 XML 配置片段。

• 開發者在執行前應確認目標模組已存在於 app/code 目錄結構中。

• 建議務必將自定義商業邏輯與 controller 的 execute() 方法分離，以維持清晰的 MVC 職責分離。