用途:在编写、审查或重构 CSS 时提供指导,优先考虑 Web 标准、无障碍、性能与可维护性。
主要能力与原则:优先使用原生 CSS 特性,除非明确要求,否则不引入 Tailwind 或 CSS-in-JS;样式须支持而非妨碍辅助技术,并尊重用户的动效、配色与对比度偏好;关注性能,减少重绘、避免布局抖动、使用高效选择器;代码可读优先于炫技,显式优先于隐式,避免魔法数字,用自定义属性共享值。
使用方式:写 CSS 前先查阅 references/patterns.md 中的既有模式与片段;不确定时参考 MDN Web Docs 或 CSS 规范;在符合上述原则的前提下可提出该技能模式之外的替代方案。
写作规范要点:选择器优先用类选择器,保持低而可预测的特异性,嵌套控制在 2 至 3 层;用 -- 前缀自定义属性管理颜色、间距、排版等重复值,定义在 :root 或合适作用域,命名如 --color-primary、--spacing-md、--font-size-body;始终使用逻辑属性(margin-inline、padding-block、inset-inline-start、block-size 等)替代物理属性,仅在逻辑等价物尚不存在时回退;排版与间距用 rem,组件相对尺寸可用 em,视口单位谨慎使用并准备回退,字号避免 px;颜色函数使用现代空格分隔语法,推荐 oklch(),可用相对颜色语法派生悬停态或透明变体;二维布局用 CSS Grid,一维对齐用 Flexbox,避免用浮动做布局;媒体查询使用现代范围语法如 @media (width < 48rem),采用 Shared First 而非移动优先,尽量减少断点。
无障碍与性能:不得用 display: none 或 visibility: hidden 隐藏应保留给屏幕阅读器的内容;尊重 prefers-reduced-motion、prefers-color-scheme、prefers-contrast;保证足够对比度(至少 WCAG AA,推荐 AAA);保留可见焦点指示,不得在无替代方案时移除 :focus 样式;动画避免昂贵属性,优先 transform 与 opacity;谨慎使用 will-change;减少 * 选择器;大型代码库可用 @layer 管理层叠。
限制:资料未提供安装命令、收费、平台或具体效果信息;references/patterns.md 的具体内容未在资料中展开,缺失模式需按核心原则自行建议。