asc-localize-metadata

asc-localize-metadata 技能概览

asc-localize-metadata 是一个工作流技能，借助 asc 和 LLM 辅助翻译，在不同语言区域之间翻译并同步 App Store Connect 元数据。它最适合已经有源语言上架页、需要一套可重复流程来本地化描述、关键词、副标题和“新内容”的团队，而不是从头重搭整套流程。

这个 asc-localize-metadata 技能能做什么

它的核心任务是把源语言中的现有 App Store 元数据翻译到目标语言区域，并更少依赖手动复制，把结果回写到 App Store Connect。这个能力很适合新市场上线、更新上架页，或让各语言版本的发布说明保持一致。

适合谁使用

如果你会用 App Store Connect，需要按语言区域逐个更新元数据，并且希望比通用翻译提示词拥有更强控制力，那么就适合用 asc-localize-metadata。它适合重视命令驱动步骤、显式 ID 和可预测输出的工作流自动化用户。

为什么它不一样

这个技能是围绕 asc 的命令约定来设计的，而不只是做文本生成。之所以重要，是因为 App Store 元数据最容易在编辑错应用、错版本或错语言区域时出问题。这个技能强调发现命令、前置条件和确定性操作，让你在上传前先核对清楚。

如何使用 asc-localize-metadata 技能

在工作区中安装该技能

先把 asc-localize-metadata 安装到你的 skills 配置里，然后在工作流中使用前确认仓库文件已经在本地可用。安装时对应的包是 rudrankriyam/app-store-connect-cli-skills，技能路径是 skills/asc-localize-metadata。

先准备正确的输入

这个技能在以下输入齐全时效果最好：

• 应用标识符，或者能可靠找到它的方法
• 源语言区域，通常是 en-US
• 你要新增或更新的目标语言区域
• 涉及的元数据类型，例如 description、keywords、subtitle 或 release notes
• 任何产品术语、品牌规则，或特定语言区域的约束

一个好的请求示例如下：“使用 asc-localize-metadata，将 App Store 的 description、subtitle、keywords 和 what’s new 从 en-US 翻译到 fr-FR、de-DE 和 ja，保持品牌名不变，并确保关键词长度符合 App Store 限制。”

按照实用的工作流执行

先阅读 SKILL.md，然后在运行任何命令之前通过 --help 确认准确的 asc 参数。这个技能希望你核对自己当前安装版本的命令形式，使用明确的长参数，并在上传前验证输出。如果不确定该编辑哪条记录，优先使用基于 ID 的查找，而不是靠表格输出去猜。

先读这些文件

对于 asc-localize-metadata usage，建议优先查看：

• SKILL.md，了解整体工作流和保护性约束
• SKILL.md 中提到的任何关联仓库说明
• asc localizations、asc localizations download、asc localizations upload 和 asc apps info edit 的命令帮助

这样的阅读顺序可以帮助你避免命令格式错误，以及把内容写到错误的语言区域。

asc-localize-metadata 技能常见问题

asc-localize-metadata 只适用于 App Store Connect 吗？

是的。它是为 App Store Connect 元数据工作流设计的，不是通用网站翻译，也不是应用内字符串本地化。如果你的目标是 App Store 上架页本地化，它很合适；如果你需要的是产品界面翻译，就应该用其他工具。

我需要熟悉 CLI 工具吗？

最好有一些基础，因为这个技能依赖 asc 命令、身份验证和显式参数。初学者只要能认真跟着安装和验证步骤做，也可以使用，但它不是那种点点鼠标就能完成的无代码流程。

它比普通翻译提示词好在哪里？

普通提示词可以翻译文本，但 asc-localize-metadata 关注的是操作层面的正确性：是不是正确的应用、正确的语言区域、正确的元数据类型，以及正确的上传路径。这能减少那种“聊天里看起来没问题，但在 App Store Connect 里却无法通过”的内容风险。

什么情况下不该用它？

如果你没有 App Store Connect 权限，不知道源元数据是什么，或者只是想做一次不需要上传的临时翻译，那就不该用 asc-localize-metadata。如果你想要完全自由发挥的营销文案，而不是受控本地化，它也不合适。

如何改进 asc-localize-metadata 技能

提供更完整、更干净的源元数据

最好的结果来自完整的源数据，而不是零散片段。请提供当前英文上架页、准确的目标语言区域，以及所有必须保持不变的术语。如果这些信息缺失，翻译步骤可能会保留错误的产品名、把关键词压缩得过头，或者漏掉发布说明的上下文。

明确会影响最终上传的规则

如果你在意字符限制、语气、大小写或禁用表达，请一开始就说明。对 asc-localize-metadata 来说，这些规则很重要，因为 App Store 元数据受字段类型和语言区域限制，不只是翻译质量的问题。

上传前先做验证

把第一次结果当作草稿来处理。先检查翻译后的关键词、本地化副标题措辞，以及任何会受语言区域影响的表达，再决定是否推送。如果结果接近但不够理想，可以通过补充偏好的术语示例来收紧源提示词，或者一次只处理一个元数据字段来迭代。

注意常见失败模式

主要风险包括语言区域选择不清、混淆应用级和版本级元数据，以及不经命令验证就过度信任生成结果。asc-localize-metadata 指南最有效的用法，是先确认相关 asc 命令帮助，使用确定性的 ID，并避免在表格输出里临时挑行。