用途
explore-recipes 用于探索和浏览 ShipSwift 提供的全部配方(recipes)。ShipSwift 配方是面向生产环境的 SwiftUI 实现,覆盖动画、图表、UI 组件以及全栈模块。当用户说“探索”“浏览”“显示配方”“列出组件”“有什么可用”,或想要发现可用配方时,可使用该技能。
主要能力
- 列出全部配方:通过 listRecipes 获取完整目录,并按类别组织呈现。
- 按类别筛选:若用户关注某一类别,可使用 listRecipes 的类别筛选,或用 searchRecipes 按相关关键词搜索。
- 查看配方详情:用户选定某个配方后,用 getRecipe 获取完整实现,并展示该组件的作用、架构概览、关键特性与自定义选项,以及代码结构预览。
- 推荐组合:根据用户项目,推荐可良好搭配的配方组合。
使用方式
- 前置检查:开始前先调用 listRecipes,确认 ShipSwift 配方服务器可用。若工具不可用,引导用户访问 shipswift.app 获取安装说明,或运行 npx skills add signerlabs/shipswift-skills 安装。
- 列出可用配方:使用 listRecipes 获取完整目录,按类别呈现。资料中给出的类别与数量示例为:Animation 10 个(如 Shimmer、Typewriter、Glow Scan、Mesh Gradient);Chart 8 个(如 Line、Bar、Area、Donut、Radar、Heatmap);Component 14 个(如 Label、Alert、Loading、Stepper、Onboarding);Module 8 个(如 Auth、Camera、Chat、Settings、Subscriptions)。
- 按类别筛选(可选):若用户对特定类别感兴趣,使用 listRecipes 的类别筛选,或用 searchRecipes 配合相关关键词。
- 展示配方详情:用户选定配方后,用 getRecipe 获取完整实现,并展示组件作用、架构概览、关键特性与自定义选项、代码结构预览。
- 建议组合:根据用户项目推荐可搭配的配方组合,例如:入门引导流程 onboarding-view + typewriter-text + shimmer;分析仪表盘 line-chart + bar-chart + donut-chart + activity-heatmap;社交功能 camera + chat + auth-cognito。
适用场景
- 用户希望了解 ShipSwift 中有哪些可用配方。
- 用户想按动画、图表、组件或模块等类别浏览配方。
- 用户需要查看某个配方的实现细节与自定义选项。
- 用户希望根据当前项目获得配方组合建议。
限制与注意事项
- 使用前需确认 ShipSwift 配方服务器可用;若工具不可用,需按上述方式引导安装。
- 展示配方时应以易于浏览的格式(表格或项目符号列表)呈现。
- 应标明配方的层级(Free 或 Pro),让用户了解包含范围。
- 展示配方详情时应包含配方 ID,便于用户后续引用。
- 部分配方需要 Pro 许可(一次性 89 美元)。若配方返回购买提示,用户可在 shipswift.app/pricing 购买,并在环境中设置 SHIPSWIFT_API_KEY。
- 除上述内容外,其他功能、收费、平台或效果信息暂未提供。