카피 작성 (후크 · 스크립트 · 캡션)은(는) 무엇을 하나요?
창작의 병목은 미디어를 생성하는 것이 아니라 무엇을 말할지 아는 데 있습니다. 이 스킬은 검증된 다이렉트 리스폰스 프레임워크를 사용하여 후크, 스크립트, 캡션을 생성하고 사용자가 선택하고 다듬을 수 있도록 합니다. 워크플로 명령어로 구동됩니다 — 스크립트를 작성하지 말고 CLI를 호출하세요:
node workflows/cli.cjs generateHooks '<json-args>' # generateScript, generateCaption도 동일
아래에 표시된 TypeScript 호출 시그니처는 각 명령어의 인수를 문서화합니다 — 이를 node workflows/cli.cjs <command> '<json-args>'로 변환하고 새 파일에 붙여넣지 마세요.
프로젝트 컨텍스트가 있을 때 먼저 가져와서(project.md의 대상 고객/페인 포인트/제안; brand.md의 톤/제한 사항) 카피가 브랜드에 맞고 restrictions를 위반하지 않도록 하세요.
STEP 0: 카피를 작성하기 전에 참조 예시를 확인하세요
목소리 일관성은 형용사가 아닌 예시에서 비롯됩니다. 후크, 스크립트 또는 캡션을 생성하기 전에:
- 레지스트리에서 저장된 카피 예시를 확인하세요:
찾은 경우 → 패턴(문장 길이, 이모지 사용, 해시태그 스타일, CTA 표현, 격식 수준)을 추출하여 아래에서 작성하는 모든 항목에 반영하세요.node workflows/cli.cjs resolveAsset '["{name}","style-copy"]' # 카피 예시를 보관하는 style_references ID cat projects/{name}/assets/style/copy-examples.md 2>/dev/null cat projects/{name}/style-samples/caption-examples/*.md 2>/dev/null # 사용자의 드롭 인박스 - 저장된 것이 없으면 → 한 번만 물어보세요:
"과거에 잘 반응했던 게시물, 캡션 또는 스크립트가 있나요? 아니면 카피 스타일이 마음에 드는 계정이 있나요? 1-3개의 예시를 붙여넣어 주세요(또는 '없음' — brand.md를 참고하겠습니다)."
- 예시를 제공하면 →
projects/{name}/assets/style/copy-examples.md에 저장하고 등록하세요(registerAsset '["{name}","style_references",...]'). 향후 작업이 이를 재사용합니다. - "없음" →
brand.md의 톤을 따라 진행하고 어떤 톤 가정을 했는지 명시하세요.
- 예시를 제공하면 →
- 예시가 있는 경우, 카피가 어떤 참조와 일치하는지
prompts.txt에 기록하세요.
STEP 1: 후크 (전체를 작성하기 전에 앵글을 선택하세요)
다양한 앵글의 후크 스프레드를 생성하고 사용자가 1-2개를 선택하여 구축할 수 있도록 하세요.
node workflows/cli.cjs generateHooks '{"topic":"AI 학습 플래너 앱","audience":"기말고사를 준비하는 대학생","painPoint":"복습을 어디서 시작할지 모름","platform":"tiktok","count":8}'
# h.data.hooks: [{ text, angle }] — angles: problem | curiosity | result | contrarian | question | stat | story
앵글별로 그룹화하여 보여주고 어떤 것을 사용할지 물어보세요. 자동 선택하지 마세요 — 후크가 전체 내용을 결정합니다.
STEP 2: 스크립트 (프레임워크 기반, 시간에 맞춤)
후크가 선택되면 목표에 맞는 프레임워크로 스크립트를 작성합니다:
| 프레임워크 | 가장 적합한 용도 |
|---|---|
hook-retain-reward | 숏폼 비디오 (TikTok/Reels/Shorts) — 기본값 |
PAS (Problem-Agitate-Solution) | 페인 리드 광고 |
AIDA (Attention-Interest-Desire-Action) | 클래식 다이렉트 리스폰스 |
BAB (Before-After-Bridge) | 변화 / 결과 |
star-story-solution | 사용후기 / 창업자 스토리 |
# hook: generateHooks에서 선택한 후크 텍스트 전달
node workflows/cli.cjs generateScript '{"brief":"60초 안에 복습 일정을 만드는 AI 학습 플래너","framework":"PAS","platform":"tiktok","durationSeconds":30,"hook":"<선택한 후크 텍스트>","cta":"무료로 체험하기 — 링크 인 바이오"}'
# s.data: { framework, sections:[{label, voiceover, visual}], wordCount, estimatedDurationSeconds }
스크립트를 레이블이 지정된 섹션(음성 해설 + 시각적 큐)과 예상 시간으로 보여주세요.
estimatedDurationSeconds가 목표와 크게 차이가 나면 사용자가 다듬거나 확장할 수 있도록 알리세요.
이 voiceover 텍스트는 generateVoiceover()에 직접 전달되고, 장면별 visual 큐는 generateStoryboard() / 비디오 스킬에 전달됩니다.
STEP 3: 캡션 (게시 준비 완료, 플랫폼별)
마지막 단계 — 비디오/이미지와 함께 실제로 게시되는 포스트 카피 + 해시태그입니다.
node workflows/cli.cjs generateCaption '{"topic":"AI 학습 플래너 앱","platform":"instagram","tone":"친근하고 자신감 있는","cta":"링크 인 바이오","count":3}' # platform: tiktok | instagram | youtube | facebook
# c.data.captions: [{ text, hashtags:[] }]
콘텐츠가 여러 플랫폼에 교차 게시되는 경우 플랫폼별 변형을 생성하세요(각 플랫폼마다 길이 및 해시태그 규범이 다릅니다). 선택한 캡션을 출력물 옆에 저장하세요(예: projects/{name}/output-contents/.../caption.md).
연결 방식
generateHooks → pick → generateScript → { voiceover → generateVoiceover,
visual cues → generateStoryboard → video }
→ generateCaption → caption.md
항상 제안하고 확인하세요 — 옵션을 제시하고, 이유와 함께 하나를 추천하며, 사용자가 편집할 수 있도록 하세요. 통계/사용후기를 만들어내지 마세요(실제 것만 project.md에서 가져오세요).