modeling-omnistudio-epc-catalog

modeling-omnistudio-epc-catalog: 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 の設計（building-omnistudio-omniscript、building-omnistudio-flexcard、または building-omnistudio-integration-procedure を使用）、Apex ビジネスロジックの実装（generating-apex を使用）、デプロイパイプラインのトラブルシューティング（deploying-metadata を使用）

---

クイックリファレンス

• 主要オブジェクト：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 = エンタープライズ製品カタログ | CME = 通信、メディア、エネルギー | 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 Items を含む Product2 オファーのセットアップをユーザーが依頼している。
   • テンプレート／例からバンドルの DataPack JSON アーティファクトを生成するようユーザーが依頼している。

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

   • 既存の EPC バンドルの採点、評価、検証、監査をユーザーが依頼している。
   • 既存の Product2／ProductChildItem（PCI）／属性ペイロードに 120 点満点の評価基準を適用するようユーザーが依頼している。
   • バンドルメタデータに関するリスクの指摘、品質上の不足、修正の推奨事項をユーザーが求めている。

指示の優先順位：プロンプトが短く、EPC という名前が含まれていない場合でも、この 2 つの意図に該当する場合は modeling-omnistudio-epc-catalog を直接呼び出してください。

---

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

フェーズ 0：前提条件

続行する前に、以下を確認してください。

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

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

---

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

次の情報を確認します。

• 製品タイプ：スペック製品またはオファーバンドル
• ドメイン分類：ファミリー、タイプ／サブタイプ、カテゴリーパス、チャネル
• 属性要件：必須／任意、選択リストの値、デフォルト値
• バンドルの構成：子製品、数量制約、任意／必須
• 対象組織の名前空間モデル：%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 タスクの実行例

---

スキル間の連携

元のスキル	modeling-omnistudio-epc-catalog の利用先	タイミング
analyzing-omnistudio-dependencies	-> modeling-omnistudio-epc-catalog	まず現在の依存関係と名前空間の一覧が必要な場合
generating-custom-object / generating-custom-field	-> modeling-omnistudio-epc-catalog	EPC のモデル化に先立ち、オブジェクトまたはフィールドの準備状況を確認する場合
querying-soql	-> modeling-omnistudio-epc-catalog	既存カタログのクエリ分析が必要な場合

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

---

外部参照

ローカルの参照資料：

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

---

注意事項

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

---