【備忘録】Metadata API Context SkillでAIにSalesforceメタデータの根拠を渡す

Salesforce 開発で AI コーディング支援を使うときの落とし穴は、Apex や SOQL よりも Metadata API の XML だ。これは単なる XML ではなく、各メタデータ型ごとに必須項目・枚数上限・名前空間・デプロイ時の制約がぎっしり詰まっている。CustomObject、Flow、PermissionSet、Profile といった要素は見た目は XML でも、一つの要素を落とすか階層を誤るだけで本番デプロイは失敗する。Salesforce 公式ブログでは、こうした課題に対して Metadata API Context Skill を紹介している。これは AI に Salesforce Metadata API の完全な根拠資料を渡すための Skill で、604個のメタデータ型の定義・フィールド・必須/任意・enum 値・XML 構造・WSDL・サンプル・配置ディレクトリなどを参照できる。 AI の鬼が注目するのは、このスキルの「渡し方」だ。Metadata API Context Skill は、必要なセクションだけを抽出して AI に読ませることを強く推奨している。全メタデータを丸ごと読ませると75,000トークン消費するが、必要な1〜5型に絞り、さらにセクション（fields、examples だけなど）を絞ると 500〜5,000トークンで済むという。これは単なる効率ではなく、根本的な安全設計だ。AI がハルシネーションしやすい環境を人間側で絞り込む。つまり「AI に生成させる前に、人間がまずスコープを決める」という責任分界がはっきりしている。そして最後に deploy validate を人間が走す。この構造なら、AI の便利さと組織の安全を両立できる。 実務への含意は、Salesforce カスタマイズを AI で行うときは「必要な型だけ・必要なセクションだけ」を最初に決めることだ。Flow なら fields だけ、PermissionSet なら classAccesses だけといった具合に。その上で AI に「この情報をもとに修正してください」と指示する。生成されたメタデータは必ず人間が確認し、対象 API バージョンに合っているか、組織固有の設定に依存していないか、deploy validate を走すまで本番には入れない。AI Context Skill は魔法ではなく、人間の確認の前置きを減らすツールに過ぎない。