Communitygithub.com

글 작성 (boring-video-studio)

승인된 콘텐츠 주제, 연구 자료, 증거를 기반으로 플랫폼 독립적인 완전한 문서(article)를 생성합니다. 블로그 포스트와 영상 계획의 마스터 원고 역할을 합니다.

글 작성 (boring-video-studio)란 무엇인가요?

이 스킬은 승인된 콘텐츠 주제(TOPIC.md)를 기반으로 플랫폼 독립적인 완전한 문서(ARTICLE.md)를 작성합니다. 주요 기능은 사용자 승인을 받은 주제의 논증과 증거를 그대로 유지하면서, 가독성 높은 산문으로 변환하고 출처를 명확히 인용하는 '글 초안 작성'입니다. Claude Code, Cursor 등 일반적인 AI 에이전트 플랫폼에서 사용할 수 있으며, SKILL.md에 정의된 워크플로우를 따라 자동으로 작동합니다. 먼저 주제와 연구 자료, 증거를 검토하고, 사전 조건(주제 승인 상태)을 확인합니다. 그 후 지정된 스타일 가이드(voice)에 따라 글의 어조를 결정하고 초안을 작성한 후, 사용자에게 검토 및 승인을 요청합니다. 승인 조건이 충족되면 최종적으로 문서를 '승인(approved)' 상태로 변경하고, 이후 영상 계획(BEATS.md) 생성을 위한 준비를 마칩니다. 승인되지 않은 문서는 이후 생산 단계로 넘어가지 않으며, 주제가 변경되면 문서도 자동으로 초안 상태로 되돌아갑니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sugarforever/boring-video-studio/tree/HEAD/skills/boring-video/to-article

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

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

문서

문서로 변환하기

승인된 content/TOPIC.md를 content/ARTICLE.md로 변환합니다. 최종 블로그 게시물과 영상 계획의 기반이 되는 읽기 가능한 콘텐츠 마스터입니다.

사전 조건

content/TOPIC.md, content/RESEARCH.md, 인용된 모든 실험 보고서, 그리고 선택된 증거를 검증하는 데 필요한 출처 자료를 읽습니다. TOPIC.md의 status가 approved인 경우에만 계속 진행합니다.

작성 중에 누락된 자료 주장, 모순되는 증거, 뒷받침되지 않는 결론, 또는 승인된 대상, 테제, 범위, 논증, 증거, 결론 경계에 대한 변경이 필요함이 드러나면 /develop-topic으로 돌아갑니다. 즉시 TOPIC.md를 status: draft로 되돌리고, 그곳에서 격차를 해결한 후, 초안 작성을 재개하기 전에 주제 승인을 다시 받습니다. 신뢰도, 경계, 해석을 변경하는 증거를 추가하는 것은 본질적인 변경입니다. 계약 내용을 변경하지 않고 동등한 출처를 추가하는 것은 그렇지 않습니다.

어조

승인된 주제에서 글의 어조를 결정합니다. 초안을 작성하기 전에, 사용 가능한 스킬 중 출력 언어와 콘텐츠 유형과 일치하는 글쓰기 스타일 스킬이 있는지 확인한 다음, voice.skills 또는 voice.documents에 명명된 적용 가능한 모든 사용자, 프로젝트 또는 브랜드 스타일 출처를 로드합니다.

게시 수준의 글에 대한 신뢰할 수 있는 출처가 없는 경우, 원하는 어조나 샘플에 대해 간결한 질문을 한 번 합니다. 사용자가 그 선택을 위임하거나, 문서가 명시적으로 내부 초안인 경우, 명확한 설명 기본값을 사용하고 voice.status: assumed를 기록합니다. 명명된 출처 중 사용할 수 없는 것은 voice.unavailable 아래에 기록합니다. 사용할 수 없는 출처가 해당 규칙이 적용되었다는 증거는 아닙니다. 다른 사용 가능한 출처가 어조를 결정할 때 사용할 수 없는 출처가 초안 작성을 차단하지는 않습니다.

초안 작성

완전하고 플랫폼 독립적인 문서를 작성합니다. 독자가 단독으로 읽을 수 있어야 하며, 승인된 논증과 경계를 유지하고, 사실과 해석을 구분하며, 핵심 주장 뒤에는 원본 출처를 인용해야 합니다. 읽기 쉽도록 제목, 링크, 표, 메모를 사용할 수 있습니다. 사이트별 SEO 필드, 게시 구성 요소, 플랫폼 경로는 이후 게시물 변환 과정에 속합니다.

다음 프론트매터와 함께 content/ARTICLE.md를 작성합니다.

---
source: content/TOPIC.md
source_digest: sha256:<TOPIC 승인된_digest>
status: draft
voice:
  language: ...
  skills: []
  documents: []
  unavailable: []
  status: resolved | assumed
---

문서는 작업 제목, 산문, 예제, 섹션 순서를 개선할 수 있습니다. 승인된 주장을 압축하거나 설명할 수 있지만, 모든 핵심 사실, 관점, 결론은 승인된 주제와 그 증거로 추적 가능해야 합니다. 새로운 콘텐츠는 먼저 상위로 올라갑니다.

승인 게이트

완성된 문서를 검토용으로 제시합니다. 명시적인 사용자 승인만이 프론트매터를 다음과 같이 변경합니다.

status: approved
approved_at: YYYY-MM-DD
approved_digest: sha256:<digest>

approved_digest는 approved_digest: 줄만 제거한 전체 파일의 SHA-256으로 계산합니다. 초안을 작성하거나 승인하기 전에 주제 다이제스트를 다시 계산하고, 이것이 TOPIC.md의 approved_digest 및 이 문서의 source_digest와 모두 일치하는지 확인해야 합니다. 불일치는 관련 승인 또는 의존적인 초안이 오래되었음을 의미합니다. 검증된 비본질적 편집은 새로운 승인 없이 다이제스트를 새로고침하고 전파할 수 있습니다.

그때까지는 BEATS.md를 생성하지 마십시오. 생산 계속 요청이 문서 자체의 승인을 대체하지는 않습니다.

TOPIC.md에 대한 본질적인 수정은 문서를 draft로 되돌립니다. 승인된 문서에 대한 본질적인 수정도 문서를 draft로 되돌립니다. 승인된 의미를 유지하는 copy 편집, 제목 변경, 예제는 그렇지 않습니다.

content/ARTICLE.md 또는 이후의 어떤 수정본을 제시하기 전에, ../boring-video/references/markdown-review.md를 따르십시오. 정식 Markdown 경로를 현재 버전으로 유지하고 검토 피드백을 거기에 적용합니다.

문서는 승인되었을 때, 독립적으로 읽힐 수 있을 때, 모든 핵심 문장이 승인된 콘텐츠 계약과 충분한 증거로 추적 가능할 때, 영상 기획자가 사실, 관점, 논증, 범위를 새로 만들지 않고 재구성할 수 있을 때, 그리고 Markdown 검토 완료 기준이 충족되었을 때 완료됩니다.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

관련 스킬