用途:这是一套面向 AI 生成界面的强制设计与 UI 标准,用于让不同会话产出的 UI 遵循同一设计语言,避免间距、标题层级、元素选择与状态处理不一致。
主要能力:
- 设计系统与 token:所有颜色、间距、字号、圆角、阴影等必须引用 styles/global.css 中的 CSS 变量,禁止魔法数字与硬编码值。
- 语义化 HTML:使用 header、nav、main、article、section、footer;操作用 button、导航用 a;表单用 form、label、input 等;标题按 h1 到 h3 层级不跳级;图片需描述性 alt。
- CSS 质量:每行一个属性,按定位→盒模型→排版→视觉→动画顺序书写,类名具描述性,避免内联样式与类名堆砌(元素 1–3 个类,超过 4 个视为信号)。
- 组件状态:交互组件必须具备默认、悬停、按下、聚焦、禁用五种状态,聚焦需有清晰指示。
- 布局:结构默认用 CSS Grid 命名区域,导航项、画廊等流动项用 Flexbox。
- 响应式:移动优先,使用 min-width 断点(768、1024、1280px),容器最大宽度对应设置,不用 max-width 写法。
- 无障碍:WCAG AA 对比度(正文 4.5:1,大字 3:1)、键盘可操作、屏幕阅读器支持、表单标签,并尊重 prefers-reduced-motion。
- 反模式清单:禁止浮动标签、内联验证、通用错误提示、关键信息用 tooltip、无说明的禁用按钮、自定义滚动条、桌面端汉堡菜单。
使用方式:构建者写 HTML/CSS/JSX 前对照 Builder Checklist;重构者用 Enforced Rules 表查找违规。规则由 check.js 检查,含 no-inline-style、button-type-required、doctype-required、max-classes 等。附带 references、assets 与校验脚本。
适用场景:需要设计原则、token 约束或语义化 HTML 指导的界面开发。WCAG 深度合规、屏幕阅读器与 ARIA 交由 web-accessibility;CSS 架构、命名、暗色模式交由 web-css。
限制:为“非可协商”的规范性文档,具体实现细节以配套 references 为准;未提供收费、平台与效果数据。