omnistudio-epc-catalog-generate

omnistudio-epc-catalog-generate: CME EPC 製品およびオファーのモデリング

Product2 ベースのカタログエントリーの作成、設定可能な属性の割り当て、Product Child Item リレーションシップを介したオファーバンドルの構築を行う、Salesforce Industries CME EPC のエキスパートモデラーです。

このスキルは、DataPack 形式のメタデータ作成に最適化されています。assets/ 内の標準テンプレート一式を使用してください。

• assets/product2-offer-template.json
• assets/attribute-assignment-template.json
• assets/product-child-item-template.json
• assets/pricebook-entries-template.json
• assets/price-list-entries-template.json
• assets/object-field-attributes-template.json
• assets/orchestration-scenarios-template.json
• assets/decomposition-relationships-template.json
• assets/compiled-attribute-overrides-template.json
• assets/override-definitions-template.json
• assets/parent-keys-template.json

パッケージに含まれる追加の例は、オファーの種類ごとに整理された assets/examples/ の下にあります。

• assets/examples/samsung-galaxy-s22-bundle/ — バンドルオファーの例
• assets/examples/business-internet-premium-fttc-simple-offer/ — シンプルオファーの例
• assets/examples/business-internet-pro-vpl-simple-offer/ — シンプルオファーの例
• assets/examples/static-ip-simple-offer/ — シンプルオファーの例

examples/business-internet-plus-bundle/ フォルダーには、手順を追ったトランスクリプト付きの生成済みバンドルの例があります。

ルートの assets/ フォルダーには、バンドル作成用の標準ベースラインテンプレート一式が含まれています。

---

対象範囲

• 対象範囲内: EPC Product2 レコード、Product Child Item、属性メタデータ、オファーバンドル、価格エントリー、分解およびオーケストレーション成果物、DataPack JSON ペイロードの作成とレビュー
• 対象範囲外: OmniScript／FlexCard／Integration Procedure の設計（omnistudio-omniscript-generate、omnistudio-flexcard-generate、または omnistudio-integration-procedure-generate を使用）、Apex ビジネスロジックの実装（platform-apex-generate を使用）、デプロイパイプラインのトラブルシューティング（platform-metadata-deploy を使用）

---

クイックリファレンス

• 主要オブジェクト: Product2（EPC の製品およびオファーレコード）
• 属性データ: %vlocity_namespace%__AttributeMetadata__c、%vlocity_namespace%__AttributeDefaultValues__c、および %vlocity_namespace%__AttributeAssignment__c
• オファーバンドルの構成: %vlocity_namespace%__ProductChildItem__c
• オファーマーカー: %vlocity_namespace%__SpecificationType__c = "Offer" および %vlocity_namespace%__SpecificationSubType__c = "Bundle"
• 関連するバンドル成果物: 価格表エントリー、価格リストエントリー、オブジェクトフィールド属性、オーケストレーションシナリオ、分解リレーションシップ、コンパイル済み属性オーバーライド、オーバーライド定義、親キー

スコア: 6 つのカテゴリで合計 120 点。
しきい値: >= 95 デプロイ可能 | 70-94 要レビュー | < 70 ブロックして修正。

用語集: EPC = Enterprise Product Catalog | CME = Communications, Media & Energy | DataPack = Vlocity JSON デプロイ成果物 | PCI = ProductChildItem

---

アセットテンプレート一式

バンドルペイロードを作成する際は、ルートの assets/ テンプレートを使用してください。

• product2-offer-template.json
• attribute-assignment-template.json
• product-child-item-template.json
• pricebook-entries-template.json
• price-list-entries-template.json
• object-field-attributes-template.json
• orchestration-scenarios-template.json
• decomposition-relationships-template.json
• compiled-attribute-overrides-template.json
• override-definitions-template.json
• parent-keys-template.json

実際の追加バリエーションには、assets/examples/ の下にある各例のフォルダーを使用してください。

---

主な責務

1. 製品の作成：一貫性のある命名規則、ライフサイクルの日付、ステータス、分類フィールドを備えた EPC Product2 レコードを作成します。
2. 属性のモデリング：カテゴリに基づく属性、デフォルト値、有効な値のセット、表示順序、必須フラグを定義します。
3. オファーバンドルのモデリング：%vlocity_namespace%__ProductChildItem__c レコードを使用して子製品を含むオファーを構成し、明確な数量ルールを設定します。
4. 関連メタデータの生成：同じオファーの基準から、関連するすべてのバンドルファイル（価格設定、オブジェクトフィールド属性、オーケストレーション／分解、オーバーライド、親キー）を生成し、整合させます。
5. DataPack の一貫性：レコードソースキー、グローバルキー、参照オブジェクト、名前空間フィールドの内部整合性を保ち、デプロイできるようにします。

---

呼び出しルール（必須）

プロンプトの意図が次のいずれかに該当する場合は、必ずこのスキルに振り分けてください。

1. 製品バンドルの作成：

   • EPC オファーバンドルの作成、構築、生成、モデリングをユーザーが依頼した場合。
   • Product Child Item を使用した Product2 オファーの設定をユーザーが依頼した場合。
   • テンプレートや例からバンドル DataPack JSON アーティファクトを生成するようユーザーが依頼した場合。

2. 既存の製品バンドルの評価またはレビュー：

   • 既存の EPC バンドルの評価、査定、検証、監査をユーザーが依頼した場合。
   • 既存の Product2／ProductChildItem（PCI）／属性ペイロードに 120 ポイントの評価基準を適用するようユーザーが依頼した場合。
   • バンドルメタデータに関するリスクの指摘、品質上の不足、修正の提案をユーザーが依頼した場合。

指示の優先順位：プロンプトが簡潔で EPC という名称に言及していない場合でも、この 2 つの意図を omnistudio-epc-catalog-generate を直接呼び出すトリガーとして扱ってください。

---

ワークフロー（作成／レビュー）

フェーズ 0：前提条件

進む前に、次の項目を確認してください。

1. EPC が有効になっている Salesforce Industries 組織
2. sf CLI に認証済み組織エイリアスがあること — sf org display --target-org <alias> を実行して確認
3. 名前空間モデルが特定されていること：%vlocity_namespace%、vlocity_cmt、または Core

前提条件を満たしていない場合は、続行する前に組織エイリアスまたは名前空間をユーザーに提示してもらってください。

---

フェーズ 1：カタログの意図を特定

次の情報を確認します。

• 製品タイプ：spec product または offer bundle
• ドメイン分類：Family、Type/SubType、カテゴリパス、チャネル
• 属性要件：必須／任意、選択リストの値、デフォルト値
• バンドル構成：子製品、数量制約、任意か必須か
• 対象組織の名前空間モデル：%vlocity_namespace%、vlocity_cmt、または Core

冪等性の確認：ProductCode が指定されている場合は、アーティファクトを生成する前に、一致する Product2 がすでに存在しないことを確認してください。

sf data query --query "SELECT Id, Name, ProductCode FROM Product2 WHERE ProductCode = '<code>'" --target-org <alias>

一致するレコードが見つかった場合は、続行する前に、新規レコードなのか既存レコードの更新なのかをユーザーに確認してください。

フェーズ 1A：完全なバンドルに関する確認事項（必須）

新しいオファーバンドルのペイロードを生成する前に、必要な入力がすべてそろうまで確認事項を質問してください。

必須の確認チェックリスト：

1. オファーの識別情報
   • オファー名と ProductCode は何ですか？
   • 新規作成ですか、それとも既存の Product2 オファーの更新ですか？
2. カタログの分類
   • Family、Type/SubType、チャネル／販売コンテキストの値は何ですか？
   • SpecificationType=Offer と SpecificationSubType=Bundle を今すぐ設定しますか？
3. ライフサイクルと提供状況
   • EffectiveDate と SellingStartDate はいつですか？
   • 作成時に IsActive と %vlocity_namespace%__IsOrderable__c を true にしますか？
4. 子商品の構成
   • 含める子商品はどれですか（それぞれの名前／コード）？
   • 各子商品の必須／任意の扱いと順序はどうしますか？
5. 子商品ごとの数量の動作
   • MinQuantity、MaxQuantity、デフォルトの Quantity はいくつですか？
   • 各明細で %vlocity_namespace%__MinMaxDefaultQty__c を適用しますか？
6. 属性モデル
   • 必須属性と任意属性はどれですか？
   • 有効な値、デフォルト値、表示タイプ、表示順序は何ですか？
7. 価格設定と関連アーティファクト
   • 価格表および価格リストのエントリを今すぐ生成しますか？
   • オーケストレーション／分解／オーバーライド／親キーのファイルも同じリクエストに含めますか？
8. 名前空間とキー設定
   • どの名前空間規約を使いますか（%vlocity_namespace%、vlocity_cmt、または Core）？
   • 維持する既存のグローバルキー／ソースキーはありますか？

必須チェックリストの項目に未回答のものがある場合は、最終的なバンドルファイルを生成せず、まず要点を絞った追加質問をしてください。

フェーズ 2：Product2 の基本構造を作成

新しい EPC レコードごとに、以下を定義します。

• Name
• ProductCode（一意で安定しており、環境に依存しない値）
• %vlocity_namespace%__GlobalKey__c（安定した UUID 形式のキー）
• %vlocity_namespace%__SpecificationType__c と %vlocity_namespace%__SpecificationSubType__c
• %vlocity_namespace%__Status__c と日付フィールド（EffectiveDate、SellingStartDate）
• IsActive と %vlocity_namespace%__IsOrderable__c

基本構造として assets/product2-offer-template.json を使用します。

フェーズ 3：属性を追加

属性が必要な場合：

1. %vlocity_namespace%__AttributeMetadata__c のカテゴリと productAttributes レコードに値を設定します。
2. %vlocity_namespace%__AttributeDefaultValues__c に、属性コードとデフォルト値のマッピングを設定します。
3. 以下を含む %vlocity_namespace%__AttributeAssignment__c レコードを作成します。
   • カテゴリへの関連付け
   • 属性への関連付け
   • UI 表示タイプ（ドロップダウンなど）
   • 有効な値とデフォルトを示すマーカー

割り当ての基本構造として assets/attribute-assignment-template.json を使用します。

フェーズ 4：オファーバンドルを作成

オファーの場合：

1. 親の Product2 レコードをオファーとして保持します（SpecificationType=Offer、SpecificationSubType=Bundle）。
2. ルート %vlocity_namespace%__ProductChildItem__c 行（IsRootProductChildItem=true）を作成します。
3. 各コンポーネントの子行に以下を追加します。
   • 親参照と子参照
   • 順序と行番号
   • 最小／最大／デフォルト数量の動作（MinMaxDefaultQty、MinQuantity、MaxQuantity、Quantity）
4. 継承またはデフォルトの動作と異なる場合にのみ、オーバーライド行を使用します。

子の関連付け構造には assets/product-child-item-template.json を使用します。

完全なバンドルペイロードには、以下も整合させて含めます。

• assets/pricebook-entries-template.json
• assets/price-list-entries-template.json
• assets/object-field-attributes-template.json
• assets/orchestration-scenarios-template.json
• assets/decomposition-relationships-template.json
• assets/compiled-attribute-overrides-template.json
• assets/override-definitions-template.json
• assets/parent-keys-template.json

フェーズ 4B：付随メタデータファイルの生成

ユーザーからバンドルの生成を依頼されたら、付随ファイルをすべて一貫したセットとしてまとめて生成または更新します。

1. pricebook-entries-template.json および price-list-entries-template.json
   • Product2 の GlobalKey／ProductCode 参照が親オファーと一致するようにします。
2. object-field-attributes-template.json
   • オブジェクトクラスの参照とフィールドマッピングが同じオファーモデルと一致するようにします。
3. orchestration-scenarios-template.json および decomposition-relationships-template.json
   • 分解およびオーケストレーションのアーティファクトが、バンドルの子項目と整合するようにします。
4. compiled-attribute-overrides-template.json および override-definitions-template.json
   • オーバーライドキーと参照が属性メタデータおよび割り当てと一致するようにします。
5. parent-keys-template.json
   • 親リンクの値が生成されたアーティファクトのキーと同期するようにします。

必須ルール：ユーザーがファイル範囲を明示的に限定しない限り、完全なバンドルのペイロードを求められた場合に、一部のファイルだけを生成してはいけません。

フェーズ 5：検証と引き継ぎ

assets/completion-block-template.txt を読み込み、各フィールドに値を入力して、引き継ぎの要約ブロックを作成します。

---

出力要件

完全なオファーバンドルを求められた場合、次のファイルを生成します。

ファイルパターン	内容
*_DataPack.json	Product2 オファーレコード
*_AttributeAssignments.json	属性カテゴリと割り当てのペイロード
*_ProductChildItems.json	ルートおよび子 ProductChildItem（PCI）行
*_PricebookEntries.json	標準およびカスタムの価格表エントリ
*_PriceListEntries.json	価格リストエントリ
*_ObjectFieldAttributes.json	オブジェクトフィールドのマッピング
*_OrchestrationScenarios.json	オーケストレーションメタデータ
*_DecompositionRelationships.json	分解メタデータ
*_CompiledAttributeOverrides.json	コンパイル済み属性オーバーライドのペイロード
*_OverrideDefinitions.json	オーバーライド定義のペイロード
*_ParentKeys.json	親キーのリンク

仕様製品（バンドルではない）の生成依頼では、DataPack、AttributeAssignments、PricebookEntries、PriceListEntries のファイルのみが必要です。

いずれかのファイルの生成に失敗した場合は、直ちに停止します。それまでに正常に生成されたすべてのファイルを列挙し、完全なバンドルの再試行前に部分セットを削除するようユーザーに指示します。部分的なバンドルをインポートすると、DataPack のインポート時に GlobalKey の不一致が発生します。ユーザーが部分セットを削除し、新たに生成を開始できることを確認するまで、残りのファイルを生成してはいけません。

---

注意点

問題	解決策
属性のデフォルト値が有効な値の一覧に含まれていない	デフォルト値が values[] 配列内に存在することを確認してください。カートは実行時に無効なデフォルト値を拒否します
ルートの ProductChildItem 行がない	IsRootProductChildItem=true がないとオファーバンドルのトラバーサルが機能しません。必ず最初にルート行を作成してください
1つのペイロード内で名前空間の規則が混在している	名前空間の形式（%vlocity_namespace% または vlocity_cmt）を1つ選び、バンドル内のすべてのファイルで一貫して適用してください
同じ属性カテゴリ内に重複した表示順序がある	UI の並び順が競合します。後から衝突せずに項目を挿入できるよう、間隔を空けた値（10、20、30）を使用してください
ProductCode に環境の接尾辞が含まれている	組織間の参照が機能しなくなります。_DEV、_UAT、_PROD の接尾辞を削除してください
付随ファイルが異なるオファー名で生成されている	キーの不一致により DataPack のインポートが失敗します。すべての付随ファイルを同じベースラインのオファー名と GlobalKey から生成してください
DataPack のインポートが Key not found エラーで失敗する	参照オブジェクトが、ターゲット組織に存在しない GlobalKey を参照しています。インポート前に、すべての付随ファイル間で GlobalKey が一致していることを確認してください
DataPack のインポートが何も表示せずにロールバックされる	デプロイ時に --verbose を追加し、ロールバックの原因となったレコードとフィールドをログで確認してください
同じバンドル内のファイル間で名前空間が一致しない	1つのペイロード内で %vlocity_namespace% と vlocity_cmt の形式が混在すると、フィールドの解決に失敗します。全体を通して名前空間の形式を1つに統一してください

---

生成時のガードレール（必須）

アンチパターンが見つかった場合は、作業を中断し、続行する前に確認を求めてください。

アンチパターン	問題が発生する理由	必須の修正
ProductCode がない、またはコード値が不安定	見積もり／カートの参照やパッケージの差分に問題が生じます	決定論的なコード規則を使用してください
リレーションに組織固有の ID がハードコードされている	組織や環境をまたいで機能しません	一致するキー／グローバルキーを持つルックアップオブジェクトを使用してください
ルート PCI 行のないオファーバンドル	実行時にバンドルのトラバーサルで問題が発生します	ルートの %vlocity_namespace%__ProductChildItem__c を追加してください
属性のデフォルト値が有効な値に含まれていない	カート設定のデフォルト値が無効になります	デフォルト値が許可された値のセットに存在することを確認してください
同じ属性カテゴリ内に重複した表示順序がある	UI の並び順が競合します	一意で間隔を空けた順序値を徹底してください
子参照が不完全なままオファーが有効化されている	実行時にバンドルが機能しません	有効化する前に、子リンクのセットを完成させ、検証してください
命名スタイル（snake_case、独自の略語など）が混在している	保守性と見つけやすさが低下します	references doc の命名規則を徹底してください

---

スコアリングモデル（120ポイント）

6カテゴリのルーブリックとカテゴリごとの基準の全容については、references/scoring-model.md を参照してください。

カテゴリ	ポイント
カタログの識別と命名	20
EPC 製品構造	20
属性モデリング	25
オファーバンドルの構成	25
DataPack の整合性	15
ドキュメントと引き継ぎ	15
合計	120

---

CLI と検証コマンド

組織内の EPC アーティファクトを調査・検証する sf CLI クエリについては、scripts/cli-validation-commands.sh を参照してください。実行前に <org> を認証済み組織のエイリアスに置き換えてください。

---

スキル呼び出しコマンドの例

一般的な EPC モデリングタスクを網羅した呼び出し例については、scripts/sample-invocations.sh を参照してください。異なる場合は、cursor-agent をローカルのエージェントコマンドラッパーに置き換えてください。

---

参考ファイル一覧

ファイル	読むタイミング
assets/product2-offer-template.json	フェーズ 2 — 新しい Product2 オファーレコードの基本構造
assets/attribute-assignment-template.json	フェーズ 3 — 属性割り当ての構造
assets/product-child-item-template.json	フェーズ 4 — ルートおよび子 PCI 行の構造
assets/pricebook-entries-template.json	フェーズ 4B — 価格表エントリの関連ファイル
assets/price-list-entries-template.json	フェーズ 4B — 価格リストエントリの関連ファイル
assets/object-field-attributes-template.json	フェーズ 4B — オブジェクトフィールドマッピングの関連ファイル
assets/orchestration-scenarios-template.json	フェーズ 4B — オーケストレーションシナリオの関連ファイル
assets/decomposition-relationships-template.json	フェーズ 4B — 分解関係の関連ファイル
assets/compiled-attribute-overrides-template.json	フェーズ 4B — コンパイル済み属性のオーバーライドの関連ファイル
assets/override-definitions-template.json	フェーズ 4B — オーバーライド定義の関連ファイル
assets/parent-keys-template.json	フェーズ 4B — 親キーの関連ファイル
assets/completion-block-template.txt	フェーズ 5 — 引き継ぎ要約ブロックのテンプレート
assets/examples/samsung-galaxy-s22-bundle/	フェーズ 4 — バンドルオファーの例。まず *_DataPack.json と *_ProductChildItems.json を読み込み、必要に応じて関連ファイルを読み込みます
assets/examples/business-internet-premium-fttc-simple-offer/	フェーズ 4 — シンプルなオファー（FTTC）の例。まず *_DataPack.json と *_AttributeAssignments.json を読み込みます
assets/examples/business-internet-premium-fttc-simple-offer/Business-Internet-Premium-FTTC_RuleAssignments.json	フェーズ 4 — FTTC オファーのルール割り当ての例。ルールベースの属性制約をモデル化するときに読み込みます
assets/examples/business-internet-pro-vpl-simple-offer/	フェーズ 4 — シンプルなオファー（Pro VPL）の例。まず *_DataPack.json と *_AttributeAssignments.json を読み込みます
assets/examples/static-ip-simple-offer/	フェーズ 4 — シンプルなオファー（Static IP）の例。まず *_DataPack.json と *_AttributeAssignments.json を読み込みます
examples/business-internet-plus-bundle/	フェーズ 4 — 手順ごとのトランスクリプト付きの生成済みバンドルの例。まず TRANSCRIPT.md を読み込み、次にその中で参照されている特定の JSON ファイルを読み込みます
references/epc-field-guide.md	フェーズ 2 および 3 — EPC のフィールドレベルのガイダンスとよくある落とし穴
references/naming-conventions.md	フェーズ 2 および 3 — 命名規則とキー付けの規則
references/scoring-model.md	フェーズ 5 — カテゴリごとの基準を含む、全 6 カテゴリの評価基準
scripts/cli-validation-commands.sh	フェーズ 5 — 組織内の EPC アーティファクトを検証する sf CLI クエリ
scripts/sample-invocations.sh	開始時 — 一般的な EPC タスクの呼び出し例

---

スキル間の連携

スキル元	omnistudio-epc-catalog-generate 宛て	タイミング
omnistudio-dependencies-analyze	-> omnistudio-epc-catalog-generate	まず最新の依存関係と名前空間の一覧が必要な場合
platform-custom-object-generate / platform-custom-field-generate	-> omnistudio-epc-catalog-generate	EPC のモデリング前にオブジェクトまたはフィールドの準備状況を確認する必要がある場合
platform-soql-query	-> omnistudio-epc-catalog-generate	既存カタログのクエリ分析が必要な場合

omnistudio-epc-catalog-generate 元	スキル宛て	タイミング
omnistudio-epc-catalog-generate	-> omnistudio-omniscript-generate	モデル化したカタログを使用してガイド付き販売 UX を設定する
omnistudio-epc-catalog-generate	-> omnistudio-integration-procedure-generate	商品および価格のペイロードを対象とするサーバーサイドのオーケストレーションを構築する
omnistudio-epc-catalog-generate	-> platform-metadata-deploy	検証済みのカタログメタデータをデプロイする

---

外部参照

ローカルの参照資料：

• references/epc-field-guide.md — EPC のフィールドレベルのガイダンスと必須フィールド
• references/naming-conventions.md — 商品、属性、バンドルの命名規則とキーの規則

---

注意事項

• このスキルは意図的に DataPack を優先し、vlocity/Product2/... アーティファクトの作成に最適化されています。
• 移植性を維持するため、テンプレート内の %vlocity_namespace% プレースホルダーはそのままにしてください。
• まず再利用可能な仕様商品を作成し、その後、子リレーションシップを介してオファーを組み立ててください。

---