asc-shots-pipeline

asc-shots-pipeline 技能概览

asc-shots-pipeline 是一款 iOS 截图自动化技能，适合需要从应用构建到带设备框、可直接上传的截图这一整套流程可重复执行的团队。它最适合 UI 设计师、App 营销人员和移动开发者，尤其是那些需要比手工在模拟器里截屏更少人工、又比一次性提示词更可控的 asc-shots-pipeline for UI Design 工作流的人。

它的核心任务是编排 xcodebuild 和 simctl 完成构建与运行，用 AXe 在模拟器内执行 UI 操作，借助 Koubou 拼接设备外框，并通过 asc screenshots upload 上传结果。如果你已经清楚自己的 App、scheme 和目标屏幕列表，这个技能能把围绕截图流水线本身的不确定性降到最低。

asc-shots-pipeline 擅长什么

它处理的是实际最容易出问题的那段路径：启动稳定性、UI 导航、一致的设备框呈现，以及从原始截图交付到可上传资产的衔接。asc-shots-pipeline skill 最适合需要反复重新生成截图，而不是只做一次的场景。

它最适合放在什么位置

当你需要基于模拟器的确定性截取来制作 App Store 物料、版本更新、语言本地化截图集或设计评审素材时，就该用它。只要 App 能通过可重复的 UI 步骤驱动，并且你希望输出遵循结构化的计划文件，而不是临时抓图，这个技能就很合适。

需要提前知道的重要限制

这是一款流水线技能，不是通用的移动测试框架。它默认你可以构建 App、在模拟器里运行，并用 JSON 表达截图步骤。若你的 App 交互随机性很高、依赖不稳定的外部服务，或者无法通过 UI 操作清晰脚本化，这个技能就不太适合。

如何使用 asc-shots-pipeline 技能

安装并定位工作流文件

先走目录安装流程完成 asc-shots-pipeline install 这一步，然后优先打开 skills/asc-shots-pipeline/SKILL.md。接着，先查看仓库级说明和任何关联文件，再把配置复制到你自己的项目里。最实用的起点其实就是技能正文本身，因为这个仓库没有辅助脚本或额外参考目录来补足上下文缺失。

准备技能期望的输入

asc-shots-pipeline usage 的模式从配置文件和截图计划开始。技能中展示的默认路径是：应用与路径配置用 .asc/shots.settings.json，截图计划用 .asc/screenshots.json。至少你需要明确这些信息：

• app bundle ID
• Xcode project file
• scheme 名称
• simulator UDID 或 booted
• 需要截取的屏幕
• 最终输出要使用的设备框

弱输入像是：“给这个 App 截几张图。”
强输入则像是：“构建 MyApp.xcodeproj，在已启动的模拟器上运行 MyApp，按 login > home > settings 的路径导航，截取三个状态，并把它们套到 iphone-air 设备框里。”

按正确顺序阅读文件

要最快完成搭建，先读 SKILL.md 看工作流，再把配置结构复制到项目中，然后定义截图计划，最后才执行构建/截取步骤。技能本身的指导重点是先创建 settings JSON，这一点很关键，因为大多数失败都来自路径不完整或 app 标识符不匹配，而不是截图动作本身。

用更明确的提示词运行工作流

在调用这个技能时，要把 App 名称、目标平台、模拟器状态、想要截取的屏幕，以及截取前需要完成的 UI 准备都写清楚。如果 App 需要先关闭引导页，或需要先加载测试数据，也要明确说明。最好的 asc-shots-pipeline guide 输入，会描述用户在界面里的路径，而不只是最终屏幕的名称。

asc-shots-pipeline 技能常见问题

asc-shots-pipeline 只能用于 App Store 截图吗？

不是。它确实以 App Store 风格的截图和设备框制作为中心，但同一套流水线也可以支持发布说明、营销演示稿、设计签核和本地化评审。它的核心价值是始终输出一致、由模拟器驱动的结果。

使用得好一定要用 AXe 吗？

如果你希望 UI 导航足够稳定、能支持多步骤操作，那么是的，AXe 是预期工作流的一部分。若你的截图流程几乎是静态的，只需要启动应用再截单个页面，这个技能仍然有用，但它真正的优势会在需要脚本化 UI 操作时更明显。

这比写一个通用提示词更好吗？

通常是更好的，前提是你需要可重复性。通用提示词可以在理论上描述截图，但 asc-shots-pipeline 给了你一套更明确的结构：配置、计划文件、设备框和上传流程都已经定好，这能降低漏掉必要步骤的概率。

什么情况下不该用这个技能？

如果你需要完全手工的视觉指导、如果你的 App 无法在本地构建，或者如果截图依赖不可预测的实时内容，就不要用它。这些情况下，手工设计流程或更简单的截取流程可能更合适。

如何改进 asc-shots-pipeline 技能

提供完整的截图简报

要想得到更好的结果，就要给出具体的 UI 状态、文案预期和目标设备。不要只说“截 onboarding”，而要提供明确步骤和目标结束状态，比如“使用测试账号登录，打开 dashboard，并分别截取空状态和已填充状态两个版本”。

在截取前先减少失败点

最常见的阻塞通常是构建问题、模拟器不匹配和路径配置缺失。运行工作流前，先核对 bundle ID、scheme 和计划文件路径，并确认模拟器已可用，或者可以通过内置设备发现流程选到正确设备。

优先迭代第一次运行，而不是整条流水线

如果第一次输出不对，先改计划或 UI 步骤，不要先动设备框或上传步骤。大多数质量提升都来自收紧截图步骤、理清导航顺序，以及明确每张截图里应显示的状态。

用输出结果固化你自己的工作流

一旦成功跑通一次，就把同样的 .asc/shots.settings.json 和 .asc/screenshots.json 结构复用为未来 App 或语言版本的模板。这就是 asc-shots-pipeline 技能最重要的长期价值：它能把一次截图会话，变成可重复执行的操作模式。