Communitygithub.com

diegosouzapw/awesome-omni-skills

i18n 與本地化工作流程技能。當使用者需要國際化與本地化模式時使用此技能,包括偵測硬編碼字串、管理翻譯、語言環境檔案、RTL 支援,操作者應在合併或交接前保留上游工作流程、複製的支援檔案與出處記錄。

awesome-omni-skills 是什麼?

這個技能封裝了來自上游儲存庫 `antigravity-awesome-skills` 中的 `i18n-localization` 工作流程,並將其轉換為 Omni Skills 的編輯格式,同時保留其原始出處。它主要用於需要保持上游工作流程完整性的情境,例如在進行驗證或增強處理時,確保複製的檔案和元資料不被修改。技能支援多種平台與框架,包括 React、Next.js 和 Python,並提供了豐富的範例、最佳實踐、檔案結構建議及 RTL 支援說明。透過 `metadata.json` 中的 `external_source` 區塊和 `ORIGIN.md` 檔案,它建立了清晰的稽核軌跡,讓操作者可以追溯來源並選擇性地載入必要的支援檔案,從而實現漸進式揭露,避免一次載入整個套件。

相容平台✓Claude Code✓Codex CLI✓Cursor✓Antigravity✓Gemini CLI✓OpenCode
npx skills add https://github.com/diegosouzapw/awesome-omni-skills/tree/HEAD/skills/i18n-localization

在你喜歡的 AI 中提問

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

說明文件

i18n 與本地化

概述

此公開複本將 https://github.com/sickn33/antigravity-awesome-skills 中的 plugins/antigravity-awesome-skills-claude/skills/i18n-localization 包裝為原生 Omni Skills 的編輯形式,同時保留其原始出處。

當操作者需要在公開驗證器和私有增強器繼續正常下游流程的同時,保持上游工作流程、支援檔案和儲存庫上下文完整無缺時使用此技能。

這個複本會保持複製的上游檔案完整無缺,並使用 metadata.json 中的 external_source 區塊和 ORIGIN.md 作為供審查的出處錨點。

i18n 與本地化 > 國際化 (i18n) 與本地化 (L10n) 最佳實務。 ---

未完全對應到公開標題的匯入來源章節仍保留在下方或支援檔案中。值得注意的匯入章節:1. 核心概念, 3. 實作模式, 4. 檔案結構, 6. 常見問題, 7. RTL 支援, 8. 檢查清單。

何時使用此技能

將此章節用作觸發篩選器。它應在操作者載入檔案、執行命令或開啟拉取請求之前,明確界定啟用範圍。

  • 專案類型 - 需要 i18n?
  • 公開網頁應用程式 - ✅ 是
  • SaaS 產品 - ✅ 是
  • 內部工具 - ⚠️ 可能
  • 單一區域應用程式 - ⚠️ 考量未來
  • 個人專案 - ❌ 可選

操作表

情況從此開始為何重要
首次使用metadata.json在觸碰複製的工作流程前,透過 external_source 區塊確認儲存庫、分支、提交和匯入路徑
出處審查ORIGIN.md為審查者提供匯入來源的純文字稽核軌跡
工作流程執行scripts/i18n_checker.py從影響執行結果的最小複製檔案開始
支援上下文scripts/i18n_checker.py在不載入整個套件的情況下,新增下一個最相關的複製來源檔案
交接決策## 相關技能當任務偏離時,協助操作者切換到更合適的原生技能

工作流程

此工作流程刻意同時具備編輯和操作性質。它在滿足下游增強器流程所需的公開接收標準的同時,讓匯入的來源對操作者保持實用。

  1. 確認使用者目標、匯入工作流程的範圍,以及此技能是否仍是處理該任務的正確路由器。
  2. 在載入任何複製的上游支援檔案之前,先閱讀概述和出處檔案。
  3. 僅載入對當前請求結果有實質影響的參考資料、範例、提示或腳本。
  4. 執行上游工作流程,同時在操作筆記中明確保留出處和來源邊界。
  5. 根據上游期望和複製檔案中可引用的證據來驗證結果。
  6. 當工作超出此匯入工作流程的核心範圍時,升級或交接給相關技能。
  7. 在合併或結案前,記錄使用了什麼、改變了什麼,以及審查者仍需驗證的內容。

匯入的工作流程筆記

匯入:1. 核心概念

術語意義
i18n國際化 - 使應用程式可翻譯
L10n本地化 - 實際的翻譯
Locale語言環境 - 語言 + 區域 (en-US, tr-TR)
RTL從右到左語言 (阿拉伯語、希伯來語)

範例

範例 1:直接要求使用上游工作流程

使用 @i18n-localization 來處理 <task>。從複製的上游工作流程開始,僅載入會改變結果的檔案,並在答案中保持出處的可見性。

說明: 當操作者需要匯入的工作流程,但不需要整個儲存庫時,這是最安全的起點。

範例 2:要求進行基於出處的審查

根據 metadata.json 和 ORIGIN.md 審查 @i18n-localization,然後解釋你會優先載入哪些複製的上游檔案以及原因。

說明: 在需要對來源和檔案選擇提供精確、可稽核的解釋時,用於審查或故障排除之前。

範例 3:在執行前縮小複製的支援檔案範圍

使用 @i18n-localization 來處理 <task>。僅載入會改變結果的複製參考資料、範例或腳本,並在繼續前明確命名這些檔案。

說明: 這使技能與漸進式揭露保持一致,而不是預設載入整個複製套件。

範例 4:建立審查者資料包

使用複製的上游檔案和出處來審查 @i18n-localization,然後在合併前總結任何差距。

說明: 當拉取請求等待人工審查,並且你想要一個可重複的稽核資料包時,這很有用。

最佳實務

將產生的公開技能視為上游儲存庫的可審查包裝層。目標是保持出處明確,並僅載入對執行結果有實質改善的複製來源材料。

  • 使用翻譯鍵,而非原始文字
  • 按功能命名空間劃分翻譯
  • 支援複數形式
  • 按語言環境處理日期/數字格式
  • 從一開始就規劃 RTL
  • 對複雜字串使用 ICU 訊息格式
  • 在元件中硬編碼字串

匯入的操作筆記

匯入:5. 最佳實務

務必 ✅

  • 使用翻譯鍵,而非原始文字
  • 按功能命名空間劃分翻譯
  • 支援複數形式
  • 按語言環境處理日期/數字格式
  • 從一開始就規劃 RTL
  • 對複雜字串使用 ICU 訊息格式

切勿 ❌

  • 在元件中硬編碼字串
  • 串聯已翻譯的字串
  • 假設文字長度(德語長 30%)
  • 忘記 RTL 版面配置
  • 在同一檔案中混合語言

故障排除

問題:操作者跳過了匯入的上下文,回答過於籠統

症狀: 結果忽略了 plugins/antigravity-awesome-skills-claude/skills/i18n-localization 中的上游工作流程,未提及出處,或完全未使用任何複製的來源檔案。 解決方案: 重新開啟 metadata.json、ORIGIN.md 和最相關的複製上游檔案。先檢查 external_source 區塊,然後在繼續前重新說明出處。

問題:審查時感覺匯入的工作流程不完整

症狀: 審查者可以看到產生的 SKILL.md,但無法快速判斷哪些參考資料、範例或腳本對當前任務重要。 解決方案: 指向證明你所採用的路徑是合理的確切複製參考資料、範例、腳本或資產。如果差距確實存在,將其記錄在拉取請求中,而不是隱藏它。

問題:任務偏離到不同的專業領域

症狀: 匯入的技能從正確的地方開始,但工作變成了偵錯、架構、設計、安全或發布協調,這些由原生技能處理得更好。 解決方案: 使用相關技能部分有意識地進行交接。保持匯入的出處可見,以便下一個技能繼承正確的上下文,而不是從頭開始。

相關技能

  • @00-andruia-consultant - 當工作在此匯入技能建立上下文後,更適合由該原生專業技能處理時使用。
  • @00-andruia-consultant-v2 - 當工作在此匯入技能建立上下文後,更適合由該原生專業技能處理時使用。
  • @10-andruia-skill-smith - 當工作在此匯入技能建立上下文後,更適合由該原生專業技能處理時使用。
  • @10-andruia-skill-smith-v2 - 當工作在此匯入技能建立上下文後,更適合由該原生專業技能處理時使用。

其他資源

使用此支援矩陣和下方連結的檔案作為此匯入技能的操作者資料包。它們應反映實際複製的來源材料,而非通用的框架。

資源系列提供給審查者的內容範例路徑
references從上游複製的參考筆記、指南或背景資料references/n/a
examples從上游複製的範例或可重複使用的提示examples/n/a
scripts會改變執行或驗證的上游輔助腳本scripts/i18n_checker.py
agents屬於匯入套件的路由或委派筆記agents/n/a
assets從來源套件複製的支援資產或結構描述assets/n/a

匯入的參考筆記

匯入:3. 實作模式

React (react-i18next)

import { useTranslation } from 'react-i18next';

function Welcome() {
  const { t } = useTranslation();
  return <h1>{t('welcome.title')}</h1>;
}

Next.js (next-intl)

import { useTranslations } from 'next-intl';

export default function Page() {
  const t = useTranslations('Home');
  return <h1>{t('title')}</h1>;
}

Python (gettext)

from gettext import gettext as _

print(_("Welcome to our app"))

匯入:4. 檔案結構

locales/
├── en/
│   ├── common.json
│   ├── auth.json
│   └── errors.json
├── tr/
│   ├── common.json
│   ├── auth.json
│   └── errors.json
└── ar/          # RTL
    └── ...

匯入:6. 常見問題

問題解決方案
缺少翻譯回退到預設語言
硬編碼字串使用 linter/檢查腳本
日期格式使用 Intl.DateTimeFormat
數字格式使用 Intl.NumberFormat
複數形式使用 ICU 訊息格式

匯入:7. RTL 支援

/* CSS 邏輯屬性 */
.container {
  margin-inline-start: 1rem;  /* 非 margin-left */
  padding-inline-end: 1rem;   /* 非 padding-right */
}

[dir="rtl"] .icon {
  transform: scaleX(-1);
}

匯入:8. 檢查清單

在發布前:

  • 所有面向使用者的字串皆使用翻譯鍵
  • 所有支援的語言都存在語言環境檔案
  • 日期/數字格式使用 Intl API
  • RTL 版面配置已測試(若適用)
  • 已設定回退語言
  • 元件中無硬編碼字串

匯入:腳本

腳本用途命令
scripts/i18n_checker.py偵測硬編碼字串與遺失的翻譯python scripts/i18n_checker.py <project_path>

匯入:限制

  • 僅在任務與上述範圍明確匹配時使用此技能。
  • 不要將輸出視為特定環境驗證、測試或專家審查的替代品。
  • 如果缺少必要的輸入、權限、安全邊界或成功標準,請停止並要求澄清。

Individual skills in this repo

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

diegosouzapw/awesome-omni-skills

AgentFolio workflow skill. Use this skill when the user needs Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

AgentFolio workflow skill. Use this skill when the user needs Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

AI UGC Ads workflow skill. Use this skill when the user needs When the user wants to create UGC ad campaigns, recruit UGC creators, generate AI UGC content, or scale with user-generated content. Also use when the user mentions 'UGC,' 'user-generated content,' 'creator ads,' 'Spark Ads,' 'whitelisting,' 'AI UGC,' 'Arcads,' 'Creatify,' 'creator brief,' or 'UGC testing.' This skill covers the UGC growth framework from creator recruitment through AI-powered scaling. Do NOT use for technical implementation, code review, or software architecture and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Astro Web Framework workflow skill. Use this skill when the user needs Build content-focused websites with Astro \u2014 zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Copy Editing workflow skill. Use this skill when the user needs You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Copy Editing workflow skill. Use this skill when the user needs You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Copy Editing workflow skill. Use this skill when the user needs You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Fal Image Edit workflow skill. Use this skill when the user needs AI-powered image editing with style transfer and object removal and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Fal Image Edit workflow skill. Use this skill when the user needs AI-powered image editing with style transfer and object removal and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

frontend-design workflow skill. Use this skill when the user needs Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications. Generates creative, polished code that avoids generic AI aesthetics. Do NOT use for design review or audit (use web-design-guidelines or web-quality-audit) and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Frontend Design (Distinctive, Production-Grade) workflow skill. Use this skill when the user needs You are a frontend designer-engineer, not a layout generator and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

i18n & Localization workflow skill. Use this skill when the user needs Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Interactive Portfolio workflow skill. Use this skill when the user needs Expert in building portfolios that actually land jobs and clients - and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Interactive Portfolio workflow skill. Use this skill when the user needs Expert in building portfolios that actually land jobs and clients - and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Landing Page Generator workflow skill. Use this skill when the user needs Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Landing Page Generator workflow skill. Use this skill when the user needs Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Interactive Portfolio workflow skill. Use this skill when the user needs Expert in building portfolios that actually land jobs and clients - and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Paid Creative AI workflow skill. Use this skill when the user needs When the user wants to create AI-generated ad creative, test performance creative, manage creative fatigue, or optimize paid media with AI tools. Also use when the user mentions 'ad creative,' 'performance creative,' 'creative testing,' 'creative fatigue,' 'Meta ads,' 'Google ads,' 'TikTok ads,' 'AI ads,' 'ad budget,' 'ROAS,' 'Advantage+,' or 'Performance Max.' This skill covers AI-powered paid creative from generation through performance optimization. Do NOT use for technical implementation, code review, or software architecture and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

SEO-AEO Landing Page Writer workflow skill. Use this skill when the user needs Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

SEO-AEO Landing Page Writer workflow skill. Use this skill when the user needs Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

相關技能