Communitygithub.com

David-Li0406/meta-skill-evloving

B2C Commerce에서 템플릿, 양식, 콘텐츠를 현지화합니다. 번역 추가, 리소스 번들(*.properties 파일) 작업, Resource.msg 사용, 또는 다중 로케일 지원 구현 시 사용하세요. 로케일 폴더, 문자열 외부화, 날짜/통화 형식 지정을 다룹니다.

meta-skill-evloving란 무엇인가요?

이 스킬은 B2C Commerce 스토어프론트를 다양한 언어와 지역으로 현지화하는 방법을 안내합니다. 템플릿, 양식, 정적 콘텐츠, 제품 데이터 등 모든 현지화 구성 요소를 다루며, 단일 템플릿 세트에 리소스 번들을 결합하는 접근 방식을 설명합니다. 주요 기능으로는 ISO 표준 로케일 형식(예: en_US, fr_CA), 계층적 리소스 번들 디렉토리 구조, ISML 템플릿에서 Resource.msg() 및 Resource.msgf()를 사용한 매개변수화된 메시지, 로케일 폴백 체인(fr_CA → fr → 기본값), 정적 파일 현지화, 양식 필드 레이블 및 오류 메시지 현지화를 포함합니다. 또한 컨트롤러에서 현재 로케일 접근, 로케일별 날짜/통화 형식 지정, 현지화된 이메일 템플릿 전송, 언어 전환기를 위한 로케일 인식 URL 생성을 다룹니다. 이 스킬은 UTF-8 인코딩, 페이지/기능별 번들 구성, 설명적인 키 이름 사용, 동적 값에 문자열 연결 대신 매개변수 사용 등 모범 사례를 강조합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/David-Li0406/meta-skill-evloving/tree/HEAD/skill-flow/data/skills-refined-36k/skillsmp/b2c-localization

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

미리보기

스킬 README에서

meta-skill-evloving preview

문서

현지화 스킬

이 스킬은 여러 언어와 지역에 맞게 B2C Commerce 스토어프론트를 현지화하는 방법을 안내합니다.

개요

B2C Commerce는 다음을 통해 현지화를 지원합니다:

구성 요소접근 방식
템플릿단일 템플릿 세트 + 리소스 번들
양식공유 정의 + 로케일별 레이블
정적 콘텐츠로케일별 폴더
제품 데이터현지화 가능 속성

로케일 형식

로케일은 ISO 표준을 따릅니다: {language}_{country}

형식예시설명
en영어언어만
en_US영어/미국언어 + 국가
fr_CA프랑스어/캐나다언어 + 국가
de_DE독일어/독일언어 + 국가

리소스 번들

디렉토리 구조

/cartridge
    /templates
        /resources
            account.properties          # 기본값 (영어)
            checkout.properties
            /fr
                account.properties      # 프랑스어
                checkout.properties
            /de
                account.properties      # 독일어
                checkout.properties
            /fr_CA
                account.properties      # 프랑스어(캐나다)

속성 파일 형식

account.properties (기본값):

##############################################
# 계정 페이지
##############################################
account.title=내 계정
account.greeting=다시 오신 것을 환영합니다
account.logout=로그아웃

# 대시보드
dashoboard.title=대시보드
dashoboard.orders=주문 내역
dashoboard.addresses=주소록
dashoboard.wishlist=위시리스트

# 프로필
profile.title=프로필
profile.firstName=이름
profile.lastName=성
profile.email=이메일 주소
profile.save=변경 사항 저장

account_fr.properties (프랑스어):

account.title=Mon compte
account.greeting=Bon retour
account.logout=Se déconnecter

dashoboard.title=Tableau de bord
dashoboard.orders=Historique des commandes
dashoboard.addresses=Carnet d'adresses
dashoboard.wishlist=Liste de souhaits

profile.title=Profil
profile.firstName=Prénom
profile.lastName=Nom
profile.email=Adresse e-mail
profile.save=Enregistrer les modifications

템플릿에서 리소스 사용

<!-- 간단한 메시지 -->
<h1>${Resource.msg('account.title', 'account', null)}</h1>

<!-- 대체 값 포함 -->
<p>${Resource.msg('account.greeting', 'account', 'Welcome')}</p>

<!-- 매개변수 포함 -->
<p>${Resource.msgf('cart.items', 'cart', null, cartCount)}</p>

Resource.msg() 매개변수:

  1. 키 이름
  2. 번들 이름 (확장자를 제외한 파일명)
  3. 기본값 (null = 키를 찾을 수 없으면 키 사용)

매개변수화된 메시지

속성:

cart.itemCount=장바구니에 {0}개의 항목이 있습니다
greeting.personalized=안녕하세요, {0} {1}님!
order.confirmation=주문 #{0} (날짜: {1})

템플릿:

${Resource.msgf('cart.itemCount', 'cart', null, itemCount)}
${Resource.msgf('greeting.personalized', 'common', null, firstName, lastName)}

로케일 폴백

B2C Commerce는 폴백 체인을 사용합니다: fr_CA → fr → 기본값

예시: fr_CA 요청 시:

  1. /resources/fr_CA/account.properties에서 찾기
  2. 없으면 /resources/fr/account.properties에서 찾기
  3. 없으면 /resources/account.properties에서 찾기

정적 파일

디렉토리 구조

/cartridge
    /static
        /default
            /css
                style.css
            /images
                logo.png
                buttons/
                    submit.png
            /js
                main.js
        /fr
            /images
                buttons/
                    submit.png      # 버튼에 프랑스어 텍스트
        /de
            /images
                buttons/
                    submit.png      # 버튼에 독일어 텍스트

정적 파일 참조

<!-- 로케일별 버전이 있으면 사용 -->
<img src="${URLUtils.staticURL('/images/buttons/submit.png')}" alt="제출"/>

<!-- CSS (보통 현지화되지 않음) -->
<link rel="stylesheet" href="${URLUtils.staticURL('/css/style.css')}"/>

양식 현지화

양식 정의

<?xml version="1.0" encoding="UTF-8"?>
<form xmlns="http://www.demandware.com/xml/form/2008-04-19">
    <field formid="email" label="form.email.label" type="string"
           mandatory="true"
           missing-error="form.email.required"
           parse-error="form.email.invalid"/>
</form>

리소스 번들

forms.properties:

form.email.label=이메일 주소
form.email.required=이메일은 필수입니다
form.email.invalid=유효한 이메일 주소를 입력하세요

forms_fr.properties:

form.email.label=Adresse e-mail
form.email.required=L'email est requis
form.email.invalid=Veuillez entrer une adresse e-mail valide

URL 현지화

로케일 인식 URL

<!-- 현재 로케일 URL -->
<a href="${URLUtils.url('Product-Show', 'pid', 'ABC123')}">제품 보기</a>

<!-- 특정 로케일 URL -->
<a href="${URLUtils.url(new URLAction('Product-Show', 'MySite', 'fr'))}">
    Voir le produit
</a>

언어 전환기

<isscript>
    var Site = require('dw/system/Site');
    var URLAction = require('dw/web/URLAction');
    var URLUtils = require('dw/web/URLUtils');
    var Locale = require('dw/util/Locale');
</isscript>

<ul class="language-switcher">
    <isloop items="${Site.current.allowedLocales}" var="localeId">
        <isscript>
            var locale = new Locale(localeId);
            var url = URLUtils.url(new URLAction('Home-Show', Site.current.ID, localeId));
        </isscript>
        <li class="${request.locale == localeId ? 'active' : ''}">
            <a href="${url}">${locale.displayLanguage}</a>
        </li>
    </isloop>
</ul>

컨트롤러 현지화

현재 로케일 접근

var Locale = require('dw/util/Locale');

server.get('Show', function (req, res, next) {
    var currentLocale = Locale.getLocale(req.locale.id);

    res.render('mytemplate', {
        locale: req.locale.id,
        language: currentLocale.language,
        country: currentLocale.country,
        displayLanguage: currentLocale.displayLanguage,
        displayCountry: currentLocale.displayCountry
    });
    next();
});

로케일별 로직

server.get('Checkout', function (req, res, next) {
    var locale = req.locale.id;

    // 로케일별 날짜 형식
    var dateFormat = locale.startsWith('en_US') ? 'MM/dd/yyyy' : 'dd/MM/yyyy';

    // 로케일별 콘텐츠
    var termsContentId = 'terms-' + locale.replace('_', '-').toLowerCase();

    res.render('checkout', {
        dateFormat: dateFormat,
        termsContentId: termsContentId
    });
    next();
});

이메일 템플릿

로케일 설정

var Template = require('dw/util/Template');
var HashMap = require('dw/util/HashMap');
var Mail = require('dw/net/Mail');

function sendOrderConfirmation(order, locale) {
    var template = new Template('mail/orderconfirmation', locale);
    var model = new HashMap();
    model.put('order', order);

    var content = template.render(model).text;

    var mail = new Mail();
    mail.addTo(order.customerEmail);
    mail.setFrom('[email protected]');
    mail.setSubject(Resource.msg('email.order.subject', 'email', null));
    mail.setContent(content, 'text/html', 'UTF-8');
    mail.send();
}

통화 형식 지정

통화는 로케일에 연결됩니다:

var Money = require('dw/value/Money');
var StringUtils = require('dw/util/StringUtils');

// 로케일로 형식 지정
var price = new Money(99.99, 'USD');
var formatted = StringUtils.formatMoney(price);  // 현재 로케일 사용

// 템플릿에서
<isprint value="${product.priceModel.price}" style="CURRENCY"/>

날짜 형식 지정

var StringUtils = require('dw/util/StringUtils');
var Calendar = require('dw/util/Calendar');

var date = new Calendar();
var formatted = StringUtils.formatCalendar(date, 'yyyy-MM-dd');  // ISO 형식
var localized = StringUtils.formatCalendar(date, 'MMMM d, yyyy');  // 로케일 인식

모범 사례

  1. UTF-8 사용 - 모든 속성 파일에 대해 (비ASCII 문자 필수)
  2. 페이지/기능별로 번들 구성 - 언어별로 구성하지 마세요
  3. 키를 설명적으로 유지 - label1 대신 account.profile.firstName
  4. 동적 값에 매개변수 사용 - 문자열을 연결하지 마세요
  5. 모든 로케일 테스트 - 폴백이 올바르게 작동하는지 확인
  6. 템플릿이나 스크립트에 텍스트 하드코딩 금지

상세 참고

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

David-Li0406/meta-skill-evloving

Browser automation with persistent page state. Use when users ask to navigate websites, fill forms, take screenshots, extract web data, test web apps, or automate browser workflows. Trigger phrases include "go to [url]", "click on", "fill out the form", "take a screenshot", "scrape", "automate", "test the website", "log into", or any browser interaction request.

David-Li0406/meta-skill-evloving

Create technical diagrams using Mermaid syntax for architecture, sequences, ERDs, flowcharts, and state machines. Use for visualizing system design, data flows, and processes. Triggers: diagram, mermaid, architecture diagram, sequence diagram, flowchart, ERD, entity relationship, state diagram, C4 model, component diagram, visualize, draw.

David-Li0406/meta-skill-evloving

Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks

David-Li0406/meta-skill-evloving

Complete color manipulation and green screen effects system. PROACTIVELY activate for: (1) Green screen/chromakey removal, (2) Color grading with LUTs, (3) Color correction (levels, curves, white balance), (4) Colorkey/color removal effects, (5) Hue/saturation manipulation, (6) Color space conversions (BT.709, BT.2020, HDR), (7) Color isolation effects, (8) Teal and orange look, (9) Vintage/film looks, (10) Color keying for transparency. Provides: chromakey and colorkey filters, LUT application (lut3d), curves and levels adjustment, color balance, selective color manipulation, color space handling, HDR tone mapping, professional color grading chains.

David-Li0406/meta-skill-evloving

Convert files and office documents to Markdown. Supports PDF, DOCX, PPTX, XLSX, images (with OCR), audio (with transcription), HTML, CSV, JSON, XML, ZIP, YouTube URLs, EPubs and more.

David-Li0406/meta-skill-evloving

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

David-Li0406/meta-skill-evloving

Build with OpenAI's stateless APIs - Chat Completions (GPT-5, GPT-4o), Embeddings, Images (DALL-E 3), Audio (Whisper + TTS), and Moderation. Includes Node.js SDK and fetch-based approaches for Cloudflare Workers. Use when: implementing chat completions with GPT-5/GPT-4o, streaming responses with SSE, using function calling/tools, creating structured outputs with JSON schemas, generating embeddings for RAG (text-embedding-3-small/large), generating images with DALL-E 3, editing images with GPT-Image-1, transcribing audio with Whisper, synthesizing speech with TTS (11 voices), moderating content (11 safety categories), or troubleshooting rate limits (429), invalid API keys (401), function calling failures, streaming parse errors, embeddings dimension mismatches, or token limit exceeded.

David-Li0406/meta-skill-evloving

Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.

David-Li0406/meta-skill-evloving

Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks

David-Li0406/meta-skill-evloving

Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis, and visualization. When Claude needs to work with spreadsheets (.xlsx, .xlsm, .csv, .tsv, etc) for: (1) Creating new spreadsheets with formulas and formatting, (2) Reading or analyzing data, (3) Modify existing spreadsheets while preserving formulas, (4) Data analysis and visualization in spreadsheets, or (5) Recalculating formulas

David-Li0406/meta-skill-evloving

Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.

David-Li0406/meta-skill-evloving

Best practices for Remotion - Video creation in React

David-Li0406/meta-skill-evloving

Provides bidirectional translation (Chinese/English), grammar checking, and sentence polishing. Supports specific tense constraints, context-aware tone adjustment, and natural expression optimization. Outputs direct text without formatting.

David-Li0406/meta-skill-evloving

指导如何通过自定义注解(如@Unicom)标识Dubbo接口,利用BeanDefinitionRegistryPostProcessor在启动时扫描并动态注册ReferenceBean,实现RPC调用的封装。

David-Li0406/meta-skill-evloving

生成Python脚本,利用FFmpeg将图片序列按3x3布局合并,或将合并图拆分。要求使用subprocess模块执行命令,并支持用户交互式输入路径。

David-Li0406/meta-skill-evloving

SOP for extracting and analyzing promotional activity details, handling time formatting, location mapping, payment logic, and step-by-step process validation.

David-Li0406/meta-skill-evloving

Specializes in creating TikTok short video scripts using an anthropomorphic 'Chef' perspective to explain wildlife food chains and survival environments, utilizing real field footage.

David-Li0406/meta-skill-evloving

针对TikTok平台,以拟人化视角(如动物作为厨师)创作系列短视频脚本。重点介绍野生动物、食物链及生态环境,要求使用野外实拍素材,风格幽默且具有教育意义。

David-Li0406/meta-skill-evloving

Generates KWL (Know, Want to know, Learned) charts for educational videos, specifically BrainPOP, using simple 7th-grade language and short, concise bullet points.

David-Li0406/meta-skill-evloving

Tracks complex, multi-session work using the Beads issue tracker and dependency graphs, and provides persistent memory that survives conversation compaction. Use when work spans multiple sessions, has complex dependencies, or needs persistent context across compaction cycles. Trigger with phrases like "create task for", "what's ready to work on", "show task", "track this work", "what's blocking", or "update status".

관련 스킬