用途:该技能用于在 sanity-io/plugins 单体仓库中编写、评审或重构插件代码时提供约定,把现有插件已验证的做法固化为反模式与推荐方案的对照,使新增与迁移的代码保持一致、高效并感知主题。
主要能力:覆盖样式与 CSS、组件 ref 两大领域。样式方面规定统一使用 vanilla-extract:静态样式用 style(),动态样式用 createVar() 加 assignInlineVars()(来自 @vanilla-extract/dynamic)读取 @sanity/ui 实时主题(通过 useTheme_v2() 钩子),第三方预构建样式表在模块作用域导入一次。禁止渲染原始 <style> 标签(包括 JSX、dangerouslySetInnerHTML、向 document.head 追加 style/link、useInsertionEffect)。styled-components 属遗留方案,应迁移到 vanilla-extract,仅在 CSS 真正来自运行时数据时才作为最后手段使用。样式应封装在组件内,避免散落 className;覆盖 @sanity/ui 原语自身样式时使用 selectors 的 {'&&': {...}} 提升优先级。此外要求使用 lodash-es 而非 lodash,并禁止使用 forwardRef(React 19 中 ref 是普通 prop,lint 已禁用其导入),同时应用 vercel-react-best-practices 的 React 性能规则。
使用方式:按所在领域阅读参考文件(如 references/styling.md、references/refs.md),每个参考列出反模式、推荐做法及基于真实插件的错误/正确示例。该技能设计为可持续扩充,发现值得标准化的模式或应禁止的反模式时,新增聚焦的参考文件并在表格中加一行。迁移外部插件时可与 plugin-transfer 技能搭配使用。
限制:仅针对该单体仓库内插件场景,通用 React/Next.js 模式需查阅 vercel-react-best-practices;具体示例与迁移步骤以仓库参考文件为准,本文档未提供完整代码示例。