스크립트 검토하기
각 스크립트는 하나의 마크다운 파일입니다. 리뷰어는 로컬 페이지에서 이를 읽고, 노트는 마크다운 형식으로 다시 전달됩니다. 모든 명령어는 python3 scripts/script_review.py <명령어> 형식이며, 경로는 이 스킬 폴더를 기준으로 합니다. Python 3.9 이상이 필요하며, 설치할 패키지는 없습니다.
검토 루프
- 스크립트 저장. 본문을 임시 파일에 쓰고
script_review.py new --title "<제목>" --body-file <파일> --status drafted를 실행합니다. 스크립트의 id, 파일 경로, 페이지 주소가 출력됩니다. 한 문장이나 비트를 각 줄에 배치하여 각 줄이 별도의 댓글을 받을 수 있도록 합니다. - 페이지 시작.
script_review.py up을 실행한 후script_review.py open <id>를 실행합니다. 리뷰어에게 주소를 알려줍니다. - 노트 대기. 백그라운드에서
script_review.py wait <id>를 실행합니다. 리뷰어가 노트 보내기를 클릭하면 노트를 출력하고, 2시간 동안 전송이 없으면 종료 코드 2로 종료됩니다. - 노트 적용. 각 노트에 답하는 최소한의 변경으로 스크립트 파일을 편집합니다. 열린 페이지는 자동으로 새로고침되고 변경된 줄을 표시합니다.
- 3단계부터 반복 노트에 "좋아요."라고 표시될 때까지 진행합니다. 이 전송은 초안을 승인 상태로 이동시킵니다.
노트가 전송되었을 때 대기 중이 아니었다면 script_review.py inbox는 읽지 않은 모든 세트를 출력합니다.
수정 규칙
- 리뷰어의 편집 내용을 그대로 유지합니다. "편집(이미 파일에 저장됨)" 아래에 나열된 줄은 리뷰어의 표현이며, 노트를 보기 전에 이미 파일에 있습니다. 노트에서 요청할 때만 변경합니다.
- 노트가 다루는 내용만 변경합니다. 댓글이 없는 줄은 다시 작성하지 않습니다.
- "적용되지 않은 편집"은 수동으로 적용합니다. 전송 전에 줄이 이동했으므로 파일이 변경되지 않았습니다.
- 설정하지 않은 프론트매터 키는 그대로 둡니다.
script_review.py status <id> <status>로 상태를 변경하고, 파일을 직접 편집하지 않습니다. - 리뷰어가 요청하지 않는 한 스크립트 파일을 삭제하지 않습니다.
파일 형식
---
type: script
id: 2026-01-15-three-prompt-habits
title: Three prompt habits
status: drafted
---
## 구술 스크립트
첫 번째 줄, 한 줄에 한 문장씩.
두 번째 줄.
## 대체 후크
후크 2 (질문): 촬영할 두 번째 오프닝 라인.
## 캡션
스크립트와 함께 보관하는 기타 모든 것.
읽기 복사는 페이지에서 Spoken Script 섹션을 한 단락으로 복사한 다음, 각 대체 후크를 후크 2부터 "둘째. <줄>"로 복사합니다. Spoken Script 섹션이 없는 파일은 전체가 읽힙니다. script_review.py read <id>는 동일한 텍스트를 출력합니다.
기타 명령어
list [--status <상태>] [--json]: 각 스크립트의 상태와 단어 수를 출력합니다.status <id> <상태>: 상태를 설정합니다 (기본값:idea,drafted,ready,filmed,posted).config: 사용 중인 설정과 설정 파일 경로를 출력합니다.down: 페이지 서버를 중지합니다.
설정 (폴더, 포트, 섹션 이름, 상태, 리뷰어 이름) 및 Tailscale을 통한 휴대폰 접근에 대한 설명은 리포지토리 루트의 README에 있습니다.