프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. Google로 로그인하면 리뷰를 쓸 수 있어요.프로토타입 · 30분마다 업데이트
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요

web-design Skill

저장소 ↗

제작자: xiaopu-ai★ 818skill 1개

설치

What it does

A Claude Code SKILL for designing beautiful, consistent web pages — spec first, code second.

  • Connects Instruction files the AI reads; connects to nothing
  • Account or key No key needed
  • Category 디자인과 웹
제작자용: README에 배지 달기

제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skill/xiaopu-ai-web-design.svg)](https://mcp.popnx.com/en/skills/xiaopu-ai-web-design)

함께 쓰기

같은 작업에서 AI를 서비스에 연결하는 MCP

Figma Context MCP

Give your coding agent access to your Figma data. Implement designs in any framework in one-shot.

제작자: GLips널리 사용됨↓ 15.2만/주★ 1.6만5개월 전 업데이트

MCP · 서비스 연결내 컴퓨터에서 실행

Next AI Draw.io

draw.io diagrams your AI agent draws on a live browser canvas that you can also edit by hand

제작자: DayuanJiang널리 사용됨↓ 2.2만/주★ 3.7만 저장소 전체의 별그저께 업데이트

MCP · 서비스 연결내 컴퓨터에서 실행

Pascal 3D Editor

Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.

제작자: pascalorg널리 사용됨↓ 1천/주★ 2.6만 저장소 전체의 별3일 전 업데이트

MCP · 서비스 연결컴퓨터 또는 클라우드✓ 서비스 회사 · pascal.app

비슷한 Skill

같은 종류의 작업, Skill 목록과 같은 순서

비슷한 항목과 비교
이 항목
web-design
impeccablediagram-designfrontend-slidesguizang-ppt-skill
제작자xiaopu-aipbakauscathrynlaveryzarazhangruiop7418
Skill 수1111–
GitHub 별818111,13167,54432,39929,871
마지막 코드 변경2026년 6월 24일2026년 11월 16일2026년 11월 13일2026년 6월 24일2026년 10월 30일
라이선스MITApache-2.0MITMITAGPL-3.0

xiaopu-ai의 Skill(지시 묶음) 1개, AI가 읽고 그대로 일해요 · MCP server가 아니에요

Skill과 MCP의 차이

MCP = 손

AI를 외부 서비스나 데이터에 연결합니다(예: Notion 읽기, 청구서 만들기). 프로그램이나 서버가 실행 중이어야 합니다.

Skill = 안내서

작업 방법을 AI에게 가르치는 텍스트 파일. 어떤 서비스에도 연결되지 않습니다.

겹치는 경우도 있습니다. 도구를 부르는 스크립트가 있는 Skill도, 지식만 보내는 MCP도 있습니다. 하려는 작업을 기준으로 고르세요.

쓸 수 있는 앱

Claude Code

제작자 README와 repo 폴더 기준

설치

Is it safe?

  • Who made it

    GitHub account xiaopu-ai (person), 1 years old

  • Use and upkeep

    ★ 818 stars · code last changed 2026년 6월 24일

  • Any scripts?

    4 scripts that can run on a computer: docs/app.js, scripts/crawl_website.py, scripts/extract_design_tokens.py, scripts/fetch_unsplash_images.py

  • Uses the internet?

    Scripts that go online: scripts/extract_design_tokens.py

  • Changes machine-wide settings?

    No hooks or writes to machine settings found

Checked automatically from the repo files at commit 22a4f48 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself

먼저: 어떤 AI를 쓰시나요

쓰는 앱을 고르면 그 앱의 설치 방법만 보여 드립니다

Option 1Upload to claude.ai (web and app)

Uploading to claude.ai would fail: the description is over 200 characters (268). Use "Let the AI install it" instead

Option 1Claude Code에게 설치 맡기기

이 문장을 복사해 Claude Code 채팅에 붙여 넣으세요

Where to install

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Claude Code를 다시 열고 /web-design를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요

Checked against official docs 2026년 11월 12일 · Source: code.claude.com

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.claude/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

  3. Claude Code를 다시 열고 /web-design를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요

직접 설치한 Skill은 ChatGPT 데스크톱 앱, Codex CLI, IDE의 Codex 확장 프로그램에서 쓸 수 있습니다 · 웹과 모바일의 ChatGPT에서는 직접 설치한 Skill을 쓸 수 없고 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다

ChatGPT 데스크톱 앱

ChatGPT 데스크톱 앱에는 Codex가 들어 있고, Codex는 ~/.agents/skills 폴더에서 Skill을 읽습니다

Option 1ChatGPT에게 설치 맡기기

ChatGPT 데스크톱 앱에서 Codex를 열고 이 문장을 채팅에 붙여 넣으세요

Where to install

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Option 2폴더를 직접 넣기

web-design 폴더를 ~/.agents/skills/web-design에 넣으세요

~는 홈 폴더($HOME)입니다

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.agents/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

설치한 뒤

  • ChatGPT 데스크톱 앱: 사이드바에서 Skills를 열어 Skill이 보이는지 확인하세요
  • 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요
  • Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

웹과 모바일의 ChatGPT

직접 설치한 Skill은 쓸 수 없고, 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다

이 Skill을 ChatGPT에서 쓰려면 위 방법대로 ChatGPT 데스크톱 앱을 쓰세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

Option 1Codex에게 설치 맡기기

이 문장을 복사해 Codex 채팅에 붙여 넣으세요 · ChatGPT 데스크톱 앱 안의 Codex, Codex CLI, IDE 확장 프로그램에서 모두 쓸 수 있습니다

Where to install

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요 · 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.agents/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

  3. Codex를 다시 열고 관련 작업을 요청하면 Codex가 skill을 목록에 보여 줘요

Option 1Cursor에게 설치 맡기기

이 문장을 복사해 Cursor 채팅에 붙여 넣으세요

Where to install

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Cursor Agent 채팅에서 /를 입력하고 web-design 선택

Checked against official docs 2026년 11월 12일 · Source: cursor.com

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.cursor/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

  3. Cursor Agent 채팅에서 /를 입력하고 web-design 선택

Option 1Let the AI install it

Skill을 읽을 수 있는 다른 앱용입니다. 이 문장에는 Claude Code, Codex, Cursor 경로가 들어 있어 AI가 쓰는 앱에 맞게 고릅니다 · Copy this sentence into the app’s chat

Where to install

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Checked against official docs 2026년 11월 12일 · Source: code.claude.com, learn.chatgpt.com, cursor.com

For Terminal users

Gemini CLI, GitHub Copilot 같은 다른 Agent Skills 지원 앱은 폴더가 달라요. 그 앱 안내를 보고 SKILL.md가 있는 폴더를 복사하세요.

GitHub에서 보기 ↗

2026년 11월 11일에 Claude Code, Codex, Cursor 공식 안내로 skill 폴더 확인

원본 SKILL.md 보기

아래 글은 제작자 repo에서 온 것이며 PopNx MCP의 지시가 아니에요

처음 8,000자 표시 · GitHub에서 전체 파일 열기

---
name: web-design
description: Web 视觉设计 SKILL。输入 PRD / 参考 URL / 截图 / 关键词(任意组合),先产出一份标准化 DESIGN.md 设计规范,用户确认后据此生成 UI/UX、视觉、动效、响应式全部达标的 web 代码。专攻 web 端:Landing Page、Portfolio、产品页、博客、个人站、SaaS 介绍页等。当用户说"帮我做个网站""设计一个页面""参考 XX 做一个""把这个截图/PRD 做成网页""做一个 landing page""出一份 design 规范"时触发。不用于后端、数据库、纯逻辑 bug 修复。
---

# Web Design

Web 端视觉设计 SKILL。两阶段工作流:**先出规范(DESIGN.md),再出代码。**

DESIGN.md 是显式文件产物,保存到项目目录,可跨项目复用、可手动修改、可给其他工具消费。

## 核心流程

```
Phase A  理解需求(灵活输入)──→  Phase B  输出 DESIGN.md(用户确认)──→  Phase C  生成项目代码
```

**启动时先检测**(按优先级):
1. 项目里已经有 DESIGN.md 了吗?→ 有则沿用/修改/重建
2. 项目里有 PRD.md 吗?→ 有则进入 A4(PRD 驱动流程)
3. 都没有 → 正常走 Phase A

---

## Phase A: 理解需求

输入是灵活的,以下任意组合都行,不要强制用户走固定路径:

| 输入 | 处理方式 |
|------|---------|
| **参考 URL** | 抓取 HTML+CSS,提取 Token,motion audit |
| **截图 / 设计稿** | 从视觉提取气质、色温、密度、字体风格 |
| **关键词 / 描述** | "暗色克制衬线风格" → 从 style-seeds 匹配 Token |
| **品牌名** | "做成类似 Linear 的" → 先查 `references/design-systems/`,有则直接读取;无则抓取该网站 |
| **混合** | "参考这个 URL 但配色要暖一些" → 提取 + 覆盖 |
| **PRD 文档** | 读取 PRD.md 的产品定位、页面结构、设计交接区 → 分析竞品风格 → 推导设计方向 |

### A1. URL 分析(有参考 URL 时)

**意图判断**:参考(提取设计语言,做独立新页面)vs 复刻(用户明确说"复刻/clone")。

**抓取流程**(按优先级尝试):

1. **首选:Playwright 爬虫**(真实浏览器,能绕反爬、渲染 SPA、模拟滚动)
   ```bash
   python3 scripts/crawl_website.py --url [URL] --output ./crawl-output --scroll-delay 600
   ```
   输出:每屏视口截图 + tokens.json + structure.json + styles.css
   
2. **备选:Token 提取脚本**(轻量,适合简单静态站)
   ```bash
   python3 scripts/extract_design_tokens.py --url [URL] --format json
   ```

3. **降级:手动 curl**(脚本都不可用时)
   ```bash
   curl -Ls [URL]
   ```

综合三类输入判断:实际体验(氛围节奏)> 截图(局部气质)> Token 数值(精确参数)。Playwright 爬虫的视口截图可直接作为"体验"和"截图"两类输入。

**Motion Audit**(参考站有滚动联动动效时必做):
- 触发信号:动效跟随滚动连续变化 / 模块间有 stagger-pin-parallax / 引用 GSAP-Lenis 等
- 记录每个动效区块的 trigger、driver、elements、effect、timing

**降级链路**:
- Playwright 爬虫失败 → 查 `references/design-systems/` 有无该品牌预置文件(58 个品牌)
- 预置文件也无 → `extract_design_tokens.py` 尝试静态提取
- 静态提取也失败 → 手动 curl CSS
- 全部失败 → 要求用户提供截图,从视觉手动建 Token

### A2. 对话引导(无参考物时)

快速锁定风格方向,不要机械走问答清单:

**核心问题**(按需选问,不全问):
- 亮色 vs 暗色?
- 衬线 vs 无衬线?
- 克制留白 vs 丰富饱满?
- 强调色偏好?
- 有没有喜欢的网站或风格参考?

从 `references/style-seeds.md` 匹配最近似的种子(10 种预设方向),展示给用户确认或混搭。

用户提到具体品牌时,查阅 `references/design-systems/INDEX.md` 按类别检索,按需读取对应品牌文件(58 个真实网站设计规范,每个 ~300 行)。品牌文件只含静态设计系统,动效仍需按交互档位补充。

### A3. 交互档位确认(不可跳过)

| 档位 | 体验感 |
|------|--------|
| **L1** 精致静态 | 优雅 hover + 柔和入场 |
| **L2** 流畅交互 | 滚动 reveal、视差、导航变化 |
| **L3** 沉浸体验 | 滚动驱动时间线、pin、光标跟随、转场 |

L2 追问:reveal 风格(fadeInUp/scaleIn)、视差、导航变化
L3 追问:section pin、光标效果、转场、是否允许 GSAP/ScrollTrigger/Lenis

查阅 `references/interaction-patterns.md` 获取对应档位的完整代码。

### A4. PRD 驱动(检测到项目级规范文件时)

**启动时自动扫描项目根目录**,按优先级:
1. `PRD.md` / `prd.md`
2. `SPEC.md` / `spec.md`
3. `README.md` 或任何 `.md` — 若含「产品定位 / Target Users / Pages / 核心页面」等关键字段

**不绑定特定工具或模板**。只要能从文档里抽到下列字段,就足以作为设计输入:

| 字段(中/英别名) | 用途 |
|-------------------|------|
| 产品名称 / Product / Name | Hero 文案 |
| 一句话定位 / Tagline / Pitch | Hero 副标题、定调 |
| 目标用户 / Target Users / Audience | 色彩温度、字体风格决策 |
| 核心页面 / Pages / Screens | Phase C 生成清单 |
| 竞品 / Competitors / References | Phase A 风格参考起点 |
| 技术栈 / Tech Stack | Phase C 代码生成方案 |
| 设计交接 / Design Notes / 调性 | 直接继承的硬约束 |

**竞品风格分析**:
- PRD 提到竞品 → 优先查 `references/design-systems/` 是否已有预置
- 有预置 → 读取该品牌规范作为起点
- 无预置 → 调用 `scripts/crawl_website.py` 抓取提取
- PRD 没提 → 按产品类型 + 调性从 `references/style-seeds.md` 匹配最近种子

**提取不到关键字段时**:不要瞎猜,回到对话引导(A2)补齐。

**与用户确认**(示例):
> 我从 `{文件名}` 读到了:
> - 产品:{名称} — {一句话定位}
> - 目标用户:{画像}
> - 参考竞品:{列表 或 "无"}
> - 建议的风格方向:{1-2 个候选,各附一句理由}
>
> 这个方向对吗?

确认后进入 A3(交互档位),然后 Phase B。

---

## Phase B: 输出 DESIGN.md(必走)

**必须生成 DESIGN.md 文件。** 按 `references/design-md-template.md` 模板输出 9 个章节:

1. **Visual Theme & Atmosphere** — 设计哲学、氛围关键词、一句话定调
2. **Color Palette & Roles** — 完整 CSS 变量定义(含 RGB 辅助值)
3. **Typography Rules** — 字体族、Google Fonts URL、字号层级表、禁止字体
4. **Component Stylings** — 按钮/卡片/导航/链接/标签等完整 CSS(含所有状态)
5. **Layout Principles** — 网格、间距梯度、容器宽度
6. **Depth & Elevation** — 阴影体系
7. **Animation & Interaction** — 动效档位、入场/滚动/悬停/特效的完整代码
8. **Do's and Don'ts** — 设计护栏、Anti-Patterns(至少 8 条)
9. **Responsive Behavior** — 断点、触摸目标、折叠策略

**文字装饰规则**:生成 Color Palette 和 Typography 后,按 `references/text-decoration-rules.md` 决策表对标题逐级判断是否添加渐变/投影。

**展示摘要给用户确认**,确认后保存 DESIGN.md 到项目目录,再进入 Phase C。

---

## Phase C: 生成项目代码(必走)

### C1. 确认场景 + 收集内容

问用户做什么页面,收集具体内容。查阅 `references/scene-defaults.md` 获取该场景的布局和组件基线。

**常见场景的内容需求**:

| 场景 | 需要收集 |
|------|---------|
| Landing Page | 标题、副标题、Feature 列表、CTA、Social proof |
| 个人站 / Portfolio | 名字、头衔、项目列表、关于、联系方式、博客列表 |
| Blog | 名称、文章列表/内容、作者信息、分类标签 |
| 产品页 | 产品名、卖点、功能截图、定价、FAQ |

用户信息不全时主动问;用户说"你先做,内容我后面填"则用合理的占位内容。

### C2. 设计框架 + 生成代码

1. **检查项目环境**:框架、路由、样式方案、现有组件和 assets
2. **框架决策**:有项目 → 沿用;无项目 → 最小可行方案
3. **严格按 DESIGN.md 生成**:
   - 所有颜色通过 CSS 变量引用
   - 字体按 DESIGN.md 定义使用
   - 交互按 DESIGN.md 指定档位实现
   - 不违反 Do's and Don'ts
4. **图片策略**:用户素材 > 项目 assets > 参考站 URL 占位 > Unsplash
5. **图标策略**:项目现有库 > lucide-react > 内联 SVG(参考 `references/icon-library.md`)

### C3. 审计

- **DESIGN.md 合规检查**:代码是否严格遵循规范
- **参考物差异审计**(有参考时):Token / 版式 / 字体 / 交互 / 素材逐项比对
- **响应式验证**:至少移动端 + 桌面端
- **质量清单**:读 `references/quality-checklist.md` 逐项自检

---

## 首页爆点原则(Landing Page 专属)

一个 Web 平台最重要的是**落地页(首页)**。其他页面保持规范、风格统一即可,唯有首页必须满足下面两条硬性原则,不可妥协。

### 原则一:3 个「卧槽」爆点 + 1 个巧思

爆点位置**固定**,每个位置必须有一个让用户"卧槽"的视觉冲击:

| # | 位置 | 要求 | 典型招式 |
|---|------|------|---------|
| **1** | **首屏 / Hero** | 加载瞬间就被动态/3D/巨型渐变震住 | 卡片星座爆发、WebGL 3D 物体、巨型标题 mask reveal、鼠标跟随光斑、3D 卡片堆 |
| **2** | **首次滑动** | 离开首屏的第一个 section 必须有"钩子"继续吸引 | 宣言横滚带(大字 marquee)、数字爆发、分屏切割、卡片汇聚转场、全屏视频 |
| **3** | **列表 / 阵列 / 枚举 / 展示区** | 不能是普通等大 grid | Bento 不等大布局、SpotlightCard hover 跟踪光、3D 倾斜卡片、抽象艺术顶 |

**1 个巧思设计点**:一处"不注意就错过、一注意到就笑"的细节。候选:
- 交互反馈微动画(复制后的 sparkle + tooltip)
- 彩蛋(Konami / Ctrl+K 命令面板)
- Meta 梗(关键词 hover 弹 "这就是本页用到的规范 →")
- 滚动到底的小惊喜(如"你看到这里了,谢谢")

### 原则二:流畅 · 滑动无阻(不可破)

以下是性能红线,与爆点设计**同等优先级**。爆点炸裂但卡顿 = 零分。

- **3D / WebGL**:全页最多 1 处,且必须 IntersectionObserver 不可见时暂停
- **`filter: blur()` on moving elements**:禁止。用 opacity + scale 做景深代替
- **`backdrop-filter: blur()`**:值 ≤ 14px,且不覆盖大面积滚动区
- **Lenis / scroll-jacking**:仅当 pin-scrub 真正必要时启用;普通页面用原生 `scroll-behavior: smooth`
- **ScrollTrigger pin**:单页 ≤ 2 处(doubao 级叙事才解锁)
- **pointermove 监听**:必须 rAF 节流
- **Custom cursor 全局替换**:仅在气质强烈的设计类/工具类站点用,普通 SaaS 禁用

### 实现建议(性能友好的爆点配方)

这些组合实测在中等配置设备可达 60fps:

| 爆点 | 实现 | 性能成本 |
|------|------|---------|
| **鼠标聚光灯** | CSS var `--mx/--my` + `radial-gradient(at var(--mx) var(--my))` | ⭐ 极低(单次 repaint)|
| **卡片爆发入场** | GSAP 一次性 timeline(load 时 stagger 1.5s,结束即释放)| ⭐⭐ 低(仅 1 次)|
| **宣言横滚带** | 纯 CSS `transform: translateX` keyframes | ⭐ 极低 |
| **SpotlightCard** | 每张卡 `--mx/--my` + `::before` radial-gradient(rAF 节流)| ⭐⭐ 低 |
| **大字 mask reveal** | 纯 CSS `clip-path` 一次性动画 | ⭐ 极低 |
| **关键字渐变流动** | `background-position` 动画 | ⭐ 极低 |

避免的反面组合:
- ❌ 12+ 元素同时带 `filter: blur()` + `will-change`(GPU 内存爆)
- ❌ Lenis + 多个 pin-scrub + WebGL(主线程堵死)
- ❌ Three.js 常驻渲染不暂停(即使离开视窗也吃 FPS)

---

## 100 分质量底线(硬性验收)

DESIGN.md + 生成代码必须**同时**满足以下全部条件,任何一条不满足都算未完成。完整细项见 `references/quality-checklist.md`,这里是最核心的红线:

### DESIGN.md 红线
- 9 个章节都有实质内容,不是模板占位
- 每个组件样式包含 default / hover / active / focus / disabled **全部状态**
- 所有颜色定义为 CSS 变量,含 RGB 辅助值(便于 rgba)
- 字体有 `@import` URL + fallback stack
- 动效档位明确(L1/L2/L3),对应依赖声明完整
- Do's and Don'ts ≥ 8 条,其中 Don'ts ≥ 5 条
- L2+ 必须包含 `prefers-reduced-motion` 降级
- 响应式至少覆盖 Desktop + Mobile

### 代码红线
- 所有颜色通过 CSS 变量引用,**零硬编码 hex**
- 字体严格按 DESIGN.md 的 Typography Rules 实现
- 每个可交互元素有 hover + focus 态
- 入场动画已实现(至少 L1 级 fadeIn)
- L2+ 实现滚动 reveal + 导航滚动态 + 视差
- L3 实现 pin / 光标跟随 / 转场
- 图片**禁用纯色块占位**(参考站 URL / Unsplash / 用户素材)
- 图标用项目库 / lucide-react / 内联 SVG(Playful 调性外禁 Emoji)
- 未违反 DESIGN.md Do's and Don'ts 中的任何一条
- 移动端 ≤ 600px 无横向溢出,触摸目标 ≥ 44×44px

### 签名动效红线(L2+ 强制,L3 加倍)

**任何 L2 及以上页面必须包含以下 6 类动效,缺一不可**。优先从 [vue-bits / reactbits](https://github.com/DavidHDev/vue-bits) 目录挑(查 `references/motion-library.md`),能复用源码就不要自己写。

| 类别 | 数量 | 落点 |
|------|------|------|
| Text Animation — Hero H1 | ≥ 1 | 大标题入场或持续态(如 SplitText / ShinyText / GradientText) |
| Text Animati

토론

질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.

아직 글이 없어요. 처음으로 질문하거나 공유해 보세요.

이곳의 글은 사용자가 쓴 것으로, PopNx 팀의 글이 아니에요.

로그인하고 글쓰기

GitHub 정보

GitHub 스타
818
제작자
xiaopu-ai
라이선스
MIT
최근 코드 수정
2026년 6월 24일
repo 안 SKILL.md(번역본과 템플릿 포함)
1
토픽
claude-code, claude-skill, design-system, we-b, web-design, webdesign, xiaopu