用途:将已批准的视觉方向转化为可测试的 UI 基础,包括真实资产、语义 token 和可复用组件。
主要能力与流程:
- 读取方向与项目:读取 visual-direction 记录并检查其已批准的 moodboard,确认批准对应可见修订;缺失输入或批准则报告并停止。检查框架、样式、资产、tokens、组件、依赖与渲染命令,保留品牌、产品与无障碍固定约束。
- 将方向映射为系统:有现成组件基座则复用,否则选择合适且维护中的基座;React 与 Tailwind 场景优先 shadcn/ui,除非项目约束另有要求。将选定的 moodboard 特质翻译为字体、语义颜色角色、间距/形状/层级/动效/焦点、摄影/插画/图标/纹理/图案规则,以及最小可复用组件集。
- 构建并验证基础:配置基座并实现资产、tokens 与组件,保留基座库的无障碍行为。构建两个代表性产品组合,均复用同一系统且无局部样式例外。渲染窄/宽宽度、主题、长短内容及交互状态,检查图片与字体加载、裁切与层级。测量对比度、键盘导航、可访问名称与角色、文本放大与回流、减少动效等,记录工具、用例、测量与限制;仅自动扫描不算证明无障碍。缺少必需检查时应报告缺口并停止,不能宣称完成。
- 展示、批准与记录:通过内联图片、打开的 harness 或外部浏览器预览展示两个渲染案例;HTML 需先提供服务并打开 URL。逐次展示视觉修订与比较、测试条件与限制。批准后写 docs/visual-foundation.md,记录方向、批准修订、资产与 token 位置、组件规则、两个证明案例、渲染命令、无障碍证据、接受限制、批准人与日期。
限制:资料未提供收费、价格、平台支持范围等具体信息;无法确定的部分应明确为暂未提供。