Codot 런타임 적응 사항
- Stitch MCP: Codot 설정 → MCP에서 중앙에서 제공됩니다(
stitch:또는mcp__stitch__접두사가 있는 도구를 찾으세요). 에이전트별 MCP 파일을 다시 구성하지 마세요.- 브라우저 및 시각적 확인: 로컬 개발 서버나 렌더링된 페이지를 검사할 때는 외부 Chrome DevTools MCP보다 Codot의 내장
browser_*도구(browser_navigate,browser_snapshot,browser_screenshot,browser_console)를 선호하세요.- 시각적 전달:
show_preview는 오프라인 상태이며 네트워크에 액세스할 수 없습니다. Stitch에서 내보낸 HTML은 CDN Tailwind/글꼴에 의존하며 직접 전달하면 빈 화면으로 렌더링됩니다. 전체 충실도/상호 작용을 위해서는stitch-preview스킬(로컬 정적 서버 +browser_*), 대화형 HTML 미리보기를 위해서는stitch-offline.mjs+show_preview,.png스크린샷에 대해서는show_preview를 직접 사용하세요.- 에셋 다운로드: 항상 Stitch MCP
download_file(htmlCode.name/screenshot.name과 함께)을 사용하고,downloadUrl에 대해curl을 절대 사용하지 마세요(자격 증명이 필요하고 JSON 래퍼를 반환합니다).download_file출력이 임시 파일로 잘린 경우stitch-preview/scripts/save-stitch-file.mjs로 디코딩하세요.- 객체 매개변수: MCP 도구가
expected object, got string오류로 실패하는 경우(일부 에이전트 런타임이 객체 인수를 문자열로 직렬화함), 동일한 실패 호출을 재시도하는 대신stitch-manage-design-system의 문자열 전용 폴백 워크플로로 전환하세요.- 장기 실행 호출:
generate_screen_from_text또는edit_screens가 시간 초과되면 60초마다 최대 약 5분(5회 폴링) 동안list_screens를 폴링합니다. 새 화면이 나타나지 않으면 무기한 기다리는 대신 호출을 한 번 다시 실행하세요.- 도구 매핑: 일반 도구 이름(
Read,Write,Edit,Bash)을 활성 Codot 하네스 도구(read,write,edit,bash)에 매핑하세요.
Stitch에서 Remotion으로 워크스루 비디오 만들기
당신은 앱 디자인으로 매력적인 워크스루 비디오를 만드는 데 특화된 비디오 제작 전문가입니다. Stitch의 화면 검색 기능과 Remotion의 프로그래밍 방식 비디오 생성 기능을 결합하여 부드럽고 전문적인 프레젠테이션을 제작합니다.
개요
이 스킬을 사용하면 전문적인 전환 효과, 확대/축소 효과 및 컨텍스트 텍스트 오버레이를 통해 앱 화면을 보여주는 워크스루 비디오를 만들 수 있습니다. 워크플로는 Stitch 프로젝트에서 화면을 검색하여 Remotion 비디오 합성으로 오케스트레이션합니다.
전제 조건
필수:
- Stitch MCP 서버에 대한 액세스
- Remotion MCP 서버에 대한 액세스(또는 Remotion CLI)
- Node.js 및 npm 설치
- 디자인된 화면이 있는 Stitch 프로젝트
권장:
- Remotion의 비디오 기능에 대한 familiarity
- React 구성 요소 이해(Remotion은 React 사용)
검색 및 네트워킹
1단계: 사용 가능한 MCP 서버 검색
list_tools를 실행하여 사용 가능한 MCP 서버와 해당 접두사를 식별합니다.
- Stitch MCP:
stitch:또는mcp_stitch:접두사 찾기 - Remotion MCP:
remotion:또는mcp_remotion:접두사 찾기
2단계: Stitch 프로젝트 정보 검색
-
프로젝트 조회(프로젝트 ID가 제공되지 않은 경우):
[stitch_prefix]:list_projects를filter: "view=owned"로 호출- 제목(예: "계산기 앱")으로 대상 프로젝트 식별
name필드에서 프로젝트 ID 추출(예:projects/13534454087919359824)
-
화면 검색:
- 프로젝트 ID(숫자만)로
[stitch_prefix]:list_screens호출 - 화면 제목을 검토하여 워크스루에 필요한 모든 화면 식별
- 각 화면의
name필드에서 화면 ID 추출
- 프로젝트 ID(숫자만)로
-
화면 메타데이터 가져오기: 각 화면에 대해:
- 화면 리소스
name(projects/{project}/screens/{screen})으로[stitch_prefix]:get_screen호출 - 검색:
screenshot.name(projects/{project}/files/{file}) — 비디오용 시각적 에셋htmlCode.name(projects/{project}/files/{file}) — 선택 사항: 텍스트/콘텐츠 추출용width,height— 적절한 크기 조정을 위한 화면 크기- 텍스트 오버레이용 화면 제목 및 설명
- 화면 리소스
-
에셋 다운로드:
- Stitch MCP
[stitch_prefix]:download_file을screenshot.name으로 호출(downloadUrl에 대해curl또는web_fetch를 사용하지 마십시오. 자격 증명이 필요하고 JSON 래퍼를 반환함) download_file출력이 임시 파일로 잘린 경우 다음으로 디코딩:node skills/stitch/stitch-preview/scripts/save-stitch-file.mjs <tool-output> assets/screens/{screen-name}.png- 의도된 워크스루 흐름 순서대로 에셋 구성
- Stitch MCP
3단계: Remotion 프로젝트 설정
-
기존 Remotion 프로젝트 확인:
remotion.config.ts또는 Remotion 종속성이 있는package.json찾기- 존재하는 경우 기존 프로젝트 구조 사용
-
새 Remotion 프로젝트 생성(필요한 경우):
npm create video@latest -- --blank- TypeScript 템플릿 선택
- 전용
video/디렉토리에 설정
-
종속성 설치:
cd video npm install @remotion/transitions @remotion/animated-emoji
비디오 합성 전략
아키텍처
다음 구성 요소로 모듈식 Remotion 합성 만들기:
-
ScreenSlide.tsx— 개별 화면 표시 구성 요소- Props:
imageSrc,title,description,width,height - 기능: 확대/축소 애니메이션, 페이드 전환
- 지속 시간: 구성 가능(화면당 기본 3-5초)
- Props:
-
WalkthroughComposition.tsx— 기본 비디오 합성- 여러
ScreenSlide구성 요소 시퀀싱 - 화면 간 전환 처리
- 텍스트 오버레이 및 주석 추가
- 여러
-
config.ts— 비디오 구성- 프레임 속도(기본값: 30fps)
- 비디오 크기(Stitch 화면 크기와 일치 또는 적절히 조정)
- 총 지속 시간 계산
전환 효과
전문적인 효과를 위해 Remotion의 @remotion/transitions 사용:
-
페이드(Fade): 화면 간 부드러운 크로스페이드
import {fade} from '@remotion/transitions/fade'; -
슬라이드(Slide): 방향성 슬라이드 전환
import {slide} from '@remotion/transitions/slide'; -
확대/축소(Zoom): 강조를 위한 확대/축소 효과
- 부드러운 확대/축소를 위해
spring()애니메이션 사용 - 중요한 UI 요소에 적용
- 부드러운 확대/축소를 위해
텍스트 오버레이
Remotion의 텍스트 렌더링을 사용하여 컨텍스트 정보 추가:
- 화면 제목: 각 프레임의 상단 또는 하단에 표시
- 기능 콜아웃: 애니메이션 포인터로 특정 UI 요소 강조
- 설명: 각 화면에 대한 설명 텍스트 페이드 인
- 진행 표시기: 워크스루의 현재 화면 위치 표시
실행 단계
1단계: 화면 에셋 수집
- 대상 Stitch 프로젝트 식별
- 프로젝트의 모든 화면 나열
- 각 화면의 스크린샷 다운로드
- 워크스루 흐름 순서대로 구성
- 매니페스트 파일 생성(
screens.json):
{
"projectName": "계산기 앱",
"screens": [
{
"id": "1",
"title": "홈 화면",
"description": "숫자 패드가 있는 메인 계산기 인터페이스",
"imagePath": "assets/screens/home.png",
"width": 1200,
"height": 800,
"duration": 4
},
{
"id": "2",
"title": "기록 보기",
"description": "이전 계산 결과 보기",
"imagePath": "assets/screens/history.png",
"width": 1200,
"height": 800,
"duration": 3
}
]
}
2단계: Remotion 구성 요소 생성
Remotion 모범 사례에 따라 비디오 구성 요소 생성:
-
ScreenSlide.tsx생성:- 애니메이션에
useCurrentFrame()및spring()사용 - 확대/축소 및 페이드 효과 구현
- 적절한 타이밍으로 텍스트 오버레이 추가
- 애니메이션에
-
WalkthroughComposition.tsx생성:- 화면 매니페스트 가져오기
<Sequence>구성 요소로 화면 시퀀싱- 화면 간 전환 적용
- 적절한 타이밍 및 오프셋 계산
-
remotion.config.ts업데이트:- 합성 ID 설정
- 비디오 크기 구성
- 프레임 속도 및 지속 시간 설정
참조 리소스:
- 시작점으로
resources/screen-slide-template.tsx사용 - 완전성을 위해
resources/composition-checklist.md따르기 examples/디렉토리의 예제 검토
3단계: 미리보기 및 개선
-
Remotion Studio 시작:
npm run dev- 브라우저 기반 미리보기 열기
- 실시간 편집 및 개선 허용
-
타이밍 조정:
- 각 화면에 적절한 표시 지속 시간이 있는지 확인
- 전환이 부드러운지 확인
- 텍스트 오버레이 타이밍 확인
-
애니메이션 미세 조정:
- 확대/축소 효과에 대한 스프링 구성 조정
- 전환에 대한 이징 함수 수정
- 텍스트가 항상 읽기 쉬운지 확인
4단계: 비디오 렌더링
-
Remotion CLI를 사용하여 렌더링:
npx remotion render WalkthroughComposition output.mp4 -
대안: Remotion MCP 사용(사용 가능한 경우):
- 합성 세부 정보로
[remotion_prefix]:render호출 - 출력 형식 지정(MP4, WebM 등)
- 합성 세부 정보로
-
최적화 옵션:
- 품질 수준 설정(
--quality) - 코덱 구성(
--codec h264또는h265) - 병렬 렌더링 활성화(
--concurrency)
- 품질 수준 설정(
고급 기능
대화형 핫스팟
클릭 가능한 요소 또는 중요한 기능 강조:
import {interpolate, useCurrentFrame} from 'remotion';
const Hotspot = ({x, y, label}) => {
const frame = useCurrentFrame();
const scale = spring({
frame,
fps: 30,
config: {damping: 10, stiffness: 100}
});
return (
<div style={{
position: 'absolute',
left: x,
top: y,
transform: `scale(${scale})`
}}>
<div className="pulse-ring" />
<span>{label}</span>
</div>
);
};
음성 해설 통합
워크스루에 내레이션 추가:
- 화면 설명에서 음성 해설 스크립트 생성
- 텍스트 음성 변환 사용 또는 오디오 녹음
<Audio>구성 요소로 오디오를 Remotion에 가져오기- 화면 타이밍을 음성 해설 속도와 동기화
동적 텍스트 추출
자동 주석을 위해 Stitch HTML 코드에서 텍스트 추출:
- 각 화면에 대해
htmlCode.name으로[stitch_prefix]:download_file호출(잘린 출력을save-stitch-file.mjs로 디코딩) - HTML을 구문 분석하여 주요 텍스트 요소(제목, 버튼, 레이블) 추출
- 중요한 UI 요소에 대한 자동 콜아웃 생성
- 시간 지정 텍스트 오버레이로 합성에 추가
파일 구조
project/
├── video/ # Remotion 프로젝트 디렉토리
│ ├── src/
│ │ ├── WalkthroughComposition.tsx
│ │ ├── ScreenSlide.tsx
│ │ ├── components/
│ │ │ ├── Hotspot.tsx
│ │ │ └── TextOverlay.tsx
│ │ └── Root.tsx
│ ├── public/
│ │ └── assets/
│ │ └── screens/ # 다운로드된 Stitch 스크린샷
│ │ ├── home.png
│ │ └── history.png
│ ├── remotion.config.ts
│ └── package.json
├── screens.json # 화면 매니페스트
└── output.mp4 # 렌더링된 비디오
Remotion 스킬과의 통합
Remotion은 모범 사례를 정의하는 자체 에이전트 스킬을 유지 관리합니다. 고급 기술에 대해서는 이를 검토하세요:
- 저장소: https://github.com/remotion-dev/remotion/tree/main/packages/skills
- 설치:
npx skills add remotion-dev/skills
활용할 주요 Remotion 스킬:
- 애니메이션 타이밍 및 이징
- 합성 아키텍처 패턴
- 성능 최적화
- 오디오 동기화
일반적인 패턴
패턴 1: 간단한 슬라이드 쇼
페이드 전환이 있는 기본 워크스루:
- 화면당 3-5초
- 크로스페이드 전환
- 화면 제목이 있는 하단 텍스트 오버레이
- 상단 진행 표시줄
패턴 2: 기능 강조
특정 UI 요소에 초점:
- 특정 영역으로 확대
- 기능을 가리키는 애니메이션 원/화살표
- 주요 상호 작용에 대한 슬로우 모션 강조
- 이전/이후 나란히 비교
패턴 3: 사용자 흐름
단계별 사용자 여정 표시:
- 방향성 슬라이드가 있는 순차적 화면 흐름
- 번호가 매겨진 단계 오버레이
- 사용자 작업 강조(클릭, 탭)
- 애니메이션 경로로 화면 연결
문제 해결
| 문제 | 해결 방법 |
|---|---|
| 흐릿한 스크린샷 | 압축된 썸네일 대신 download_file(screenshot.name)을 통해 다운로드된 이미지가 전체 해상도인지 확인 |
| 텍스트 정렬 불량 | 화면 크기가 합성 크기와 일치하는지 확인, 실제 화면 크기를 기준으로 텍스트 위치 조정 |
| 끊기는 애니메이션 | 프레임 속도를 60fps로 높이기, 적절한 댐핑으로 올바른 스프링 구성 사용 |
| Remotion 빌드 실패 | Node 버전 호환성 확인, 모든 종속성이 설치되었는지 확인, Remotion 문서 검토 |
| 타이밍이 맞지 않음 | 매니페스트에서 화면 당 지속 시간 조정, Remotion Studio에서 미리보기, 실제 사용자로 테스트 |
모범 사례
- 종횡비 유지: 실제 Stitch 화면 크기를 사용하거나 비례적으로 크기 조정
- 일관된 타이밍: 특정 화면을 강조하지 않는 한 화면 표시 지속 시간을 일관되게 유지
- 읽기 쉬운 텍스트: 충분한 대비 보장, 적절한 글꼴 크기 사용, 복잡한 오버레이 피하기
- 부드러운 전환: 자연스러운 움직임을 위해 스프링 애니메이션 사용, 급격한 컷 피하기
- 철저한 미리보기: 최종 렌더링 전에 항상 Remotion Studio에서 미리보기
- 에셋 최적화: 이미지를 적절하게 압축, 효율적인 형식 사용(UI는 PNG, 사진은 JPG)
사용 예
사용자 프롬프트:
Stitch 프로젝트 "계산기 앱"의 화면을 찾아서 워크스루를 보여주는 remotion 비디오를 만들어 주세요.
에이전트 워크플로:
- Stitch 프로젝트 나열 → "계산기 앱" 찾기 → 프로젝트 ID 추출
- 프로젝트의 화면 나열 → 모든 화면 식별(홈, 기록, 설정)
- 각 화면의 스크린샷 다운로드 →
assets/screens/에 저장 - 화면 메타데이터로
screens.json매니페스트 생성 - Remotion 구성 요소 생성(
ScreenSlide.tsx,WalkthroughComposition.tsx) - Remotion Studio에서 미리보기 → 타이밍 및 전환 개선
- 최종 비디오 렌더링 →
calculator-walkthrough.mp4 - 비디오 미리보기 링크와 함께 완료 보고
성공을 위한 팁
- 간단하게 시작: 기본 슬라이드 쇼로 시작하여 점진적으로 기능 추가
- 자주 미리보기: Remotion Studio를 사용하여 자주 변경 사항 확인, 마지막에 한 번만 렌더링하지 않기
- 매니페스트 재사용: 자주 변경되는 프로젝트의 경우
screens.json을 재사용하여 신속하게 비디오 재구성 - 에셋 크기 최적화: 최종 비디오 크기를 줄이기 위해 Remotion으로 가져오기 전에 이미지 압축
- 분할 비디오: 매우 긴 워크스루의 경우 비디오를 여러 개의 작은 부분으로 분할, 최종 프로젝트에서 결합
- 커뮤니티 활용: 문제 해결을 위해 Remotion Discord 및 문서 참조