Communitygithub.com

edit

편집 단계: 렌더링된 블록을 완성된 영화로 편집합니다. 편집 프로그램(editor.id)에서 작업합니다. "/edit", "영화 편집", "컷 편집", "Resolve에서 열기", "최종 영상 제작" 등의 명령에 사용합니다.

edit란 무엇인가요?

이 스킬은 AI 에이전트가 개별 클립 블록을 완성된 영화로 편집하는 방법을 정의합니다. `config.json`의 `editor.id` 설정에 따라 에이전트는 ffmpeg를 사용해 직접 편집하거나(assemble 스킬 사용), DaVinci Resolve, Premiere Pro, Final Cut Pro, CapCut과 같은 전문 편집 프로그램 내에서 작업할 수 있습니다. 편집 프로그램을 사용할 때는 MCP(Model Context Protocol) 서버로 정밀한 작업을 수행하고, computer use 기능으로 화면을 확인하여 두 기능을 항상 함께 사용합니다. 에이전트는 편집 전에 모든 클립 경로를 확인하고, 화면 제어 전에 사용자에게 먼저 물어보며, 절대로 미디어를 생성하거나 음악을 추가하지 않습니다. MCP나 computer use 중 하나만 사용 가능한 경우에는 그에 맞게 작업 방식과 결과물의 신뢰도를 명확히 보고합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bidah/storyseam/tree/HEAD/.claude/skills/edit

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

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

/edit — 클립 → 영화, 스토리가 지정한 프로그램에서

영화는 작가가 계속 작업할 곳에서 편집됩니다. config.json에 다음과 같이 지정합니다:

"editor": { "id": "davinci_resolve", "mcp": true, "computer_use": true }
키의미
idnone — ffmpeg로 직접 편집합니다. 또는 프로그램: davinci_resolve, premiere_pro, final_cut_pro, capcut, 또는 작가가 지정한 다른 이름.
mcp해당 프로그램의 MCP 서버가 클라이언트에 설치 및 연결된 경우 true.
computer_use화면을 직접 제어할 수 있는 경우 true (Claude의 computer use 또는 도구의 동등한 기능).
notes선택적 자유 텍스트: 프로그램 버전, 에디션, 프로젝트 위치.

editor 키가 없으면 { "id": "none" }과 동일합니다.

0단계 — 클립 확인 (모든 경로)

편집기 종류와 관계없이 assemble 스킬의 1단계를 먼저 수행하세요: 모든 블록에 클립이 순서대로, 실제 길이로 있어야 합니다. 누락된 블록을 기반으로 한 편집은 구멍이 있는 영화입니다.

경로 A — editor.id: "none": 에이전트가 편집기

assemble 스킬을 따르세요. 출력은 renders/final/film.mp4입니다. 이것이 전체 단계입니다.

경로 B — 프로그램: 해당 프로그램에서 편집

B1. 접근 가능한 것 확인 후 보고

아무것도 건드리기 전에 config.json의 설정을 확인하세요:

  • MCP: 프로그램 서버의 읽기 전용 도구를 호출하세요 (DaVinci Resolve의 경우 프로젝트 또는 타임라인 목록). 실패하면 config.json mcp_servers의 해당 서버 설치 명령어(npx storyseam mcp --agent <yours>; Resolve의 경우 npx davinci-resolve-mcp setup)를 출력하고 기다리세요. 작가가 서버가 필요 없다고 확인한 후에만 editor.mcp를 false로 설정하세요. 직접 설치하지 마세요.
  • Computer use: 스크린샷 한 장을 찍어 프로그램이 열려 있거나 열 수 있는지 확인하세요.

그런 다음 작가에게 작업 모드를 한 줄로 알리고 화면 제어 전에 먼저 물어보세요: computer use는 사용자의 마우스와 키보드를 움직입니다.

B2. MCP와 computer use를 함께 사용

어느 하나만으로는 충분하지 않으며, 모든 단계에서 두 가지를 함께 사용할 때 최상의 결과를 얻을 수 있습니다:

  • MCP가 정밀하고 반복 가능한 작업을 수행합니다: 스토리의 해상도와 프레임 레이트로 프로젝트와 타임라인 생성, renders/clips/block_NN.mp4를 블록 순서대로 가져오기, 각각을 V1/A1에 연속 배치, shotlist/shotlist.json의 블록별 마커 추가, 렌더링 설정 지정 및 렌더링 시작. 정확한 값과 잘못된 클릭이 없어야 합니다.
  • Computer use는 눈과 API가 닿지 않는 곳의 손 역할을 합니다: 각 MCP 단계 후 스크린샷을 찍어 보고된 대로 수행되었는지 확인, 뷰어에서 모든 접합면을 스크러빙하여 양쪽 프레임 확인, 오디오 미터 확인, MCP가 노출하지 않는 모든 것(대화상자, 패널, 드래그, API가 없는 설정) 처리.
  • 직접 확인하지 않은 MCP 성공 메시지를 절대 신뢰하지 마세요. 잘못된 프레임 레이트로 가져온 클립, 잘못된 해상도의 타임라인, 빈 렌더링 큐 모두 성공을 보고합니다.

하나만 사용 가능한 경우:

mcpcomputer_use작업 방식
truetrue둘 다 사용. 기본값이며 최상의 방법.
truefalseMCP만 사용. 눈으로 확인되지 않은 편집이라고 말하고 작가에게 직접 접합면을 확인해 달라고 요청하세요.
falsetrueComputer use만 사용. 속도가 느리므로 작가에게 알리고 각 단계 후 스크린샷과 함께 작게 진행하세요.
falsefalse프로그램을 구동할 수 없습니다. renders/edit/timeline.edl (CMX 3600, shotlist.json과 클립 실제 길이 기준으로 블록 순서대로 이벤트 하나씩)을 작성하고 가져오는 방법을 알려주세요. 또한 assemble 스킬을 통해 renders/final/film.mp4도 생성하여 어떤 경우든 영화가 있도록 하세요.

B3. 편집

  1. storyseam.md의 title을 딴 프로젝트 이름, 클립의 실제 해상도와 프레임 레이트 사용 (ffprobe로 한 클립 확인; 추정하지 마세요).
  2. 타임라인 하나. V1에 블록, A1에 오디오, 순서대로, 간격이나 겹침 없음.
  3. 블록당 마커 하나, 블록 ID와 첫 번째 샷으로 이름 지정.
  4. 빈 음악 트랙(A2)을 작가를 위해 남겨두세요. 절대 음악을 추가하지 마세요. 스코어는 작가의 몫이며 assets/audio/music/에 있습니다.
  5. renders/final/film.mp4로 렌더링 (H.264, AAC, 타임라인 해상도), 프로그램의 자체 프로젝트 파일은 프로그램이 저장하는 위치에 저장하세요. 해당 경로를 editor.notes에 기록하세요.

B4. 프로그램 참고 사항

  • DaVinci Resolve. MCP 서버는 Resolve의 스크립팅 API를 구동합니다. 외부 스크립팅은 Studio 전용입니다; 무료 에디션에서는 앱 내 브리지(Workspace › Scripts)가 접근 방법이며, 무료 21.1+에서는 Python 스크립팅이 사라졌으므로 computer use에 의존해야 합니다. 타임라인에는 Edit 페이지, 렌더링에는 Deliver 페이지를 사용하세요; 렌더링을 시작하기 전에 스크린샷으로 렌더링 큐를 확인하세요.
  • 다른 모든 프로그램. 먼저 MCP 서버를 찾으세요. 없으면 위의 mcp: false 행에 해당합니다. 직접 소프트웨어, 플러그인 또는 MCP 서버를 설치하지 마세요; 작가에게 무엇이 도움이 될지 알려주고 작가가 설치하도록 하세요.

마지막 단계 — 보고

영화 파일 경로, 실제 런타임 및 해상도, 프로그램의 프로젝트 파일, 작업 모드(MCP + computer use, 둘 중 하나, 또는 EDL), 눈으로 확인하지 못한 사항, 그리고 의도적으로 음악이 없음을 보고하세요.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬