Communitygithub.com

HXZ09845/ecommerce-sku-skill-builder

プロダクトブリーフやセールスポイント、参照アセットから、検証済みのAI動画生成向けSKUスキルパッケージを作成するエージェントスキルシステムです。

ecommerce-sku-skill-builder とは?

このスキルは、Eコマース向けの製品SKU(在庫管理単位)ごとに、AI動画生成用の「スキルパッケージ」を自動生成するためのメタスキルです。単にプロンプトを書くのではなく、製品理解からセールスポイントのビジュアル証明、素材マッピング、標準パッケージの作成、検証、そしてエッジケースの回帰テストまでをガイドします。CursorやClaude CodeなどのAIエージェント上で動作するCodexスキル形式のパッケージ(SKILL.md、references/、scripts/、assets/を含む)を出力することをデフォルトとし、生成された各SKUスキルはこのメタスキルや他の外部リソースに依存しない独立したパッケージとして提供されます。ワークフローは、製品アーキタイプの分類(固定型A+B、小型可動型A+B、純粋A型)、セールスポイント単位の素材選定対話、音声と映像の同期設計、そして検証ゲートを通した品質管理を段階的に実行します。

対応✓Claude Code✓Codex CLI✓Cursor
npx skills add HXZ09845/ecommerce-sku-skill-builder

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

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

ドキュメント

SKUスキルビルダー

このスキルは、新しいEコマース製品/SKU動画生成スキルを作成するための業界汎用ジェネレーターとして使用します。単にプロンプトを書くだけではありません。製品理解からセールスポイントの証明、素材マッピング、標準パッケージのドラフト作成、検証、そして不良ケースの回帰テストまでをガイドします。

現在のステージの焦点:具体的な製品SKUスキルをしっかりと構築することです。同じワークフローは、十分な質の高い具体的SKUスキルが存在する場合に、後で抽象的なカテゴリスキルを生成するためにも使用できます。ただし、それらの抽象カテゴリスキルも、将来の具体的な製品SKUスキルを作成するのに役立つことを目的としています。クリエイターが明示的に要求しない限り、カテゴリの抽象化をメインタスクとして扱わないでください。

デフォルトの出力は、公開可能なCodexスキルパッケージです。

skill-name/
  SKILL.md
  agents/openai.yaml
  references/
    product-rules.md
    core-asset-layer.md
    audio-visual-sync.md
    asset-manifest.md
    prompt-plan-format.md
    gotchas.md
    trigger-tests.md
    quickstart.md
  scripts/
    validate_*.py
  assets/

古い3ファイル構成のパッケージを主要な成果物として作成しないでください。古いCursor時代の素材を変換する場合は、それらをソース入力として保持し、標準のCodexパッケージを正規化された出力として作成します。

このクリエイターは、references/golden-case-abstractions.md などのメタ専用リファレンスも持っています。ターゲットのSKUスキルを構築する際にはこれらを使用してください。これらは自己完結型の抽象化であり、他のスキルへの依存関係ではありません。

生成された製品SKUスキルは、自己完結型の引き継ぎ可能なパッケージでなければなりません。ターゲットのSKUパッケージは、このクリエイターやカテゴリメタスキル、ゴールデンケーススキル、ローカルソースフォルダ、または外部スキルを必要とせずに動作する必要があります。ランタイムに必要なすべてのルールは、ターゲットパッケージ自身の SKILL.md、references/、scripts/、または assets/ に記述されていなければなりません。

メタからSKUへの独立性ルール

このメタスキルはビルド時専用のクリエイターです。このパッケージ自身のファイルから使用可能でなければなりません。

このメタスキルによって生成または更新された具体的なSKUスキルは、引き渡された後、独立して実行可能でなければなりません。生成されたSKUスキルは、ユーザーがこのメタスキル、カテゴリメタスキル、ゴールデンケーススキル、古いSKUパッケージ、外部コラボレーション資料、メモリ、またはローカルの絶対パスをランタイムで読むことを要求してはいけません。

プロダクトブリーフ、セールスポイント表、実写アセット、古いSKUパッケージ、外部コラボレーション資料、カテゴリメタスキル、ケース動画、スクリーンショット、メモリなどの外部素材は、作成中の現在の実行入力としてのみ使用できます。それらから学習した有用なルールはすべて、生成されたSKUスキル自身の SKILL.md、references/、scripts/、assets/、または asset-manifest.md にコピー、書き換え、または要約されなければなりません。

ランタイム使用に必要な確定済みの実写アセットは、生成されたSKUスキルの assets/ ディレクトリに正規化され、references/asset-manifest.md にセマンティックロール、製品状態、承認ステータス、および参照境界とともに記録される必要があります。未承認、サイズ超過、または未解決の素材バージョンのみを pending として保持します。必要なランタイム素材を外部フォルダに残してはいけません。

作業モード

  1. 新規SKUスキル作成:製品理解から状態マトリックス、アーキタイプ、セールスポイント証明、素材戦略、パッケージドラフト、代表検証、不良ケースルーティングまでの完全ワークフローを使用します。
  2. 既存SKUスキル更新:報告された問題、変更されたソース、または不良ケースから開始します。影響を受けるファイルを特定し、必要最小限のルール/素材/バリデーターの表面を修正し、その後、自己完結型監査と代表検証を実行します。
  3. 不良ケースパッチ:障害を製品ルール、アセットマニフェスト、ゴチャ、バリデーター、またはトリガーテストにルーティングします。問題が構造的なギャップを明らかにしない限り、スキル全体を書き換えないでください。
  4. プロダクションバッチ:SKUスキルが代表検証に合格した後、またはクリエイターが既知の保留リスクとともにバッチ処理を明示的に要求した場合にのみ許可されます。

運用契約

  1. このスキルをロードした後、固定された初心者向けの安全なインプットでクリエイターをガイドします。「何か一つ提供してください」と言ったり、いきなり最終的なスキル作成に飛び込んだりしないでください。名前付きの入力スロットを使用し、次の出力を説明し、欠落しているアイテムは pending とマークします。
  2. ソース確認から開始します。まずこのパッケージの内部ルールを読みます。次に、クリエイターから提供または承認された現在の実行入力(カテゴリメタ、古いSKUリファレンス、外部コラボレーション資料、ケース動画、スクリーンショット、素材フォルダなど)を読みます。
  3. カテゴリメタや古いSKUリファレンスがない、または弱い場合でも、このパッケージの業界ルールと組み込みのゴールデンケース抽象化を使用して続行します。外部ソースがないことを理由に処理をブロックしないでください。
  4. 最初に製品を理解します。クリエイターが明示的にすべてを提供しない限り、最初のラウンドで承認済み素材ライブラリ全体を要求したり、最終的なルールを作成したりしないでください。
  5. 詳細なルール作成の前に、製品構造と状態マトリックスを確認します。
  6. プロンプト作成の前に、製品を1つのプロダクションアーキタイプに分類します:大きな固定型A+B、小さな可動型A+B、または純粋A非変形/装着型。
  7. A/B判定を最も重要な意思決定ゲートとして扱います。クリエイターの明示的な基準と現在の実行による判定は、デフォルトのヒューリスティックよりも優先されます。不確かな場合は、推論を提示し、確認を待ちます。
  8. 選択されたアーキタイプに対して、組み込みのゴールデンケース抽象化を適用します。それらの抽象化から、幻覚ポイント、A/B処理、プロンプト安全策、素材ルール、バリデーターフックを抽出します。
  9. 高品質ケースと現在の入力からコアアセットレイヤーを抽出します:アイデンティティ/ロゴ、環境、リズム、アクション、プロンプト形式、提出契約、TSリスク。
  10. セールスポイントをビジュアルプルーフに1つずつマッピングします。各セールスポイントについて、候補となる実写リファレンスの選択肢を提案し、OK とマークする前にクリエイターの過去の素材選択経験を活用した対話テストを実行します。現在のセールスポイントの証明ルート、リファレンスタイプ、製品状態、A/B判定、禁止素材、ダウングレードルートが確認されるまで、次のセールスポイントに進まないでください。 10.5. セールスポイントの素材選択中に、製品状態のリスクとリファレンス継承の境界を監査します。白背景のP0/P1画像など、ノイズの少ない製品リファレンスを優先します。1つのUnitが複数のリファレンスを使用することもできますが、デフォルトでは1つの製品状態にサービスする必要があります。靴、バッグ、アパレルなど、身体にリンクする製品の場合、クリエイターが明示的に承認しない限り、製品リファレンスからモデル/人物、スタイリング、服装、背景、小道具を継承しないでください。
  11. プロンプト作成の前に、音声と映像の同期アレンジメントを構築します:スクリプトコピー -> 具体的なビジュアルエンティティ -> 実際の環境 -> セールスポイント証明 -> Unit -> 素材ロール -> プロンプトアクション -> TSリスク。コピーだけ、または素材だけからプロンプトを作成しないでください。 11.5. シーンストーリーテリング導出(product-rules.md の §11.5)。スクリプトのシーンが製品のデフォルト/プライマリーシーンでない場合、Aクラスプロンプトを作成する前に4段階の導出を完了します:ステップ1 シーンマイクロアクション → ステップ2 シーン固有の小道具 → ステップ3 感情の弧 → ステップ4 ナラティブ品質セルフチェック(Q1-Q6)。プロンプトプランの先頭に「シーンストーリーテリング適応テーブル」を出力します。デフォルトシーンのスクリプトはステップ1-3をスキップできますが、それでもQ1-Q6に合格する必要があります。
  12. @圖片 または @動画 を使用するすべてのUnitプロンプトには、簡潔な 【素材説明】 / Reference Materials ブロックを含める必要があります。監査テーブルでは controls / does_not_control を使用できますが、最終的なプロンプトでは 只參考...、不參考...、...以 @圖片X 為準 など、モデルに優しい短い表現を使用する必要があります。
  13. 各Unitを製品状態の動作からA、A-out、A-in、またはBに分類し、主要な行をクリエイターと確認します。黙って「十分な」アセットを選ばないでください。
  14. 承認された素材バージョンが選択されるまで、ランタイムアセットを保留状態にしておきます。テストモードでは、1つまたは2つのスクリプトが最初のスキルドラフトとビジュアルフィードバックループを作成します。プロダクションモードでは、バッチスクリプトがバッチプロンプトプラン、素材アレンジメント、検証、および動画タスク入力を駆動します。
  15. 製品理解、プロダクションアーキタイプ、ゴールデンケース抽象化、コアアセットインベントリ、セールスポイント証明、音声映像同期、および素材戦略が調整された後にのみ、標準のスキルパッケージを生成します。
  16. 自己完結型ハンドオフ監査を実行します:外部スキル依存性なし、ローカル絶対パス依存性なし、「親/メタ/ゴールデンスキルを読め」という指示なし、すべてのランタイムリファレンスがターゲットパッケージ内で解決されるか、明示的に pending であること。
  17. 代表的なプロンプトプランと製品バリデーターで検証します。不良ケースをルール、ゴチャ、マニフェスト、またはバリデーターにフィードバックします。

必須ワークフロー

  1. クリエイターへの最初の応答の前に references/creator-onboarding.md を読みます。それを使用して、名前付きの最初のラウンド入力を要求し、初心者向けの安全な言葉で段階的なプロセスを説明します。
  2. references/sku-creator-workflow.md を読みます。
  3. references/product-rules.md を読み、業界のハードルール、A/Bロジック、素材ロール、状態の一貫性、プロンプトプラン要件、ケース抽象化ルールを確認します。
  4. プロダクションアーキタイプを選択した後、references/golden-case-abstractions.md を読みます。組み込まれている茶バー、カップ/コンテナ、靴/アパレル、バッグ型ウェアラブルの抽象化を、幻覚ポイントとA/B処理に使用します。クリエイターが明示的に抽象化するための現在の実行ソースを提供しない限り、外部スキルをロードしないでください。
  5. セールスポイントマッピングまたはプロンプト作成の前に references/core-asset-layer.md を読みます。最初にそれを使用してプロダクションアーキタイプを選択し、次に高品質ケースと現在の入力からロゴ/テキスト、環境、リズム、Unit分割、プロンプト形式、提出、TSリスクルールを抽出します。
  6. プロンプト作成の前に references/audio-visual-sync.md を読みます。それを使用して、スクリプトコピー、具体的なビジュアルエンティティ、実際の環境、セールスポイント証明、Unit分割、A/BまたはA+Bの素材ロール、プロンプトアクション、期間、TSリスクダウングレードをバインドします。
  7. references/category-questionnaire.md を段階的なクリエイター質問と確認カードに使用します。
  8. references/method-decision-tree.md を使用して生成方法を選択します。デフォルトは直接生成です。ユーザーが明示的にTVC/広告を要求した場合のみ、グリッド/TVCフローを使用します。
  9. references/skill-template.md をターゲットSKUスキルパッケージのドラフト作成時に使用します。
  10. references/asset-manifest.md をセマンティックアセットロールと承認済み/保留中のランタイムアセットを定義する際に使用します。
  11. references/prompt-plan-format.md を代表的なスクリプトプランを検証する際に使用します。
  12. references/gotchas.md をハンドオフ前および不良ケースを取り込む際に使用します。
  13. references/validate-template.py と製品固有のケースを使用して scripts/validate_*.py を作成します。
  14. scripts/scaffold_category_skill.py は開始スキャフォールドとしてのみ使用し、その後実際の製品ルールで洗練します。

カテゴリメタフォールバック

成熟したカテゴリメタまたは古いSKUリファレンスが存在する場合はそれらを優先しますが、アシスタントとして扱い、ブロッカーとしては扱いません。それらがないか弱い場合は、業界ルールと組み込みのゴールデンケース抽象化を使用します。古いルールを継承する場合は、適用する前に 可繼承 / 需改寫 / 禁止繼承 を出力します。

品質ゲート

  • インプットゲート:名前付きの最初のラウンド入力スロット、ソース確認、製品理解、コンポーネント/状態マトリックス、およびプロダクションアーキタイプが、詳細なルールの前に生成されます。
  • プルーフゲート:各セールスポイントに、クリエイターが確認したビジュアルプルーフルート、素材タイプ、製品状態、A/B判定、禁止素材/状態、ダウングレードルート、および1対1の対話テスト記録があります。
  • アセットゲート:コアアセットインベントリ、TSリスク、P0/P1/P2ロール、製品状態リスク、低ノイズリファレンス選好、有用/無視されるリファレンスコンテンツ、およびランタイムアセット承認ステータスが、プロンプト作成前に記録されます。
  • 同期ゲート:意味のあるすべてのスクリプトビートが、具体的なビジュアルエンティティ、実際の環境、Unit、プルーフターゲット、素材ロール、プロンプトアクション、期間/リズム、およびTSリスクにマッピングされます。
  • プロンプトゲート:@圖片 または @動畫 を使用するすべてのUnitに、モデルに優しい 只參考 / 不參考 / 以...為準 の表現を使用した簡潔な素材目的ブロックが含まれます。
  • シーンゲート U31:デフォルト以外のシーンは、Aクラスプロンプトの前に、シーンマイクロアクション、シーンの小道具、感情の弧、およびQ1-Q6ナラティブセルフチェックを完了します。
  • Unitゲート U32-U35:Unitは、固定されたクロックスライスではなく、プルーフ、製品状態、A/Bタイプ、シーン、幻覚リスクによって分割されます。標準のAクラスプロンプトは、ユニット目標、アクションフロー、終了条件を宣言し、秒単位の散文による分割記述は行いません。
  • ハンドオフゲート:生成されたSKUスキルは標準のCodex形状であり、自己完結型で、SKILL.md は簡潔、references/ は詳細であり、このクリエイター、カテゴリメタ、ゴールデンケース、外部ドキュメント、メモリ、ローカルパス、または外部素材フォルダへのランタイム依存性がありません。
  • 検証ゲート:トリガーテスト、代表的なプロンプトプラン、製品バリデーター、素材テーブル、A/B分類、音声映像同期マッピング、API/素材カウント、検証記録、および不良ケースルーティングが存在します。

関連スキル