Communitygithub.com

johnson7543/design

저장소 내 제품이나 디자인의 실제 UI 데모 비디오를 시나리오 기반 Chrome 탭 캡처를 통해 기록, 재생성 및 적용합니다. 제품 프리뷰 영상이나 기록된 액션의 생성/변경을 요청할 때 사용하고, 합성 애니메이션이나 관련 없는 비디오 편집에는 사용하지 마세요.

design란 무엇인가요?

이 스킬은 실제 웹 애플리케이션의 브라우저 기반 데모 비디오를 시나리오 기반으로 기록, 재생성 및 적용하는 자동화된 워크플로우입니다. 제품의 첫 번째 데모를 만들거나 기존 시나리오를 업데이트할 수 있으며, Chrome의 네이티브 탭-컴포지터 스트림을 통해 실제 Vite 애플리케이션을 캡처합니다. 주요 특징으로는 매끄러운 모션 보장을 위한 60fps 선호, 연속 프레임 중복 감지를 통한 품질 검증, 정확한 지속 시간/해상도/인코딩 검증이 포함됩니다. 시나리오는 JSON 파일로 정의되며 'npm run record:demo' 명령어로 실행하고, 생성된 미디어는 'public/previews/' 디렉토리에 배치됩니다. 이 도구는 사용자 요청에서 경로, 셀렉터, 기존 자산 사용처를 추론하여 기술적 세부사항 없이도 'Design QR 데모 생성'과 같은 간단한 요청을 처리할 수 있습니다. 실제 제품 동작을 보존하면서도 데모 품질을 최적화하며, 네이티브 탭 캡처가 불가능할 경우 시뮬레이션 비디오 대신 구체적인 전제 조건을 보고합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/johnson7543/design/tree/HEAD/skills/record-product-demo

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

제품 데모 기록

사용자의 제품 및 액션 설명을 체크인된 녹화 시나리오로 변환하고, 실제 애플리케이션에서 실행한 후 생성된 자산을 요청된 프리뷰에 적용합니다.

워크플로우 선택

워크플로우

  1. 제품 라우트, 안정적인 상호작용 셀렉터, 그리고 프리뷰를 소비하는 컴포넌트를 찾습니다. 요청된 콘텐츠, 순서, 프레이밍, 지속 시간, 출력 위치를 보존합니다.

  2. scripts/demo-video-scenarios/<product-slug>.json을 생성하거나 업데이트합니다. 첫 번째 데모의 경우 npm run init:demo -- --product "<name>" --route <route> --consumer <file>으로 초기화한 후, 시작 액션을 요청된 시퀀스로 교체합니다. 제품별 동작은 레코더에 하드코딩하지 말고 시나리오에 유지합니다.

  3. 실제 브라우저 액션을 사용하세요. 뷰어가 디바운스된 업데이트, 완료된 애니메이션 또는 중간 상태를 반드시 봐야 하는 경우 의도적인 대기를 추가합니다. 총 액션 시간을 녹화 지속 시간보다 짧게 유지하고, 사용되지 않은 시간은 최종 홀드가 됩니다. 연속 애니메이션의 경우 전체 실행 시간과 읽을 수 있는 홀드를 예산에 포함하고 quality.motionChecks 윈도우를 추가합니다.

  4. 생성된 미디어는 기존 제품이 다른 공개 자산 위치를 사용하지 않는 한 public/previews/ 아래에 배치합니다. application.consumerFiles와 공개 경로를 설정하여 러너가 자산이 적용되었는지 확인하도록 합니다. 새 프리뷰를 추가할 때는 먼저 컨슈머를 패치하고, 이미 참조된 출력을 덮어쓰는 것은 업데이트 적용으로 간주됩니다.

  5. 다음을 실행합니다:

    npm run record:demo -- --scenario scripts/demo-video-scenarios/<product-slug>.json
    
  6. 명령어 종료 코드뿐만 아니라 결과를 검증합니다:

    • 레코더는 verify:demo를 실행하며 정확한 지속 시간, 해상도, 정사각형 픽셀, 평균 프레임 속도, 프레임 수, H.264 인코딩, 설정된 연속 모션 검사를 통과해야 합니다.
    • view_image로 출력된 모든 개요 및 모션 콘택트 시트를 엽니다. 입력된 값, 중간 제품 변경 사항, 균등하게 분포된 모션, 전환의 양 끝, 최종 상태를 확인합니다.
    • npm run lint를 실행하고, 프리뷰를 적용하는 동안 이루어진 애플리케이션 UI 변경 사항에 대해 AGENTS.md에 필요한 검사를 실행합니다.

매끄러운 모션 계약

  • 애니메이션 데모의 경우 진정한 60fps를 선호합니다. 소스 캡처의 보고된 프레임 속도 상한을 존중하고, 프레임 복제 또는 WebGL 모션 보간으로 더 부드러운 출력을 광고하지 마세요.
  • 주요 전환에는 시나리오 시간을 충분히 할애하여 명확하게 읽히도록 하세요. 제품의 의도된 지속 시간을 사용하고, 해당 사항이 없으며 부드러움이 핵심인 경우 방향당 약 2-3초에서 시작하여 이후 액션을 서두르는 대신 전체 비디오를 연장하세요.
  • quality.motionChecks에서 연속적으로 움직여야 하는 각 간격을 표시합니다. 기본 게이트는 연속된 정확한 중복 프레임을 허용하지 않습니다. 제품이 해당 간격 내에서 의도적으로 정지하는 경우에만 완화하고, 시나리오 설명에 그 이유를 문서화하세요.
  • 조밀한 모션 콘택트 시트에서 시각적으로 페이싱을 판단하세요. 유효한 프레임 수로는 프론트-로드되거나 급격한 이징 곡선을 감지할 수 없습니다.
  • 실제 제품 애니메이션이 울퉁불퉁하고 사용자가 부드러움 개선을 요청한 경우, 프레임 페이싱이나 이징을 수정하고 다시 녹화하기 전에 관련 UI 검사를 실행하세요. 그렇지 않으면 제품 동작을 보존하고 한계를 설명하며, 후반 작업에서 마스킹하지 마세요.

캡처 불변 조건

  • Chrome의 네이티브 탭-컴포지터 스트림을 통해 실제 Vite 애플리케이션을 녹화하세요. Puppeteer가 키보드, 포인터 및 타이밍을 제공할 수 있지만, 제품은 자체 상태 업데이트 및 렌더링을 수행해야 합니다.
  • WebGL 모션을 위해 DevTools 스크린샷 샘플링으로 네이티브 탭 캡처를 대체하지 마세요. 중간 프레임이 누락되어 거짓된 전환을 생성할 수 있습니다.
  • 실제 캡처 속도 이상으로 인코딩하거나 모션 보간을 사용하여 부드러움 요청을 통과시키지 마세요.
  • 사용자의 전체 데스크탑이나 기존 디스플레이를 절대 캡처하지 마세요. 로컬 확장은 선택된 localhost 제품 탭만 캡처할 수 있습니다.
  • recordingCss는 데모 프레이밍에만 사용하세요. 녹화를 쉽게 만들기 위해 실제 제품 UI를 변경하지 마세요. 단, 사용자가 해당 UI 변경을 요청한 경우는 예외입니다.
  • 시나리오에 임의의 JavaScript 평가 액션을 추가하지 마세요. 상호작용이 진정으로 지원되지 않는 경우 좁은 이름의 실제 입력 액션을 러너에 추가하세요.
  • 네이티브 탭 캡처가 실행될 수 없는 경우, 시뮬레이션된 비디오를 자동 생성하지 말고 구체적인 전제 조건을 보고하세요.

요청 해석

저장소에서 경로, 셀렉터, 기존 자산 소비자를 추론하세요. 검사 후에도 여러 제품이나 실질적으로 다른 출력 배치가 가능한 경우에만 질문하세요.

사용자가 기술적 세부사항 없이 "<product>에 대한 데모 생성/초기화 및 적용"이라고 말하는 경우, 구현된 라우트, 카탈로그 소비자, 셀렉터 및 기존 프리뷰 규칙을 추론하세요. 저장소와 요청이 더 나은 규칙을 제공하지 않는 경우에만 기본값으로 8초, 60fps, 세로 프레이밍을 사용합니다. 데모 요청이 누락된 제품 구현을 승인하지는 않습니다.

적절한 요청은 다음과 같이 간단할 수 있습니다:

Design QR에 $record-product-demo 사용: URL을 두 부분으로 입력하고, 트리 업데이트를 위해 일시 중지하고, 3D를 2D로 또는 그 반대로 변환한 다음 카탈로그 카드에 적용합니다.

사용자 대상 초기화 및 프롬프트 예제는 데모-비디오 워크플로우에 문서화되어 있습니다.

관련 스킬