VidPipe: GitHub Copilot CLI로 에이전틱 비디오 편집기를 만들었습니다
Source: Dev.to
이것은 GitHub Copilot CLI Challenge에 대한 제출물입니다.
내가 만든 것
VidPipe은 전체 후반 작업 흐름을 자동화하는 오픈‑소스 에이전시 비디오 편집기입니다. 비디오 파일을 넣으면 15단계 AI 파이프라인이 다음과 같이 변환합니다:
- 짧은 클립 (15–60 초) – 각각 6가지 변형(가로, 세로, 정사각형, 피드 — 모두 자막이 영상에 직접 삽입)
- 중간 길이 클립 (1–3 분) – 크로스‑페이드 전환 포함
- 노래방 스타일 자막 (단어별 하이라이트, 영상에 직접 삽입)
- AI 무음 제거 (맥락 인식, 최대 20 % 제한)
- 챕터 감지 (JSON, Markdown, YouTube 타임스탬프, FFmpeg 메타데이터)
- 플랫폼 맞춤형 소셜 포스트 – TikTok, YouTube, Instagram, LinkedIn, X용
- 블로그 포스트 – 웹에서 수집한 링크 포함
- 비용 추적 – 모든 LLM 제공업체별로 관리
파이프라인은 @github/copilot-sdk를 기반으로 만든 8개의 특화된 AI 에이전트가 조율합니다:
ShortsAgent, SummaryAgent, ProducerAgent, ChapterAgent, SocialMediaAgent, BlogAgent, MediumVideoAgent, SilenceRemovalAgent.
각 에이전트는 구조화된 툴 호출을 사용해 콘텐츠에 대한 지능적이고 상황에 맞는 결정을 내립니다.
내가 이것을 만든 이유
저는 풀타임 직장인이고, 아버지이며(쌍둥이를 곧 맞이하게 되어 곧 세 아이가 될 예정), 기술 크리에이터를 꿈꾸고 있습니다. 기술 이야기를 하는 것은 좋아하지만 편집은 정말 싫어합니다. 녹화는 재미있지만 그 이후의 모든 작업은 시간이 부족한 저에게 큰 부담이었습니다. VidPipe을 사용하면 한 번 녹화하고 모든 플랫폼에 바로 게시할 수 있습니다.
GitHub Repository | npm package | Documentation
데모
이 비디오는 VidPipe가 녹화를 처음부터 끝까지 처리하는 과정을 단계별로 보여줍니다 — 인제스트부터 쇼츠 생성, 캡션 삽입, 그리고 소셜 미디어 게시물을 승인하기 위한 틴더 스타일 검토 인터페이스까지.
파이프라인 작동 예시
Ingest → Transcribe → Silence Removal → Captions → Caption Burn
→ Shorts → Medium Clips → Chapters → Summary
→ Social Posts → Short Posts → Medium Posts
→ Blog → Queue Build → Git Push출력 구조
각 처리된 비디오는 자체적으로 정리된 폴더에 저장됩니다:
recordings/my-demo/
my-demo-captioned.mp4 # With burned‑in captions
transcript.json # Word‑level timestamps
README.md # AI‑generated summary
shorts/
catchy-title-portrait.mp4 # 9:16 for TikTok/Reels
catchy-title-square.mp4 # 1:1 for Instagram
catchy-title/posts/ # Per‑short social posts
chapters/
chapters-youtube.txt # Ready to paste into YouTube
social-posts/
tiktok.md, youtube.md, instagram.md, linkedin.md, x.md
devto.md # Full blog postReview UI
VidPipe includes a built‑in web app where you review and approve content before it gets scheduled:
GitHub Copilot CLI 사용 경험
GitHub Copilot CLI는 이 프로젝트를 작성하기 위해 사용한 도구에 그치지 않고 개발 워크플로우의 핵심 요소가 되었습니다. 그 과정은 다음과 같습니다:
1. 맞춤형 Copilot 훅 — 모든 단계에서 품질 보장
.github/hooks/에 5개의 맞춤형 Copilot 훅을 만들었으며, 개발 중 자동으로 실행됩니다:
| Hook | Purpose |
|---|---|
pre-push-block | git push를 차단합니다. npm run push 워크플로우(타입‑체크 → 테스트 → 커버리지 → 빌드 → 푸시 → CodeQL + Copilot PR 리뷰)를 강제합니다. |
post-edit-invalidate | Copilot CLI 편집 후마다 코드 리뷰를 무효화하여 푸시 전 새로운 리뷰를 요구합니다. |
pre-amend-block | 푸시된 커밋을 수정(amend)하는 것을 방지해 git 히스토리를 보호합니다. |
pre-force-push-block | git push --force 자체를 차단합니다. |
pre-import-ban | 코드베이스 전체에 걸쳐 ESM import 규칙을 강제합니다. |
이 훅들은 Copilot CLI가 엄격한 가드레일 안에서 동작하도록 하여, 지름길, 테스트 건너뛰기, 리뷰 우회를 모두 차단합니다.
2. 맞춤형 에이전트 — 특화된 AI 워커
.github/agents/에 3개의 맞춤형 Copilot 에이전트를 만들었습니다:
| Agent | Role |
|---|---|
code-reviewer | VidPipe 전용 컨벤션을 검토합니다: 프로바이더 추상화 패턴, FFmpeg resolver 사용, 비용 추적, ESM import, 테스트 커버리지 기준 등. |
security-fixer | GitHub API를 통해 CodeQL 알림을 가져오고, 해결 가이드를 읽어 각 취약점을 최소한의 수정으로 해결합니다. |
review-triage | Copilot 자체 PR 리뷰 코멘트를 ACCEPT, REJECT, DEFER 로 분류합니다. ACCEPT된 수정 사항을 모두 적용하고, GraphQL을 이용해 스레드를 해결합니다. |
3. 맞춤형 스킬 — 재사용 가능한 워크플로우
.github/skills/에 3개의 맞춤형 스킬이 존재합니다:
| Skill | Function |
|---|---|
npm-publish | Playwright를 이용해 세분화된 npm‑access‑token을 자동 생성하고, 인증 후 배포합니다. |
release | 버전 bump, changelog 생성, GitHub 릴리즈 작성, npm 배포를 한 번에 처리합니다. |
late-api | Late.co 소셜 미디어 스케줄링 API를 관리합니다: 목록 조회, 일정 변경, 대량 삭제, 포스트 동기화 등. |
4. 37 KB copilot-instructions.md
.github/copilot-instructions.md 파일은 37 KB 규모로, 전체 프로젝트 컨텍스트를 담고 있습니다—모든 파이프라인 단계, 에이전트 동작, FFmpeg 패턴, 테스트 규칙 등을 상세히 기술합니다. 이를 통해 Copilot CLI는 코드베이스를 다룰 때 VidPipe 아키텍처에 대한 깊은 이해를 갖게 됩니다.
knows that the adjusted transcript goes to captions while the original transcript goes to shorts. It knows that `execFile` (not `exec`) is required for FFmpeg. It knows the provider abstraction layer and cost tracking patterns.5. 푸시 워크플로우 — Copilot이 구동하는 CI/CD
npm run push 명령(이 명령은 Copilot 훅에 의해 강제됨)은 다음 전체 파이프라인을 실행합니다:
typecheck → tests (51 test files) → coverage check → build → git push
→ poll CodeQL alerts → poll Copilot PR review
→ auto-dispatch security‑fixer agent for CodeQL alerts
→ auto-dispatch review‑triage agent for review comments어떤 단계에서든 실패가 발생하면 Copilot CLI가 자동으로 수정하고 다시 실행합니다. 모든 게이트가 통과될 때까지 이 사이클이 반복됩니다.
How Copilot CLI Impacted My Development
숫자가 이야기를 말해줍니다:
- 131 TypeScript 파일, 약 12,000줄의 소스 코드
- 51 테스트 파일, 약 10,500줄의 테스트
@github/copilot-sdk로 만든 8 AI 에이전트- 15단계 파이프라인으로 비디오를 엔드‑투‑엔드 처리
- npm에 공개된 전역 CLI 도구
이 전체 프로젝트를 3주 만에 만들었습니다 — 부업으로, 퇴근 후, 육아를 하면서. Copilot CLI 없이는 불가능했을 겁니다. 테스트를 작성하고, 보안 경고를 수정하며, 자체 코드 리뷰를 삼분하고, 커스텀 훅과 지시문을 통해 코드베이스 일관성을 유지했습니다.
가장 강력한 점? Copilot CLI는 단순히 코드를 작성하도록 돕는 것이 아니라, 여러분의 엔지니어링 시스템의 일부가 됩니다. 훅은 표준을 강제하고, 에이전트는 리뷰를 처리하며, 스킬은 릴리스를 자동화합니다. 옆에 앉아 있는 어시스턴트가 아니라, 워크플로에 내장된 팀원입니다.
바쁜 아빠가 사랑을 담아 만든 프로젝트로, 편집보다 녹화를 선호합니다. 포스트‑프로덕션 작업에 어려움을 겪는 크리에이터라면, VidPipe를 한 번 사용해 보세요.