asc-screenshot-resize

asc-screenshot-resize 技能概览

asc-screenshot-resize 的作用

asc-screenshot-resize 技能可以帮你在上传前准备 App Store 截图：它会结合 macOS sips 和 asc CLI 检查当前可接受的尺寸，并对图片进行调整或校验。它适合处理“把截图准备到可提交状态”这类实际工作，而不是依赖一张过时尺寸表去猜规格。

适合谁使用

如果你要管理 App Store Connect 资源、修正发布用的截图导出，或者需要一套可重复的方式来验证不同设备的截图集合，就适合用 asc-screenshot-resize 技能。它尤其适合 Design Implementation 工作流：设计产出必须与 App Store Connect 的要求完全一致。

这项技能的不同之处

asc-screenshot-resize 的核心价值在于，它不会在技能内部硬编码一张固定尺寸表。它预期由 CLI 提供当前的真实标准，这样当 Apple 调整可接受的截图尺寸时，工具与规则之间的偏差会更小。

如何使用 asc-screenshot-resize 技能

安装并验证技能

使用 npx skills add rudrankriyam/app-store-connect-cli-skills --skill asc-screenshot-resize 安装技能。安装后，先打开 skills/asc-screenshot-resize/SKILL.md，因为那里定义了工作流程和精确的验证命令。然后再查看你本地文件树中父项目的相关约定，确认是否有周边规则需要先遵循，再批量处理资源。

先从最新尺寸矩阵开始

在使用 asc-screenshot-resize 时，先让 CLI 告诉你当前接受哪些尺寸：

asc screenshots sizes --output table
asc screenshots sizes --all --output table

当你需要支持 Apple TV、Mac、Vision Pro、Watch 或 iMessage 这类不太常见的目标时，使用 --all 视图。这个步骤很重要，因为这项技能是围绕当前平台数据设计的，而不是围绕记忆或静态文档设计的。

调整尺寸前先准备输入

在开始缩放之前，先清理文件名并检查图片元数据。隐藏的 Unicode 空格会破坏批处理工具，而尺寸不匹配则可能让一张本来没问题的截图在校验时失败。一个高质量的提示词或任务请求，应明确写出目标设备类型、源文件夹、期望输出文件夹，以及你需要的是“只做严格校验”还是“缩放加校验”。

使用具体的工作流提示

给 asc-screenshot-resize 的请求要具体，不要空泛。比如：Validate the screenshots in ./screenshots/iphone for IPHONE_65, fix filename issues first, then resize only if needed and report any images that still fail dimensions. 这样的输入能给技能足够上下文，让它选择正确路径，也让结果更容易被信任。

asc-screenshot-resize 技能 FAQ

asc-screenshot-resize 只适用于 App Store Connect 吗？

是的，它的用途就是为 App Store Connect 做截图准备和校验。它不是通用图片编辑技能，也不能替代设计工具来处理版式修改、裁切决策或品牌审核。

使用这个技能需要 asc CLI 吗？

需要。这个技能依赖 asc 来获取当前截图尺寸的真实标准，也依赖它执行校验命令。如果你只是想做通用图片缩放，普通提示词或者独立脚本可能更简单。

asc-screenshot-resize 适合新手吗？

基本适合，只要你能跟着基础终端流程操作。主要学习难点在于理解设备类型目标，以及读懂校验输出。新手通常在先从一组设备开始、先确认可接受尺寸再动手处理文件时，效果最好。

如何改进 asc-screenshot-resize 技能

给出真实目标，不要只说一个模糊目的

提升质量最大的一步，是明确写出确切的目标：设备类型、文件夹路径，以及截图是给 iPhone、iPad 还是其他 App Store Connect 目标使用。asc-screenshot-resize 最适合在有明确上传目标时进行校验，而不是靠文件名去猜测意图。

减少本可避免的失败点

常见问题包括尺寸假设过时、文件名里有隐藏字符，以及把不同设备的截图混在同一个文件夹里。如果第一次运行失败，先检查文件名清理情况，再用 sips 对照图片元数据，然后再重新执行缩放或校验流程。

用校验迭代，不要靠猜

把第一次输出当作诊断步骤。如果某张截图哪怕只差一点点，也应该修正源导出或裁切策略，而不是反复把同一份错误文件重新缩放。对于 Design Implementation 场景下的 asc-screenshot-resize，最强的反馈闭环是：先校验，再修正源设计导出，然后再次校验，直到整套资源符合当前 App Store Connect 的要求。