AgentSkillsCN

magento-luma-specialist

对 Magento 默认的 Luma 主题进行个性化定制与功能扩展。无论是使用 Luma 主题、进行 LESS 预处理、配置 RequireJS 模块、开发 KnockoutJS 组件，还是沿用传统的 Magento 前端架构，本技能都能助您灵活运用 LESS 变量、配置 RequireJS，以及实现响应式设计。

SKILL.md
--- frontmatter
name: magento-luma-specialist
description: Customizes and extends Magento's default Luma theme. Use when working with Luma theme, LESS preprocessing, RequireJS modules, KnockoutJS components, or traditional Magento frontend architecture. Masters LESS variables, RequireJS configuration, and responsive design.

Magento 2 Luma Specialist

Expert specialist in creating sophisticated customizations and extensions to Magento's default Luma theme, leveraging traditional Magento frontend technologies while maintaining compatibility and performance.

When to Use

  • •Customizing Luma theme
  • •Working with LESS preprocessing
  • •Developing RequireJS modules
  • •Building KnockoutJS components
  • •Implementing traditional Magento frontend patterns

Luma Theme Architecture

  • •Theme Inheritance: Master Luma's parent-child theme structure and fallback mechanisms
  • •LESS Architecture: Expert in Luma's LESS variable system and mixins
  • •RequireJS Integration: Advanced module loading and dependency management
  • •KnockoutJS Components: Build dynamic UI components and data binding
  • •Layout System: Deep understanding of XML layout instructions and containers

Traditional Magento Frontend Stack

  • •LESS Preprocessing: Advanced LESS compilation and optimization
  • •RequireJS: Asynchronous module loading and configuration
  • •KnockoutJS: MVVM pattern implementation for dynamic interfaces
  • •jQuery: Legacy JavaScript functionality and plugin integration
  • •UI Components: Magento's knockout-based UI component library

Luma Development Process

1. Theme Setup & Customization

  • •Child Theme Creation: Set up proper theme inheritance structure
  • •Variable Customization: Modify LESS variables for brand consistency
  • •Layout Modifications: Customize page layouts and component placement
  • •Template Overrides: Create custom template files while maintaining upgradability
  • •Asset Organization: Organize custom CSS, JavaScript, and images

2. LESS Development

  • •Variable Management: Efficiently manage theme variables and overrides
  • •Mixin Development: Create custom mixins for repeated patterns
  • •Component Styling: Style individual components with BEM methodology
  • •Responsive Patterns: Implement consistent responsive design patterns
  • •Performance Optimization: Optimize compiled CSS output

3. JavaScript Development

  • •RequireJS Modules: Create custom JavaScript modules and widgets
  • •KnockoutJS Components: Build interactive UI components
  • •jQuery Integration: Integrate jQuery plugins and custom functionality
  • •Event Handling: Implement proper event delegation and management
  • •AJAX Implementation: Create seamless AJAX interactions

4. UI Components Integration

  • •Custom Components: Build custom UI components using Magento's framework
  • •Component Configuration: Configure existing components for specific needs
  • •Data Binding: Implement sophisticated data binding patterns
  • •Validation: Create custom validation rules and messages
  • •Form Handling: Enhance form functionality and user experience

LESS Mastery

Advanced Variables

  • •Implement complex variable systems and calculations
  • •Use LESS functions for dynamic values
  • •Create theme-specific variable overrides
  • •Manage variable inheritance and scope

Mixins & Functions

  • •Create reusable mixins for common patterns
  • •Use LESS functions for calculations
  • •Implement responsive mixins
  • •Build component-specific mixins

RequireJS Development

Module Configuration

  • •Configure RequireJS for optimal loading
  • •Manage module dependencies
  • •Create custom module paths
  • •Optimize module loading order

Widget Development

  • •Create Magento widgets
  • •Implement widget initialization
  • •Handle widget options and configuration
  • •Build reusable widget patterns

KnockoutJS Components

Component Development

  • •Build KnockoutJS components
  • •Implement data binding
  • •Handle component communication
  • •Create reusable component patterns

Data Binding

  • •Two-way data binding
  • •Computed observables
  • •Observable arrays
  • •Custom bindings

Best Practices

Performance

  • •Asset Optimization: Minimize and compress CSS/JS files
  • •Lazy Loading: Implement lazy loading for images and content
  • •Caching: Leverage browser and CDN caching
  • •Code Splitting: Split JavaScript into logical chunks

Code Organization

  • •Modular Structure: Organize code in logical modules
  • •BEM Methodology: Use BEM for CSS class naming
  • •Component Reusability: Create reusable components
  • •Documentation: Maintain clear documentation

References

Focus on creating maintainable Luma customizations that leverage Magento's traditional frontend architecture effectively.