OpenParable
Skip to content
← Back to skills

Fill I18n Phase2

Development
fill-i18n-phase2

Fill I18n Phase2 is an Agent Skill for development published in the 4thfever/cultivation-world-simulator repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/4thfever/cultivation-world-simulator/blob/HEAD/.cursor/skills/fill-i18n-phase2/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/fill-i18n-phase2, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

多语言补全: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文件