AgentSkillsCN

xcode-preview-capture

在 Codex 中构建并捕获 SwiftUI 预览，以进行视觉分析。当用户要求预览 Swift 文件、捕获模拟器界面，或检查 SwiftUI 视图的可视化输出时，此功能便能派上用场。

SKILL.md
--- frontmatter
name: xcode-preview-capture
description: Build and capture SwiftUI previews for visual analysis in Codex. Use when asked to preview a Swift file, capture simulator UI, or inspect visual output from SwiftUI views.

Xcode Preview Capture (Codex)

Use this skill to build SwiftUI previews and inspect screenshots.

Prerequisites

  • •Xcode + iOS Simulator installed
  • •Swift toolchain (preview-tool auto-builds on first run)
  • •PREVIEW_BUILD_PATH set to this repository root
    • •Example: export PREVIEW_BUILD_PATH=/absolute/path/to/XcodePreviews

Primary Command

Use the unified entry point first:

bash
"${PREVIEW_BUILD_PATH}"/scripts/preview \
  "<path-to-file.swift>" \
  --output /tmp/preview.png

The script auto-detects:

  • •Xcode project with #Preview -> dynamic target injection
  • •Swift Package -> SPM preview workflow
  • •Standalone Swift file -> minimal host build

Capture Current Simulator

bash
"${PREVIEW_BUILD_PATH}"/scripts/preview \
  --capture \
  --output /tmp/preview.png

Workflow

  1. •Run scripts/preview with the requested file or --capture.
  2. •Confirm the output path exists.
  3. •Open /tmp/preview*.png and analyze the rendered UI.
  4. •Report structure, styling, and visible issues (alignment, clipping, contrast, etc.).

Troubleshooting

  • •No simulator booted: run sim-manager.sh boot "iPhone 17 Pro".
  • •Build failure: surface the error and suggest targeted fixes.
  • •Wrong project detected: pass --project or --workspace explicitly.