팀원의 최초 설정
누군가 스킬 패키지를 방금 설치했지만 무엇이 필요한지 모릅니다. 이 스킬은 작업을 시작할 수 있을 때까지 단계별로 안내합니다. 전문 용어 없이 평이한 말로 이야기하며, 각 단계를 실제로 확인한 후에야 다음 단계로 넘어갑니다 — "아마 될 거예요" 같은 말은 하지 않습니다.
모든 것보다 우선하는 규칙
이전 단계를 명령어로 확인하지 않고 다음 단계로 넘어가지 않습니다. 단계가 실패하면 거기서 멈추고 해결합니다. 이런 설정을 처음 하는 사람이 터미널이 무엇인지 알 필요는 없습니다: 무언가를 입력하라고 요청할 때는 전체 명령어를 복사해서 붙여넣을 수 있게 제공하고, 어떤 출력이 나와야 하는지도 알려줍니다.
단계 0 — 무엇을 설치했는가
python3 instalar.py --revisar
파일이 없다면 저장소를 클론하지 않은 것입니다: 다시 클론하도록 명령어를 알려줍니다. 출력 결과에 무엇이 부족한지 나옵니다. 위에서 아래로 순서대로 해결합니다.
단계 1 — 도구들
| 부족한 항목 | 할 말 |
|---|---|
| Python 3 | Mac에는 이미 있습니다. 정말 안 되면: brew install python |
| rclone | brew install rclone — Drive 연결에 필요합니다 |
| openpyxl | pip3 install openpyxl — 보고서 스프레드시트를 다룰 때만 필요합니다 |
| ffmpeg | brew install ffmpeg — 오직 영상 편집을 할 때만 필요합니다 (그리고 그 경우 editar-vsl-cliente/INSTALACION.md의 모든 내용이 필요합니다). 아니라면 건너뜁니다 |
Homebrew가 없으면: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
단계 2 — 에이전시 드라이브 연결
가장 자주 실패하고 가장 중요한 단계입니다: Drive가 없으면 브리프, 브랜딩, 무엇을 저장할 공간도 없습니다.
rclone config
그리고 하나씩, 무엇을 입력해야 하는지 알려줍니다:
n(새 원격)- 이름:
gdrive← 정확히, 소문자로. 스킬들이 이 이름으로 찾습니다. - 유형:
drive입력 client_id와client_secret: Enter (빈 칸)- 범위:
1(전체 액세스) root_folder_id: Enter- 서비스 계정: Enter
- 고급 설정:
n - 브라우저 사용:
y→ Chrome이 열림 → Dirección이 알려준 Flowboost 계정으로 로그인하고 승인 - 공유 드라이브:
n· 확인:y· 종료:q
실제로 확인합니다 (그냥 끝났다고 말하는 것으로는 충분하지 않습니다):
rclone lsd gdrive: | head -5
클라이언트 폴더 목록(i_…, c_…)이 나와야 합니다. 비어 있거나 오류가 발생하면 연결되지 않은 것입니다: 단계 2를 다시 수행합니다.
단계 3 — 작업 폴더
mkdir -p ~/Desktop/CLIENTES && echo OK
클라이언트와 관련하여 다운로드하거나 생성하는 모든 것은 ~/Desktop/CLIENTES/<cliente>/에 저장됩니다. 절대 다운로드 폴더에 흩어지지 않습니다.
단계 4 — 일부 영역에서만 필요한 것
무엇을 담당할 것인지 물어보고 해당하는 부분만 설정합니다. 사용하지 않을 것은 요청하지 않습니다.
| 담당 업무 | 필요한 것 | 제공자 |
|---|---|---|
| 캠페인 또는 보고서 | Meta Ads 읽기 권한 | Dirección이 Business Manager에 추가 |
| 보고서 | 추가로 필요한 것 없음: 스프레드시트는 이미 Drive에 있음 | — |
| 정적 이미지 | 에이전시 ChatGPT 계정 | Dirección. ⚠️ 절대 <correo-direccion> 계정 사용 금지 |
| 영상 | ffmpeg보다 훨씬 더 많은 것: Python 라이브러리, 전사 모델, QC 도구, 자체 Pexels 키가 있는 MoneyPrinterTurbo, 약 8GB 디스크 공간. editar-vsl-cliente/INSTALACION.md를 단계별로 따르고 python3 ~/.claude/skills/editar-vsl-cliente/scripts/comprobar_entorno_edicion.py로 확인 | 본인 (Pexels 키는 본인이 직접 입력하며, 채팅으로 절대 전달하지 않음) |
| 랜딩 페이지 | 클라이언트 호스팅 접근 권한 | Dirección, 게시할 때 |
⚠️ 채팅으로 비밀번호나 키를 요청하거나 에이전트가 입력하지 않습니다. 키가 필요한 것이 있으면 본인이 자신의 컴퓨터에 직접 입력하고, 입력 위치를 설명합니다.
단계 5 — 실제 테스트
다음 명령어가 동작할 때까지 완료되었다고 하지 않습니다:
rclone lsd gdrive: | wc -l
0보다 큰 숫자가 나오면 준비가 완료된 것입니다. 그런 다음 지금 무엇을 요청할 수 있는지 해당 영역의 예시와 함께 알려줍니다:
- 보고서: "<클라이언트> 보고서 주세요", "<클라이언트>를 보고서에 등록해 주세요"
- 캠페인: "<클라이언트> 캠페인 만들어 주세요" (일시 중지 상태로 생성, 활성화는 항상 Dirección의 몫)
- 정적 이미지: "<클라이언트> 정적 이미지 만들어 주세요"
- 랜딩 페이지: "<클라이언트> 랜딩 페이지 카피 써 주세요"
처음부터 알아야 할 사항
- 모든 클라이언트 대상 텍스트는 스페인어(스페인)로 작성합니다. voseo를 사용하지 않습니다.
- 어떤 것도 지어내지 않습니다: 숫자, 사용 후기, 날짜, 보증. 없는 것은
[FALTA]로 표시합니다. - 클라이언트 Drive는 읽기 전용이며, 해당 폴더의 결과물만 제외합니다.
- 캠페인 활성화는 항상 Dirección의 몫입니다. 에이전트는 일시 중지 상태로 둡니다.
- 접근 권한이 없으면 알리고 중단합니다. 반쯤 진행하지 않습니다.
문제 해결
| 증상 | 대부분 원인 |
|---|---|
| "클라이언트 폴더를 찾을 수 없습니다" | Drive가 연결되지 않음 → 단계 2 |
| "파일이 존재하지 않습니다" | fundamentos 패키지가 없음 → 함께 설치 |
| 카피가 기준 없이 나옴 | 마찬가지: fundamentos가 없으며, 자동으로 알리지 않음 |
| "command not found: rclone" | 단계 1 |