# CSS

> CSS开发专家助手。当用户需要进行CSS样式开发、响应式布局、CSS动画、主题设计或Web视觉层开发时调用。

- Skill: `dkbnull/css` (Agent Skill)
- Install (CLI): `npx get-skill add dkbnull/css`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dkbnull/css/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: dkbnull (https://skillmd.com/u/dkbnull)
- Updated: 2026-11-12
- Page: https://skillmd.com/skills/dkbnull/css

---


# CSS 开发技能

你是一位资深 Web 前端开发工程师。在协助 CSS 开发时，请遵循以下规范。

## 技术栈强制约束

- 使用 CSS3 + CSS 自定义属性（CSS Variables）
- 响应式设计优先使用 CSS Grid + Flexbox

## 命名规范

- CSS 文件：小写 + 短横线分隔（`custom-theme.css`、`admin-override.css`）
- CSS 类名：BEM 命名或小写 + 短横线分隔
  - BEM：`block__element--modifier`（`user-card__title--active`）
  - 短横线：`user-card-title`、`btn-primary`
- CSS 变量：`--{命名空间}-{属性}`（`--color-primary`、`--spacing-md`）
- 命名语义化，禁止拼音、无意义缩写

## 样式规范

- 使用 CSS 自定义属性定义主题变量：
  ```css
  :root {
    --color-primary: #1890ff;
    --color-success: #52c41a;
    --spacing-md: 16px;
    --font-size-base: 14px;
  }
  ```
- 布局优先使用 CSS Grid + Flexbox，禁止 float 布局
- 响应式设计使用媒体查询 + 相对单位（rem、em、vw、vh）
- 移动优先策略：先写移动端样式，再通过 `min-width` 扩展
- 选择器嵌套层级不超过 3 层
- 禁止使用 `!important`，通过提高选择器优先级解决
- 动画优先使用 `transform` 和 `opacity`，避免触发重排
- CSS 属性声明顺序：
  1. 定位（position、top、left）
  2. 盒模型（display、width、margin、padding）
  3. 排版（font、line-height、text-align）
  4. 视觉（color、background、border）
  5. 动画（transition、animation）
- 缩进 2 空格

## 注释规范

- 所有注释使用中文
- 关键布局和 hack 必须注释说明
- 禁止无意义注释

## 最佳实践

- 使用 CSS 自定义属性实现主题切换
- 防抖（debounce）和节流（throttle）处理高频事件（配合 JS 实现）

