SuperAPI AI 工具集

sf-lwc

前端与建站

查看项目

更新于 10-15 22:40

技能介绍

用途:sf-lwc 用于 Salesforce Lightning Web Components(LWC)开发,适用于处理 lwc/**/*.js、.html、.css、.js-meta.xml 文件,包括组件脚手架与 bundle 设计、wire 服务、Apex 与 GraphQL 集成、SLDS 2 与深色模式、无障碍、性能优化以及 Jest 单元测试。若任务以 Apex 控制器或业务逻辑为主,应交给 sf-apex;构建 Flow XML 交给 sf-flow;部署元数据交给 sf-deploy。

主要能力:采用 PICKLES 思路(原型、集成数据源、组合组件边界、定义交互模型、使用平台库、优化执行、强制安全)。数据访问模式按需选择:单记录 UI 用 LDS/getRecord,简单 CRUD 表单用基础记录表单组件,复杂服务端查询用 Apex @AuraEnabled(cacheable=true),关联图数据用 GraphQL wire 适配器,跨 DOM 通信用 Lightning Message Service。提供基础组件 bundle、datatable、模态、Flow 屏幕组件、GraphQL 组件、LMS 消息通道、Jest 测试、TypeScript 组件等资产。

使用方式:先收集组件用途、目标界面、数据源、是否需要测试、运行上下文(Flow、App Builder、Experience Cloud、仪表板)以及无障碍与样式期望。完成后按顺序报告:创建或更新的组件、所选数据访问模式、变更文件、无障碍/样式/测试说明、下一步实现或部署步骤。本地预览命令:sf lightning dev component --target-org <alias>、sf lightning dev app --target-org <alias>、sf lightning dev site --target-org <alias>。这些命令首次运行时会即时安装,属长驻进程并打开浏览器实时预览,.js、.html、.css 变更自动重载,需要活动 org 连接以获取数据和 Apex 调用。

限制与规则:优先使用平台基础组件;只读响应式场景用 @wire,显式操作与 DML 用命令式调用;不得引入不可访问的自定义 UI;避免硬编码颜色,使用 SLDS 2 兼容样式钩子/变量;避免 renderedCallback() 中的重渲染循环;组件通信模式应显式且最小化。评分参考:150+ 为可投产 bundle,125–149 为较强但需少量打磨,100–124 可用但建议审查,低于 100 需大幅改进。参考资料包括 component-patterns、slds-design-guide、lwc-best-practices、scoring-and-testing、jest-testing、accessibility-guide、performance-guide、state-management、template-anti-patterns、lms-guide、flow-integration-guide、advanced-features、async-notification-patterns、triangle-pattern 等。