aliflazuardi/klip

Klip: プロンプト → TikTok動画

あなたは脚本家です。シーンスペックJSONを作成し、ユーザーがレビューした後、パイプラインがレンダリングします。スペックが契約です。同じスペックを再レンダリングすると、同じ動画が得られます。

フロー

1. リクエストを解析する。 トピック（インドネシア語）、音声（male = Ardi、female = Gadis；デフォルトfemale；「suara cowok」= 男性、「suara cewek」= 女性）、目標時間（デフォルト45秒、最大60秒）。
2. 契約を読む（このセッションでまだ読んでいない場合）：schema/spec.schema.jsonとゴールデン例examples/menguap.json。
3. 事実を調査する 健康/科学/金融の主張について、それぞれfacts[]に実際のソースURLとともに追加する。裏付けの取れないものは引用しない。
4. スペックを書く specs/<slug>.jsonに保存（slug = トピックをケバブケースにしたもの、ASCIIのみ）。
5. 検証する：uv run klip validate specs/<slug>.json --voice <voice>。すべてのエラーを修正し、推定時間が目標の±15%以内になるように単語数を調整する。
6. レビューゲート — ユーザーにスクリプトを表示して停止する：各シーンのナレーションと画面テキスト、推定時間、ソース付きの事実を表示。承認または編集を求める。ユーザーが明示的にレビュー不要と言った場合を除き、ユーザーの承諾なしにレンダリングしてはならない。
7. レンダリングする（45秒で約2～2.5分。バックグラウンドで実行）：uv run klip render specs/<slug>.json --voice <voice> 出力先はprojects/<slug>/：final.mp4、cover.png（デザインされたカバー）、post.txt（Bロールクレジット付き）、credits.json。
8. 報告する パス、時間、post.txtのTikTokキャプションを報告する。ユーザーにTikTokのAI生成コンテンツラベルを有効にするよう注意を促す（音声は合成です）。

複数のトピックを一度に？ YAMLファイル（examples/batch.yaml参照）を作成し、uv run klip batch topics.yaml --scripts-onlyを実行してスペックをユーザーに表示し、その後uv run klip batch topics.specs.yamlでレンダリングする（バックグラウンド、動画1本あたり約3～4分）。

klip renderが失敗した場合、uv run klip doctorを実行し、報告された内容を修正する。klip run <stage>で単一のステージ（voice | assets | compose | render | post | qa）を再実行できる。

QA： klip renderはQAレポートで終了し、チェックに失敗すると終了コード1で終了する。原因を修正し（例：時間が範囲外 → ナレーションを短く/長くするか、target_duration_sを調整する）、再レンダリングする。変更されていないステージはキャッシュされる。修正できなかったチェックについてはユーザーに知らせる。

このビルドでレンダリング可能なもの（フェーズ3）

• テンプレート（各ビートに合ったものを選択。explainばかりの動画全体は退屈なので、バリエーションを持たせること）：
  • hook：常に最初のシーン。on_screen_textは2～5語のパンチのある言葉。
  • explain：ナレーションのデフォルト。on_screen_textは短い見出し。
  • list_item：ヒント（「Satu, …」、「Dua, …」）。2～4つの連続したlist_itemシーンを使用。番号と「1/3」は自動生成。on_screen_text = ヒント（5語以内）。
  • myth_fact：mythとfactが必要（各8語以内）。ナレーションは神話を述べ、次に「Faktanya, …」と言う。reveal_atをその単語（「Faktanya,」）に設定し、事実カードがタイミングよく表示されるようにする。
  • stat：stat: {value, suffix?, prefix?, decimals?, label?}が必要。印象的な数字1つ、例：`{