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 职责分离。