Communitygithub.com

ws-cczj/article-video-skill

학술 논문을 학습용 비디오로 변환합니다. 먼저 중국어 학술 스타일 요약을 생성한 후, 내레이션, 시각적 기획, 스토리보드 및 비디오 검토를 거쳐 최종 비디오를 제작합니다. 적절한 도구가 있는 경우에만 비디오를 렌더링합니다.

article-video-skill란 무엇인가요?

이 기술은 학술 논문을 학습 비디오로 변환하는 전문 AI 에이전트 스킬입니다. 연구 질문, 방법, 증거 및 한계를 체계적으로 구성하여 학습자에게 적합한 비디오 설명을 제공합니다. 작업 흐름은 세 단계로 나뉩니다: (1) 중국어 학술 스타일 요약 생성 (증거 기록 및 사실 확인 포함), (2) 내레이션 및 스토리보드 작성, (3) 비디오 제작 및 검토. 이 기술은 Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 사용할 수 있으며, 사용 가능한 도구(예: TTS, 자막 정렬, 렌더러)가 있는 경우에만 비디오를 렌더링합니다. 필수 구성 요소로 '증거 템플릿', '스토리보드 템플릿', '중국어 요약 및 형식 참조'와 같은 템플릿을 활용합니다. PDF 및 비디오의 실제 생성 상태를 투명하게 보고하며, 부족한 기능이 있을 경우 사용자에게 명확히 알립니다. 이 기술은 교육 및 학습 목적으로 설계되어 논문 기반 학습 콘텐츠 제작을 간소화합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add ws-cczj/article-video-skill

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

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

문서

문헌을 학습 비디오로 변환

논문의 연구 문제, 방법, 증거 및 한계를 학습에 적합한 비디오 설명으로 구성합니다. 먼저 중국어 논문식 요약을 제공한 후, 내레이션을 다시 작성하고, 시각적 계획을 선택하고, 스토리보드를 구성한 다음, 최종적으로 비디오를 제작하고 검토합니다. 최종 비디오는 환경에서 실제로 사용 가능한 도구에 따라 달라집니다.

입력 및 범위

  • 논문 파일, 접근 가능한 링크 또는 사용자가 제공한 본문을 수락합니다. 먼저 실제로 읽은 부분을 확인하고, 초록만 있는 경우 이를 기반으로 전체를 읽거나 요약했다고 주장하지 않습니다.
  • 원문이 중국어든 영어든, 문헌 요약의 본문, 초록, 장(chapter) 설명 및 그림 설명은 모두 중국어를 사용합니다. 원 논문 제목, 저자, 검증 가능한 인용, 공식, 변수 및 필수 영어 용어는 유지합니다. 비디오 언어는 사용자 요청에 따라 별도로 결정되며, 이로 인해 중국어 요약의 기본 요구 사항이 변경되지 않습니다.
  • 사용자 요청에 따라 대상, 비디오 언어, 길이, 화면 비율 및 출력 위치를 결정합니다. 지정되지 않은 경우, 학부생, 중국어, 약 5분, 16:9를 초기 가정으로 사용하고, 전달 시 이를 명시합니다.
  • 입력 읽기 및 스크립트 기획은 직접 수행할 수 있습니다. 사실적 근거에 영향을 미치는 자료(예: 본문)가 누락된 경우 보충을 요청하며, 기존 내용을 먼저 정리하고 범위를 표시할 수 있습니다.

증거에서 중국어 논문식 요약으로

  1. 독립적인 출력 디렉토리를 생성합니다. 증거 템플릿을 evidence.md로 복사하고, 논문 메타데이터와 접근 범위를 기록합니다.
  2. 연구 문제, 기존 연구의 한계, 방법, 실험 조건, 주요 결과 및 한계를 읽습니다. 각 핵심 사실에 대해 페이지 번호, 장, 그림 또는 표 번호를 기록합니다. 논문 결론, 어시스턴트 설명 및 확인이 필요한 항목을 구분합니다.
  3. 수치와 그 단위, 비교 기준, 데이터 세트 및 적용 조건을 확인합니다. 상관 관계를 인과 관계로 다시 쓰거나, 국소 실험을 일반적인 결론으로 확장해서는 안 됩니다.
  4. 중국어 요약 및 형식 지침을 읽고, 독립적인 summary.md를 생성합니다. 요점 표나 내레이션으로 중국어 요약을 대체할 수 없습니다. 논문식 구조로 본문을 구성합니다. 이론, 리뷰 등 유형에 따라 방법 및 결과 장을 조정하고, 존재하지 않는 실험을 만들어서는 안 됩니다.
  5. 중국어 논문 조판 템플릿을 사용하여 요약 본문과 일치하는 summary.tex를 생성합니다. 사용자가 이미 학교나 저널 템플릿이 있는 경우 이를 우선 따르고, 없는 경우 프로젝트 기본 조판을 사용하며, 이를 통일된 학술 표준이라고 주장하지 않습니다.
  6. 번역, 공식, 첨자, 기호, 단위, 인용 및 사실적 근거를 확인합니다. 사용 가능한 컴파일러가 있는 경우 summary.pdf를 생성하고 실제 페이지를 확인합니다. 컴파일러가 없는 경우 본문과 원고를 전달하고, PDF가 생성되지 않았으며 페이지 조판이 검증되지 않았음을 명확히 합니다. 공식을 식별할 수 없는 경우 확인이 필요함을 표시하고, 추측하여 작성하지 않습니다.
  7. 중국어 요약의 사실 확인이 완료된 후에만 이를 기반으로 비디오 내레이션을 작성합니다. 페이지 조판이 아직 검증되지 않은 경우 해당 작업을 보류하고, 전체 요약 전달을 조판 검증 완료로 선언해서는 안 됩니다. 사용자가 명시적으로 요청하지 않는 한, 각 단계에서 승인을 요구하지 않습니다.

중국어 요약에서 내레이션 및 스토리보드로

  1. summary.md에서 대상과 길이에 적합한 스토리 라인을 추출하고, 읽을 수 있는 완전한 문장으로 다시 작성합니다. 논문식 요약을 그대로 더빙해서는 안 됩니다. 용어가 처음 등장할 때 설명합니다. 기본적으로 분당 약 220-280개의 중국어 문자를 초기 추정에 사용하며, 최종적으로 실제 더빙 시간을 기준으로 합니다.
  2. 스토리보드 템플릿을 storyboard.md로 복사하고, 요약 장과 증거 번호를 연결합니다. "문제 - 핵심 아이디어 - 방법 - 결과 - 한계 - 복습" 순서로 내용을 구성하며, 논문에 따라 순서와 비중을 조정할 수 있습니다.
  3. 내용에 따라 시각적 계획을 결정합니다: 전체 비디오에 걸쳐 균일한 글꼴, 색상 조합, 자막 및 전환. 필요에 따라 개념 설명, 방법 흐름, 실험 비교, 데이터 표시 또는 공식 추론을 촬영합니다. 선택 이유, 실제 템플릿 또는 구현 방식을 기록합니다. 기성 렌더링 템플릿이 없는 경우 시각적 디자인 계획으로 명시하고, 템플릿 라이브러리를 사용할 수 있다고 주장하지 않습니다.
  4. 스토리보드 항목별로 시간, 학습 목표, 화면, 내레이션, 자막 및 인용을 명확히 작성합니다. 수치 그래프는 원문에서 검증 가능한 데이터에서 가져와야 합니다. 직접 그린 개념도나 애니메이션은 "개념도"라고 표시하고, 실험 결과로 위장해서는 안 됩니다.
  5. 마지막에 2-3개의 복습 질문이나 요점을 설정하여 학습자가 방법, 증거 및 한계를 기억하도록 돕습니다.

비디오 제작 및 전달

  • 먼저 문서 추출, TTS, 자막 정렬 및 비디오 렌더링 도구를 사용할 수 있는지 확인합니다. 사용자가 지정한 도구와 자료를 존중합니다. 본 스킬은 이러한 프로그램을 자체 포함하지 않습니다.
  • 도구가 부족한 경우에도 먼저 중국어 요약 및 조판 원본을 전달한 다음, 증거 기록, 전체 내레이션 및 스토리보드를 전달합니다. PDF와 비디오의 실제 생성 상태 및 부족한 기능을 설명하고, 빈 비디오를 출력하거나 가상 파일 링크를 생성하지 않습니다.
  • 사용 가능한 기존 도구를 사용하여 음성을 합성하고, 자막을 생성하며, 화면을 렌더링합니다. 대규모 종속성을 설치하거나 유료 서비스를 사용해야 하는 경우, 먼저 구체적인 종속성 또는 비용을 설명하고, 해당 권한을 얻습니다.
  • 자막 타임라인은 실제 오디오와 일치해야 합니다. 렌더링이 완료되면 총 길이, 오디오 트랙, 자막 동기화, 중국어 글꼴, 화면 자르기, 그래프 가독성 및 출처 표시를 확인합니다.
  • 증거 기록과 대조하여 최종 스크립트 및 비디오의 핵심 결론과 수치를 재확인합니다. 검증할 수 없는 내용은 삭제하거나 명확히 표시합니다.
  • 실제 렌더링된 비디오를 검토하며, 스크립트나 정적 표지만 검토해서는 안 됩니다. 내용 정확성, 학습 효과, 미적 일관성 및 시청각 동기화 문제를 review.md에 기록하고, 시간, 촬영 번호, 문제, 수정 제안 및 재검토 결과를 포함합니다. 문제에 따라 국소적으로 미세 조정하고, 수정된 촬영과 전후 연결을 재검토합니다. 주요 내용 변경 후에는 전체 비디오를 다시 시청합니다.
  • 실제 비디오를 재생하거나 분석할 수 없는 경우, 수행한 검사, 수행하지 않은 검사 및 그 이유를 나열하고, 전체 검토를 완료했다고 주장하지 않습니다. 정확성, 가독성 또는 동기화 문제가 아직 해결되지 않은 경우, 수정 대기 상태로 표시하고, 합격했다고 선언하지 않습니다.
  • 실제 생성된 파일 경로, 다루는 원문 범위, 채택한 가정 및 미완료 항목을 전달합니다. 파일이 존재하고 검사된 경우에만 비디오 완료를 선언합니다.

자료 및 출처

논문 제목, 저자, 연도 및 검증 가능한 DOI 또는 출처 링크를 인용합니다. 공개 예시는 재배포가 허용된 자료만 사용합니다. 사용자가 제공한 비공개 문헌이나 생성된 비디오를 자동으로 저장소나 다른 플랫폼에 업로드해서는 안 됩니다.

관련 스킬