vibe-webeffect
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinesevibe-webeffect — 웹 애니메이션 추천·적용 스킬
vibe-webeffect — 网页动画推荐与应用 skill
사용자의 UI 작업 요구를 읽고 → 카탈로그에서 어울리는 효과를 골라 → 정확한 이름(KR+EN)과 이유와 함께 추천하고 → 동의하면 코드를 적용한다.
핵심 철학: "용어가 곧 능력" — 효과의 정확한 이름을 알려주는 것 자체가 사용자의 자산이 된다.
读取用户的 UI 工作需求 → 从目录中挑选合适的效果 → 用准确名称(KR+EN)并说明理由进行推荐 → 用户同意后应用代码。
核心理念:“术语即能力”——告诉用户效果的准确名称,本身就能成为用户后续可复用的资产。
파일 구성
文件构成
- — 72개 효과.
catalog.json스키마{id, cat, kr, en, intensity, tags, prereq, code, ref} - — 카테고리별 공용 구현 패턴(보일러플레이트). 코드 적용 전 반드시 읽는다
references/recipes.md
- — 72 个效果。
catalog.jsonschema{id, cat, kr, en, intensity, tags, prereq, code, ref} - — 按类别整理的通用实现模式(boilerplate)。应用代码前必须阅读
references/recipes.md
워크플로우
工作流
1단계 — UI 컨텍스트 추출
第 1 步 — 提取 UI 上下文
사용자 요청에서 만들려는 화면의 구성요소를 파악한다. 명시가 없으면 요청의 성격에서 추론한다.
| 감지된 컨텍스트 | 매칭 태그 | 우선 카테고리 |
|---|---|---|
| 히어로/랜딩 첫 화면 | hero, landing | signature, scroll, insane(1개만) |
| 콘텐츠 섹션/블로그/소개 | section, content | reveal (기본값) |
| 카드 그리드/갤러리/포트폴리오 | grid, gallery, card, portfolio | reveal(stagger) + hover |
| 통계/수치/성과 | stats, number | reveal(count-up), signature(number-roll) |
| 폼/로그인/설정 | form, input, settings | micro + loading(error-shake) |
| 버튼/CTA | button, cta | micro, hover |
| 데이터 로딩/API 호출 화면 | loading, wait, feed | loading (필수) |
| 챗/AI 인터페이스 | chat, ai | loading(typing), micro |
| 제품 상세/이커머스 | product, ecommerce | hover, scroll(before-after), micro(star) |
| 스토리텔링/브랜드 사이트 | storytelling, brand, wow | scroll, signature, insane |
| 타임라인/프로세스/연혁 | timeline, process | reveal(line-draw, alternate-slide) |
| 배경이 밋밋함 | background, ambient | insane(constellation 등), signature(blob) |
从用户请求中识别其想要构建的页面组成部分。如果未明确说明,则根据请求类型进行推断。
| 识别到的上下文 | 匹配标签 | 优先类别 |
|---|---|---|
| Hero/落地页首屏 | hero, landing | signature, scroll, insane(仅 1 个) |
| 内容区域/博客/介绍 | section, content | reveal(默认) |
| 卡片网格/画廊/作品集 | grid, gallery, card, portfolio | reveal(stagger) + hover |
| 统计数据/数值/业绩 | stats, number | reveal(count-up), signature(number-roll) |
| 表单/登录/设置 | form, input, settings | micro + loading(error-shake) |
| 按钮/CTA | button, cta | micro, hover |
| 数据加载/API 请求页面 | loading, wait, feed | loading(必需) |
| 聊天/AI 界面 | chat, ai | loading(typing), micro |
| 产品详情/电商 | product, ecommerce | hover, scroll(before-after), micro(star) |
| 叙事/品牌网站 | storytelling, brand, wow | scroll, signature, insane |
| 时间线/流程/发展历程 | timeline, process | reveal(line-draw, alternate-slide) |
| 背景过于单调 | background, ambient | insane(constellation 等), signature(blob) |
2단계 — 카탈로그 매칭
第 2 步 — 匹配目录
catalog.json读取 ,收集标签重叠的效果作为候选。如果强度相同,则优先选择 intensity 较低的效果(避免过度设计)。
catalog.json3단계 — 추천 제시 (적용 전에 반드시)
第 3 步 — 提出推荐(应用前必须执行)
상황별로 2~4개를 골라 아래 형식으로 제시하고 사용자의 선택을 받는다:
[한국어 이름] ([영어 이름]) — 왜 이 화면에 맞는지 한 줄 + 필요한 전제조건(있으면)
단, 사용자가 "알아서 해줘/바로 적용해줘"라고 했거나 이미 효과를 지정했다면 추천 단계를 건너뛰고 적용한다. 이때도 적용한 효과의 이름은 반드시 결과 보고에 명시한다.
根据具体场景选择 2~4 个效果,按照以下格式给出推荐,并让用户选择:
[韩文名称]([英文名称]) — 用一行说明它为何适合此页面 + 必要的前提条件(如果有)
但如果用户表示“你看着办/直接应用”,或者已经指定了具体效果,则跳过推荐步骤并直接应用。即便如此,最终结果中仍必须注明已应用效果的名称。
4단계 — 적용
第 4 步 — 应用
- 에서 해당 카테고리의 공용 패턴을 읽는다
references/recipes.md - catalog의 (핵심)와 recipes의 보일러플레이트를 조합해 사용자 프로젝트 구조에 맞게 삽입한다
code - 아래 적용 규칙을 지킨다
- 读取 中对应类别的通用模式
references/recipes.md - 将目录中的 (核心代码)与 recipes 中的 boilerplate 组合,并插入到适合用户项目结构的位置
code - 遵守以下应用规则
5단계 — 결과 보고
第 5 步 — 结果报告
적용한 효과의 이름(KR+EN)을 명시하고, 사용자가 나중에 AI에게 재요청할 수 있는 한 줄 지시문("~효과 넣어줘")을 함께 알려준다.
注明已应用效果的名称(KR+EN),并提供一句用户以后可以向 AI 再次提出的指令(“加上~效果”)。
적용 규칙 (위반 금지)
应用规则(禁止违反)
- 강도 배합 — 한 화면(뷰포트)에 는 최대 1개. 나머지는 subtle/medium. 전 화면이 다 움직이면 아무것도 안 보인다.
bold - reduced-motion 필수 — 모든 애니메이션에 가드 또는 JS
@media(prefers-reduced-motion:reduce)체크를 넣는다.matchMedia - 성능 — transform·opacity만 애니메이션하는 것을 기본으로 한다. ·
filter애니메이션은 작은 요소에만. 스크롤 핸들러엔 lerp/rAF, 리스너엔box-shadow.{passive:true} - transition 재생 함정 — transition 기반 효과를 재트리거할 땐 recipes.md의 "스냅 리셋" 패턴을 쓴다 (클래스 뗐다 바로 붙이면 재생 안 됨).
- 등장 효과는 IntersectionObserver 1개로 통합 — 요소마다 옵저버를 만들지 않는다.
- 로딩 UX 원칙 — 진행률을 알면 확정 프로그레스(+% 숫자), 모르면 무한/스피너, 구조를 알면 스켈레톤. 1초 미만 작업엔 로딩 표시 생략.
- 의존성 0 — 모든 효과는 라이브러리 없이 순수 HTML/CSS/JS로 적용한다. 사용자가 GSAP 등을 이미 쓰고 있을 때만 그 방식을 따른다.
- 마이크로 인터랙션 공용 이징 — (오버슈트 스프링).
cubic-bezier(.34,1.56,.64,1)
- 强度搭配 — 单个页面(viewport)中最多只能使用 1 个 效果,其余效果应为 subtle/medium。如果整个页面都在运动,反而会让任何元素都不够突出。
bold - reduced-motion 必需 — 所有动画都必须加入 守卫,或使用 JS
@media(prefers-reduced-motion:reduce)检查。matchMedia - 性能 — 默认只对 transform 和 opacity 做动画。与
filter动画仅用于较小的元素。滚动处理器使用 lerp/rAF,事件监听器使用box-shadow。{passive:true} - transition 重播陷阱 — 需要重新触发基于 transition 的效果时,使用 中的
recipes.md模式(如果只是移除 class 后立即重新添加,动画不会重播)。snap reset - 入场效果统一使用一个 IntersectionObserver — 不要为每个元素分别创建 observer。
- 加载 UX 原则 — 已知进度时使用确定性进度条(显示百分比数字),未知进度时使用无限动画或 spinner,已知数据结构时使用 skeleton。耗时不足 1 秒的操作无需显示加载状态。
- 零依赖 — 所有效果均使用纯 HTML/CSS/JS 实现,不引入任何库。只有当用户已经使用 GSAP 等库时,才沿用其实现方式。
- 微交互通用 easing — (超调弹簧效果)。
cubic-bezier(.34,1.56,.64,1)
추천 어조
推荐语气
- 이름을 가르치듯: "이건 **라인 마스크 리빌(line mask reveal)**이라고 하는데…"
- 과잉을 말리는 것도 추천이다: "여긴 효과 없이 두는 게 낫다"가 정답인 화면이 있다.
- 전제조건(예: 이미지 시퀀스는 ffmpeg 프레임 추출 필요)은 추천 시점에 미리 알린다.
- 像是在传授术语:“这个叫 线条遮罩显现(line mask reveal),原因是……”
- 也可以主动劝阻过度设计:有些页面最好的答案就是“这里不放效果”。
- 前提条件(例如,图像序列需要使用 ffmpeg 抽帧)应在推荐时提前说明。