Agent Skills
返回列表
🏢

小游戏出海本地化工作流

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/tencent-adm-minigame-i18n-101。

技能介绍

要解决什么问题

微信小游戏出海时,中文往往散落在 JS/TS、WXML、JSON、CSV/TSV 配置表、Unity/Cocos 场景与编译产物里。纯手工 grep 容易漏掉注释与代码的边界,直接让模型改源码又容易破坏语法或误改注释里的同名文本。若还要处理含文案的图片,还涉及 OCR、翻译与资源路径替换,流程更长且极易缺步。

技能如何工作

本技能扮演本地化总控制器:在阶段 0 收集项目路径、引擎类型、localizationStrategy(replace / langpack / both)、是否翻译图片及 MCP 可用性,并写入 i18n-config.json。阶段 1 要求先安装 scripts/package.json 依赖,再跑 scan-chinese.js 做 AST 扫描,并用 [一-鿿] 的 grep 交叉对比,产出 scan_report.json 与 analysis_report.json。阶段 2 生成 i18n_plan.md 与 glossary.json,仅此步暂停等待你确认术语。确认后自动连续执行:翻译(text_translations.json 条目数须等于扫描总数)、generate-langpack.js(若选语言包)、replace-text.js / replace-image.js(须先 --dry-run)、质量验证,以及可选的 verify-build-strings.js。

文本替换禁止 AI 手改源码,必须通过脚本;图片上传只允许 upload-images.js。脚本失败条目由 AI 按 replace_report.json 逐条补救并做语法校验。

适用边界与注意点

  • translateImages: false 时跳过全部图片链路;MCP 不可用时不应假装完成 OCR/重绘。
  • 语言包模式覆盖 Cocos L10N、Laya、Egret、Unity、原生小游戏等,但引擎识别错误会导致语言包路径或注入点不对。
  • 大规模条目可能需分批翻译,但不允许以窗口限制为理由遗漏 scan_report 中的任意 TextEntry。

使用场景

  • Cocos/Laya 项目上线海外版前,要把代码与 CSV 关卡表里的中文一次性扫描并接入语言包
  • 已勾选翻译 UI 图,需要走 upload-images.js + MCP OCR,再批量替换按钮与 Banner 资源
  • 术语表含角色名与道具专有名词,先人工确认 glossary.json 再连续跑翻译与 replace-text.js
  • 直接替换模式只适合单目标语言,但希望在 dry-run 与语法回滚保护下改上千处字符串字面量

适合人员

  • 负责小游戏海外包的客户端工程师,要把 JS/配置表中文改成目标语言且不能破坏构建
  • 本地化协调人,需要先冻结术语表再让助手按阶段 0–6 自动跑完扫描到验证
  • 带图文 UI 的休闲小游戏制作人,需要在 MCP 可用时把含字图片纳入同一套 i18n 流程
  • 技术负责人审查出海风险,要求 AST+grep 双路径扫描与脚本替换三层校验可追溯