# Fill I18N Phase2

> 运行 Phase 2 工作流。执行脚本扫描缺失的多语言词条，并按注册表补全启用语言（如 en-US、zh-TW、vi-VN、ja-JP、fr-FR），最后修复相关测试。

- Skill: `4thfever/fill-i18n-phase2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add 4thfever/fill-i18n-phase2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/4thfever/fill-i18n-phase2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: 4thfever (https://skillmd.com/u/4thfever)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/4thfever/fill-i18n-phase2

---


# 多语言补全：Phase 2 工作流

当你被要求执行此技能时，说明我们现在进入了 **Phase 2**，你可以暂时忽略 "Phase 1" 的限制规则。你的目标是补齐所有缺失的翻译，并让测试变绿。

此技能也适用于两类场景：

1. 正式补全 `registry.json` 中已启用语言的缺失词条。
2. 正式接入一门新语言（例如 `fr-FR`），并补齐其前后端、模板、配置与测试链路。

请严格执行以下步骤：

1. **生成缺失报告**：运行 `python tools/i18n/generate_missing_report.py`（该脚本会对比 zh-CN 和其他语言，输出 Markdown 报告到根目录）。
2. **阅读报告**：读取生成的 `i18n_missing_report.md` 报告文件。
3. **Vibe Coding 补全**：
   - 遍历报告中的文件路径和缺失项。
   - 运用你对“修仙(Cultivation)”背景的理解，将中文原意翻译为 `static/locales/registry.json` 中已启用且需要补全的目标语言。常见包括英文 (`en-US`)、繁体中文 (`zh-TW`)、越南语 (`vi-VN`)、日语 (`ja-JP`) 与法语 (`fr-FR`)。
   - 使用文件编辑工具，将对应的键值对或 msgid/msgstr 正确地插入到目标文件中。保持现有格式和缩进。对于 JSON 文件要确保逗号正确，不要破坏语法。对于 PO 文件要在 msgstr 中填入正确的翻译，并且条目之间保持一个空行。
4. **编译与验证**：
   - 如果修改了后端 `.po` 文件，必须运行 `python tools/i18n/build_mo.py`。但是不要去修改 `messages.po` 文件，这个是通过 `python tools/i18n/build_mo.py` 生成出来的，你不需要修改也不需要去阅读任何语言的 `messages.po` 文件。
   - 运行 `pytest tests/test_frontend_locales.py tests/test_backend_locales.py` 进行终检。如果有缺失，重复步骤 3 直到全部通过。
   - 全部ok后，删除生成的i18n_missing_report.md文件