Communitygithub.com

David-Li0406/meta-skill-evloving

B2C Commerce ストアフロントのテンプレート、フォーム、コンテンツをローカライズします。翻訳の追加、リソースバンドル(*.properties ファイル)、Resource.msg、またはマルチロケール対応の実装時に使用します。ロケールフォルダ、文字列の外部化、日付/通貨フォーマットをカバーします。

meta-skill-evloving とは?

このスキルは、Salesforce B2C Commerce プラットフォームでストアフロントを複数の言語や地域にローカライズするための包括的なガイドです。リソースバンドル(.properties ファイル)を使用したテンプレート、フォーム、静的コンテンツのローカライズ方法を詳細に説明しており、ISO 標準に基づくロケール形式(例:en_US、fr_CA)、ロケールフォールバックチェーン(fr_CA → fr → デフォルト)、そしてパラメータ化されたメッセージの使用法をカバーします。また、URL のローカライゼーション、言語スイッチャー、コントローラーでのロケールアクセス、メールテンプレート、通貨・日付フォーマットのベストプラクティスも含まれています。適用可能なツールとしては、ISML テンプレートや JavaScript コントローラーを使用するあらゆる 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に質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

プレビュー

スキル 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=My Account
account.greeting=Welcome back
account.logout=Sign Out

# ダッシュボード
dash lord.title=Dashboard
dash lord.orders=Order History
dash lord.addresses=Address Book
dash lord.wishlist=Wishlist

# プロフィール
profile.title=Profile
profile.firstName=First Name
profile.lastName=Last Name
profile.email=Email Address
profile.save=Save Changes

account_fr.properties(フランス語):

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

dash lord.title=Tableau de bord
dash lord.orders=Historique des commandes
dash lord.addresses=Carnet d'adresses
dash lord.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')}">商品を表示</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".

関連スキル