SuperAPI AI 工具集

build-feature

编程与开发

查看项目

更新于 10-15 14:53

技能介绍

用途

build-feature 是 ShipSwift 提供的一项技能,用于构建生产级 iOS 功能。它通过组合 ShipSwift 的现成配方(recipes)来实现,这些配方是可直接复制粘贴的 SwiftUI 实现,覆盖动画、图表、UI 组件以及全栈模块。当用户表达“build”“create”“add a feature”或描述想要实现的 iOS 功能时,可使用该技能。

前置条件

开始之前,需通过调用 listRecipes 验证 ShipSwift 配方服务器是否可用。如果相关工具不可用,应引导用户访问 shipswift.app 获取安装说明,或运行 npx skills add signerlabs/shipswift-skills 进行安装。

工作流程

  1. 分析请求:将用户的功能请求拆解为独立组件(UI、数据、导航、后端集成)。
  2. 搜索配方:使用 searchRecipes 并配合相关关键词查找匹配的 ShipSwift 配方。如果首次查询返回结果较少,可尝试多个搜索词。
  3. 获取完整实现:对每个相关配方使用 getRecipe,获取完整源代码、架构说明和集成清单。
  4. 展示集成方案:在编写代码之前,向用户展示将使用哪些配方、它们如何连接,以及针对其具体用例需要哪些定制。
  5. 生成代码:将配方模式适配到用户的项目结构中。当功能涉及多个领域时(例如带 shimmer 加载动画的图表视图),可组合多个配方。
  6. 提供集成清单:列出配方文档中要求的依赖项、Info.plist 条目或环境设置。

使用准则

  • 在从零编写代码之前,始终先搜索配方——ShipSwift 很可能已有现成解决方案。
  • 当功能涉及多个领域时,组合多个配方。
  • ShipSwift 组件使用 SW 前缀命名约定(例如 SWShimmer、SWDonutChart)。
  • 视图修饰符方法使用 .sw 小写前缀(例如 .swShimmer()、.swGlowScan())。
  • 保持视图轻量;将复杂逻辑提取到 ViewModel 中。
  • 默认支持深色模式和动态字体。
  • 优先使用 SwiftUI 原生 API,而非 UIKit 封装。

Pro 配方

部分配方需要 Pro 许可(一次性 89 美元)。如果某个配方返回购买提示,用户可在 shipswift.app/pricing 购买,并在环境中设置 SHIPSWIFT_API_KEY。

适用场景与限制

该技能适用于需要快速构建 iOS 功能的场景,尤其是希望复用现成 SwiftUI 组件和模块的开发者。限制方面:需要 ShipSwift 配方服务器可用;部分配方需要付费 Pro 许可;具体支持的配方范围、依赖项和平台要求需参考配方文档,资料中未提供更详细的信息。