mcpField
G
generating-ui-bundle-features

generating-ui-bundle-features

github.com/forcedotcom开发1.1k3.7k 次安装1 天前更新
代码仓库

关于 generating-ui-bundle-features

用于在 Salesforce UI bundle 中查找和安装预构建功能的工作流技能,涵盖搜索、查看详情、处理冲突及整合示例文件。

主要功能

  1. 01检查项目中已有实现
  2. 02搜索并查看功能详情
  3. 03安装功能并处理冲突
  4. 04整合示例文件

适用场景

  1. 01自定义开发前查找现成功能
  2. 02预览并安装 UI bundle 功能
  3. 03在非交互运行中解决安装冲突

安装

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

$npx skills add https://github.com/forcedotcom/sf-skills --skill generating-ui-bundle-features

安装后在 Claude Code 中输入/generating-ui-bundle-features确认已加载。

详细介绍

UI Bundle 功能

安装预构建功能

从头构建之前,务必先检查是否已有现成的功能。features CLI 可将经过预构建和测试的软件包安装到 Salesforce UI Bundle 中,涵盖基础 UI 库(shadcn/ui)以及全栈功能(身份验证、搜索、导航、GraphQL、Agentforce AI)。

工作流
  1. 先搜索项目代码 — 安装任何内容之前,先检查 src/ 中是否已有实现。搜索范围限定为 src/,避免匹配 node_modules/ 或 dist/。

  2. 搜索可用功能 — 使用 npx @salesforce/ui-bundle-features list 并通过 --search <query> 按关键词筛选。使用 --verbose 查看完整说明。

  3. 描述功能 — 使用 npx @salesforce/ui-bundle-features describe <feature> 查看组件、依赖项、复制操作和示例文件。

  4. 安装 — 使用 npx @salesforce/ui-bundle-features install <feature> --ui-bundle-dir <name>。主要选项:

    • 使用 --dry-run 预览更改
    • 使用 --yes 进入非交互模式(跳过冲突)
    • 使用 --on-conflict error 检测冲突,然后使用 --conflict-resolution <file> 解决冲突

如果未找到匹配的功能,请先询问用户,再构建自定义实现 — 可能存在名称不同但相关的功能。

冲突处理

在非交互环境中,使用两步法:先运行 --on-conflict error 检测冲突,然后创建一个解决方案 JSON 文件({ "path": "skip" | "overwrite" }),再使用 --conflict-resolution 重新运行。

安装后:集成示例文件

功能可能包含展示集成模式的 __example__ 文件。对于每个文件:

  1. 阅读示例文件,了解其模式
  2. 阅读目标文件(显示在 describe 的输出中)
  3. 将示例中的模式应用到目标文件中
  4. 成功集成后删除示例文件
提示占位符

某些复制路径使用 <descriptive-name> 占位符(例如 <desired-page-with-search-input>),CLI 不会解析这些占位符。安装后,将这些文件重命名或移至预期目标位置,或者将其中的模式集成到现有文件中。

评论

支持 Markdown