القائمة
国际化与本地化模式。包含硬编码字符串检测、翻译管理、语言文件与 RTL 支持。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | i18n-localization |
| description | 国际化与本地化模式。包含硬编码字符串检测、翻译管理、语言文件与 RTL 支持。 |
| allowed-tools | Read, Glob, Grep |
国际化（i18n）与本地化（L10n）最佳实践。
| 术语 | 含义 |
|---|---|
| i18n | Internationalization（国际化）—— 使应用具备可翻译性 |
| L10n | Localization（本地化）—— 实际的翻译实施过程 |
| Locale | 语言 + 地区（例如：en-US, tr-TR） |
| RTL | Right-to-left（从右向左语言，如阿拉伯语、希伯来语） |
| 项目类型 | 是否需要 i18n？ |
|---|---|
| 公共 Web 应用 | [OK] 是 |
| SaaS 产品 | [OK] 是 |
| 内部工具 | [WARN] 视情况而定 |
| 单一地区应用 | [WARN] 考虑未来扩展 |
| 个人项目 | [FAIL] 可选 |
import { useTranslation } from 'react-i18next';
function Welcome() {
const { t } = useTranslation();
return <h1>{t('welcome.title')}</h1>;
}
import { useTranslations } from 'next-intl';
export default function Page() {
const t = useTranslations('Home');
return <h1>{t('title')}</h1>;
}
from gettext import gettext as _
print(_("Welcome to our app"))
locales/
+-- en/
| +-- common.json
| +-- auth.json
| +-- errors.json
+-- tr/
| +-- common.json
| +-- auth.json
| +-- errors.json
+-- ar/ # RTL
+-- ...
| 问题 | 解决方案 |
|---|---|
| 缺少翻译 | 回退到默认语言 |
| 硬编码字符串 | 使用 Linter/检查脚本 |
| 日期格式 | 使用 Intl.DateTimeFormat |
| 数字格式 | 使用 Intl.NumberFormat |
| 复数逻辑 | 使用 ICU 消息格式 |
/* CSS Logical Properties */
.container {
margin-inline-start: 1rem; /* Not margin-left */
padding-inline-end: 1rem; /* Not padding-right */
}
[dir="rtl"] .icon {
transform: scaleX(-1);
}
在正式发布前：
| 脚本 | 用途 | 执行命令 |
|---|---|---|
scripts/i18n_checker.py | 检测硬编码字符串与缺失翻译 | python scripts/i18n_checker.py <project_path> |
务实的编码标准—— 简洁、直接、不做过度设计、不写无用注释（Pragmatic coding standards）
性能分析原则。测量、分析与优化技术。
API design principles and decision-making（API 设计原则与决策逻辑）。REST vs GraphQL vs tRPC selection（选择）、response formats（响应格式）、versioning（版本控制）、pagination（分页）。
App Builder（应用构建编排器）主编排器。根据自然语言请求创建全栈应用，确定项目类型、选择技术栈并协调智能体。
Project scaffolding templates（项目脚手架模板）。用于从零创建新项目。包含 12 个技术栈模板。
Architectural decision-making framework（架构决策框架）。Requirements analysis（需求分析）、trade-off evaluation（权衡评估）、ADR documentation（架构决策记录）。Use when making architecture decisions or analyzing system design（用于架构决策与系统设计分析）。