waterfall-blueprint について
複数のプロバイダーにレコードを振り分けるデータエンリッチメントのワークフローを設計・文書化するスキルです。RevOpsとエンジニアリングチームが、利用順序、フォールバック、安全策、変更履歴を定めるのに役立ちます。
主な機能
- 01エンリッチメントの目標と制約の定義
- 02プロバイダー、成功率、遅延、コンプライアンス情報の整理
- 03ルーティング、分岐、再試行間隔の設計
- 04スロットリング、重複排除、例外条件の設定
- 05変更、承認、適用日の記録
活用シーン
- 01連絡先や企業のエンリッチメント構築
- 02障害やコスト変化後のフォールバック更新
- 03RevOpsとエンジニアリング向けのルーティング文書化
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/waterfall-blueprintを入力して読み込まれたか確認します。
詳細
ウォーターフォール設計スキル
使用する場面
- 複数のプロバイダーをまたぐ連絡先／企業情報のエンリッチメントワークフローを構築するとき。
- プロバイダーの障害やコストの変化を受けて、フォールバックルールを更新するとき。
- RevOps とエンジニアリング間の引き継ぎ用に、ウォーターフォールのロジックを文書化するとき。
フレームワーク
- 目標と制約 – エンリッチメントの種類、データ要件、クレジット上限、SLA を定義します。
- プロバイダーカタログ – 対象となるプロバイダーを、成功率、レイテンシ、コンプライアンスに関する注記とともに列挙します。
- ルーティングロジック – 順序、分岐、再試行の間隔を決定します。
- セーフガード – スロットリング、重複排除チェック、例外のトリガーを設定します。
- バージョン管理 – 変更、承認、有効日を記録します。
テンプレート
- ウォーターフォール図（順序、入力、出力、フォールバック経路）。
- ルーティングテーブル（プロバイダー、条件、コスト、注記）。
- 担当者と変更理由を記載した変更履歴。
ヒント
- リアルタイムのユースケースでは順序を短く保ち、長いチェーンはバッチモード用に確保します。
- 新しいプロバイダーは、全面導入の前に A/B テストで検証します。
provider-scorecardと組み合わせて、ルーティングを継続的に最適化します。
コメント
Markdown 対応