Salesforce データ操作エキスパート (sf-data)

ユーザーが Salesforce データ操作 を必要とする場合、このスキルを使用します: レコード CRUD、一括インポート/エクスポート、テストデータ生成、クリーンアップスクリプト、または Apex、Flow、統合動作の検証用データファクトリパターン。

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

以下の作業が含まれる場合は sf-data を使用します:

• sf data CLI コマンド
• レコードの作成、更新、削除、upsert、エクスポート、またはツリーのインポート/エクスポート
• リアリスティックなテストデータ生成
• 一括データ操作とクリーンアップ
• データシーディング/ロールバック用の Apex 匿名スクリプト

以下の場合は他へ委任してください:

• SOQL のみ記述 → sf-soql
• Apex テストを実行または修復 → sf-testing
• メタデータを最初にデプロイ → sf-deploy
• スキーマ/フィールド定義を発見 → sf-metadata

---

重要なモード決定

ユーザーが希望するモードを確認してください:

モード	使用する場合
スクリプト生成	org に触れずに再利用可能な .apex、CSV、JSON アセットを求めている場合
リモート実行	実際の org でレコードを今すぐ作成/変更する場合

ユーザーがスクリプトのみを希望している場合は、リモート実行を想定しないでください。

---

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

以下を確認するか推測してください:

• 対象オブジェクト
• org エイリアス(リモート実行が必要な場合)
• 操作タイプ: クエリ、作成、更新、削除、upsert、インポート、エクスポート、クリーンアップ
• 予想ボリューム
• これがテストデータ、マイグレーションデータ、または一度限りのトラブルシューティングデータかどうか
• 最初に存在する必要がある親子関係

---

コア操作ルール

• sf-data は、ユーザーが明示的にローカルスクリプト生成を希望しない限り、リモート org データ に対して機能します。
• オブジェクトとフィールドは、データ作成前に既に存在している必要があります。
• 自動化テストでは、バルク動作が重要な場合は 251+ レコード を推奨します。
• 大規模またはノイズの多いデータセットを作成する前に、常にクリーンアップを検討してください。
• 生成されたテストデータで実在の PII を使用しないでください。
• 直線的な CRUD には CLI-first を推奨; 操作が真にサーバー側のオーケストレーションを必要とする場合は匿名 Apex を使用してください。

メタデータが不足している場合は停止し、以下へ委任してください:

• sf-metadata または sf-deploy

---

推奨ワークフロー

1. 前提条件の確認

オブジェクト/フィールド可用性、org 認証、および必要な親レコードを確認してください。

2. スキーマが不確実な場合は describe-first プレフライト検証を実行

レコードを作成または更新する前に、オブジェクト describe データを使用して以下を検証してください:

• 必須フィールド
• 作成可能 vs 非作成可能フィールド
• ピックリスト値
• 関連性フィールドと親要件

例パターン:

sf sobject describe --sobject ObjectName --target-org <alias> --json

有用なフィルタ:

# 必須 + 作成可能フィールド
jq '.result.fields[] | select(.nillable==false and .createable==true) | {name, type}'

# 1 つのフィールドの有効なピックリスト値
jq '.result.fields[] | select(.name=="StageName") | .picklistValues[].value'

# 作成時に設定できないフィールド
jq '.result.fields[] | select(.createable==false) | .name'

3. 最小の正しいメカニズムを選択

必要な操作	デフォルトアプローチ
小規模な一度限りの CRUD	sf data 単一レコードコマンド
大規模インポート/エクスポート	sf data ... bulk による Bulk API 2.0
親子シードセット	ツリーのインポート/エクスポート
再利用可能なテストデータセット	ファクトリ/匿名 Apex スクリプト
可逆的な実験	クリーンアップスクリプトまたはセーブポイントベースのアプローチ

4. アセットを実行または生成

assets/ の組み込みテンプレートを使用してください(適用可能な場合):

• assets/factories/
• assets/bulk/
• assets/cleanup/
• assets/soql/
• assets/csv/
• assets/json/

5. 結果を検証

作成または更新後、カウント、関連性、およびレコード ID を確認してください。

6. 制限されたリトライ戦略を適用

作成が失敗した場合:

1. 主要 CLI 形式を 1 回試します
2. 修正されたパラメータで 1 回再試します
3. describe を再実行/仮定を検証します
4. 異なるメカニズムにピボットするか、手動での回避策を提供します

同じ失敗コマンドを無限に繰り返さないでください。

7. クリーンアップガイダンスを提供

データが作成されるたびに、正確なクリーンアップコマンドまたはロールバックアセットを提供してください。

---

高シグナルルール

バルク安全性

• 大量のデータに一括操作を使用します
• 適切な場合は 251+ レコードでオートメーション機密動作をテストしてください
• バルクシナリオで 1 レコードずつのパターンを避けてください

データ整合性

• 必須フィールドを含めます
• 作成前にピックリスト値を検証してください
• 親 ID と関連性の整合性を確認してください
• 検証ルールと重複制約を考慮してください
• 入力ペイロードから非作成可能フィールドを除外してください

クリーンアップ規律

次のいずれかを推奨します:

• ID による削除
• パターンによる削除
• 作成日時ウィンドウによる削除
• スクリプトベースのテスト実行用ロールバック/セーブポイントパターン

---

一般的な失敗パターン

エラー	可能性のある原因	デフォルト修正方向
INVALID_FIELD	間違ったフィールド API 名または FLS の問題	スキーマとアクセスを確認してください
REQUIRED_FIELD_MISSING	必須フィールドが省略されている	describe データから必須値を含めてください
INVALID_CROSS_REFERENCE_KEY	悪い親 ID	親を最初に作成/確認してください
FIELD_CUSTOM_VALIDATION_EXCEPTION	検証ルールがレコードをブロック	有効なテストデータを使用するか、セットアップを調整してください
無効なピックリスト値	describe-backed 値の代わりに推測値	まずピックリスト値を検査してください
書き込み不可フィールドエラー	フィールドが作成不可/更新不可	ペイロードから削除してください
バルク制限/タイムアウト	ボリュームに対する間違ったツール	バルク/段階的インポートに切り替えてください

---

出力形式

完了時に、この順序でレポートしてください:

1. 実行された操作
2. オブジェクトと数
3. ターゲット org またはローカルアーティファクトパス
4. レコード ID/出力ファイル
5. 検証結果
6. クリーンアップ指示

推奨される形式:

データ操作: <create / update / delete / export / seed>
オブジェクト: <object + counts>
ターゲット: <org エイリアスまたはローカルパス>
アーティファクト: <record ids / csv / apex / json files>
検証: <passed / partial / failed>
クリーンアップ: <正確な削除またはロールバックガイダンス>

---

クロススキル統合

必要な操作	委任先	理由
オブジェクト/フィールド構造を発見	sf-metadata	正確なスキーマの根拠
バルク機密 Apex 検証を実行	sf-testing	テスト実行とカバレッジ
不足しているスキーマを最初にデプロイ	sf-deploy	メタデータの準備
データを消費する本番ロジックを実装	sf-apex または sf-flow	動作実装

---

リファレンスマップ

ここから始めてください

• references/sf-cli-data-commands.md
• references/test-data-best-practices.md
• references/orchestration.md
• references/test-data-patterns.md
• references/test-data-factory-usage.md

クエリ/バルク/クリーンアップ

• references/soql-relationship-guide.md
• references/relationship-query-examples.md
• references/bulk-operations-guide.md
• references/cleanup-rollback-guide.md
• references/cleanup-rollback-example.md

例/制限

• references/crud-workflow-example.md
• references/bulk-testing-example.md
• references/anonymous-apex-guide.md
• references/governor-limits-reference.md
• assets/

---

スコアガイド

スコア	意味
117+	強力な本番安全データワークフロー
104–116	改善の余地がある良好な操作
91–103	許容可能だがレビュー推奨
78–90	危険なパターンが存在する部分的操作
< 78	修正まで実施禁止