# Seedance 2.0 Skill OS 빠른 시작

> 버전 6.7.0 · 설치부터 첫 "연출된" 프롬프트까지 약 5분.
> 자세한 내용은 [README](../README.md)와 [한국어 가이드](README.ko.md)를 참고하세요.

## 한마디로

Seedance 2.0 Skill OS 는 형용사를 늘어놓는 대신 영화감독처럼 Seedance 2.0 을 연출하는 agent skill 입니다. 규칙은 하나뿐입니다——**모델을 연출하되, 프레임을 한 컷씩 붙들지 마세요.** 그 장면이 "무엇을 하고 있는지"만 말해 주면, 그 의도를 바로 쓸 수 있는 프롬프트로 컴파일합니다.

## 1. 설치 (약 5분)

이 저장소를 `seedance-20` 이라는 **하나의** 루트 스킬로 설치합니다. 하위 스킬과 references 는 상대 경로로 자동으로 불러옵니다.

**먼저 파일을 받으세요.** 아래 명령은 모두 로컬 사본 안에서 실행합니다:

```bash
git clone https://github.com/Emily2040/seedance-2.0.git
cd seedance-2.0
```

`git` 이 없다면 저장소 페이지의 **Code → Download ZIP** 을 쓰고, 압축을 푼 뒤 그 폴더로 `cd` 하세요.

**그다음 설치합니다.** 이 설치 스크립트는 Codex 전용이 아닙니다. `--dest` 로 클라이언트가 읽는 skills 디렉터리를 지정하세요:

```bash
# Codex (기본값 ~/.codex/skills)
python scripts/install_codex_skill.py

# Claude Code (개인 설치, 모든 프로젝트에서 사용)
python scripts/install_codex_skill.py --dest ~/.claude/skills

# 다른 프로젝트에 설치 — 그 프로젝트 디렉터리에서 실행
python /path/to/seedance-2.0/scripts/install_codex_skill.py --dest .claude/skills
```

설치 위치가 출력됩니다. 클라이언트를 다시 시작한 뒤 `seedance-20` 을 불러오세요. `--force` 는 기존 설치를 교체할 때만 붙입니다 — 이전 사본을 먼저 지웁니다. 이 저장소 내부를 가리키는 `--dest` 는 거부됩니다. 소스 트리를 자기 자신 안으로 복사하면 경로 길이 한계에 도달할 때까지 재귀하기 때문입니다.

**GitHub 에서 설치 (저장소 URL 설치를 지원하는 클라이언트)**

```text
https://github.com/Emily2040/seedance-2.0
```

**수동 복사 (그 밖의 클라이언트)**

폴더를 이름 `seedance-20` 그대로 클라이언트의 스킬 디렉터리에 복사하세요. 흔한 위치는 [README 설치 표](../README.md#install)에 정리해 두었습니다(보장이 아니니 반드시 본인 클라이언트에서 확인하세요). 예: Claude Code `.claude/skills/`, Cursor `.cursor/skills/`, GitHub Copilot `.github/skills/`, Windsurf `.windsurf/skills/`.

> 안전이 먼저입니다. 믿을 수 있는 agent 클라이언트에만 설치하세요. 낯설거나 서드파티 agent 에서 쓰기 전에 [SECURITY.md](../SECURITY.md)를 꼭 읽어 보세요.

## 2. 상황에 맞춰 스킬 고르기

| 지금 상황 | 먼저 로드 |
|---|---|
| 아직 막연한 아이디어 | `seedance-interview` |
| 분명해진 장면 | `seedance-prompt` |
| 여러 클립으로 이어지는 이야기 | `seedance-sequence` |
| 확정된 클립의 다음 이어가기 | `seedance-continuation` |
| 결과가 나쁘거나 막혔을 때 | `seedance-troubleshoot` |
| 캐릭터·브랜드·유명인·실존 인물이 얽힐 때 | `seedance-copyright` |

## 3. 쓰기 전에 "연출"부터 —— 네 가지 질문

1. **이 장면은 무엇을 하고 있나요?** 전환인가, 폭로인가, 감정인가, 아니면 제시인가요.
2. **카메라는 그것을 어떻게 말하나요?** 고독은 와이드로, 표정은 클로즈업으로, 깨달음은 푸시인으로.
3. **빛은 무엇을 위해 일하나요?** 시간대, 강함과 부드러움, 따뜻함과 차가움 —— 모두 의도를 위해서.
4. **소리는 무엇을 하나요?** 거의 무음인가, 환경음 하나인가, 아니면 대사 한 줄인가요.

## 4. 한 가지 대비

**치장 위주 (약함)**

```
웅장한 시네마틱 샷, 편지를 읽는 여성, 감성적, 아름다운 조명, 4K
```

**연출 (강함)**

```
울 카디건을 입은 여자가 부엌 식탁에 앉아 편지지 한 장을 읽는다. 같은 줄을 두 번 훑은 뒤, 두 손이 편지지를 식탁에 내려놓고 완전히 멈춘다. 카메라는 눈높이 미디엄 클로즈업을 유지한 채 천천히 다가가, 손이 멈추는 지점에서 멈춘다. 왼쪽에서 들어오는 흐린 날 창빛이 얼굴을 평평하게 만들고, 보조광은 없다. 사운드: 룸톤, 의자 긁히는 소리 하나, 그다음 거의 무음.
```

단어만이 아니라 **순서**를 보세요. 피사체와 그가 하고 있는 일이 **맨 앞**에 오고, 카메라·빛·사운드가 그 뒤를 따릅니다. 프롬프트의 첫머리가 바로 모델이 "이 숏은 누구의 것인가"를 확정하는 자리이기 때문입니다. `미디엄 클로즈업, 눈높이`로 시작하면 그 자리를 프레이밍 정보에 써버리고, 피사체는 나중에 추론하게 됩니다. 같은 기술인데 위계가 약해집니다.

길이도 같은 원리입니다. 피사체·동작·카메라·빛·사운드를 전달할 수 있는 압축된 촬영 브리프로 쓰세요. 한국어는 단어 수가 아니라 **음절 수**로 셉니다(`vocab/ko` 참고). 너무 짧으면 모델이 빈칸을 채우고, 너무 길면 뒤쪽 문장이 화면에 닿지 않습니다.

## 5. 테이크를 아끼는 두 가지 원칙

- **참조 태그는 한 글자도 바꾸지 마세요.** `@Image1`, `@Video1`, `@Audio1`, `@图片1`, `@视频1` 를 번역하거나 형식을 손대지 않습니다.
- **이야기 전체를 한 번에 생성하려 하지 마세요.** 먼저 Clip 01 을 만들고, 그것이 "실제로" 어디서 끝났는지 본 다음, 그 진짜 결말에서 Clip 02 를 씁니다(`seedance-continuation`).

## 6. 안전

- **콘텐츠 안전:** 보호되는 캐릭터, 유명인, 브랜드, 로고, 노래, 또는 실존 인물의 얼굴과 목소리를 쓴다면 다른 언어로 숨기려 하지 마세요. `seedance-copyright` 로 오리지널·라이선스·후반작업 대체안처럼 안전한 형태로 바꿉니다.
- **agent 안전:** 이 패키지는 **어떤 통신도 하지 않고 텔레메트리도 보내지 않습니다.** 스크립트는 결정론적이며 오프라인으로 동작합니다. API 키, 계정 쿠키, 비공개 소스를 믿을 수 없는 agent 에 붙여넣지 마세요. [SECURITY.md](../SECURITY.md) 참고.

## 7. 더 깊이

- `references/directing-engine.md` — 장면을 읽고 하나의 의도를 고르기(33개 장르 예제).
- `references/capability-map.md` — 모델의 강점을 살리고 알려진 약점을 피해 설계하기.
- `references/api-workflow.md` — API, 제공자, 가격, 모델 ID(모두 출처 날짜 표기).
- `references/examples-by-mode.md` — T2V, I2V, V2V, R2V, FLF2V, 편집, 확장 예시.

---

다른 언어: [English](QUICKSTART.md) · [中文](QUICKSTART.zh.md) · [日本語](QUICKSTART.ja.md) · [Español](QUICKSTART.es.md) · [Русский](QUICKSTART.ru.md)
