asc-metadata-sync

asc-metadata-sync 技能概览

asc-metadata-sync 的作用

asc-metadata-sync 技能帮助你使用当前的标准 asc metadata 工作流，在 App Store Connect 和本地文件之间同步 App Store 元数据。它面向那些要更新应用信息、版本级本地化文案、关键词和元数据迁移的人，能减少一次性 prompt 带来的意外。

适合谁使用

如果你在 CI 或团队工作流中负责 App Store 发布、本地化或元数据交接，就适合使用 asc-metadata-sync 技能。它最有价值的场景，是你需要可重复的修改、上传前验证，或者想从旧的 fastlane 元数据格式平稳迁出。

为什么值得安装

asc-metadata-sync 的核心价值在于，它把拉取、编辑、验证和应用拆成了独立步骤，而不是把元数据处理当成一个黑盒操作。这让你更容易在本地审查变更、尽早发现格式错误，并清楚自己实际在更新哪个 App Store Connect 对象。

如何使用 asc-metadata-sync 技能

安装 asc-metadata-sync

使用以下命令安装 asc-metadata-sync 技能：
npx skills add rudrankriyam/app-store-connect-cli-skills --skill asc-metadata-sync

安装后，先打开 SKILL.md，再查看仓库里解释相关约定的文档。在这个仓库中，SKILL.md 是主要事实来源，因为没有额外的 rules/、resources/ 或辅助脚本目录可供依赖。

把模糊任务整理成可用的 prompt

想让 asc-metadata-sync 用得顺，prompt 里要写清楚应用目标、平台、版本，以及你希望修改的具体元数据。像“update metadata”这种请求太模糊；更好的写法是“sync App Store metadata for app APP_ID, version 1.2.3, iOS, then update subtitle, keywords, and what’s new in the local files.”

如果你的应用有多个 app-info 记录，务必一开始就带上 app-info identifier，这样技能不会猜错记录。这个细节往往决定工作流是准确执行，还是需要返工修正。

先读这些部分

先看 SKILL.md 里的工作流章节，重点关注 pull/edit/validate 顺序，以及 app-info 字段和 version-localized 字段的文件路径映射。最有用的决策点包括：

• 哪条命令会拉取 canonical metadata
• 每个字段分别存在哪个本地位置
• 什么时候该用 asc versions update 更新 copyright
• 什么时候才真的需要更底层的命令，比如 asc localizations 或 asc migrate

上传前要检查什么

在把元数据重新应用到 App Store Connect 之前，先验证本地元数据。这个技能最强的用法，是把本地文件当作审查层：上传前确认 locale 覆盖范围、字段名以及版本特定文本。对于 asc-metadata-sync for Workflow Automation，这样也更容易把技能嵌入脚本化发布步骤，而不是手工直接改线上元数据。

asc-metadata-sync 技能常见问题

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

是的。asc-metadata-sync 技能是围绕 App Store Connect 元数据及其标准文件布局设计的。它不是通用的本地化管理器，也不能替代所有发布自动化工具。

什么时候不该用 asc-metadata-sync？

如果你只是想快速改一处文字，而且不在乎保留本地 canonical 副本，就不必用 asc-metadata-sync。如果你的工作流完全依赖旧的 fastlane 格式文件，而且也不打算迁移，它同样不是最佳选择。

asc-metadata-sync 适合新手吗？

适合，但前提是你已经知道自己在编辑哪个应用和哪个版本。它的流程并不复杂，真正容易卡住的是范围判断：app-info 还是 version metadata、app-info ID 是否正确，以及改动应该落在本地文件还是直接版本更新里。

它和普通 prompt 有什么不同？

普通 prompt 只能告诉你要改什么，而 asc-metadata-sync 技能提供的是一套稳定流程：拉取 canonical metadata、编辑本地 JSON 文件、验证，然后再上传或应用变更。这个流程能减少漂移，也更适合跨多个版本重复使用。

如何改进 asc-metadata-sync 技能

给技能完整的元数据上下文

asc-metadata-sync 最好的结果，来自能明确写出应用、平台、版本、locale 集合以及要修改字段的输入。如果你想让输出更准确，就要说明你改的是应用级字段，比如 name，还是版本级字段，比如 description、keywords 和 whatsNew。

避免常见失败模式

最常见的问题，是把 app-info 字段和 version 字段混在一起、忘记提供正确的 app-info ID，以及在上传前跳过验证。另一个常见问题，是在提到迁移时没有说明你需要的是 canonical JSON 文件、.strings 文件，还是旧的 fastlane 元数据支持。

先拉取，再审查，再迭代

一个实用的 asc-metadata-sync guide 是先拉取，检查生成文件，再根据本地结构实际包含的内容细化 prompt。如果第一次输出已经接近目标但还不够完整，可以把请求收窄，比如：“keep all locale keys unchanged, update only keywords and promotional text.”

把仓库路径当作检查清单

把仓库里的实际路径当作质量检查清单：metadata/app-info/<locale>.json、metadata/version/<version>/<locale>.json 和 SKILL.md。如果你在搭自动化，就把工作流绑定到这些路径和验证步骤上，这样后续运行才会保持可预测，也更方便审查。