Storybook-SwiftUI
iOS组件预览与开发调试的SwiftUI微框架
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Storybook-SwiftUI。 它的用途是：iOS组件预览与开发调试的SwiftUI微框架 完整的 Skill 内容见：https://321skill.com/skills/storybook-swiftui/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我正在开发一个iOS应用的按钮组件，想快速查看它在不同主题和字体大小下的效果。”，AI会建议你安装并配置Storybook-SwiftUI，然后指导你如何将按钮组件添加到Storybook集合中，最后在Xcode的预览画布或模拟器中直接交互式地切换暗色模式、调整字体大小来验证UI。
介绍
Storybook-SwiftUI 是一个用于在iOS和macOS应用中预览UI组件的微框架。它解决了开发者在构建UI时难以快速、独立地查看和验证组件在各种状态下的外观与行为的问题。
该框架利用Objective-C运行时和SwiftUI，无需修改现有应用代码。开发者只需在Storybook类上添加带有@objc标记的静态变量，即可将组件自动注入到预览集合中。它提供了一个类似Storybook的UI界面，支持按文件夹组织、搜索、标签筛选，并内置了暗色模式、动态字体大小等交互式预览控制。
它非常适合iOS/macOS应用的前端开发者和UI设计师，尤其是那些希望在不频繁编译运行整个应用的情况下，快速迭代和审查UI组件的团队。无论是纯SwiftUI项目，还是混合了UIKit的项目，都可以通过辅助库轻松集成。
使用建议是，虽然框架移除了DEBUG限制，但务必通过条件编译宏（如#if DEBUG）或构建配置来确保Storybook相关代码不会包含在最终的生产版本中，以避免不必要的包体积增加和潜在的安全风险。
核心特点
与同类工具相比，它无需修改现有组件代码即可实现动态预览，并提供了可交互的预览控制面板（如暗色模式切换、屏幕尺寸调整）；同时，它不强制要求项目使用SwiftUI，通过辅助库也能在UIKit项目中无缝使用。
注意事项
不适合用于生产环境代码打包，且对macOS的系统版本要求为11+。
常见问题
Storybook-SwiftUI 能在纯UIKit项目中使用吗？
可以，需要配合 UIKit helper library 使用。
这个框架会增大生产包的体积吗？
需要开发者自行通过条件编译宏控制，确保相关代码不被打包进生产版本。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/storybook-swiftui/raw/index.md 读取 Storybook-SwiftUI 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/storybook-swiftui/raw/index.md（查看排版版本）