Communitygithub.com

주제 개발

후보 주제에서 연구, 실험, 논증 및 사용자 승인을 거쳐 승인된 콘텐츠 계약을 체결합니다. 아티클이나 비디오 대본을 작성하기 전에 사용합니다.

주제 개발란 무엇인가요?

이 스킬은 콘텐츠 제작 워크플로우의 초기 단계를 다루며, 단순한 후보 주제를 승인된 콘텐츠 계약으로 전환합니다. 주요 목표는 아티클이나 비디오 대본 작성을 시작하기 전에 논증, 증거 및 범위가 명확히 정의되도록 하는 것입니다. 연구와 증거 수집을 편집 작업과 분리하여 `content/RESEARCH.md`에 사실, 해석, 의견 차이 및 미지의 영역을 기록하고, 필요시 실험을 통해 검증 가능한 증거를 확보합니다. 최종 산출물은 `content/TOPIC.md`로, 청중, 핵심 질문, 논제, 범위 및 상세한 논증 구조를 포함하는 콘텐츠 계약입니다. 사용자가 명시적으로 승인해야만 상태가 'draft'에서 'approved'로 변경되며, 해시 다이제스트를 통해 승인 무결성을 관리합니다. 이 스킬은 Claude Code, Cursor, Codex 등 AI 에이전트와 함께 사용하여 체계적인 콘텐츠 개발 프로세스를 지원합니다.

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

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

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

문서

주제 개발은(는) 무엇을 하나요?

후보 주제를 승인된 콘텐츠 계약으로 전환합니다. 논증, 증거, 경계가 하위 단계에서 더 이상 발명될 필요가 없을 때에만 작성 작업을 시작할 수 있습니다.

범위

하나의 후보 주제 또는 자연스럽게 경계가 정해진 작은 집합에서 시작합니다. 여러 방향이 가능할 경우, 청중 가치, 참신성, 검증 가능성, 입증 가능성, 저자 적합성, 과장 위험 등을 가볍게 비교하여 사용자에게 선택을 요청한 후 심층 연구를 진행합니다. 개방형 트렌드 스캔이나 아이디어 백로그 유지 관리는 이 스킬의 범위를 벗어납니다.

증거 작업 공간

비디오 프로젝트에 content/ 디렉토리를 생성합니다:

content/
|-- RESEARCH.md
|-- TOPIC.md
`-- experiments/

RESEARCH.md에는 출처가 있는 사실, 해석, 의견 차이, 미지의 영역, 기각된 방향, 원자료 링크를 기록합니다. 수집과 편집 선택을 분리하여 유지합니다.

주장이 다음에 영향을 미칠 때 해당 주장을 중요하게 취급합니다: 주제가 작동하는지, 청중에게 중요한지, 대안과 다른지, 입증 가능한지, 명시된 범위 내에서 유효한지. 해당 주장에 충분히 강력한 출처나 실험으로 뒷받침하고, 약한 증거는 조용히 확대 해석하지 말고 provisional이라고 표시합니다.

주장을 실행 가능한 증거로 뒷받침해야 하는 경우, 해당 주장을 해결할 수 있는 가장 작은 실험을 수행하고 content/experiments/<name>.md에 질문, 방법, 샘플, 환경, 명령어, 결과, 한계 및 결과가 지지하는 결론을 기록합니다. 코드와 원시 데이터는 해당 프로젝트에 두고, 비디오 프로젝트에 복사하지 않고 경로와 Git 리비전을 기록합니다.

콘텐츠 계약

content/TOPIC.md를 작성합니다:

---
status: draft
audience: ...
core_question: ...
thesis: ...
scope: ...
voice:
  language: ...
  skills: []
  documents: []
  unavailable: []
  status: resolved | assumed
---

# 작업 제목

## 독자 약속

## 논증

### A01 - 주장
- role: 이 주장이 논증에 존재하는 이유
- claim: 정확한 명제
- evidence: RESEARCH.md의 헤더나 실험 보고서 링크
- confidence: established | provisional
- boundary: 증거가 입증하지 않는 것

## 범위 외

## 미해결 질문

## 대체 제목

음성 소스는 다음 순서로 결정합니다: 명시적 사용자 지시, 프로젝트 또는 브랜드 가이드, 언어와 콘텐츠 유형에 맞는 사용 가능한 문서 스타일 스킬, 보이는 사용자 선호도, 작성 샘플, 명확한 설명 기본값. 실제로 사용된 소스를 기록하고 요청되었으나 사용할 수 없는 소스는 voice.unavailable 아래에 유지합니다; 사용할 수 없는 메모리나 숨겨진 프로필을 가정하지 마십시오.

승인 게이트

작업 제목, 논제, 범위, 논증, 주요 증거, 경계 및 중요한 미해결 질문을 검토용으로 제시합니다. 제목은 계속 변경될 수 있지만, 청중, 논제, 범위, 논증, 증거 및 결론 경계는 고정된 결정입니다.

명시적 사용자 승인만이 프론트매터를 다음과 같이 변경합니다:

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

다이제스트는 approved_digest: 줄만 제거한 완전한 파일의 SHA-256입니다. 승인을 신뢰하기 전에 다시 계산하십시오. 불일치는 승인을 무효화하고 파일을 draft로 되돌립니다. 비본질적인 제목이나 복사 편집 후에는 재승인 없이 다이제스트를 새로 고칠 수 있습니다; 새 다이제스트를 모든 종속 아티팩트에 전파합니다.

그때까지 모든 작성은 RESEARCH.md, 실험 보고서, 초안 TOPIC.md 내에서 유지합니다. ARTICLE.md 또는 BEATS.md를 생성하지 마십시오; 빠른 진행 요청이나 논제 선택 권한은 결과 계약 승인을 대체하지 않습니다.

나중에 고정된 결정에 대한 본질적인 변경은 TOPIC.md를 draft로 되돌리고 하위 아티클 승인을 무효화합니다. 의미를 보존하는 복사 편집, 예시, 제목 변경은 승인을 취소하지 않습니다.

content/TOPIC.md 또는 이후 개정판을 제시하기 전에 ../boring-video/references/markdown-review.md를 따르십시오. 정식 Markdown 경로를 현재 버전으로 유지하고 검토 피드백을 해당 경로에 적용합니다.

TOPIC.md가 승인되고, 모든 중요 주장이 충분한 증거를 가리키며, 남은 미해결 질문이 차단되지 않고 보이며, 아티클 작성자가 사실, 실험, 저자 입장, 논증 또는 범위를 발명하지 않고 초안을 작성할 수 있고, Markdown 검토 완료 기준이 충족되면 주제가 완료됩니다.

Individual skills in this repo

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

관련 스킬