asc-whats-new-writer 是一款 App Store 发布说明写作技能,用于把零散的更新信息整理成有吸引力、本地化的 What's New 文本,并可配合推广文本更新。
用途:接受三种输入(自动识别)——自上次标签以来的 git log、粗略要点,或自由描述的变更。无输入时会提示用户提供。若元数据已通过 asc metadata pull --app "APP_ID" --version "1.2.3" --dir "./metadata" 拉到本地规范目录,可读取关键词与现有本地化。
主要能力:按 New、Improved、Fixed 对变更分类(空分类省略);写以用户收益为中心的文案,首约 170 字符前置最重要变化;从 metadata/version/{最新版本}/{主语言}.json 的 keywords 字段自然呼应关键词;主语言控制在 500-1500 字符,硬上限 4000 字符;可选草拟 170 字符推广文本;将定稿翻译到所有已有语言环境,使用正式称谓(如德语 Sie、法语 vous),按市场调整语气,不改写惯用语;各语言同样限制 4000/170 字符,超限则缩短而非截断。
使用方式:先阅读 references/release_notes_guidelines.md 了解语气与结构,找到 metadata/version/ 下最高 semver 目录并枚举语言。先展示草稿与字符数,等待批准后再本地化;上传前展示各语言摘要表并等待确认。上传可单语言直更:asc apps info edit --app "APP_ID" --version-id "VERSION_ID" --locale "en-US" --whats-new "Your release notes here";或写回规范 JSON 后批量推送:asc metadata push --app "APP_ID" --version "1.2.3" --dir "./metadata" --dry-run,再执行不带 --dry-run 的同一命令。部分失败时报告成功与失败语言并提供重试。
适用场景:iOS 应用版本更新说明撰写、多语言发布说明与推广文本生成、与 ASO 关键词协同。
限制:需配置 asc 认证(asc auth login 或 ASC_* 环境变量);What's New 不参与 App Store 搜索索引,应为人而写;推广文本是唯一无需新提交即可更新的字段;需用户批准才上传;完整元数据翻译应使用 asc-localize-metadata,关键词研究先使用 asc-aso-audit;具体收费、价格、平台范围等资料暂未提供。