Communitygithub.com

David-Li0406/meta-skill-evloving

本地化 B2C Commerce 中的樣板、表單與內容。適用於新增翻譯、處理資源套件 (*.properties 檔案)、使用 Resource.msg,或實作多語言支援的情境。涵蓋語言區域資料夾、字串外部化與日期/貨幣格式化。

meta-skill-evloving 是什麼?

此技能專門用於引導開發者在 Salesforce B2C Commerce 平台上進行完整的本地化實作。它涵蓋了多語言與多地區店面支援的核心技術,包括如何建立與組織資源套件(.properties 檔案)、在 ISML 樣板中使用 Resource.msg 與 Resource.msgf 方法來提取翻譯字串、以及處理語言區域的後備(fallback)機制(例如 fr_CA → fr → default)。 此外,該技能也詳細說明了表單定義的本地化(透過 form XML 與 properties 檔案)、靜態檔案(如圖片與 CSS)的區域特定目錄結構、以及透過 URLUtils 和 Locale API 建立語言切換器與區域感知邏輯的控制器程式碼。最後,它涵蓋了貨幣與日期的格式化實務,並提供了最佳實踐,例如使用 UTF-8 編碼、按頁面/功能而非語言組織套件、並避免在樣板中硬編碼文字。此技能主要適用於 B2C Commerce 的開發者、架構師與技術專案經理。

相容平台~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 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

預覽

來自技能 README

meta-skill-evloving preview

說明文件

本地化技能

此技能指導您如何在 B2C Commerce 中為多語言與多地區店面進行本地化。

概述

B2C Commerce 透過以下元件支援本地化:

元件方式
樣板單一樣板組 + 資源套件
表單共享定義 + 區域特定標籤
靜態內容區域特定資料夾
產品資料可本地化的屬性

語言區域格式

語言區域遵循 ISO 標準:{language}_{country}

格式範例說明
enEnglish僅語言
en_USEnglish/USA語言 + 國家
fr_CAFrench/Canada語言 + 國家
de_DEGerman/Germany語言 + 國家

資源套件

目錄結構

/cartridge
    /templates
        /resources
            account.properties          # 預設 (English)
            checkout.properties
            /fr
                account.properties      # French
                checkout.properties
            /de
                account.properties      # German
                checkout.properties
            /fr_CA
                account.properties      # French Canadian

屬性檔案格式

account.properties (預設):

##############################################
# Account Pages
##############################################
account.title=My Account
account.greeting=Welcome back
account.logout=Sign Out

# Account Dashboard
dash.oard.title=Dashboard
dash.oard.orders=Order History
dash.oard.addresses=Address Book
dash.oard.wishlist=Wishlist

# Profile
profile.title=Profile
profile.firstName=First Name
profile.lastName=Last Name
profile.email=Email Address
profile.save=Save Changes

account_fr.properties (French):

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

dash.oard.title=Tableau de bord
dash.oard.orders=Historique des commandes
dash.oard.addresses=Carnet d'adresses
dash.oard.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=You have {0} items in your cart
greeting.personalized=Hello, {0} {1}!
order.confirmation=Order #{0} placed on {1}

樣板:

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

語言區域後備

B2C Commerce 使用後備鏈:fr_CA → fr → default

範例: 請求 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="Submit"/>

<!-- 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=Email Address
form.email.required=Email is required
form.email.invalid=Please enter a valid email address

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')}">View Product</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. 保持鍵名具描述性 - account.profile.firstName 而非 label1
  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".

相關技能