blitz-gtm-brainstorm

Blitz GTM ブレインストーミング

あいまいなGTMの目標を、正確で検証済みの GTMブリーフ（gtm-brief.yaml）に変換します。 blitz-create-script がこれを実行可能なスクリプトにコンパイルし、気付かないまま失敗することはありません。Blitzは、3億8,000万人以上のLinkedInベースのデータセットから、検証済みのB2B意思決定者を返します。ブリーフは仕様書です。

クイックスタート

ユーザーに目標を一文で尋ねます（「米国のシリーズBのSaaS企業で営業責任者にリーチする」など）。次に、以下の手順を進めて gtm-brief.yaml を出力します。ここではコードを書かないでください。それは blitz-create-script の役目です。

以下の scripts/ と references/ のパスは、このスキルのディレクトリを基準としています。ヘルパーはユーザーのプロジェクトルートではなく、そのディレクトリから実行してください（例：bash <skill-dir>/scripts/pull_enums.sh list）。

ワークフロー

1. アプローチとエンドポイントを選びます。 目標をちょうど1つのエンドポイントに対応付けます。詳細とリクエスト形式については、references/endpoint-decision.md を参照してください。

   • 多数の企業をICPで検索 → Find People（/v2/search/people）
   • 指定した1社で最適な意思決定者を検索 → Waterfall ICP（/v2/search/waterfall-icp-keyword）
   • 1社の全従業員を検索 → Employee Finder（/v2/search/employee-finder）
   • 人ではなく企業を検索 → Company Search（/v2/search/companies）

2. フィルターを下書きします — 想起率を優先します。 まず references/strategy.md を読み、ほぼすべてのレコードに含まれる密度の高いフィールドを軸にします。job_title（全文検索 — 同義語、長短の表記、多言語の表記を幅広く含めます）、会社の keywords（説明を検索）、都市、従業員数、min_connections を使います。疎な列挙値（industry、job_level、job_function、type、revenue）は、精度を調整するためにのみ追加します。いずれもタグ付け済みのレコードだけに絞り込み、結果を気付かないうちに大幅に減らす可能性があります。選択したエンドポイントで使うキーだけを設定してください。

3. 使用する列挙値はすべて、その場で検証します。 大文字と小文字を区別する列挙値に誤りがあると、結果が0件になります（"SaaS" ≠ "Software Development"）。ブリーフ内の各 industry／job_level／job_function／employee_range／sales_region／country_code／type の値について、bash scripts/pull_enums.sh search <enum> "<value>" で完全一致を確認してください（例：search industry "health"。list ですべての列挙値を表示し、小規模なものは get <enum> で一覧を取得できます）。一致しない値はユーザーと修正します。このスクリプトはBlitz OpenAPI仕様から最新の値を取得します。SDKが列挙値を生成する際に使うものと同じ情報源です。オフラインの場合は、コミット済みの references/enums.json にフォールバックします（古い可能性があるため、再確認してください）。使用する列挙値がすべて一致したら enums_verified: true を設定します（列挙値を使わないキーワードのみの検索は、自動的に検証済みとなります）。これにより入力ミスを防ぎます。列挙値を積極的に使うよう促すものではありません。手順2で説明したキーワードを軸にしてください。

4. 件数を調べ、分割方法を決めます。 次を実行して、total_results（Find People／Company Search）または total_pages（Employee Finder）を確認します。 echo '<request-json>' | BLITZ_API_KEY=... bash scripts/probe_volume.sh /v2/search/people 対象の母集団が取得可能な上限（人物／企業は約5万件、1社あたり約1万件）を超える場合は、volume.exceeds_ceiling: true と partition_plan を設定します。references/volume-and-partition.md を参照してください。

5. エンリッチメント、出力、言語を決めます。 email（あらゆるリード計画で使用）、phone（米国内限定 — 対象が米国以外の場合は警告します）、逆引きを設定します。出力形式：csv／json／stdout。言語：python、typescript、javascript — ユーザーの選択をそのまま記録します（JavaScriptを選んだユーザーに、デフォルトでTypeScriptを選ばないでください）。

6. ブリーフを出力します。 references/gtm-brief-schema.md に従って gtm-brief.yaml を作成し、ユーザーの作業ディレクトリへの保存を提案します。その後、blitz-create-script を実行するようユーザーに伝えます。

ルール

• 使用する列挙値を推測してはいけません。毎回、最新の値を取得して完全に一致させてください（データセットは変更されます）。ただし、列挙値への依存をできるだけ減らすため、密度の高いキーワードのバックボーンを優先してください。
• API キーをブリーフに記載してはいけません。BLITZ_API_KEY / .env のみに保存してください。
• ユーザーがすでに ICP を把握している場合は、先に進んで構いません。ただし、列挙値の検証（ステップ 3）は行ってください。