关于 generating-ui-bundle-features
用于在 Salesforce UI bundle 中查找和安装预构建功能的工作流技能,涵盖搜索、查看详情、处理冲突及整合示例文件。
主要功能
- 01检查项目中已有实现
- 02搜索并查看功能详情
- 03安装功能并处理冲突
- 04整合示例文件
适用场景
- 01自定义开发前查找现成功能
- 02预览并安装 UI bundle 功能
- 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)。
工作流
-
先搜索项目代码 — 安装任何内容之前,先检查
src/中是否已有实现。搜索范围限定为src/,避免匹配node_modules/或dist/。 -
搜索可用功能 — 使用
npx @salesforce/ui-bundle-features list并通过--search <query>按关键词筛选。使用--verbose查看完整说明。 -
描述功能 — 使用
npx @salesforce/ui-bundle-features describe <feature>查看组件、依赖项、复制操作和示例文件。 -
安装 — 使用
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__ 文件。对于每个文件:
- 阅读示例文件,了解其模式
- 阅读目标文件(显示在
describe的输出中) - 将示例中的模式应用到目标文件中
- 成功集成后删除示例文件
提示占位符
某些复制路径使用 <descriptive-name> 占位符(例如 <desired-page-with-search-input>),CLI 不会解析这些占位符。安装后,将这些文件重命名或移至预期目标位置,或者将其中的模式集成到现有文件中。