Communitygithub.com

ComeOnOliver/asc 本地化元数据

自动拉取英文(或任何源语言)的 App Store 元数据,通过大语言模型(LLM)翻译,并将译文推送回 App Store Connect,全程自动化。

asc 本地化元数据 是什么?

此技能(skill)专为自动化 App Store Connect 本地化工作流而设计。它首先使用 `asc` 命令行工具从 App Store Connect 下载指定源语言(如 en-US)的版本本地化(描述、关键词、新内容等)和应用信息本地化(名称、副标题、隐私政策 URL 等)字段。随后,技能内置一套严谨的翻译指南,指导如何调用 LLM 进行高质量翻译,重点包括:根据目标市场采用正式礼貌的语气(如德语 Sie、法语 vous)、对“关键词”字段进行本地化搜索词研究而非直译、严格遵守各字段的字符数限制(如副标题最多 30 字符、描述最多 4000 字符)。翻译完成后,技能支持通过批量 `.strings` 文件或单个命令将译文上传回 App Store Connect,并提供验证步骤。该技能主要面向使用 `asc` CLI 工具的开发者,适用于 Claude Code、Cursor 等支持技能调用的 AI 编码助手,能显著减少手动本地化 App Store 元数据的重复性工作,并确保翻译质量和格式规范。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/rudrankriyam/app-store-connect-cli-skills/asc-localize-metadata

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

asc 本地化元数据 是做什么的?

使用此技能自动拉取英文(或任何源语言)的 App Store 元数据,通过大语言模型(LLM)翻译,并将译文推送回 App Store Connect,全程自动化。

命令发现与输出约定

  • 始终通过 --help 确认当前 asc 版本的标志:
    • asc localizations --help
    • asc localizations download --help
    • asc localizations upload --help
    • asc apps info edit --help
  • 优先使用完整的标志名称(--app、--version、--version-id、--type、--app-info)。
  • 默认输出为 JSON;仅在进行人工确认步骤时使用 --output table。
  • 优先使用基于 ID 的确定性操作。除非用户明确同意,否则不要通过 head -1 选择第一条记录。

前提条件

  • 已配置认证(asc auth login 或设置 ASC_* 环境变量)
  • 已知您的应用 ID(通过 asc apps list 查找)
  • App Store Connect 中至少有一个语言(通常为 en-US)已包含元数据

支持的语言

App Store Connect 支持的版本和应用信息本地化语言:

ar-SA, ca, cs, da, de-DE, el, en-AU, en-CA, en-GB, en-US,
es-ES, es-MX, fi, fr-CA, fr-FR, he, hi, hr, hu, id, it,
ja, ko, ms, nl-NL, no, pl, pt-BR, pt-PT, ro, ru, sk,
sv, th, tr, uk, vi, zh-Hans, zh-Hant

两种元数据类型

版本本地化(按发布版本)

字段:description、keywords、whatsNew、supportUrl、marketingUrl、promotionalText

应用信息本地化(应用级别,持久保留)

字段:name、subtitle、privacyPolicyUrl、privacyChoicesUrl、privacyPolicyText

工作流程

第 1 步:解析 ID

# 查找应用 ID
asc apps list --output table

# 查找最新版本的 ID(已准备发布状态)
asc versions list --app "APP_ID" --state READY_FOR_DISTRIBUTION --output table
# 或查找可编辑版本:
asc versions list --app "APP_ID" --state PREPARE_FOR_SUBMISSION --output table

# 查找应用信息 ID(用于应用级别的字段,如名称、副标题)
asc apps info list --app "APP_ID" --output table

注意事项:

  • 版本本地化字段(description、keywords、whatsNew 等)按版本关联。
  • 应用信息字段(name、subtitle、隐私 URL/文本)为应用级别,使用 --type app-info。
  • 如果您只有名称(应用名、版本字符串)而需要 ID,请使用 asc-id-resolver 技能进行确定性解析。

第 2 步:下载源语言

# 下载版本本地化到本地的 .strings 文件
# (description、keywords、whatsNew、promotionalText、supportUrl、marketingUrl 等)
asc localizations download --version "VERSION_ID" --path "./localizations"

# 下载应用信息本地化到本地的 .strings 文件
# (name、subtitle、privacyPolicyUrl、privacyChoicesUrl、privacyPolicyText 等)
asc localizations download --app "APP_ID" --type app-info --app-info "APP_INFO_ID" --path "./app-info-localizations"

此命令将创建类似 ./localizations/en-US.strings 和 ./app-info-localizations/en-US.strings 的文件。如果无法下载,可以逐个读取字段:

# 列出版本本地化以查看现有语言及其内容
asc localizations list --version "VERSION_ID" --output table

第 3 步:使用 LLM 翻译

对于每个目标语言,翻译源文本。遵循以下规则:

翻译指南

  • 语气与语域:始终使用正式、礼貌的语言。在语言区分该形式时,使用正式的“您”形式(俄语:вы,德语:Sie,法语:vous,西班牙语:usted,荷兰语:u,意大利语:Lei,葡萄牙语:você 正式体等)。App Store 描述是专业的营销文案——切勿使用随意或非正式的语域。
  • description:自然翻译,根据当地市场调整语气。保留格式(换行、项目符号、表情符号)。不超过 4000 字符。
  • keywords:不要逐字翻译。研究该语言用户在 App Store 中会搜索什么。以逗号分隔,总共最多 100 字符。不要重复,不要包含应用名称(Apple 会自动添加)。
  • whatsNew:翻译版本发布说明。保持简洁。最多 4000 字符。
  • promotionalText:翻译营销宣传语。最多 170 字符。此字段可在不发布新版本的情况下更新。
  • subtitle:翻译或改编副标题。最多 30 字符——这个限制非常严格,可能需要创造性地改编。
  • name:通常保留原应用名称。仅在用户明确要求时才翻译。最多 30 字符。

LLM 翻译提示模板

对于每个目标语言,使用以下方法:

将以下 App Store 元数据从 {source_locale} 翻译为 {target_locale}。

规则:
- description:自然流畅的翻译。保留格式(换行、项目符号、表情符号)。最多 4000 字符。
- keywords:不要逐字翻译。选择本地用户会在 App Store 中搜索的关键词。以逗号分隔,总共最多 100 字符。不要包含应用名称。
- whatsNew:自然翻译版本发布说明。最多 4000 字符。
- promotionalText:翻译营销宣传语。最多 170 字符。
- subtitle:创造性地改编以适应最多 30 字符的限制。
- name:除非明确要求翻译,否则保留原应用名称。最多 30 字符。
- 使用正式、礼貌的语言和正式的“您”形式(俄语:вы,德语:Sie,法语:vous,西班牙语:usted,荷兰语:u 等)。App Store 文案是专业的营销内容——切勿使用非正式语域。
- 尊重文化背景。英语中俏皮的语气可能需要在正式市场(如 ja,de-DE)进行调整。

源语言 ({source_locale}):
description: """
{description}
"""

keywords: {keywords}

whatsNew: """
{whatsNew}
"""

promotionalText: {promotionalText}

name: {name}

subtitle: {subtitle}

第 4 步:上传翻译

方式 A:通过 .strings 文件(批量)

在相应的目录中,为每个语言创建一个 .strings 文件。

版本本地化示例:

// nl-NL.strings
"description" = "Je app-beschrijving hier";
"keywords" = "wiskunde,kinderen,tafels,leren";
"whatsNew" = "Bugfixes en verbeteringen";
"promotionalText" = "Leer de tafels van vermenigvuldiging!";

然后上传版本本地化:

asc localizations upload --version "VERSION_ID" --path "./localizations"

应用信息本地化示例:

// nl-NL.strings
"subtitle" = "Leer tafels spelenderwijs";

然后上传应用信息本地化:

asc localizations upload --app "APP_ID" --type app-info --app-info "APP_INFO_ID" --path "./app-info-localizations"

方式 B:通过单个命令(精细控制)

# 版本本地化字段(精细控制)。
# 优先传入明确的版本 ID 以确保确定性。
asc apps info edit --app "APP_ID" --version-id "VERSION_ID" --locale "nl-NL" \
  --description "Je beschrijving..." \
  --keywords "wiskunde,kinderen,tafels" \
  --whats-new "Bugfixes en verbeteringen"

对于应用级别字段:

# 副标题/名称(应用信息本地化)通过应用信息本地化管理。
# 使用应用信息本地化的 .strings 文件 + 上传流程(没有 `asc app-infos localizations ...` 命令)。
#
# 1)编辑:./app-info-localizations/nl-NL.strings
# "subtitle" = "Leer tafels spelenderwijs";
#
# 2)上传:
asc localizations upload --app "APP_ID" --type app-info --app-info "APP_INFO_ID" --path "./app-info-localizations"

第 5 步:验证

# 检查所有语言是否都已存在
asc localizations list --version "VERSION_ID" --output table

# 检查应用信息本地化
asc localizations list --app "APP_ID" --type app-info --app-info "APP_INFO_ID" --output table

字符数限制(上传前强制执行!)

字段限制
Name30
Subtitle30
Keywords100(逗号分隔)
Description4000
What's New4000
Promotional Text170

始终验证翻译后的文本是否在限制范围内,然后再上传。截断的文本显得不专业。如果翻译内容超出限制,请缩短它——不要在句子中间截断。

完整示例:为 Roxy Math 添加荷兰语(nl-NL)和俄语(ru)

# 1)确定性解析 ID(不自动选择“第一”行)
# 如果只有名称,请使用 asc-id-resolver 技能。
asc apps list --output table
APP_ID="APP_ID_HERE"

asc versions list --app "$APP_ID" --state PREPARE_FOR_SUBMISSION --output table
VERSION_ID="VERSION_ID_HERE"

asc apps info list --app "$APP_ID" --output table
APP_INFO_ID="APP_INFO_ID_HERE"

# 2)下载英文源(或您选择的源语言)
asc localizations download --version "$VERSION_ID" --path "./localizations"
asc localizations download --app "$APP_ID" --type app-info --app-info "$APP_INFO_ID" --path "./app-info-localizations"

# 3)读取 en-US.strings,翻译为 nl-NL 和 ru(LLM 步骤)

# 4)将 nl-NL.strings 和 ru.strings 写入:
#    - ./localizations/(版本本地化字段)
#    - ./app-info-localizations/(副标题/名称/隐私字段)

# 5)上传所有内容
asc localizations upload --version "$VERSION_ID" --path "./localizations"
asc localizations upload --app "$APP_ID" --type app-info --app-info "$APP_INFO_ID" --path "./app-info-localizations"

# 6)验证
asc localizations list --version "$VERSION_ID" --output table
asc localizations list --app "$APP_ID" --type app-info --app-info "$APP_INFO_ID" --output table

智能体行为指南

  1. 始终从读取源语言开始——不要凭借记忆或假设进行翻译。
  2. 先检查现有本地化——除非用户要求更新,否则不要覆盖已有的翻译。
  3. 版本与应用信息是不同的——版本字段使用 --version "VERSION_ID";副标题/名称/隐私字段使用 --app ... --type app-info。
  4. 优先使用确定性 ID——除非明确要求,否则不要通过 head -1 选择 ID;使用 --output table 进行选择或使用 asc-id-resolver。
  5. 上传前验证字符数限制,检查每个字段的字符数。如果超限,重新翻译得更短。
  6. 关键词是特殊的——不要逐字翻译。研究适合当地语言的搜索词。像使用该语言在 App Store 中搜索的用户一样思考。
  7. 在上传前向用户展示翻译内容——要提供一个所有字段 × 语言的摘要表格以供批准。未经确认不要推送。
  8. 如果翻译多种语言,一次处理一个语言——更容易审查和发现错误。
  9. 如果某个语言上传失败,记录错误,继续处理其他语言,最后报告所有失败信息。
  10. 对于更新现有本地化——下载当前内容,显示将要更改的差异,获得批准,然后上传。

注意事项

  • 版本本地化与特定版本绑定。如果版本尚不存在,请先创建版本。
  • promotionalText 可以随时更新,无需提交新版本。
  • whatsNew 仅适用于更新,不适用于第一个版本。
  • 如果您只有应用/版本名称而没有 ID,请使用 asc-id-resolver 技能。
  • 对于非翻译的元数据操作,请使用 asc-metadata-sync 技能。
  • 对于订阅/IAP 显示名称本地化,请改用 asc-subscription-localization 技能。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

相关技能