用途:该技能用于构建 SwiftUI 视图并截取其渲染结果,以便进行视觉分析,适合需要查看 UI 实际输出、验证布局或检查视觉组件的场景。
主要能力:支持构建仅含系统框架的独立 Swift 文件;支持从现有 Xcode 项目构建视图;支持从 SPM 包构建视图;支持截取当前已启动模拟器的屏幕;并对截取到的截图进行分析。统一预览脚本会自动检测项目类型并选择合适方式。
使用方式:脚本位于 ${CLAUDE_PLUGIN_ROOT}/scripts/。推荐的统一预览命令为:"${CLAUDE_PLUGIN_ROOT}"/scripts/preview <path-to-file.swift> --output /tmp/preview.png。截取当前模拟器屏幕可使用:"${CLAUDE_PLUGIN_ROOT}"/scripts/capture-simulator.sh --output /tmp/preview-capture.png。针对 Xcode 项目可加 --project <path.xcodeproj>;SPM 包会从父目录的 Package.swift 自动检测。工作流为:确定目标(某个 Swift 文件、含 scheme 的 Xcode 项目/工作区、或当前模拟器状态),构建并截取,用 Read 工具查看 PNG,然后报告布局结构、颜色样式、对齐或溢出等问题以及改进建议。可指定参数包括 file、project、workspace、scheme、simulator(默认 iPhone 17 Pro)、wait(默认 3 秒)。示例:/preview ContentView.swift、/preview --project MyApp.xcodeproj --scheme MyApp、/preview --capture-only。
错误处理:构建失败时显示构建错误输出,并基于错误信息建议修复方式,可在修复后重试;若没有已启动的模拟器,则列出可用模拟器并提供启动选项。
限制:资料未提供收费、价格、平台要求、依赖版本、支持范围或性能等额外信息;具体可用性取决于本机的 Xcode、模拟器与脚本环境。