구독 편집하기 (剪口播)

하나의 비디오에서 인간이 검토한 삭제 장부(Cuts + EDL) 까지, 미디어 파일은 건드리지 않습니다. 일곱 단계로 진행:

0  준비     「업데이트 확인」 참조 (본 스킬은 환경 로직 없음)
1  프로젝트 생성  실제 비디오 → 클라우드 단어별 전사 → 제품 프로젝트 생성 → 서비스 시작 → 상태 읽어오기
2  글자 수정   사전으로 글자 바로잡기 (공통 1권 + 사용자 1권) → 수정표 출력
3  단어 삭제   선호도 및 규칙 읽기 → 5회 스캔, 각 회차는 한 유형만 찾고, 줄만 기록
4  집계     삭제 요약표 + 중복 문장표 → 표에 따라 자체 읽기 검증
5  검토     전체 제출 → 두 표를 사용자에게 제시 → Studio 열어 직접 검토
6  복기 및 인계  제안과 최종 버전 비교 → 세 서랍에 보관 → 네 가지 사항 보고

미디어를 자르지 않음: 장부를 한 번 수정하는 것은 수십 밀리초가 걸리지만, 자르는 것은 취소할 수 없는 파일 작업입니다. 본 스킬이 끝날 때까지 디스크에는 새로운 비디오가 없습니다. 스킬은 의미 판단과 편성만 수행하며, 제품 런타임이 프로젝트, Cuts 및 Studio 상태의 유일한 작성자입니다.

사용자는 세 곳에서만 말합니다: 동일 소스 프로젝트에서 계속할지 다시 시작할지 선택(이미 편집한 경우), Studio 검토, 완료 확인. 나머지는 단방향 보고이며, 답변을 기다리지 않습니다. 각 단계의 완료 기준은 산출물입니다: 표가 나오지 않으면 완료가 아닙니다.

먼저 비즈니스 스킬 단계 계약을 읽고 실행하세요. 본 문서의 단계와 계약의 대응: 1=preflight+Product state readback, 5=proposal+Product CAS, 검토=project-level review binding. 계약의 마지막 세 단계(확인, 실행, 검수)는 내보내기 스킬에 속합니다.

각 규칙의 사고 연혁은 사고부에 있습니다——규칙은 본문에, 이야기는 거기에.

0. 준비

먼저 업데이트 확인의 '준비 확인'을 실행하세요——skills가 최신인지, Runtime이 호환되는지; 플러그인 루트도 거기서 찾습니다(본문 명령어의 <플러그인 루트>는 모두 해당 리터럴 경로를 대입). '준비'를 받아야만 계속합니다; '새 세션 필요' 또는 '중지'는 해당 조치를 따릅니다 ('자가 제작 대체 인터페이스 금지' 명령 포함).

준비 결과가 runtime.kind=desktop-managed이면, CLI 설치와 동일한 안정적인 진입점 및 launchd/windows-task 서비스를 공유하므로 바로 계속합니다; Electron 설치 디렉토리, Bun / FFmpeg를 추가로 설치하거나 두 번째 Runtime을 시작하지 마십시오.

1. 프로젝트 생성: 실제 입력 → 전사 → 제품 프로젝트 생성

목적: 사용자의 로컬 실제 비디오와 클라우드 단어별 전사 자료를 제품에 전달하여, 원자적으로 프로젝트를 생성하고, 서비스를 시작하고, 상태를 읽어옵니다.

# 클라우드 단어별 전사(작업 디렉토리 내 transcript 후보 생성) 이후:
node "<플러그인 루트>/scripts/videocut-cli.cjs" project create "<프로젝트 디렉토리>" --video "<작업 디렉토리 내 비디오 파일>" --transcript "<작업 디렉토리 내 단어별 전사 자료>" --json

node "<플러그인 루트>/scripts/ensure-running.cjs" --json          # 제품 선언적 상주 서비스(5190) 확인

node "<플러그인 루트>/scripts/videocut-cli.cjs" workflow get "<프로젝트 디렉토리>" --json    # Product state readback
node "<플러그인 루트>/scripts/videocut-cli.cjs" cuts get "<프로젝트 디렉토리>" --json

규칙:

사용자가 제공한 실제 구독 비디오 또는 기존 실제 프로젝트만 허용; 실제 미디어가 없으면 중단하고, 예제나 플레이스홀더 비디오로 대체 금지
전사는 현재 환경에서 승인된 클라우드 ASR만 사용; 로컬 ASR로 폴백 금지; 사용 가능한 클라우드 ASR이 없으면 missing_cloud_transcription_adapter 보고, Studio 열지 않으며, transcript 위조 금지
--video / --transcript는 작업 디렉토리 내 실제 파일이어야 함; 화면비는 전달하지 마십시오——제품이 비디오 실제 크기에서 자동으로 추론합니다(Runtime 0.4.4+). 사용자가 특별한 화면비를 명시적으로 요청하는 경우에만 --aspect-ratio W:H 추가
이미 규범적인 프로젝트가 있으면 inspect로 확인하고 재사용하며, projectId를 중복 생성하지 않음; 같은 비디오를 이미 편집한 경우 사용자에게 묻습니다: 이어서 할지, 다시 시작할지(이것이 세 가지 대화 지점 중 하나). project prepare는 멱등성 컴파일러이며, 중단된 작업을 복구하거나 명시적으로 새로 고칠 때만 사용; 중단 시 바로 다시 실행하면 됨
project create가 유일한 진입점: 미디어 라이브러리, 업로드 세션 또는 추가 스킬을 거치지 않음; 스킬이 먼저 project.json을 쓰는 것 금지
서비스는 스크립트가 healthy=true, runtimeMode=launchd(macOS) 또는 runtimeMode=windows-task(Windows), 버전 호환, URL이 표준 5190임을 확인한 후에만 계속; 실패 시 구조화된 오류를 전달하고 중단하며, foreground 폴백, 포트 변경, 알 수 없는 프로세스 종료 금지
두 개의 readback은 동일한 projectId를 가리켜야 하며, workflow stage와 Project / Cuts / EditList 세 revision을 저장; 누락되거나 일치하지 않으면 중단

2. 글자 수정: 글자를 바로잡고, 수정표 출력

목적: 모든 단어 삭제 판단 전에 사전을 사용하여 전사에서 잘못 들은 글자를 수정합니다——글자가 맞지 않으면 이후 판단이 반드시 틀림; 잘못 들은 글자는 불필요한 말이 아니므로, 단어 삭제로는 고칠 수 없습니다.

node "<플러그인 루트>/scripts/videocut-cli.cjs" transcript dictionary "<프로젝트 디렉토리>" --dictionary "<플러그인 루트>/references/ai-term-dictionary.md" --json

파일 도구를 사용하여 $HOME/.chengfeng-videocut/dictionary.md가 존재하는지 확인; 존재하면 다시 한 번 실행 (임시 조치: CLI는 현재 단일 파일만 수용하므로 두 번 나누어 실행; 추가만 가능하고 이전 실행을 취소할 수 없음—— 완전한 사용자 우선 병합 등 다중 사전 CLI가 출시될 때까지):

node "<플러그인 루트>/scripts/videocut-cli.cjs" transcript dictionary "<프로젝트 디렉토리>" --dictionary "$HOME/.chengfeng-videocut/dictionary.md" --json

산출물: 수정표——두 번 호출에서 반환된 applied 목록을 하나의 작은 표(원래 단어 → 수정 → 컨텍스트)로 병합하여 사용자에게 보고합니다. 수정 후 반드시 이 표를 확인하십시오——사전도 컨텍스트를 보지 않고 잘못 수정할 수 있습니다; 잘못된 것을 발견하면 사전을 수정하고, 다른 곳에 패치를 적용하지 마십시오.

사전으로 해결할 수 없고, 저자가 대본을 가지고 있는 경우에만 컨텍스트 정렬을 한 번 더 추가합니다:

node "<플러그인 루트>/scripts/videocut-cli.cjs" transcript align "<프로젝트 디렉토리>" --script "<구독 대본 파일>" --json   # 보고만 하고 수정하지 않음
node "<플러그인 루트>/scripts/videocut-cli.cjs" transcript correct "<프로젝트 디렉토리>" --file "<수정 파일>" --json

규칙:

글자만 수정하고, 시간, 단어 수, wordId는 수정하지 않음——제품이 단어별로 타임스탬프를 비교하므로, 변경 시 바로 거부
표기만 바꾸고, 의미는 바꾸지 않음——실제로 잘못 말하고 다시 말한 것은 불완전 문장 변경에 해당하며, 단어 삭제가 담당
사전에 없고 대본으로도 확인할 수 없는 것은 추측 금지: 보고하여 사람이 사전을 보충하도록 남겨둠. 지어낸 이름을 넣는 것은 잘못 들은 이름을 남기는 것보다 더 나쁨
중국어 구어는 원문 그대로 유지: '叉', '大模型'이라고 말한 것이 그가 말한 것
사전은 매 전사마다 통과해야 하는 관문 (같은 오디오를 두 번 전사해도 결과가 다름, 사고부 참조)

원고는 구두점 기준으로 분할: 전사에서 각 단어에는 구두점이 있으며, 원고는 쉼표 하나당 한 단락, 한 문장당 한 줄; 자막도 같은 구두점을 사용하여 양쪽의 단락이 일치합니다. 2026-07-28 이전의 구형 프로젝트에는 구두점이 없으므로, node "<플러그인 루트>/scripts/videocut-cli.cjs" transcript regroup "<프로젝트 디렉토리>" --json을 실행하여 단락을 다시 자르면 됩니다(단어별 id/시간/글자 변경 없음, 이미 편집된 프로젝트에 안전); 구두점이 필요하면 다시 전사해야 합니다——구두점은 구형 전사에 존재하지 않습니다.

3. 단어 삭제: 5회 스캔, 각 회차는 한 유형만 찾음

목적: 자료를 읽은 다음, 재생 순서대로 전체를 다섯 번 읽고, 매번 하나의 판단 기준만 적용합니다. 한 번에 하나의 판단 기준만 가지고 읽으면, 판단 품질이 한 번에 여섯 개를 가져오는 것보다 훨씬 높음; 각 회차의 산출물이 작아 점검 가능합니다.

먼저 자료 읽기:

node "<플러그인 루트>/scripts/videocut-cli.cjs" transcript playback "<프로젝트 디렉토리>" --json

그런 다음 파일 도구를 사용하여 $HOME/.chengfeng-videocut/cut-preferences.md를 읽습니다(사용자 선호도, 그가 말한 것이 유효; 파일이 없으면 신규 사용자이므로 건너뜁니다).

판단 기준은 의미 삭제 규칙에 있습니다(원칙 + 판례). 교재 우선순위: 사용자 선호도 > 사용자 판례 > 일반 판례.

1회차  중복          문장 간 중복, 문장 내 중복(가장 객관적: 두 번 동일)
2회차  불완전 문장 및 변경  말하다 중단, 다른 표현으로 다시 말함
3회차  말실수 재언급      잘못 말한 숫자, 고유명사, 단어, 이후 올바르게 다시 말함
4회차  영어 막힘        단어 시작 / 문자 / 음절 반복
5회차  추임새 및 감탄사    가장 주관적, 사용자 선호도의 밀도와 허용 한도에 따름

각 회차 동작 고정: 해당 회차 유형별 판례 검색 → 한 곳 발견 시 한 줄 기록(wordIds + 유형 + 위험) → 다른 유형은 판단하지 않음. 이후 회차에서 이미 표시된 단어는 건너뛰고, 충돌은 집계에서 해결.

규칙:

판단은 transcript playback의 재생 순서만 사용하며, transcript.json에서 직접 조합 금지—— '두 번 말했다'는 재생 시 인접해야 알 수 있으며, 직접 조합하면 번호 건너뛰기를 내용 부재로 오인하여 잘못 판단할 수 있음(사고부 참조)
삭제는 '삭제 / 미삭제' 두 가지 상태만 있음; AI 이유가 '삭제 권장'이라는 세 번째 상태를 형성하지 않음
말실수, 중복, 불완전 문장은 기본적으로 앞을 삭제하고 뒤를 유지; 긴 문장, 전체 문장, 분기 재언급은 반드시 고위험 재검토
일반적인 멈춤은 스킬이 계산하지 않음: 인접 무음 병합과 natural-pause-v2는 제품이 결정적으로 실행

4. 집계: 두 개의 표, 표가 나와야 작업 시작

목적: 5회차의 행을 두 개의 표로 병합——이것이 이 단계의 산출물이며, 사용자에게 보여줄 것입니다.

삭제 요약표(개별 삭제 결정):

| # | 시간   | 유형   | 삭제              | 남은 부분 읽기      | 위험 | 근거      |
|---|-------|--------|------------------|--------------------|-----|----------|
| 1 | 00:12 | 중복   | 이 기능은요         | 이 기능은 사실      | 낮음  | 판례 R2   |
| 2 | 02:31 | 변경   | 예를 들어 나는 그에게 추적하게 했는데 | 예를 들어 내가 grok에게 추적하게 했는데 | 높음  | 판례 R5   |

중복 문장표(여러 번 말한 문장, 단어별 표에서는 '몇 번 녹음했고, 어느 버전을 유지했는지' 알 수 없으며, 이것이 사용자가 가장 확인하고 싶어하는 것):

| 문장(시작)          | 말한 횟수 | 유지한 버전        | 삭제한 버전    | 위험            |
|-------------------|--------|------------------|--------------|-----------------|
| 오늘 뭐가 있어서…    | 3      | 3번째 00:08       | 1, 2번째     | 낮음——세 번 거의 동일 |
| 대부분 Agent가 검색… | 2      | 2번째 04:40       | 1번째        | 높음——두 번 표현에 차이 있음, 집중 청취 필요 |

그런 다음 자가 읽기: 표에 따라 삭제 후 전체 텍스트를 재생 순서대로 한 번 읽고, 읽히지 않는 행은 취소. 이것이 재검토의 정의: AI가 스스로 다시 한 번 보는 것이지, 사용자에게 묻는 것이 아님; 확실하지 않음 = 나열하지 않음(두 상태).

5. 검토: 인공 검토 시에만 Studio 열기

목적: 전체 후보를 제출하고, 두 개의 표를 사용자에게 제시한 다음, 제품 검토 페이지를 열어 사용자가 직접 검토하도록 합니다.

node "<플러그인 루트>/scripts/videocut-cli.cjs" cuts get "<프로젝트 디렉토리>" --json              # Cuts의 revision 가져오기
node "<플러그인 루트>/scripts/videocut-cli.cjs" cuts set "<프로젝트 디렉토리>" --file "<제안 파일>" --expected-revision "<Cuts 현재 revision>" --json

후보는 안정적인 wordIds만 참조:

{
  "schemaVersion": 1,
  "cutWordIds": ["word-12", "word-13"],
  "reasons": [
    { "wordIds": ["word-12", "word-13"], "kind": "repeat", "risk": "low" }
  ]
}

제출 규칙:

후보는 이번 판단의 전체 결론이며, 증분이 아님——cuts set은 대체 의미이며, 증분을 제출하면 이전 회차의 의미 단어 삭제가 조용히 유실됨(사고부 참조); 후보 제출 시 initialization.baselineCutWordIds를 읽거나 수동 병합 금지 (제품이 자동으로 멈춤 기준을 통합함)
reasons는 디스크에 저장되며, 있는 그대로 기록; 제품이 삭제되지 않은 단어에 대한 부분은 제거함
cut-selection.json, project.json 또는 이벤트 로그를 직접 쓰지 않음
cuts get.data.revision은 Cuts의 revision이고, workflow get.data.revision은 프로젝트의 revision이며, 혼용 금지
제출 성공 후 반드시 noLongerCut(이번에 더 이상 삭제하지 않는 단어 수)을 확인: 0이 아니고 의도적인 철회가 아니면 = 증분 제출, 돌아가서 전체를 다시 제출; "unknown"을 읽어도 반드시 확인
그런 다음 즉시 다시 workflow get + cuts get을 실행하여 cut_review_ready와 세 개의 revision을 확인; 불일치 시 중단하고, 절대 JSON을 직접 쓰거나 자동 덮어쓰기 금지
제출 후 <제안 파일>을 작업 디렉토리에 남겨둠——6단계 복기에서 사용(reasons는 사용자 편집 후 제품에 의해 제거될 수 있으므로, 사후에 장부에서 역추적하는 것은 신뢰할 수 없음)

그런 다음 먼저 표를 제시하고, 그런 다음 페이지 열기: 두 개의 표를 사용자에게 보내고, 표를 가지고 Studio에 들어가 검토하도록 합니다.

node "<플러그인 루트>/scripts/ensure-running.cjs" --json                    # 열기 전 다시 멱등성 ensure
node "<플러그인 루트>/scripts/videocut-cli.cjs" open "<프로젝트 디렉토리>" --json          # 제품이 반환한 프로젝트 URL 가져오기

node "<플러그인 루트>/scripts/ensure-studio.cjs" --url "<제품 프로젝트 URL>" --view koubo --json                                  # 기능 게이트: 5190이 koubo 뷰를 등록했는지 확인

규칙:

게이트가 ok=true를 반환한 경우에만 Codex 내장 브라우저로 studio.url을 열고, 그런 다음 자동 진행을 중단하고, 사용자가 단어 선택, 복원, 저장할 때까지 기다림
열기 전에 productUrl의 #project/<projectId>를 readback의 projectId와 엄격히 비교하고, stage=cut_review_ready 및 세 개의 revision과 바인딩——게이트 ok=true는 제품 측 기능만 증명할 뿐, 프로젝트 수준 바인딩을 대체할 수 없음; 불일치 시 다시 readback
studio_capability_missing: 중단하고 버전 비호환을 설명하며, $chengfeng-report-bug를 제안할 수 있음; URL에 ?view=koubo가 있다고 해서 새 인터페이스가 존재한다고 간주하거나, 구형 작업 패널로 폴백 금지
'작업대 열기'를 작업의 첫 단계로 삼지 마십시오; 구형 review.html, 8898/8899에 접근 금지; Studio DOM을 제어하거나 미디어 요소를 직접 변경 금지; 독립 오디오 트랙 또는 플레이스홀더 자막 트랙 생성 금지

6. 복기 및 인계: 사용자가 수정한 작업을 버리지 마십시오

사용자 검토가 완료되면 먼저 읽어옵니다:

node "<플러그인 루트>/scripts/videocut-cli.cjs" workflow get "<프로젝트 디렉토리>" --json
node "<플러그인 루트>/scripts/videocut-cli.cjs" cuts get "<프로젝트 디렉토리>" --json

복기(임시 조치, 제품의 cuts diff 명령어가 출시되면 대체): 5단계에서 보관된 <제안 파일>을 읽어온 최종 cutWordIds와 비교——

사용자가 복원한 것(제안에 있고 최종 버전에 없음) = AI가 잘못 삭제함. 제안서에 자신이 쓴 reason과 대조하여 질문: 어느 유형에서 잘못되었나?
사용자가 추가 삭제한 것(최종 버전에 있고 제안에 없으며, initialization.baselineCutWordIds 멈춤 기준에도 없음) = AI가 놓친 것. 질문: 이것은 어떤 유형에 속하며, 왜 식별하지 못했나? (기준은 여기서 멈춤 단어를 제외하는 데만 사용되며, 여전히 제출에 병합하는 것은 금지됨)

세 개의 서랍에 보관:

취향 차이 → ~/.chengfeng-videocut/cut-preferences.md에 추가(Agent가 유지 관리하는 markdown, 자신의 절만 추가 및 수정; 파일이 없으면 생성)
고유명사 오류 → ~/.chengfeng-videocut/dictionary.md에 추가(두 개의 열로 된 표, 추가 전 중복 확인)
규칙 공백 → 선호도 파일 '업그레이드 대기 판례' 절에 기록; 동일한 유형이 세 번째 발생 시 사용자에게 보고하고, 일반 판례로 업그레이드 제안(인간 검토 후에만 skills 저장소 수정)
차이가 없는 경우에도 기록: 선호도 파일 프로젝트 기록에 한 줄 '전면 채택' 추가

네 가지 사항 보고: 삭제한 단어 수, 줄어든 초(second) 수; 현재 stage(cut_review_ready여야 함); 프로젝트 / Cuts / EDL 세 개의 revision; 복기 요약(제안 N개, 채택 X, 복원 Y, 추가 삭제 Z, 주요 차이점 한 문장). 그런 다음 사용자에게 다음 단계인 내보내기를 알림.

확인 카드 팝업 금지, 절단 실행 금지——물리적 절단의 확인 카드는 내보내기 스킬에 속하며, 그 카드가 동결해야 하는 것은 사용자가 확인을 누르는 순간의 revision입니다.

return_cut_review: 먼저 다시 node "<플러그인 루트>/scripts/ensure-running.cjs" --json을 실행한 다음, 동일한 Studio로 돌아가 검토를 계속; 복기를 트리거하지 않으며, 복기는 최종 인계 시에만 한 번 수행됩니다.

보고서 등급: Product 구조화된 revision은 API/readback PASS; 실제 브라우저 프레임 검토는 visual frame PASS; 실제로 듣는 사람이 없으면 human listening UNVERIFIED, 재생, DOM, 스크린샷 또는 미디어 탐색으로 대체 불가.

복구 및 실패

revision_conflict: 상태를 다시 읽고, 사용자의 최근 편집을 설명하며, 자동으로 덮어쓰지 않음
runtime_unhealthy: 재설치를 반복하지 않음
service_identity_mismatch / service_port_conflict: 중단, foreground 폴백, 포트 변경, 알 수 없는 프로세스 종료 금지
페이지가 닫혔지만 서비스는 계속 실행 중: workflow를 읽은 후 현재 상태에서 계속 진행하며, 새 프로젝트를 생성하지 않음
어떤 실패든 '장부가 기록되었다'고 '이미 편집 완료'라고 말하면 안 됨——이 단계까지는 어떤 미디어 파일도 생성되지 않음

참고: 본 스킬은 로컬 실제 비디오와 클라우드 단어별 전사 자료를 제품에 직접 입력하는 것을 허용하며, 이것이 계약 preflight의 요구사항입니다; 둘 다 실제로 존재하는 것이 모든 판단의 전제입니다.

Agentchengfeng/chengfeng-videocut-skills

chengfeng-videocut-skills란 무엇인가요?

즐겨 사용하는 AI에게 물어보기

문서