krea-ai

Krea AI - 生成と強化

デフォルトでは CLI 経由で Krea を使用し、フォールバックとして Krea MCP サーバーを使用します。このスキルは意図優先のワークフロープリファブを中心に構成されています。ユーザーの動詞 + モダリティ + フレーバーを分類し、一致する workflows/*.md を読み込み、モデルメニューから即興で選ぶのではなく、そのレシピに従います。

Krea をプログラムから呼び出すアプリを開発している開発者は、代わりに姉妹スキルである krea-build/ を使用してください。

ブートストラップ

Krea CLI がインストールされ認証済みであれば、常にそちらを優先してください:

which krea && krea doctor 2>&1 | head -5

正常な CLI は list_models に対して api auth の成功を出力します。CLI が存在しない場合:

npm install -g @krea-ai/cli
krea auth login
# or export KREA_API_KEY=...

MCP は CLI が利用できず、かつ list_models、get_model_schema、generate_image、generate_video、enhance_image、get_job、upload_asset などの Krea ツールが接続されている場合にのみ使用してください。どちらのサーフェスも利用できない場合は、停止してユーザーに CLI のインストールまたは MCP の接続を依頼してください。LoRA トレーニングなど文書化されたフローを除き、通常の生成に直接 HTTP を使用しないでください。

セッション内で最初の生成を行う前に、このスキルディレクトリに scripts/update-check.sh が含まれている場合に限り、パッシブなアップデートチェックを任意で実行してください:

bash /path/to/krea-ai/scripts/update-check.sh 2>/dev/null || true

これは生成を決してブロックしません。UPGRADE_AVAILABLE または JUST_UPGRADED は一度だけ表示し、それ以外は何も表示しないでください。

普遍的な UX ルール

1. 簡潔な出力。結果のパス/URL と有用な一文を送ってください。生の ID や JSON ダンプは不要です。
2. ユーザーの最初のメッセージから言語を検出し、その言語で返信してください。技術的なパラメータは英語のままにします。
3. ビジョン優先。生成前に添付画像を読み込み、生成されたすべてのスチル/フレームを Read ツールで読んでから、承認したり、ユーザーに表示したり、下流のモデルに渡したりしてください。各出力を references/vision-qa.md に従って 1 行ずつ批評します — 構図、指定されたアクションの有無、識別できる詳細、ライティング、次のクリップへの連続性のフック。バッチ全体を「全部よく見えます」の一言で承認しないでください。それは壊れた endImages や下流での Seedance の拒否を生む、いい加減な承認という失敗モードです。
4. 安価な操作に早すぎる質問はしない。安価な画像/強化では、妥当なデフォルトを選んでください。高価な操作では、早まって回答せず、該当する場合はキャンペーンブリーフのヒアリングを実行し、一度だけ明確化し、今後の支出について references/cost-preflight.md を実行し、セッションの累計について references/budget-tracking.md を維持して、402 Payment Required がクレジット切れの最初のシグナルにならないようにしてください。
5. 30 秒を超える非同期ポーリングでは、進捗報告は必須です。references/progress-reporting.md を使用してください。
6. モデルを選ぶ前に、常に krea models list --json または MCP の list_models を呼び出してください。references/model-catalog.md を使用して、アーキタイプを実際の ID に解決してください。
7. 送信前に常にモデルスキーマを確認してください。imageUrl、imageUrls、startImage、duration、resolution などのフィールド名を推測しないでください。
8. 生成前に、生成参照を Krea でホストされるアセットに正規化してください。ローカルファイルや任意の外部画像/動画/音声 URL は、まず Krea にアップロードする必要があります。すでに Krea の/承認済みのアセット URL のみを直接渡してください。調査に使用する製品/ページの URL は生成参照ではありません。
9. 存在する場合は KREA_PREFERENCES.md またはプロジェクトドキュメント内の ## Krea preferences セクションを尊重してください。
10. 悪い出力を問題ないふりをしないでください。不一致を明示し、具体的な再試行の道筋を提示してください。
11. 散文より先に参照。ユーザーが複数の正当な視覚的意味を持つ用語（storyboard、mood board、key visual、hero shot、mockup、tearsheet、look book）を使用した場合、独自の視覚言語で解釈する前に参照画像を求めてください。
12. 忠実性のゲートだけでなく、テイストのゲート。キャンペーン級の出力を届ける前に、自問自答を一文書いてください: これは紛れもなくプレミアムなクリエイティブか、それともカテゴリのクリシェか? クリシェなら、リリース前に反復してください。
13. ルーティングの質問でデフォルトに誘導しない。画像か動画か、ドラフトか最終かを尋ねる場合、類似のものでも、「go と言えばデフォルト」といった言い回しを使わず、中立的に選択肢を提示してください。

キャンペーンブリーフの受け付け

リクエストに製品、ブランド、キャンペーン、広告、ショート、ソーシャルパック、または 4 つ以上の成果物が含まれる場合は、ルーティングの前に必須です。単発のクイック生成の場合にのみスキップしてください。

不足している項目があれば、1 つの簡潔なメッセージで一度に確認します。

1. 用語: 読み込まれた用語（storyboard、ad、short、campaign、draft、hero）を、ユーザーの業界で想定される文脈で言い換えます。用語が曖昧な場合は references/artifact-taxonomy.md を使用します。
2. 参考資料: 計画用の成果物を生成する前に、レイアウト、スタイル、トーン、またはフォーマットの参考資料を求めます。
3. ブランドボイス: 製品、パッケージ、参考資料、ユーザーのブリーフから 1 文で推測します。不確かな場合は確認します。
4. 成功基準: 成果物ごとに 1 行で、対象オーディエンス、プラットフォーム、意図するアクションを記載します。
5. 調整要素: 「つまらない」「いまいち」「驚かせて」といったフィードバックに応じるときは、フォーマット、コンテンツ、パレット、ボイスを分けて扱います。広告/キャンペーンの作業では、references/marketing-creative-anatomy.md を読み込み、モード、フォーマット、フック、設定、タレント、製品、ブランド、参考パス、CTA を分けて扱います。

確認済みのブリーフを 5 行で出力してから、ルーティングします。

ルーティング - 意図 -> ワークフロー

意図（動詞 + モダリティ + ニュアンス）	ワークフロー
縦型ショート / ソーシャル / TikTok / Reels / Shorts / GRWM 動画を 15 秒以下で作成	workflows/social-video-short.md
広告ストーリーボード / キービジュアル / キャンペーンシート / ソーシャルパック / エージェンシー風の製品レイアウト	workflows/key-visual-sheet.md
ハードカットを使った 15 秒超の長めのナラティブ動画を作成	workflows/narrative-video-long.md
静止画をアニメーション化 / 画像から動画 / この画像を動かす	workflows/image-to-video-animate.md
プロ品質のアニメーション / アニメシリーズ / ストーリーボードから動画 / アセットバイブル / ショットリストからシーケンス / スタジオのリテイク	同階層の ../krea-animation/SKILL.md を使用
画像を作成（品質基準の指定なし、探索中）	workflows/image-fast-iterate.md
制作品質の画像 / 納品用 / ヒーローアセット	workflows/image-final-render.md
この画像を変換 / 編集 / リスタイル	workflows/image-edit-i2i.md
ポスター / タイポグラフィ / テキスト主体の画像	workflows/image-text-poster.md
顔の参考資料を使用したポートレート	workflows/portrait-with-refs.md
製品ヒーロー写真 / EC ヒーローショット	workflows/product-photo-hero.md
製品ライフスタイル / モデル着用 / シーン構成	workflows/product-photo-lifestyle.md
3D スクリーンショット -> フォトリアルレンダリング（アーキビズ）	workflows/archviz-3d-to-render.md
アップスケール / 4K / 高画質化 / シャープにする	workflows/enhance-upscale.md
クリエイティブな高画質化 / リスタイル / 再ライティング	workflows/enhance-creative.md
LoRA をトレーニング / これらの画像でファインチューニング	workflows/lora-train-and-use.md
製品 URL -> フルキャンペーン	workflows/full-ad-campaign.md

厳格なルール: 先に workflows/*.md ファイルを読み込まずに generate video を呼び出さないでください。ワークフローは、コストの事前チェック、一度だけの確認、ショート動画のストーリーボード承認、進捗の通知、禁止ムーブのリストを徹底します。これらを回避したことが、2026-05-17 に約 5,000 CU を無駄にした原因です。

参照資料

アクティブなワークフローが必要とするものだけを読み込んでください：

• references/cli-or-mcp.md - CLI と MCP の操作の並列比較。
• references/model-catalog.md - ライブの list_models を通じて解決するアーキタイプ。
• references/media-inputs.md - アップロード、ローカルファイル、画像参照、開始/終了フレーム。
• references/async-polling.md - ジョブライフサイクルのセマンティクス。
• references/prompt-engineering.md - モダリティ別のプロンプト処理。
• references/artifact-taxonomy.md - ストーリーボード、キービジュアル、ムードボード、ヒーローショット、モックアップ、ティアシート、ルックブックを明確に区別します。
• references/marketing-creative-anatomy.md - キャンペーン/広告のタプル、フックファミリー、静的フォーマットファミリー、参照駆動型とコンポーズ型のパス。
• references/storyboard-variations.md - 動画の前に低コストなストーリーボードバリエーションを作るための軸とデリバリーパターン。
• references/story-spine.md - PROTAGONIST/WANT/OBSTACLE/STAKES/TURN/NEW-NORMAL ゲート。15 秒を超えるナラティブのストーリーボード作成前に必須です。
• references/shot-grammar.md - シーンとショットの語彙、ビートパターン、マッチカット。60 秒のナラティブは 6 ショットではなく 20〜30 ショットです。
• references/dialogue-and-audio.md - TTS パイプライン、アンビエントベッド、adelay/amix を使った ffmpeg 音声ミックス。SHOTLIST.md にダイアログがある場合は必須です。
• references/ugc-social-video.md - UGC のリアリズムの手がかり、ストーリーボードテンプレート、禁止されたポリッシュワード、敵対的 QA。
• references/troubleshooting.md - 既知の CLI/モデルの問題と復旧。
• references/preferences.md - プロジェクトレベルのオーバーライド。
• references/cost-preflight.md - 100 CU 超または動画/トレーニングジョブの前の必須承認。
• references/progress-reporting.md - 長時間の非同期ポーリング中の必須 ping。
• references/models/ - モデル別のプロンプティングプレイブック（プロンプト構造、メディアパスのルール、エンジンの癖、失敗からの復旧、ペーシングのガードレール）。アクティブなワークフローがそのモデルを解決した場合にのみ読み込んでください。現在：seedance-2.md。

関連スキル

プロフェッショナルなアニメーション制作には krea-animation/ を使用してください：アニメシリーズ、アセットバイブル、キャラクターモデルシート、ストーリーボード、ショットリスト、AI 動画ジョブ、編集アセンブリ、QA、リテイク。

開発者向け統合作業には krea-build/ を使用してください：API クライアント、フロントエンドスニペット、バリデーション、再現可能なアプリコード。

マーケティング、製品、キャンペーン、建築ビジュアライゼーションのリクエストはこのスキルにとどまり、krea-ai/workflows/ にルーティングされます：

• マーケティング/製品作業：workflows/product-photo-hero.md、workflows/product-photo-lifestyle.md、workflows/key-visual-sheet.md、workflows/social-video-short.md、workflows/full-ad-campaign.md。
• 建築ビジュアライゼーション：workflows/archviz-3d-to-render.md。

キャンペーン納品前のセルフ評価

キャンペーン層の成果物を納品する前に、以下に非公開で回答し、「いいえ」または「わからない」があれば修正してください：

1. 成果物の一致：これはユーザーが業界の語彙で求めた形になっていますか？
2. 参照の遵守：スタイル参照が存在する場合、視聴者は両方を同じキャンペーンに位置づけるでしょうか？
3. 忠実性：ブランドアセット、ラベルの詳細、パレット、タイポグラフィ、訴求内容は正確ですか？
4. センス：カテゴリーのクリシェに感じさせない、唯一の際立った要素は何ですか？
5. ボイス：コピー/レイアウトは、ヒアリングで明らかになったブランドボイスに一致していますか？
6. バリエーションの規律：各バリエーションは、単なる壁紙の細部ではなく、意味のあるレバーを動かしましたか？
7. コストの誠実さ：これは最小 CU パスの 2 倍以上を費やしましたか、そしてどのヒアリング質問がそれを防げたでしょうか？
8. 次のステップの明瞭さ：ユーザーは追加の説明なしに承認、却下、または微調整の依頼ができますか？

ファイル名パターン

ローカル出力には、yyyy-mm-dd-hh-mm-ss-short-name.ext を使用し、画像には .png、動画には .mp4 を付けます。短い名前は小文字とハイフンで統一してください。