コピーを書く(フック・台本・キャプション)
クリエイティブのボトルネックはメディアを生成することではなく、何を言うかを知ることです。このスキルは 実証済みのダイレクトレスポンスフレームワークを使ってフック、台本、キャプションを生成し、ユーザーが 選んで洗練できるようにします。ワークフローコマンドで動作します — スクリプトを書かずにCLIを呼び出してください:
node workflows/cli.cjs generateHooks '<json-args>' # 同様に: generateScript, generateCaption
以下に示すTypeScript呼び出しシグネチャは各コマンドの引数を文書化しています —
それを node workflows/cli.cjs <command> '<json-args>' に変換し、新しいファイルに貼り付けないでください。
プロジェクトのコンテキスト(project.md のオーディエンス/ペインポイント/オファー;
brand.md のトーン/制約)が存在する場合は最初に取得し、コピーがブランドに沿い、restrictions に違反しないようにします。
ステップ 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に記録します。
ステップ 1: フック(全体を書く前に角度を選ぶ)
さまざまな角度にわたるフックのバリエーションを生成し、ユーザーに1〜2を選んでもらい構築します。
node workflows/cli.cjs generateHooks '{"topic":"AI学習計画アプリ","audience":"期末試験を準備する大学生","painPoint":"どこから復習を始めればよいかわからない","platform":"tiktok","count":8}'
# h.data.hooks: [{ text, angle }] — 角度: problem | curiosity | result | contrarian | question | stat | story
角度ごとにグループ化して表示し、どれを使うか尋ねてください。 自動選択しないでください — フックが作品全体を決定します。
ステップ 2: 台本(フレームワーク駆動、尺に合わせて調整)
フックが選ばれたら、目的に合ったフレームワークで台本を書きます:
| フレームワーク | 最適な用途 |
|---|---|
hook-retain-reward | 短尺動画(TikTok/Reels/Shorts)— デフォルト |
PAS(Problem-Agitate-Solution) | ペイン主導の広告 |
AIDA(Attention-Interest-Desire-Action) | クラシックなダイレクトレスポンス |
BAB(Before-After-Bridge) | 変革 / 結果 |
star-story-solution | お客様の声 / 創業者ストーリー |
# フック: generateHooks から選ばれたフックテキストを渡す
node workflows/cli.cjs generateScript '{"brief":"60秒で復習スケジュールを作成するAI学習計画アプリ","framework":"PAS","platform":"tiktok","durationSeconds":30,"hook":"<選ばれたフックテキスト>","cta":"無料で試す — リンクはbio"}'
# s.data: { framework, sections:[{label, voiceover, visual}], wordCount, estimatedDurationSeconds }
台本をラベル付きセクション(ナレーション + ビジュアルキュー)と推定尺で表示します。
estimatedDurationSeconds が目標から大きく外れている場合はフラグを立て、ユーザーがトリミング/拡張できるようにします。
この voiceover テキストは generateVoiceover() に直接渡され、シーンごとの visual
キューは generateStoryboard() / 動画スキルに渡されます。
ステップ 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 → 選択 → generateScript → { voiceover → generateVoiceover,
visual cues → generateStoryboard → 動画 }
→ generateCaption → caption.md
常に提案して確認 — オプションを提示し、理由を添えて1つを推奨し、ユーザーが編集できるようにします。
統計/お客様の声を捏造しないでください(project.md からの実際のもののみを取得します)。