vibe-webeffect

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

vibe-webeffect — 웹 애니메이션 추천·적용 스킬

vibe-webeffect — 网页动画推荐与应用 skill

사용자의 UI 작업 요구를 읽고 → 카탈로그에서 어울리는 효과를 골라 → 정확한 이름(KR+EN)과 이유와 함께 추천하고 → 동의하면 코드를 적용한다. 핵심 철학: "용어가 곧 능력" — 효과의 정확한 이름을 알려주는 것 자체가 사용자의 자산이 된다.
读取用户的 UI 工作需求 → 从目录中挑选合适的效果 → 用准确名称(KR+EN)并说明理由进行推荐 → 用户同意后应用代码。 核心理念:“术语即能力”——告诉用户效果的准确名称,本身就能成为用户后续可复用的资产。

파일 구성

文件构成

  • catalog.json
    — 72개 효과.
    {id, cat, kr, en, intensity, tags, prereq, code, ref}
    스키마
  • references/recipes.md
    — 카테고리별 공용 구현 패턴(보일러플레이트). 코드 적용 전 반드시 읽는다

  • catalog.json
    — 72 个效果。
    {id, cat, kr, en, intensity, tags, prereq, code, ref}
    schema
  • references/recipes.md
    — 按类别整理的通用实现模式(boilerplate)。应用代码前必须阅读

워크플로우

工作流

1단계 — UI 컨텍스트 추출

第 1 步 — 提取 UI 上下文

사용자 요청에서 만들려는 화면의 구성요소를 파악한다. 명시가 없으면 요청의 성격에서 추론한다.
감지된 컨텍스트매칭 태그우선 카테고리
히어로/랜딩 첫 화면hero, landingsignature, scroll, insane(1개만)
콘텐츠 섹션/블로그/소개section, contentreveal (기본값)
카드 그리드/갤러리/포트폴리오grid, gallery, card, portfolioreveal(stagger) + hover
통계/수치/성과stats, numberreveal(count-up), signature(number-roll)
폼/로그인/설정form, input, settingsmicro + loading(error-shake)
버튼/CTAbutton, ctamicro, hover
데이터 로딩/API 호출 화면loading, wait, feedloading (필수)
챗/AI 인터페이스chat, ailoading(typing), micro
제품 상세/이커머스product, ecommercehover, scroll(before-after), micro(star)
스토리텔링/브랜드 사이트storytelling, brand, wowscroll, signature, insane
타임라인/프로세스/연혁timeline, processreveal(line-draw, alternate-slide)
배경이 밋밋함background, ambientinsane(constellation 등), signature(blob)
从用户请求中识别其想要构建的页面组成部分。如果未明确说明,则根据请求类型进行推断。
识别到的上下文匹配标签优先类别
Hero/落地页首屏hero, landingsignature, scroll, insane(仅 1 个)
内容区域/博客/介绍section, contentreveal(默认)
卡片网格/画廊/作品集grid, gallery, card, portfolioreveal(stagger) + hover
统计数据/数值/业绩stats, numberreveal(count-up), signature(number-roll)
表单/登录/设置form, input, settingsmicro + loading(error-shake)
按钮/CTAbutton, ctamicro, hover
数据加载/API 请求页面loading, wait, feedloading(必需)
聊天/AI 界面chat, ailoading(typing), micro
产品详情/电商product, ecommercehover, scroll(before-after), micro(star)
叙事/品牌网站storytelling, brand, wowscroll, signature, insane
时间线/流程/发展历程timeline, processreveal(line-draw, alternate-slide)
背景过于单调background, ambientinsane(constellation 等), signature(blob)

2단계 — 카탈로그 매칭

第 2 步 — 匹配目录

catalog.json
을 읽고 태그가 겹치는 효과를 후보로 모은다. 동률이면 intensity가 낮은 쪽을 우선한다(과잉 방지).
读取
catalog.json
,收集标签重叠的效果作为候选。如果强度相同,则优先选择 intensity 较低的效果(避免过度设计)。

3단계 — 추천 제시 (적용 전에 반드시)

第 3 步 — 提出推荐(应用前必须执行)

상황별로 2~4개를 골라 아래 형식으로 제시하고 사용자의 선택을 받는다:
[한국어 이름] ([영어 이름]) — 왜 이 화면에 맞는지 한 줄 + 필요한 전제조건(있으면)
단, 사용자가 "알아서 해줘/바로 적용해줘"라고 했거나 이미 효과를 지정했다면 추천 단계를 건너뛰고 적용한다. 이때도 적용한 효과의 이름은 반드시 결과 보고에 명시한다.
根据具体场景选择 2~4 个效果,按照以下格式给出推荐,并让用户选择:
[韩文名称]([英文名称]) — 用一行说明它为何适合此页面 + 必要的前提条件(如果有)
但如果用户表示“你看着办/直接应用”,或者已经指定了具体效果,则跳过推荐步骤并直接应用。即便如此,最终结果中仍必须注明已应用效果的名称。

4단계 — 적용

第 4 步 — 应用

  1. references/recipes.md
    에서 해당 카테고리의 공용 패턴을 읽는다
  2. catalog의
    code
    (핵심)와 recipes의 보일러플레이트를 조합해 사용자 프로젝트 구조에 맞게 삽입한다
  3. 아래 적용 규칙을 지킨다
  1. 读取
    references/recipes.md
    中对应类别的通用模式
  2. 将目录中的
    code
    (核心代码)与 recipes 中的 boilerplate 组合,并插入到适合用户项目结构的位置
  3. 遵守以下应用规则

5단계 — 결과 보고

第 5 步 — 结果报告

적용한 효과의 이름(KR+EN)을 명시하고, 사용자가 나중에 AI에게 재요청할 수 있는 한 줄 지시문("~효과 넣어줘")을 함께 알려준다.

注明已应用效果的名称(KR+EN),并提供一句用户以后可以向 AI 再次提出的指令(“加上~效果”)。

적용 규칙 (위반 금지)

应用规则(禁止违反)

  1. 강도 배합 — 한 화면(뷰포트)에
    bold
    는 최대 1개. 나머지는 subtle/medium. 전 화면이 다 움직이면 아무것도 안 보인다.
  2. reduced-motion 필수 — 모든 애니메이션에
    @media(prefers-reduced-motion:reduce)
    가드 또는 JS
    matchMedia
    체크를 넣는다.
  3. 성능 — transform·opacity만 애니메이션하는 것을 기본으로 한다.
    filter
    ·
    box-shadow
    애니메이션은 작은 요소에만. 스크롤 핸들러엔 lerp/rAF, 리스너엔
    {passive:true}
    .
  4. transition 재생 함정 — transition 기반 효과를 재트리거할 땐 recipes.md의 "스냅 리셋" 패턴을 쓴다 (클래스 뗐다 바로 붙이면 재생 안 됨).
  5. 등장 효과는 IntersectionObserver 1개로 통합 — 요소마다 옵저버를 만들지 않는다.
  6. 로딩 UX 원칙 — 진행률을 알면 확정 프로그레스(+% 숫자), 모르면 무한/스피너, 구조를 알면 스켈레톤. 1초 미만 작업엔 로딩 표시 생략.
  7. 의존성 0 — 모든 효과는 라이브러리 없이 순수 HTML/CSS/JS로 적용한다. 사용자가 GSAP 등을 이미 쓰고 있을 때만 그 방식을 따른다.
  8. 마이크로 인터랙션 공용 이징 —
    cubic-bezier(.34,1.56,.64,1)
    (오버슈트 스프링).
  1. 强度搭配 — 单个页面(viewport)中最多只能使用 1 个
    bold
    效果,其余效果应为 subtle/medium。如果整个页面都在运动,反而会让任何元素都不够突出。
  2. reduced-motion 必需 — 所有动画都必须加入
    @media(prefers-reduced-motion:reduce)
    守卫,或使用 JS
    matchMedia
    检查。
  3. 性能 — 默认只对 transform 和 opacity 做动画。
    filter
    与
    box-shadow
    动画仅用于较小的元素。滚动处理器使用 lerp/rAF,事件监听器使用
    {passive:true}
    。
  4. transition 重播陷阱 — 需要重新触发基于 transition 的效果时,使用
    recipes.md
    中的
    snap reset
    模式(如果只是移除 class 后立即重新添加,动画不会重播)。
  5. 入场效果统一使用一个 IntersectionObserver — 不要为每个元素分别创建 observer。
  6. 加载 UX 原则 — 已知进度时使用确定性进度条(显示百分比数字),未知进度时使用无限动画或 spinner,已知数据结构时使用 skeleton。耗时不足 1 秒的操作无需显示加载状态。
  7. 零依赖 — 所有效果均使用纯 HTML/CSS/JS 实现,不引入任何库。只有当用户已经使用 GSAP 等库时,才沿用其实现方式。
  8. 微交互通用 easing —
    cubic-bezier(.34,1.56,.64,1)
    (超调弹簧效果)。

추천 어조

推荐语气

  • 이름을 가르치듯: "이건 **라인 마스크 리빌(line mask reveal)**이라고 하는데…"
  • 과잉을 말리는 것도 추천이다: "여긴 효과 없이 두는 게 낫다"가 정답인 화면이 있다.
  • 전제조건(예: 이미지 시퀀스는 ffmpeg 프레임 추출 필요)은 추천 시점에 미리 알린다.
  • 像是在传授术语:“这个叫 线条遮罩显现(line mask reveal),原因是……”
  • 也可以主动劝阻过度设计:有些页面最好的答案就是“这里不放效果”。
  • 前提条件(例如,图像序列需要使用 ffmpeg 抽帧)应在推荐时提前说明。