sf-flow: Salesforce Flow作成と検証

このスキルは、ユーザーがFlow設計またはFlow XMLの作業が必要な場合に使用します：レコード連動、画面、自動起動、スケジュール済み、またはプラットフォームイベントFlow。検証、アーキテクチャの選択、および安全なデプロイメントシーケンスを含みます。

このスキルがタスクを担当する場合

sf-flowは以下の作業に使用します：

• .flow-meta.xmlファイル
• Flow Builderアーキテクチャとxml生成
• レコード連動、画面、スケジュール済み、自動起動、またはプラットフォームイベントフロー
• Flow固有のバルク安全性、フォルトパス、およびサブフロー編成

以下の場合は他に委譲します：

• Apex優先の自動化を記述 → sf-apex
• オブジェクト/フィールドを最初に作成 → sf-metadata
• メタデータをデプロイ → sf-deploy
• デプロイ後のテストデータをシード → sf-data

---

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

以下を質問するか推定します：

• フロータイプ
• トリガーオブジェクト/エントリ条件
• コア業務目標
• これが新規、リファクタ、または修復であるかどうか
• デプロイまたは検証が必要な場合のターゲットorgエイリアス
• 関連オブジェクト/フィールドが既に存在するかどうか

---

推奨ワークフロー

1. 正しい自動化ツールを選択する

構築前に、Flow以外の以下の選択肢がないか確認します：

• 数式フィールド
• 検証ルール
• ロールアップサマリー
• Apex

2. 正しいFlowタイプを選択する

必要な機能	デフォルトFlowタイプ
保存前の同一レコード更新	保存前レコード連動
関連レコード作業/メール/呼び出し	保存後レコード連動
ガイド付きUI	画面フロー
再利用可能なバックグラウンドロジック	自動起動/サブフロー
スケジュール済み処理	スケジュール済みフロー
イベント駆動宣言型応答	プラットフォームイベントフロー
AI評価ルーティング（感情、意図、トーン）	AI Decision要素を持つ自動起動

3. テンプレートから開始する

提供されているアセットを優先します：

• assets/record-triggered-before-save.xml
• assets/record-triggered-after-save.xml
• assets/screen-flow-template.xml
• assets/autolaunched-flow-template.xml
• assets/scheduled-flow-template.xml
• assets/platform-event-flow-template.xml
• assets/ai-decision-template.xml
• assets/subflows/

4. Flowガードレールに対して検証する

以下に焦点を当てます：

• ループ内のDMLなし
• ループ内のGet Recordsなし
• 適切なフォルトパス
• 正しいトリガー条件
• 安全なサブフロー構成
• AI Decision要素がループ内に配置されていない（反復ごとのクレジットコスト）
• AI Decisionプロンプトにデータコンテキスト用のマージフィールド参照を含む

5. デプロイメントとテストに引き継ぐ

以下を使用します：

• sf-deploy デプロイ/ドライラン用
• sf-data 高ボリュームテストデータ用

---

高シグナルルール

Flowアーキテクチャ

• 保存前：同一レコードフィールド更新用
• 保存後：関連レコード、メール、呼び出し用
• $Recordをループしない
• ロジックが複雑または反復的になったときはサブフローを使用

バルク安全性

• ループ内のDMLなし
• ループ内のGet Recordsなし
• バルク動作が重要な場合は251+レコードでテストする
• レコード単位の分岐ではなくデータ成形が目的の場合はTransformを優先

エラーハンドリング

• データ変更するすべてのパスにはフォルトハンドリングが必要
• 自己参照フォルトコネクタを回避
• 起動リスクが大きい場合はFlowをドラフトとしてデプロイ

---

出力フォーマット

完了時は以下の順序でレポートします：

1. Flowタイプと目標
2. 作成または更新されたファイル
3. アーキテクチャの選択
4. バルク/エラーハンドリング注記
5. デプロイ/テストの次のステップ

推奨される形式：

Flow: <name>
Type: <flow type>
Files: <paths>
Design: <trigger choice, subflows, key decisions>
Risks: <bulk safety, fault paths, dependencies>
Next step: <dry-run deploy, activate, or test>

---

Flow テスト (CLI)

VS CodeなしでコマンドラインからFlowテストを実行します：

# すべてのflowテストを実行
sf flow run test --target-org <alias> --json

# 特定のflowのテストを実行
sf flow run test --class-names MyFlow --target-org <alias> --json

# 非同期実行の結果を取得
sf flow get test --test-run-id <id> --target-org <alias> --json

Flowテストは orgで実行され、1～5分かかります。sf flow run testは非同期実行のテスト実行IDを返します。後でsf flow get testを使用して結果を取得します。常に--jsonで実行し、より長い実行にはバックグラウンド実行を使用します。

---

クロススキル統合

必要な作業	委譲先	理由
オブジェクト/フィールドを最初に作成	sf-metadata	スキーマの準備状況
flowをデプロイ/起動	sf-deploy	安全なデプロイメントシーケンス
リアルなバルクテストデータを作成	sf-data	デプロイ後の検証
Apexアクション/呼び出し可能オブジェクトを作成	sf-apex	命令型ロジック
LWCを画面flowに埋め込む	sf-lwc	カスタムUIコンポーネント
FlowをAgentforceに公開	sf-ai-agentscript	エージェントアクション編成

---

リファレンスマップ

ここから開始

• references/flow-best-practices.md
• references/flow-quick-reference.md
• references/orchestration.md
• references/testing-guide.md

設計/編成

• references/subflow-library.md
• references/governance-checklist.md
• references/transform-vs-loop-guide.md
• references/orchestration-guide.md
• references/orchestration-parent-child.md
• references/orchestration-sequential.md
• references/orchestration-conditional.md

AI Decision

• references/ai-decision-guide.md

画面/統合/トラブルシューティング

• references/form-building-guide.md
• references/integration-patterns.md
• references/lwc-integration-guide.md
• references/agentforce-flow-integration.md
• references/xml-gotchas.md
• references/testing-checklist.md
• references/wait-patterns.md
• assets/

---

スコアガイド

スコア	意味
88+	本番環境対応Flow
75–87	優れたFlowですが、いくつかの確認項目あり
60–74	機能的だが、より強力なガードレールが必要
< 60	デプロイメント向けに安全でない/不完全