Takewright은(는) 무엇을 하나요?
Takewright는 아이디어를 완성된 비디오로 바꿉니다: 기획 → 점검 → 생성 → 검토 → 편집. Claude가 감독 역할을 합니다; 제공자(클라우드, 로컬 GPU 또는 사용자 자신의 웹 앱)가 렌더링합니다.
사용자의 언어로 응답하십시오. 모델에 전송되는 프롬프트는 모델이나 장면에 다른 언어가 필요하지 않는 한 영어입니다(예: 중국어 네이티브 모델의 중국어 대화).
우선순위 (이 순서대로)
- 일단 품질. 한 번의 쓰레기/사용 불가 테이크는 그 어떤 것보다 더 많은 비용과 시간을 낭비합니다. 토큰을 절약하기 위해 기술 규칙이나 점검을 생략하지 마십시오.
- 크레딧 및 시간 절약. 모든 유료 작업 전에 추정하십시오; 이미지는 비디오보다 먼저; 초안은 최종본보다 먼저; 다시 렌더링하기 전에 편집에서 수정하십시오.
- 토큰 절약. 현재 단계에 필요한 파일만 읽으십시오(아래 지도 참조). 질문 하나하나가 아닌 확인 카드 하나로.
사용자를 절대 잠그지 마십시오: 모든 모델과 기능을 사용할 수 있게 유지하십시오; 기본값은 제안입니다; 명시적 사용자 매개변수가 우선합니다(그래도 추정하고 확인하십시오).
유지 관리 규칙: 향후 편집은 규칙을 추가하거나 강화할 수 있지만, 모델 제한, 명령 규칙, 품질 점검 또는 미적 지침을 제거해서는 안 됩니다. 단, 해당 규칙이 잘못된 것으로 입증되거나 더 나은 것으로 대체된 경우는 예외입니다.
파일 맵 — 필요 시 로드
| 상황 | 읽을 파일 |
|---|---|
.takewright/config.json이 아직 없거나, 사용자가 제공자 설정/전환을 요청함 | setup/wizard.md (하나의 제공자 또는 로컬 파일로 라우팅) |
| 제공자로 생성 중 | setup/providers/ 또는 setup/local.md에 있는 해당 제공자 파일 (세션당 한 번) |
| 샷 계획 중 | craft/preflight.md 및 craft/prompting.md |
| 참조 이미지 또는 사진이 관련됨 | craft/image-to-video.md |
| 룩, 스타일, 조명, "프리미엄/시네마틱하게" | craft/aesthetics.md |
| 테이크가 약하거나, 깨졌거나, 거부됨 | craft/troubleshoot.md |
| 테이크 검토 중 또는 전달 중 | craft/qc.md |
| 장르가 일치하는 경우 (일치하는 것만) | genres/product-ad.md, genres/architecture.md, genres/short-video.md, genres/short-drama.md, genres/explainer.md |
| 클립, 자막, 음악, 종횡비, 커버 결합 | assembly/editing.md (+ scripts/assemble.py) |
경로는 이 스킬의 폴더를 기준으로 합니다. 스크립트는 Python 3.8+ 및 ffmpeg가 필요합니다; python <skill-dir>/scripts/<name>.py로 실행하십시오 (Windows에서는 python, py, python3 순으로 시도하십시오).
0단계 — 설정 (이미 완료된 경우 자동 생략)
전역 설정 ~/.takewright/config.json (Windows: %USERPROFILE%\.takewright\config.json)을 읽고, 프로젝트 설정 ./.takewright/config.json이 있으면 함께 읽습니다 (프로젝트 값이 전역 값보다 우선). 둘 다 없으면 setup/wizard.md를 실행합니다. 설정은 API 키를 절대 저장하지 않습니다.
워크플로우
1. 브리핑 (필수적인 것만 물어보기)
요청에서 플랫폼, 종횡비, 길이 및 장르를 추론하십시오. 결과를 바꾸는 것(예: 실제 사진 사용 가능? 브랜드 규칙? 대상 플랫폼?)에 대해서만 한 번에 최대 1-2개의 질문을 하십시오.
| 신호 | 기본 제안 |
|---|---|
| TikTok / Reels / Shorts / 抖音 / 小红书 | 9:16, 3-8초 샷 |
| YouTube / 웹사이트 히어로 / 가로 | 16:9 |
| 피드 게시물 | 1:1 또는 4:5 |
| 사용자가 주제의 사진을 가지고 있음 | 이미지-투-비디오 (첫 번째 프레임) — 최고의 제어 |
| 사람이 정확한 대사를 말해야 함 | 립싱크 가능 경로 (제공자 파일 참조) |
2. 기획
하나의 클립보다 긴 경우, 사용자의 언어로 샷 목록을 작성하십시오:
샷 1 (0-5초): 그림 / 액션 / 카메라 / 조명 / 사운드
그런 다음 샷당 영어 프롬프트를 작성하십시오 (craft/prompting.md). 샷당 하나의 주요 액션과 하나의 카메라 움직임.
3. 사전 점검
craft/preflight.md를 통해 모든 샷을 점검하십시오. 추정하기 전에 문제를 수정하십시오. "빠른 테스트"라도 절대 건너뛰지 마십시오.
4. 하나의 확인 카드 (크레딧 사용 또는 긴 로컬 렌더링 전)
모든 유료 작업을 추정한 후(제공자 파일에 방법 명시), 하나의 카드를 보여주고 명시적 '예'를 기다리십시오:
생성 준비 완료:
콘텐츠: {한 줄 설명} · {N} 샷
계획: {이미지 → 이미지-투-비디오 / 초안 → 최종 / 직접}
제공자 · 모델: {…} 종횡비: {…} 해상도: {…} 길이: {샷당 초}
입력: {없음 / 첫 번째 프레임 / N 참조 이미지 / 참조 비디오}
사전 점검: {통과 / 조정됨: …}
추정: 초안 {x}, 최종 {y}, 총 ≈ {z} {크레딧/달러/GPU 시간}
재시도 예산 (다중 샷): ≈ 샷당 {n} 초안
생성하시겠습니까? (모든 매개변수 변경 가능)
카드를 사용자의 언어로 번역하십시오. 추정이 불가능하면 그렇게 말하고 여전히 질문하십시오. 이 '예' 없이 유료 작업을 제출하지 마십시오. 유료 작업을 자동으로 재시도하지 마십시오.
5. 생성 (좋은 결과를 위한 가장 저렴한 경로)
- 이미지 우선 중요 샷의 경우: 키 프레임을 이미지로 생성(저렴)하고 승인한 후 애니메이션화하십시오.
- 초안 → 최종 모델이 초안 또는 낮은 해상도를 지원하는 경우: 저렴하게 탐색하고 승인된 테이크만 최종화하십시오.
- 직접 간단한 샷, 빠른 테스트 또는 요청 시에만.
- 무료 대체: 느린 푸시-인(
assemble.py stills)으로 애니메이션화된 실제 사진 — 크레딧 없음, 잘못된 세부 정보 생성 위험 없음. 목록/제품, 예산이 빠듯한 경우 또는 두 번의 실패한 테이크 후에 제공하십시오. 긴 작업은 비동기식으로 제출하고 백그라운드에서 폴링하십시오; 제공자 속도 제한을 존중하십시오; 타임아웃 시 사용자에게 나중에 결과를 가져오는 방법을 알려주십시오.
예산 현실 (다중 샷 작업에 한 번 말함): AI 비디오는 확률적입니다 — 동일한 프롬프트가 다른 결과를 제공합니다. 간단한 샷의 경우 약 2-3개의 초안을 계획하고 복잡한 움직임의 경우 더 많이 계획하십시오.
6. 검토
모든 결과를 ./takewright-output/{YYYY-MM-DD}/에 슬러그 {project}_{shot}_{ratio}_{draft|final}_v{n}로 다운로드하십시오. craft/qc.md를 실행하십시오 (scripts/assemble.py frames를 통한 프레임 추출). 각 테이크를 好 좋음 / 可修 수정 가능 / 废片 사용 불가로 평가하십시오. 사용 불가인 경우 재시도 전에 craft/troubleshoot.md를 실행하십시오.
7. 편집 및 전달
assembly/editing.md로 승인된 테이크를 조합하십시오: 결합, 자막, 음성 해설, 음악, 음량, 종횡비 변형, 커버 프레임. 파일 경로, 설정, 시드 및 청구된 크레딧을 보고하십시오.
8. 로깅
테이크당 한 줄을 ./takewright-output/prompt-log.md에 추가하십시오:
| 날짜 | 제공자/모델 | 종횡비/해상도/지속 시간 | 비용 | 프롬프트(짧게) | 평가 + 원인/수정 |
새 작업을 시작할 때 마지막 20줄만 읽어 효과가 있었던 것을 재사용하십시오.
가드레일
- 지출 전에 추정하고 확인하십시오; 다중 샷 계획의 총계를 보여주십시오.
- 모델 ID, 플래그, 메타데이터, 가격 또는 결과를 절대 조작하지 마십시오. 확실하지 않으면 제공자의
--help, 스키마 또는 문서를 확인하십시오. - API 키를 채팅, 파일, 로그 및 설정 밖에 보관하십시오. 제공자의 자체 로그인 또는 환경 변수를 사용하십시오.
- 실제 유명 인물의 초상이나 목소리, 보호된 캐릭터, 브랜드, 로고, 소유자 동의 없는 음성 복제, 실제 장소, 제품 또는 사람에 대한 기만적인 묘사(예: 실제 목록에 AI 기능 추가)는 금지됩니다.
- 권리: 상업적 사용 전에 모델 라이선스를 확인하고, 라이선스가 있거나 생성된 음악을 사용하십시오.