用途:在目标仓库中新建或改写本地 React 与 Tailwind 页面组件,使实现尽可能小且贴合设计,同时保留 Prime 的工程质量。Prime 参考只作为实现模式,不要求保留不合适的标记。
前置条件:需先检查目标仓库及其最近的指令;将设计区块归一化并判定为 adapt 或 custom;记录结构契约(网格拓扑与跨度、媒体位置、图注布局、文字层级、全部可见控件与图标);检索并比较最接近的 Prime 候选组件族,必要时包括相邻分组;理解目标路径与已有本地使用方。若现有 Prime 组件无需结构性改动即可匹配,应回到复用路径,不要新建组件。
参考包:先读参考包说明再收集示例。规模保持小,通常两三个 Prime 候选加项目内最接近的本地模式,使用现有 Prime 候选、校验与组件导出工具,不要调用私有 API 或复制整个注册表。参考包需覆盖语义结构与组件边界、容器与网格/弹性盒/响应式约定、排版/间距/颜色/圆角/阴影/动效 token、prop 与变体模式、类名组合约定、资源处理与允许依赖、可访问性与客户端/服务端边界、仓库校验命令。当来源结构跨越分类标签时,应纳入不同分组的候选。参考冲突时,本地仓库指令与目标项目既有约定优先,除非它们妨碍所需设计结果。
adapt 与 custom:宏观结构、网格拓扑、内容顺序、媒体关系、图注结构和行为仍成立,差异仅在布局细节、响应式、样式或装饰时用 adapt;相似主题或栏目名不足以作为依据。需要不同的语义结构、内容槽、交互行为或响应式结构时用 custom,创建聚焦组件,避免在不适配的 Prime 组件中堆叠条件分支。两种模式都需在实现报告中记录所采用的 Prime 参考组件 ID。
编写契约:保留语义 HTML、键盘行为、焦点可见性、标签、替代文本、减少动效与交互状态语义;遵循仓库默认服务端组件,仅在真实浏览器 API、副作用、事件处理或本地交互状态处引入客户端边界;使用项目既有的 cn、cva、token 与变体约定,Tailwind 类需可静态发现;默认使用 Tailwind 工具类与语义 token,设计级重复值更新既有 token 源,真正一次性值使用可静态发现的任意工具类,不要散落重复原始值;不创建页面局部 CSS Module;用类型化 props 建模内容与变体,邻近组件分离数据时也分离;默认不下载或导出 Figma 位图媒体,用项目既有基于 Prime token 的占位模式保留精确槽位几何,并保持可由 next/image、video 或动画替换;保留精确 SVG 图标、矢量插画与矢量标志,仅在无矢量时可按原样导出位图标志,其他 Figma 位图导出需用户明确批准;记录待定位图节点身份、角色、宽高比、裁剪或焦点指引、推荐输出与媒体待定状态;复合 Figma 导出仅作结构证据,周围标题、文案、图标、卡片与控件应以 DOM 编写;不要用代码近似密集仪表盘、收据、图表、设备界面、地图或产品原型,除非明确要求功能重建;不得为视觉相似保留无效交互,每个可见标签、箭头、选择器、折叠触发器或按钮都须使用项目交互原语并暴露键盘、焦点与选中/展开状态。
视觉校正与验证:以 Figma 参考与浏览器渲染状态校正组件,先结构几何(容器与区块尺寸、网格对齐与换行、排版与文本行宽、间距与响应式过渡),再处理颜色、边框、圆角、阴影、媒体与动效。在参考视口下对齐截图比较;网格拓扑或跨度错误、媒体与文案顺序改变、图注布局错误、缺失图标或媒体槽、占位几何或明暗处理错误、未经批准的位图近似、文本换行显著不同均为阻塞项。layout-parity 可通过形状正确的媒体待定占位,但完整视觉一致与像素级状态不能通过;构建或交互测试通过不能清除这些差异,也不得报告为非阻塞偏差。若视觉校正会违反可访问性、产品行为或仓库策略,保留更高优先级要求并报告差异。
运行限定范围的仓库检查与每个受影响视口的渲染验证;共享组件适配需检查每个已知使用方,页面局部组件需检查目标页面及周围布局与导航。报告创建或改写的文件、Prime 参考、有意偏差、合成的交互状态、依赖、检查结果与视觉证据。浏览器验证须点击每个可见交互并确认可观察状态变化。不要将组件描述为可供 Prime 注册表发布;该流程仅产出本地项目代码。
限制:资料未提供具体命令、依赖版本、平台范围、收费信息或安装步骤;上述工具名称与路径前缀仅为原文提及,未给出可执行命令。