# Software Localization Skill

> AI 驱动的软件本地化/翻译技能
>
> 归档：2026-04-23

---

## 📊 基本信息

| 项目 | 数据 |
|------|------|
| **名称** | localization |
| **作者** | aaronbrethorst |
| **来源** | https://github.com/aaronbrethorst/claude-skills/tree/main/localizer |
| **Stars** | ⭐ 4 |
| **文件** | 7 个（SKILL.md + 6 个支撑文件） |

---

## 🎯 核心定位

**软件本地化/翻译技能** — 将项目翻译成新语言、添加新语言环境、创建翻译、本地化字符串或处理 i18n/l10n 文件。

支持**自动检测**任何项目类型的本地化框架。

---

## 🔄 工作流程（6步）

### Step 1: Detect Project Type

检测项目使用的本地化框架和文件格式。

| 框架 | 位置 | 格式 | 关键模式 |
|------|------|------|----------|
| React (react-i18next) | `public/locales/`, `src/locales/` | JSON | `{"key": "value"}` |
| React (react-intl) | `src/translations/`, `lang/` | JSON | `{"key": {"defaultMessage": "..."}}` |
| Vue (vue-i18n) | `src/locales/`, `locales/` | JSON/YAML | `{"key": "value"}` |
| Angular | `src/assets/i18n/`, `src/locale/` | JSON/XLIFF | JSON 或 XML |
| iOS | `*.lproj/Localizable.strings` | Strings | `"key" = "value";` |
| Android | `res/values-*/strings.xml` | XML | `<string name="key">value</string>` |
| Rails (i18n) | `config/locales/` | YAML | `en:\n  key: value` |
| Django | `locale/*/LC_MESSAGES/` | PO/POT | `msgid "key"\nmsgstr "value"` |
| .NET (resx) | `Resources/`, `*.resx` | XML | `<data name="key"><value>...</value></data>` |
| Flutter | `lib/l10n/`, `assets/translations/` | ARB/JSON | `{"key": "value", "@key": {...}}` |
| Go (go-i18n) | `locales/`, `translations/` | JSON/TOML | Various |
| PHP (Laravel) | `resources/lang/` | PHP/JSON | `return ['key' => 'value'];` |
| Next.js | `messages/`, `locales/` | JSON | `{"namespace": {"key": "value"}}` |
| Gettext | `*.po`, `*.pot` | PO | msgid/msgstr pairs |

### Step 2: Validate Target Language

验证目标语言是否为有效的 ISO 639 语言代码。

**需要确认的情况**：
- **"Chinese"** → 需要确认：繁体(zh-TW/zh-HK)、简体(zh-CN/zh-Hans)？
- **"Spanish"** → 需要确认：西班牙(es-ES)、拉丁美洲(es-419)、墨西哥(es-MX)？
- **"Portuguese"** → 需要确认：巴西(pt-BR)还是葡萄牙(pt-PT)？
- **"Serbian"** → 需要确认：西里尔文(sr-Cyrl)还是拉丁文(sr-Latn)？
- **"Norwegian"** → 需要确认：Bokmål(nb)还是Nynorsk(nn)？
- **"Malay"** → 需要确认：马来西亚(ms-MY)、新加坡(ms-SG)、文莱(ms-BN)？

### Step 3: Extract Source Strings

加载英语源文件并解析所有可翻译字符串。

**注意**：
- **精确保留 keys** — 不修改 key 名称
- **注意占位符** — `{name}`, `{{count}}`, `%s`, `%d`, `%@` 等
- **注意 HTML/标记** — `<b>`, `<a href="...">` 等
- **注意复数形式** — `one`, `other`, `few`, `many`
- **注意上下文** — ICU 消息格式、性别变化等

### Step 4: Dual Translation（双翻译）

使用两个独立子代理（`translator-alpha` 和 `translator-beta`）进行翻译。

### Step 5: Verification（验证）

第三个子代理 `translator-adjudicator` 比较两个翻译结果，选择最佳翻译。

### Step 6: Output

生成正确格式的本地化文件。

---

## 📁 支持文件

| 文件 | 说明 |
|------|------|
| `SKILL.md` | 主技能文件（8.3 KB） |
| `ADJUDICATOR_INSTRUCTIONS.md` | 裁判指令（6.0 KB） |
| `ISO_CODES.md` | ISO 639 语言代码参考（3.5 KB） |
| `TRANSLATOR_INSTRUCTIONS.md` | 翻译员指令（4.8 KB） |
| `translator-adjudicator.md` | 裁判代理配置 |
| `translator-alpha.md` | Alpha 翻译代理配置 |
| `translator-beta.md` | Beta 翻译代理配置 |

---

## 🧠 三代理架构

```
用户请求
    ↓
[检测项目类型] → [验证语言代码] → [提取源字符串]
    ↓
┌─────────────────┬─────────────────┐
↓                 ↓                 ↓
translator-alpha  translator-beta   两个独立翻译代理
↓                 ↓                 ↓
        ↓         ↓                 ↓
    translator-adjudicator          裁判代理（选择最佳）
        ↓
    输出最终翻译文件
```

---

## 💡 核心亮点

1. **自动框架检测** — 支持 React/Vue/iOS/Android/Rails/Django/.NET/Flutter/Go/PHP 等
2. **双翻译验证** — 两个独立翻译 + 裁判选择，质量更高
3. **ISO 语言代码验证** — 确保语言代码正确
4. **精确字符串提取** — 保留占位符、HTML、复数形式等

---

## 📦 安装方式

```bash
# 使用 skills.sh
npx skills add aaronbrethorst/claude-skills

# 或下载本地
wget skill.zip
```

---

## 🔗 相关资源

| 资源 | 链接 |
|------|------|
| GitHub | https://github.com/aaronbrethorst/claude-skills/tree/main/localizer |
| SkillsMP | https://skillsmp.com/skills/aaronbrethorst-claude-skills-localizer-skill-md |
| Manus | https://manus.im/features/agent-skills |

---

## AI工程索引

相关笔记：
- [[INDEX_AI工程]] - AI工程知识索引
- [[ClaudeCode完全研究]] - Claude Code 完整指南
- [[claude-code-best-practice详解]] - 最佳实践详解

---

*整理：知识库管理员 | 归档：2026-04-23*