Communitygithub.com

100x-プロンプト構成

UGC広告生成テンプレートに商品・ペルソナ・シーンの変数を埋め込み、最終的なプロンプトを組み立てます。

100x-プロンプト構成 とは?

このスキルは、指定されたテンプレートID(または自然言語によるテンプレート要件)と変数から、Veo、Seedance、即創などのターゲットモデル向けに最適化された最終プロンプトを生成します。100xシステムにおける「プロンプト+モデル」の中間工程を担い、上流の商品・ペルソナ・シーン検索スキルと、下流のAI生成モデルを橋渡しします。入力は14種類のテンプレートから選択し、必須変数(テンプレート内で'(オプション)'と明示されていないもの)はすべて提供する必要があります。出力は、レンダリングされたプロンプト本文、使用した変数リスト、モデル選択(動画の場合)、参照ロック情報などを含む構造化バンドルです。4つの公理に従い、テンプレートの逐語的置換、参照ロックの整合性、シーン変数への光表現の禁止、動画モデルごとの長さ・禁止語句の遵守を強制します。ユーザーが不足情報を補うための段階的なワークフローと、自己検証スクリプトも備えています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kezd088/100x-skill-tiktok/tree/main/skills/100x-prompt-compose

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

100x-プロンプト構成 は何をしますか?

一言での位置づけ

プロンプトテンプレートID(または要件説明)と変数を入力として、ターゲットモデル(Veo / Seedance / 即創)向けに最終生成プロンプトを逐語レンダリングし、適切な形式にラップして出力します。100xシステムの「プロンプト+モデル」工程に該当し、上流の人物・シーン・検索キーワード系スキルと下流のAI生成モデルを連携します。

いつトリガーされるか

ユーザーが次のように言った場合:

  • 「プロンプトを組み立てて」/「テンプレートに変数を入れてプロンプトを出して」/「この動画にはどのモデルを使う?」/「動画プロンプトを生成して」/「テンプレートと変数を選んで」
  • 「compose a video prompt」/「fill in this template」/「which model should I use for this」/「generate an AI video prompt」
  • または、製品/ペルソナ/シーンの説明を直接渡し、画像/動画生成モデルにそのまま入力できるプロンプトを要求する場合

入力

最小入力(カテゴリA、必須): template_id(14テンプレートのいずれか。templates.json参照)または、テンプレートを一意に特定できる要件説明(カテゴリ+use_whenシナリオ。workflow.md Phase 1 ステップ1参照)。そのテンプレートのvariables[]内でlabelに'(オプション)'が含まれない変数はすべて指定する必要があります(推測や外見/台詞内容の創作は禁止)。

補完入力(カテゴリB、欠けている場合はダウングレード。workflow.md Phase 1 ステップ2/4参照): labelに'(オプション)'が含まれる変数;動画テンプレートのmodel選択(欠けている場合は1回だけ尋ね、回答がなければデフォルトでmodel_hint[0])。

上流からの任意の出力(カテゴリC、欠けていても静かにスキップ。ブロックせず、ユーザーに他のスキルを先に実行するよう要求もしない): existing_refs_input(以前の呼び出しで確立された商品/人物ロック番号。公理2参照)。

出力

構造はschema.json参照: ComposedPromptBundle = template_id/category + variables_used + rendered_body(逐語補間された中国語本文。realism_suffix含む) + reference_locks(商品/人物ロックの確立または参照記録) + (動画テンプレートの場合)model + video_unit(モデルに応じてラップされた最終プロンプト+長さ) + meta。オプションで人間が読める要約(テンプレート名/変数一覧/最終プロンプト)を追加でレンダリング可能。

中核制約(4つの公理。詳細はaxioms.md参照)

  1. 最終プロンプトはテンプレート本文を逐語置換しなければならない。意訳や削除は禁止。rendered_bodyはtemplates.jsonの対応テンプレート本文を逐語補間した結果(角括弧のプレースホルダ展開を含む)でなければならず、「意味が通じればよい」という自由な書き換えは認められない。
  2. 参照画像番号の引用は、既に宣言されたロックを指さなければならない。架空の参照は禁止。商品/人物が初めてロックされる際は外見を記述し、以降は「参照図N商品/人物」と書き、Nは確立された番号集合内に実在しなければならない(既知の限界: ここで検証できるのは「形式が正しいか」と「番号が実在するか」のみ。「最初のロック記述自体が本当に具体的か(商品外観の全要素が揃っているか/人物の年齢+人種+性別+服装+外見の五要素が揃っているか)」は検証できない。persona: "a person"やproduct_lock: "a thing"のような空疎なプレースホルダテキストは現在の検証を通過する。なぜならschema.json/scripts/validate.jsは文字列が空でないこと、形式、番号の存在のみをチェックし、意味内容は判断しないからである。最短長などのヒューリスティックで塞ぐ評価は行ったが、テンプレート自身の正当な短い例を誤って殺すため実装しなかった。これをaxioms.md公理2「既知の境界」セクションに正直に記録し、呼び出し元がworkflow.md Phase 1 ステップ2「欠けている場合は問い詰め、脳内補完しない」という規律に完全に依存する)
  3. シーン変数への光表現の記載は禁止。光は接尾辞で一元的に制御する。scene/scenes/place/rooms系の変数が閉集合の光表現リストにヒットした場合は拒否する。天気表現は許可される。
  4. 動画は選択されたモデルの最大長と禁止語句リストに従う。ゼロトレランス。veo 8.0秒 / seedance 10.0秒 + 各禁止語句リスト + 末尾固定フレーズ。即創には専用のソース資料がないため、ナラティブ/カメラショットの分類のみ検証し、長さ/禁止語句のハード検証は行わない(既知の限界: 現在、即創モデル専用の公理資料は含まれていない。詳細はsources.md参照)。既知の限界(実データで確認済み。机上の仮定ではない):veo/seedanceの禁止語句リストは純粋な単語境界マッチングであり、「AIの決まり文句として使われるprofessional」(例:"professional lighting"、禁止語句リストが本来対象とするもの)と、「話者の実際の職業を忠実に説明するprofessional」を区別できない。実際の職業を忠実に説明してもFAILと判定されるため、衝突しない同義語に書き換えるしかない。詳細はaxioms.md公理4「既知の境界」セクション参照

3フェーズのワークフロー

詳細はworkflow.md参照: Phase 1 受付+検証(テンプレート選択→変数の確認→シーンに光表現がないことの確認→[動画]モデル選択→参照番号コンテキスト)→ Phase 2(逐語レンダリング→角括弧展開→参照ロック記帳→[動画]モデルラッピング→項目ごとの自己チェック)→ Phase 3 ユーザー起動による再作業(L1 単一変数 / L2 モデル変更 / L3 全体。「非英語の台詞」分岐はなし。テンプレートライブラリのハードルールとして、台詞は米国TikTok向けにアメリカ英語で記述する。例外なし。workflow.md Phase 3 テーブル最終行参照)。

独立呼び出しの保証

カテゴリAが欠けている場合(テンプレートが選択できず、かつ必須変数が不足)→ 固定の断り文言で問い詰める。推測や具体的な外見/台詞内容の創作は行わない。カテゴリBが欠けている場合はダウングレード(オプション変数はテンプレート自身のセマンティクスに従って処理。modelが欠けている場合は1回尋ねた後、デフォルト値を使用)。カテゴリC(existing_refs_input)が欠けている場合は静かにスキップ。本スキルは、ユーザーに「最初にIMG-01を実行して商品ロックを確立してから」と要求しない。初回登場時は、参照画像の代わりにテキスト記述を直接許可する。

禁止語句

「讓」 / 「希望」 / 「或許」 / 「大概」 / 「可能」 / 「也許」 / 「讓我們」;AIカスタマーサポート的な表現(as an AI / I'd be happy to / feel free to);スクリプト/コピーにない効能認証やユーザー証言の創作;ユーザーが提供していない商品外観/人物詳細を変数を埋めるために創作すること;veo/seedance動画ラッピングの禁止語句についてはprofiles/veo.md/profiles/seedance.mdを参照(cinematic / stunning / flawlessなどのAI決まり文句+二重引用符+マークダウン fences。具体的なリストは該当ファイルにあり、スクリプト定数表と乖離しないようここでは重複記載しない)。

ルーティング(推奨。強制ではない)

  • まだ商品/ペルソナ/シーンの素材がなく、コピーのみある場合 → 人物/シーン系スキル(既に構築されている場合)
  • 最初にビジュアル参照画像を探してからテンプレートを決めたい場合 → 検索キーワード系スキル(既に構築されている場合)
  • プロンプトは既に完成していて、一括で複数のバリエーションを作りたい場合 → プロンプト分裂系スキル(既に構築されている場合)
  • エントリーポイントに戻って再振り分けしたい場合 → 100x体系の総合エントリーポイント(既に構築されている場合)

上記はすべて「出力後、必要に応じて推奨」するものであり、前提依存ではない。対応するスキルがまだ構築されていなくても、本スキルは独立して動作する。

出荷前自己テスト

node scripts/validate.js --selftest を実行して検証する。公理1(テンプレート再構築)、公理2(参照ロック整合性)、公理4(モデル固有の長さ/禁止語句/末尾フレーズ)は、ファイル横断・項目横断・大語彙リストの判定基準であり、schema.json(バニラJSON Schema)では表現できない。実際の判定ロジックはscripts/validate.jsで実行される:

npm install                                                    # 初回使用時にajvをインストール
node scripts/validate.js <bundle.json> [bundle2.json ...]    # 出力を検証
node scripts/validate.js --selftest                           # 組み込み回帰テストを実行

ソース

本スキルは、プロンプトテンプレートライブラリと各主要モデル(Veo / Seedance)の適応ルールを組み合わせて構築されている。templates.jsonは14組の標準化されたプロンプトテンプレートを提供する。profiles/veo.mdとprofiles/seedance.mdはターゲットモデルのラッピング仕様を提供する。判定体系には、参照整合性、閉集合語彙検出、モデルの長さと禁止語句検証が含まれる。詳細な設計判断とソースの説明はsources.mdを参照。

Individual skills in this repo

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

関連スキル