Higgsfield Brandkit

Higgsfield Brandkit は何をしますか？

一貫性のあるアイデンティティと、要求されたアプリケーションを構築します。提供されたブランドの事実と公式アセットは固定された制約として扱います。

ブートストラップ

1. SKILL_ROOT をこのスキルのインストールディレクトリに解決し、永続的なプロジェクトディレクトリを作成します:

   BRANDKIT_WORKDIR="${PWD}/brandkit"
   BRANDKIT_STATE="${BRANDKIT_WORKDIR}/state.json"
   mkdir -p "${BRANDKIT_WORKDIR}"
   

2. 前提条件を読んでください。その段階で必要なツールを確認します。ユーザーの許可なくシステムパッケージをインストールしないでください。

3. higgsfield が存在しない場合、許可を得た後にのみインストールします:

   curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
   

4. higgsfield account status が認証エラーまたはワークスペースエラーで失敗した場合、ユーザーに higgsfield auth login の実行またはワークスペースの選択を依頼し、待機します。

5. 有料生成の前にライブモデル契約を確認します:

   higgsfield model get recraft_v4_1 --json
   higgsfield model get seedream_v5_pro --json
   higgsfield model get gpt_image_2 --json
   

CLI マッピング

操作	コマンド
モデルの検出	higgsfield model get <model> --json
生成とポーリング	higgsfield generate create <model> ... --wait --json
ジョブの再開	higgsfield generate wait <job_id> --json
ローカルアセットのアップロード	higgsfield upload create <path> --json
Webサイトメタデータのインポート	higgsfield marketing-studio brand-kits fetch --url <url> --wait --json
承認状態の読み取り/書き込み	python3 "$SKILL_ROOT/scripts/brandkit.py" state ...
レビューボードのレンダリング	python3 "$SKILL_ROOT/scripts/brandkit.py" preview ...
選択されたロゴの検査	python3 "$SKILL_ROOT/scripts/brandkit.py" logo-inspect ...
ロゴファイルのエクスポート	python3 "$SKILL_ROOT/scripts/brandkit.py" logo-export ...
ブランドブックの構築	python3 "$SKILL_ROOT/scripts/brandkit.py" brandbook-build ...

--image で渡されたローカル画像パスは自動的にアップロードされます。HTML、SVG、PPTX、PDFの成果物は、ユーザーが明示的にホストされたコピーを必要としない限り、ローカルプロジェクトファイルとして保持します。

ユーザー向けの振る舞い

• ユーザーの言語に合わせてください。Design Brain の推論、プロンプト、状態メカニズム、スクリプト、モデル検索、QAの内部処理は非公開に保ちます。
• 可視の生成バッチごとに最大1つの短いステータス文を送信し、結果が準備できるまで沈黙を保ちます。
• 未解決のブロック質問のみをコンパクトなセットで一度に尋ねます。事実を繰り返したり、部分的なタスクで完全なアイデンティティ質問票を強制したりしないでください。
• パレット、ロゴ、タイポグラフィ、または下流の各レビューの後、停止して通常のユーザーフィードバックを待ちます。
• 沈黙、生成成功、または自分の好みから承認を推測しないでください。
• ユーザーの正確なコピーを保持します。ポジショニング、価値、クレーム、成分、価格、認証、統計、規制コンテンツを決して invent しないでください。

コアワークフロー

1. リクエストを分類します。

   • apply-existing: 提供された公式アセットを再設計せずに使用します。
   • extend-partial: 要求された出力に必要な不足スロットのみを作成します。
   • create-identity: 明示的に要求された場合にのみ新しいロゴまたはアイデンティティを作成します。

2. 状態を読み取ります。 次を実行:

   python3 "$SKILL_ROOT/scripts/brandkit.py" state \
     --state-file "$BRANDKIT_STATE" --action get_status
   

   ローカル状態は永続的です。状態ファイルが存在する場合、承認を貼り付けたり、手動編集したり、再作成したりしないでください。

3. インテークとアセット分析を実行します。 intake、asset analysis、state routing、exact state payloadsを読んでください。ユーザーが宣言したすべての公式ロゴ、パレット、タイポグラフィスロットを直ちにロックします。

4. ブランドロックを作成します。 Brand Lockを読んでください。正確な綴り、公式アセット、色、フォント、レイアウト/形状ルール、要求された出力、禁止された処理を記録します。

5. 出力で使用されるスロットのみを要求します。

   • ロゴのみ → 新しいマークの場合はパレット+ロゴ; 既存のマークの場合は公式ロゴのみ
   • パレットのみ → パレット
   • タイポグラフィのみ → タイポグラフィ
   • コピーフリーモックアップ/マーチ → ロゴ; 色/アプリケーションで必要な場合のみパレットを追加
   • テキストを含むソーシャル/パッケージ/ポスター/看板 → ロゴ+パレット+タイポグラフィ
   • ブランドブック/デッキ → ロゴ+パレット+タイポグラフィ

6. 不足している基礎スロットを構築します。 Design Brain、concept boards、inline reviews、および必要なモジュール (palette、logo、typography) のみを読みます。

7. 必要なスロットが承認されたらすぐに元のリクエストを続行します。 ユーザーに再度スコープを選択させることはありません。

8. 要求されたプロダクションモジュールのみをロードします:

   • mockups
   • social graphics
   • posters/banners
   • packaging
   • signage
   • merchandise
   • presentation decks
   • Brandbooks

9. QAと承認。 QA and iterationを読んでください。失敗した出力のみを修復します。下流要素は、その正確な基礎依存関係とともに明示的な承認後にのみ保存します。

新しいアイデンティティのシーケンス

1. パレット

preview payloadsを使用して、2〜3の正確なパレットオプションを決定論的HTMLとしてレンダリングします。PNGスクリーンショットと編集可能なHTMLファイルを表示して待機します。ロゴ生成の前に approve_palette で選択されたパレットを永続化します。

2. SVGロゴマーク

logo prompt enhancerを読んでください。正確に3つの異なるシンボル専用メカニズムと、それぞれに対する1つのRecraftプロンプトを作成します。各長いプロンプトをファイルに書き込み、個別に送信します:

higgsfield generate create recraft_v4_1 \
  --model_type vector \
  --colors @"${BRANDKIT_WORKDIR}/logo-colors.json" \
  --background_color '#F7F7F5' \
  --aspect_ratio 1:1 \
  --resolution 2k \
  --wait --json < "${BRANDKIT_WORKDIR}/logo-candidate-1.txt"

レビューのために返されたSVG URLを直接使用します。選択後、変更せずに正確なSVGを検査します:

python3 "$SKILL_ROOT/scripts/brandkit.py" logo-inspect \
  --source "<selected Recraft SVG URL or absolute local path>"

正確なジョブID、SVG URL、名前、パレットリビジョン、返されたカノニカルジオメトリフィンガープリントを approve_logo で永続化します。

3. タイポグラフィ

提供されたフォントまたは検証済みのGoogle Fontsを使用して、2〜3のユニークなディスプレイ/ボディペアを提案します。プレビュースクリプトを通じて実際のブランド名とサンプルコピーをレンダリングします。approve_typography で選択されたペアのみを永続化します。

インタラクティブフローは常にパレット、ロゴ、タイポグラフィの選択で停止します。明示的な No-Question モードではパレットを選択して永続化できますが、それでも3つすべてのSVGロゴ候補を表示し、ユーザーのロゴ選択のために停止します。正確なブランドマークは自己承認されません。

一貫性不変条件

• 承認された同じロゴソースをどこでも再利用します。決定論的な配置/エクスポートが可能な場合、公式または選択されたSVGを再描画しないでください。
• 生成されたロゴは、その作成に使用されたパレットリビジョンに依存します。そのパレットを変更すると、生成されたロゴとその依存物が無効になります。タイポグラフィを変更してもシンボルマークは無効になりません。
• 基礎スロットを変更すると、そのスロットを required_slots にリストする下流要素のみが無効になります。
• 同じブランドロック値をすべての関連する生成プロンプトにコピーします: 正確なHEX、フォントの役割、形状言語、配置、クリアスペース、構図、禁止された処理。
• 新しいロゴマークには Recraft V4.1 ベクターモードのみを使用します。
• 主要なフォトリアルモックアップジェネレーターとして Seedream を使用します。GPT Image 2 は、読み取り可能なテキストや正確なグラフィック詳細を追加する制御されたステージにのみ使用します。
• 正確なコピーと編集可能なレイアウトには、ローカルの決定論的SVG/PPTX/HTML構築を使用します。画像モデルに編集可能なファイルを偽装させることはしません。
• ネイティブのFigma、Canva、PSD、AI、またはEPSファイルは約束しません。

決定論的スクリプト

JSON入力ファイルを "$BRANDKIT_WORKDIR" の下に作成します。ユーザーテキストをシェル引数に直接 interpolate しないでください。

python3 "$SKILL_ROOT/scripts/brandkit.py" preview \
  --input "$BRANDKIT_WORKDIR/reviews.json" \
  --output-dir "$BRANDKIT_WORKDIR/reviews"

python3 "$SKILL_ROOT/scripts/brandkit.py" logo-export \
  --input "$BRANDKIT_WORKDIR/logo-export.json" \
  --output-dir "$BRANDKIT_WORKDIR/logo"

python3 "$SKILL_ROOT/scripts/brandkit.py" brandbook-build \
  --state-file "$BRANDKIT_STATE" \
  --input "$BRANDKIT_WORKDIR/brandbook.json" \
  --output-dir "$BRANDKIT_WORKDIR/brandbook"

ロゴエクスポートには、logo export payloads をロードしてください。Brandbook には、バンドルされたビルダーのみを使用します。決定論的契約の失敗後に、即席のPowerPointやPDFジェネレーターを代用しないでください。

失敗ポリシー

• 失敗した Recraft または画像生成リクエストを、同じロックされたコンセプトと修正された契約で1回再試行します。2回目の同等の失敗後に停止します。
• プレビューまたはロゴエクスポートが2回失敗した場合、具体的なエラーを報告します。アドホックなSVG書き換えで置き換えないでください。
• Brandbookテンプレート、フォント、または変換契約が失敗した場合、直ちに停止します。視覚的に異なるフォールバックを生成してそれをカノニカルと呼んではいけません。
• 正確なタイポグラフィまたは公式ロゴの忠実性を維持できない場合、完了を主張する代わりに制限を開示します。
• 生の認証トークンや資格情報をファイル、ログ、チャットに公開しないでください。

配信

Brandbook については、brandbook の厳格な応答契約に従います: PPTXリンク/パス、PDFリンク/パス、およびフォントインストール警告のみ。

その他の出力については、以下を返します:

1. 要求されたビジュアルファイルとプレビュー。
2. コンパクトなブランドロックサマリー。
3. 編集可能形式とフラット化形式のラベル。
4. 必要なフォント/インポートの制限。
5. 対象を絞ったリビジョンのための安定したバリアント名。

リファレンスインデックス

• Prerequisites — 段階固有のローカル依存関係とインストールコマンド。
• Intake — 最小限の質問と入力ルーティング。
• Asset analysis — 公式/リファレンスの分類と測定。
• State routing と state payloads — 永続的な承認。
• Brand Lock — カノニカルなビジュアル制約。
• Design Brain — 非公開のアートディレクション。
• Concept boards、preview payloads、inline reviews — 選択段階。
• Logo、logo prompt enhancer、logo export payloads — SVG生成と決定論的バリアント。
• Palette と typography — 基礎スロット。
• Mockups、social graphics、posters/banners、packaging、signage、merchandise — アプリケーション。
• Presentation decks と Brandbooks — 編集可能なドキュメント。
• QA and iteration — プレフライト、修復、承認、配信マニフェスト。