to-narration について
to-narrationは、承認済みの記事構成を話し言葉のナレーションに書き換えるライティングスキルです。各ビートの主張とつなぎを保ちながら、ソースのダイジェスト、長さ、段落アンカーを確認します。
主な機能
- 01BEATS.mdをNARRATION.mdに変換
- 02記事と構成のダイジェスト確認
- 03ビートの主張とつなぎを維持
- 04読み上げ時間に合わせた調整
- 05安定した段落アンカーの付与
- 06未解決の発音・事実確認事項を記録
活用シーン
- 01承認済みの動画構成をナレーション化
- 02目標時間に合わせて原稿を修正
- 03提出前に原稿とソースの整合性を確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ sugarforever/ boring-video-studio --skill to-narrationインストール後、Claude Code で/to-narrationを入力して読み込まれたか確認します。
詳細
ナレーションへ
BEATS.md を NARRATION.md に変換します。これは、承認済みの記事と動画構成を、読み上げ用にしたものです。この工程では、耳で聞きやすい表現に変えます。著者の主張を初めて打ち立てることはありません。
手順
BEATS.md、承認済みの元資料content/ARTICLE.md、正確性の確認に必要な引用根拠、および記事に記録された解決済みの音声ソースを読みます。記事の承認ダイジェストとビートの成果物ダイジェストを再計算し、記事のapproved_digest、ビートのsource_digest、およびビートのartifact_digestに保存された値と一致することを確認します。利用可能な、適用対象となるライティングスタイルのスキルやドキュメントをすべて読み込みます。各ビートの役割、主張、引き継ぎを維持します。- 自然で読み上げやすい言葉でナレーションを書きます。具体的な主語、動作、変化を使って出来事を明確にし、聞き手が進行に沿って話を追い、理解できるようにします。文章を読み上げ用に調整しながら、著者の声を保ちます。
- 目に見える構成、比較、変化は映像に委ねます。ナレーションでは、映像だけでは伝えられない意味を補います。
- 映像の指示を追加せず、段落とビートの境界を示します。未解決の発音や事実確認の質問は
Open checksセクションに記載します。 NARRATION.mdを作成します。
---
source: BEATS.md
source_digest: sha256:<BEATS artifact_digest>
content_source: content/ARTICLE.md
content_digest: sha256:<ARTICLE approved_digest>
artifact_digest: sha256:<digest>
status: draft
target_duration: ...
---
## B01 — Title
<a id="b01-p01"></a>
Spoken paragraph.
artifact_digest は、artifact_digest: の行だけを削除したナレーションファイル全体の SHA-256 として計算します。後続の工程では、使用前に必ず再計算してください。
- 各段落に、安定した
<beat-id>-pNNアンカーを付けます。段落を書き直す場合はアンカーを維持し、新しい段落を挿入する場合は新しいアンカーを割り当てます。 - 声に出して読むか、ユーザーが設定した読み上げ速度を使って所要時間を見積もります。すべてのビートが予算内に収まり、原稿全体が目標に収まるまで修正します。
重要な事実、見解、結論はすべて、ビートを経由して承認済みの記事にたどれる必要があります。読み上げに、記事で裏付けられていない内容が必要になった場合は、すぐに content/ARTICLE.md の status: draft に戻し、そこで修正します。ロック済みのトピック決定に影響する変更の場合は、content/TOPIC.md も draft に戻します。上流ファイルで定められた承認を更新し、内容をナレーションに使う前に、それに合わせて BEATS.md を更新します。このワークフローでは、BEATS.md に個別の承認状態はありません。
NARRATION.md またはその後の改訂版を提示する前に、../boring-video/references/markdown-review.md に従ってください。HyperFrames の後続のボイスレビューループを開始または置き換えることなく、確認用に正式な Markdown を提示します。
ビジュアルのプランニングに進める状態であり、重要な文がすべてビートと承認済みの記事の両方にたどれ、後の映像を先取りして指定しておらず、Markdown レビューの完了基準を満たしていれば、草稿は完成です。/to-scenes の開始後は、共有 HyperFrames プロジェクトがレビューのタイミングと、音声収録用ナレーションのバージョンを管理します。