컷 브리핑 (구두 연설 편집)
하나의 비디오에서 인간 검증을 거친 삭제 단어 원장 (Cuts + EDL) 까지, 미디어 파일은 건드리지 않습니다. 7단계 1선:
0 준비 「업데이트 확인」 참조 (이 Skill은 환경 로직을 포함하지 않음)
1 프로젝트 생성 실제 비디오 → 클라우드 단어별 전사 → 제품 프로젝트 생성 → 서비스 시작 → 상태 읽어오기
2 단어 수정 사전으로 단어 수정 (공용 1개 + 사용자 1개) → 수정표 출력
3 단어 삭제 선호도 및 규칙 읽기 → 5라운드 스캔, 각 라운드마다 한 유형만 찾고 행만 기록
4 집계 삭제 단어 요약표 + 반복 문장표 → 표에 따라 자체 읽기 검증
5 검토 전체 제출 → 두 표를 사용자에게 제시 → Studio 열어 직접 검토
6 복기 및 인계 제안과 최종 버전 비교 → 세 가지 서랍에 보관 → 네 가지 사항 보고
미디어 절단 안 함: 원장을 한 번 수정하는 데는 수십 밀리초가 걸리지만, 한 번 절단은 되돌릴 수 없는 파일입니다. 이 Skill이 끝날 때까지 디스크에는 새 비디오가 없습니다. Skill은 의미 판단과 편성만 수행합니다. 제품 Runtime은 프로젝트, Cuts 및 Studio 상태의 유일한 기록자입니다.
사용자는 세 곳에서만 말합니다: 동일 소스 프로젝트에서 계속할지 다시 시작할지 (이미 편집된 경우만), Studio 검토, 완료 확인. 그 외에는 모두 단방향 보고이며, 응답을 기다리며 멈추지 않습니다. 각 단계의 완료 판단은 그 산출물입니다: 표가 나오지 않으면 완료된 것이 아닙니다.
먼저 비즈니스 Skill 단계 계약을 읽고 실행하십시오. 이 문서의 단계와 계약 단계의 대응: 1=preflight+Product state readback, 5=proposal+Product CAS, 검토=project-level review binding. 계약의 세 단계 (확인, 실행, 검수)는 내보내기 Skill에 속합니다.
각 규칙의 사고 경위는 사고 기록부에 있습니다—규칙은 본문, 이야기는 거기에 있습니다.
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는 유일한 진입점입니다: 미디어 라이브러리, 업로드 세션 또는 추가 Skill을 거치지 않습니다. Skill이 먼저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 이유로 '삭제 권장'이라는 세 번째 상태를 만들지 않습니다.
- 실수, 반복, 잔여 문장은 기본적으로 앞을 삭제하고 뒤를 보존합니다. 긴 문장, 전체 문장, 분기 재말은 반드시 높은 위험 검토가 필요합니다.
- 일반적인 일시 정지는 Skill이 계산하지 않습니다: 인접한 무음 병합과
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 # 열기 전에 다시 멱등성 보장
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 저장소 수정).
- 차이가 없는 경우에도 기록: 선호도 파일 프로젝트 기록에 한 줄 '전면 수용' 추가.
네 가지 사항 보고: 삭제된 단어 수, 줄어든 초 수; 현재 stage (cut_review_ready여야 함); 프로젝트 / Cuts / EDL 세 revision; 복기 요약 (제안 N개, 수용 X 복원 Y 추가 삭제 Z, 주요 이견 한 문장). 그런 다음 사용자에게 다음 단계는 내보내기라고 알립니다.
확인 카드를 표시하지 않고, 절단을 실행하지 않음—물리적 절단의 확인 카드는 내보내기 Skill에 속하며, 해당 카드는 사용자가 확인을 누른 순간의 revision을 고정해야 합니다.
return_cut_review: 먼저 다시 node "<플러그인 루트>/scripts/ensure-running.cjs" --json을 실행한 후, 동일한 Studio로 돌아가 검토를 계속합니다. 복기를 트리거하지 않으며, 복기는 최종 인계 시에만 한 번 수행됩니다.
보고 등급: 제품 구조화 revision은 API/readback PASS입니다. 실제 브라우저 프레임 검토만이 visual frame PASS입니다. 아무도 실제로 듣지 않은 경우 항상 human listening UNVERIFIED이며, 재생, DOM, 스크린샷 또는 미디어 감지를 대체 수단으로 사용할 수 없습니다.
복구 및 실패
revision_conflict: 상태를 다시 읽고, 사용자의 최근 편집 사항을 설명하며, 자동으로 덮어쓰지 않습니다.runtime_unhealthy: 재설치를 반복하지 않습니다.service_identity_mismatch/service_port_conflict: 중단하고, foreground로 대체, 포트 변경, 알 수 없는 프로세스 종료를 하지 않습니다.- 페이지가 닫혀도 서비스는 계속 실행됨: workflow를 읽은 후 현재 상태에서 계속하며, 새 프로젝트를 생성하지 않습니다.
- 어떤 실패에서도 '원장이 작성됨'을 '이미 편집됨'으로 말해서는 안 됩니다—이 단계까지는 어떤 미디어 파일도 생성되지 않았습니다.
참고: 이 Skill은 로컬 실제 비디오와 클라우드 단어별 전사본을 직접 제품에 입력하며, 이는 계약 preflight의 요구 사항입니다. 둘 다 실제로 존재하는 것이 모든 판단의 전제 조건입니다.