mcpField
A
add-component

add-component

github.com/signerlabs开发3.3k121 次安装6 天前更新
代码仓库

关于 add-component

此技能用于从 ShipSwift 本地源码库向项目添加 SwiftUI 组件，帮助定位组件、复制实现及依赖，并按项目需求调整。

主要功能

  1. 01从目录查找组件
  2. 02读取组件源码文件
  3. 03将文件复制到项目
  4. 04调整名称、颜色和数据模型
  5. 05检查依赖与设置步骤

适用场景

  1. 01添加 shimmer 加载效果
  2. 02集成图表或提醒组件
  3. 03添加认证或相机模块

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/signerlabs/shipswift --skill add-component

安装后在 Claude Code 中输入/add-component确认已加载。

详细介绍

从 ShipSwift 添加组件

从 ShipSwift 的本地源代码库向项目中添加可用于生产环境的 SwiftUI 组件。

工作流

  1. 确定组件：阅读 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/（所有文件）

  2. 阅读源文件：从 ShipSwift/SWPackage/<path> 读取 Swift 文件。该文件包含完整实现。

  3. 集成到项目中：

    • 将文件复制到用户的项目中
    • 如果项目中尚不存在 SWUtil/，也将其复制过去
    • 调整命名、颜色和数据模型，使其与项目保持一致
    • 对于 +iOS/+macOS 文件，在 Xcode Build Phases 中设置平台筛选器

  4. 验证：检查所需的依赖项和设置步骤。

指南

  • 类型使用 SW 前缀（SWDonutChart、SWTypewriter）。
  • 视图修饰符使用 .sw 前缀（.swShimmer()、.swGlowScan()）。
  • 图表组件使用泛型 CategoryType 模式，并提供便捷的 String 初始化器。
  • 内部辅助类型应设为 private，并使用 SW 前缀。
  • SWAnimation/、SWChart/ 和 SWComponent/ 中的组件都是独立的（单个文件 + SWUtil）。
  • SWModule/ 中的模块包含多个文件，应复制整个文件夹。

评论

支持 Markdown