sf-metadata: Salesforce Metadata Generation and Org Querying

このスキルを使用するのは、ユーザーがメタデータ定義または組織メタデータの検出を必要としている場合です: カスタムオブジェクト、項目、検証ルール、レコードタイプ、ページレイアウト、権限セット、または sf CLI を使用したスキーマ検査。

このスキルがタスクを所有する場合

以下の作業に sf-metadata を使用します:

• オブジェクト、項目、検証ルール、レコードタイプ、レイアウト、プロフィール、または権限セットのメタデータ
• .object-meta.xml、.field-meta.xml、.profile-meta.xml およびその他の関連メタデータファイル
• コードまたは Flow の作業前のスキーマ記述
• 要件からのメタデータ XML 生成

以下の場合は他のスキルに委譲します:

• メタデータ定義ではなくアクセス権限の分析 → sf-permissions
• メタデータのデプロイ → sf-deploy
• Flow XML の編集 → sf-flow

---

最初に収集すべき必須コンテキスト

以下を確認または推論します:

• ユーザーが生成またはクエリを望んでいるかどうか
• 関連するメタデータタイプ
• 対象のオブジェクト / 項目 / パッケージディレクトリ
• クエリが必要な場合の対象の組織エイリアス
• 新しいカスタムオブジェクトまたは項目に権限セット / FLS 生成も含める必要があるかどうか

ユーザーが明示的に除外しない限り、新しいカスタムオブジェクトまたは項目には権限セットのフォローアップが必要であると想定します。

---

推奨ワークフロー

1. モードを選択する

モード	使用する場合
generation	ユーザーが新規または更新されたメタデータ XML を望んでいる
querying	ユーザーがオブジェクト / 項目 / メタデータの検出を必要としている

2. テンプレートまたは CLI describe データから開始する

生成の場合、以下のアセットを使用します:

• assets/objects/
• assets/fields/
• assets/permission-sets/
• assets/profiles/
• assets/record-types/
• assets/validation-rules/
• assets/layouts/

クエリの場合、sf metadata および sobject describe コマンドを優先します。

古い例を読むときに知っておく価値のある最近の SDR/CLI サポート: CnfgItemSourceDefinition、ExtlClntAppOauthSecuritySettings、および UIBundle は現在の名前の下でソースサポートされています。references/metadata-types-reference.md を参照してください。

3. メタデータの品質を検証する

確認事項:

• ネーミング規約
• 構造の正確性
• 項目タイプの適合性
• セキュリティ / FLS への影響
• 後続のデプロイ依存関係

4. デフォルトで権限影響を計画する

新しいカスタム項目またはオブジェクトが作成される場合:

• ユーザーが除外しない限り、デフォルトで権限セットを生成または更新する
• 適格なカスタム項目に対して fieldPermissions を含める
• Salesforce がシステム管理またはいつでも利用可能として扱うため除外されるメタデータカテゴリに注記する
• オブジェクト CRUD だけではカスタム項目が表示されるわけではないことを覚えておく

5. デプロイに引き継ぐ

ユーザーがメタデータをロールアウトする必要がある場合は、sf-deploy を使用します。

---

高シグナルルール

• フィールドレベルセキュリティはデプロイ後の隠れたブロッカーであることが多い
• オブジェクト権限 ≠ フィールド権限
• プロフィール中心のアクセスパターンより権限セットを優先する
• 新しいカスタムオブジェクトと項目に対してデフォルトで権限セットのフォローアップを生成する
• FLS を手動の後付けのまま放置するのではなく、適格なカスタム項目に対して fieldPermissions を含める
• 数式またはメタデータロジックでハードコードされた ID を避ける
• 検証ルールは運用上必要な場合の意図的なバイパス戦略を持つべき
• Flow またはそれに依存するデータタスクを試みる前にメタデータを作成する

---

出力形式

完了時に、この順序で報告します:

1. 作成またはクエリされたメタデータ
2. 作成または更新されたファイル
3. 主要なスキーマ/セキュリティ決定
4. 権限 / レイアウトのフォローアップ
5. デプロイ次のステップ

推奨される形式:

Metadata task: <generate / query>
Items: <objects, fields, rules, layouts, permsets>
Files: <paths>
Notes: <naming, field types, security, dependencies>
Next step: <deploy, assign permset, or verify in Setup>

---

クロススキル統合

必要事項	委譲先	理由
メタデータをデプロイ	sf-deploy	ロールアウトと検証
新しいスキーマで Flow を構築	sf-flow	宣言型自動化
新しいスキーマで Apex を構築	sf-apex	メタデータに対するコード
作成後のアクセス権限を分析	sf-permissions	アクセス監査
デプロイ後にデータをシード	sf-data	テストデータ作成

---

リファレンスマップ

ここから開始

• references/field-and-cli-reference.md
• references/metadata-types-reference.md
• references/naming-conventions.md
• references/orchestration.md

セキュリティ / スコアリング / 例

• references/fls-best-practices.md
• references/permset-auto-generation.md
• references/best-practices-scoring.md
• references/field-types-guide.md
• references/field-types-example.md
• references/custom-object-example.md
• references/permission-set-example.md
• references/profile-permission-guide.md
• references/sf-cli-commands.md
• assets/

---

スコアガイド

スコア	意味
108+	本番環境対応の強固なメタデータ
96–107	わずかな確認事項があるが良好なメタデータ
84–95	許容可能だが慎重に検証する
< 84	修正されるまでデプロイをブロック