用途:把 ShipSwift 本地源码库中现成的 SwiftUI 组件添加到用户项目里,适合用户提出“add component”“add a view”“I need a chart”“add animation”等需求时使用。
主要能力与流程:先读取 skills/catalog.md 确定组件,常见映射如“shimmer/loading skeleton”对应 SWAnimation/SWShimmer.swift,“donut chart/pie chart”对应 SWChart/SWDonutChart.swift,“alert/popup”对应 SWComponent/Feedback/SWAlert.swift,“auth/login”对应 SWModule/SWAuth/ 全部文件,“camera”对应 SWModule/SWCamera/ 全部文件。随后从 ShipSwift/SWPackage/<path> 读取 Swift 源文件,其中包含完整实现。接着把文件复制进用户项目,如尚未存在同时复制 SWUtil/,并按项目适配命名、颜色与数据模型;对 +iOS/+macOS 文件需在 Xcode Build Phases 中设置平台过滤。最后走查所需依赖或设置步骤。
约定:类型使用 SW 前缀(如 SWDonutChart、SWTypewriter);视图修饰符使用 .sw 前缀(如 .swShimmer()、.swGlowScan());图表组件采用泛型 CategoryType 模式并提供 String 便捷初始化器;内部辅助类型应为 private 且带 SW 前缀。SWAnimation/、SWChart/、SWComponent/ 下的组件各自独立(单文件加 SWUtil),SWModule/ 下为多文件模块,需复制整个文件夹。
限制:资料未提供支持的平台版本、依赖清单、许可方式、安装命令与价格信息。