Communitygithub.com

77777R7/screenstudio-demo-optimizer

Screen Studio 데모 녹화본을 안전하게 최적화하는 Codex 스킬 및 헬퍼 스크립트

screenstudio-demo-optimizer란 무엇인가요?

이 스킬은 Screen Studio 데모 녹화물의 편집 의도를 안전하고 되돌릴 수 있는 방식으로 타임라인에 반영할 수 있게 해줍니다. 사용자가 원하는 결과물(목표 길이, 속도, 로직 보존, 줌 동작, 출력 형식)을 기준으로 편집 계획을 수립하고, 스크립트를 통해 안전한 복사본 생성, 타임라인 분석, 압축 계획 수립, 속도 및 줌 변경 적용, 최종 검증까지의 전 과정을 지원합니다. 주로 Cursor, Codex, Claude Code 등 터미널 기반 AI 에이전트와 함께 사용되며, JSON 기반의 선호 계약(preference contract)을 통해 사용자의 의도를 명확히 파악하고 기본값을 적용합니다. 원본 파일을 직접 수정하지 않고 편집용 복사본을 생성하여 작업하므로 안전성이 높으며, 각 단계마다 사용자 확인을 요청하여 의도치 않은 변경을 방지합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add 77777R7/screenstudio-demo-optimizer

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

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

문서

Screen Studio 데모 최적화기

이 스킬을 사용하여 사용자의 편집 의도를 안전하고 되돌릴 수 있는 Screen Studio 타임라인 편집으로 전환하세요.

이 스킬은 고정된 편집 스타일이 아닙니다. 항상 사용자가 원하는 결과물(목표 길이, 속도, 로직 보존, 속도 제한, 줌 동작, 출력 형식)이 계획을 제어하도록 하세요.

핵심 워크플로우

  1. 편집 계약을 명확히 하거나 추론하세요:
    • 목표 길이: 정확, 대략, 또는 제약 없음.
    • 스타일: 소셜 데모, 튜토리얼, 투자자 데모, 내부 워크스루, 차분한 리뷰, 빠른 티저, 또는 맞춤 설정.
    • 우선순위: 모든 논리적 단계 보존, 대기 시간 자르기 허용, 반복 삭제 허용, 오디오 보존, 줌 보존, 모션 줄이기.
    • 출력: 계획만, 편집 복사본, 또는 내보내기.
  2. 수정하기 전에 안전한 복사본을 준비하세요.
    • scripts/prepare_edit_copy.mjs를 사용하세요.
    • 사용자가 명시적으로 요청하지 않는 한 원본 .screenstudio 프로젝트를 절대 수정하지 마세요.
  3. 프로젝트를 분석하세요.
    • scripts/analyze_timeline.mjs를 사용하세요.
    • 슬라이스, 속도, 재생 범위, 줌 범위, 서브초 줌 위험을 읽어보세요.
  4. 편집 가능한 계획을 만드세요.
    • 목표 길이가 제공된 경우 scripts/plan_compression.mjs를 사용하세요.
    • 적용하기 전에 계획을 사람이 이해할 수 있는 용어로 설명하세요.
  5. 편집 복사본을 변경하기 전에 확인을 요청하세요.
  6. 확인된 변경 사항을 적용하세요.
    • scripts/apply_speed_plan.mjs를 사용하세요.
    • 외부 또는 CLI 저장 후 scripts/normalize_project_json.mjs를 사용하세요.
  7. 줌 편안함을 검토하세요.
    • scripts/optimize_zoom_track.mjs --review를 사용하세요.
    • 확인 후에만 줌 변경 사항을 적용하세요.
  8. 검증하세요.
    • scripts/verify_project.mjs를 사용하세요.
    • Screen Studio를 사용할 수 있는 경우, 선택적으로 scripts/screenstudio_cdp_open_project.mjs 및 screenstudio --port <port> status를 사용하세요.

선호 계약

사용자가 충분한 의도를 제공하면 합리적인 기본값으로 진행하세요. 목표가 모호한 경우, 간결한 질문 하나를 던지세요.

사용자가 단순히 "더 좋게 만들어 줘"라고 말할 때의 기본 계약:

{
  "targetSeconds": null,
  "style": "balanced-demo",
  "preserveLogic": true,
  "allowDelete": false,
  "maxReadingSpeed": 1.6,
  "maxActionSpeed": 3,
  "maxWaitSpeed": 10,
  "zoomPolicy": "reduce-jumpy-zooms"
}

일반적인 프리셋:

  • social-demo: 짧고, 선명하며, 높은 대기 속도, 불규칙한 줌 줄이기.
  • tutorial: 느리게, 단계 보존, 공격적인 줌 변경 피하기.
  • investor-demo: 간결하게, 서사적 순간 보존, 결과 강조.
  • agent-workflow: 대기/로딩 시간을 많이 단축, 주요 결정과 최종 결과 보존.
  • review-only: 분석하고 권장만 하며, 수정하지 않음.

속도 조절 휴리스틱은 references/compression-rules.md를, 줌 편집 전에는 references/zoom-comfort-rules.md를 읽으세요.

스크립트 빠른 시작

안전한 파일 준비:

node scripts/prepare_edit_copy.mjs "/path/to/demo.screenstudio"

분석:

node scripts/analyze_timeline.mjs "/path/to/demo.agent-edit-copy.screenstudio"

90초 컷 계획:

node scripts/plan_compression.mjs "/path/to/demo.agent-edit-copy.screenstudio" --target-seconds 90 --preset social-demo > /tmp/plan.json

확인된 계획 적용:

node scripts/apply_speed_plan.mjs "/path/to/demo.agent-edit-copy.screenstudio" /tmp/plan.json
node scripts/verify_project.mjs "/path/to/demo.agent-edit-copy.screenstudio"

줌 편안함 검토:

node scripts/optimize_zoom_track.mjs "/path/to/demo.agent-edit-copy.screenstudio" --review

Screen Studio가 설치된 경우 CDP 모드로 열기:

node scripts/screenstudio_cdp_open_project.mjs "/path/to/demo.agent-edit-copy.screenstudio"

안전 규칙

  • 중요하지 않은 편집의 경우 기본적으로 계획 우선.
  • 기본적으로 원본 프로젝트를 덮어쓰지 마세요.
  • 사용자가 삭제를 허용하지 않는 한 슬라이스를 삭제하지 마세요.
  • 오디오 중심 또는 내레이션 중심 녹화는 속도에 민감한 것으로 취급하세요.
  • 일부 Screen Studio/CLI 흐름이 프로젝트 데이터를 중첩된 JSON 문자열로 래핑할 수 있으므로 저장 후 project.json을 정규화하세요.
  • 프로젝트 파일에서 최종 길이를 확인하고, 가능하면 Screen Studio 런타임에서도 확인하세요.
  • 변경된 슬라이스와 줌을 정확히 보고하세요.

파괴적이거나 되돌릴 수 없는 작업을 수행하기 전에 references/safety-and-backups.md를 읽으세요.

알려진 제한 사항

  • Screen Studio 내부는 버전에 따라 변경될 수 있습니다. CDP 열기가 실패하면 프로젝트 파일 분석으로 대체하고 사용자에게 알리세요.
  • 시각적 품질은 타임라인 데이터만으로 완전히 판단할 수 없습니다. 가능하면 프레임 추출이나 Screen Studio 미리보기를 사용하세요.
  • 번들된 스크립트는 보수적인 기본 요소입니다. 에이전트는 여전히 주관적인 트레이드오프를 설명하고 확인을 요청해야 합니다.

관련 스킬