blitz-gtm-brainstorm

Blitz GTM 头脑风暴

将模糊的 GTM 目标转化为精确且经过验证的 GTM 简报（gtm-brief.yaml），由 blitz-create-script 编译成可运行的脚本，且不会静默失败。Blitz 从基于 LinkedIn、拥有 3.8 亿多个档案的数据集中返回经过验证的 B2B 决策者；简报就是规格说明。

快速开始

让用户用一句话描述目标（“触达美国 B 轮 SaaS 公司的销售负责人”），然后 执行以下步骤并输出 gtm-brief.yaml。不要在这里编写代码——那是 blitz-create-script 的工作。

以下 scripts/ 和 references/ 路径均相对于此技能自身的目录——从该目录运行辅助脚本（例如 bash <skill-dir>/scripts/pull_enums.sh list），而不是从用户的项目根目录运行。

工作流

1. 选择拓客方式和端点。 将目标映射到唯一一个端点。详情和 请求格式见：references/endpoint-decision.md。

   • 按 ICP 搜索多家公司 → Find People（/v2/search/people）
   • 搜索一家指定客户，找到最佳决策者 → Waterfall ICP（/v2/search/waterfall-icp-keyword）
   • 搜索一家公司的所有员工 → 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. 探测数据量并决定是否分区。 运行 echo '<request-json>' | BLITZ_API_KEY=... bash scripts/probe_volume.sh /v2/search/people 读取 total_results（Find People / Company Search）或 total_pages（Employee Finder）。如果 人群超出可触达上限（约 5 万人/家公司，每家公司约 1 万人），设置 volume.exceeds_ceiling: true，并填写 partition_plan。参见 references/volume-and-partition.md。

5. 数据补全、输出和语言。 email（适用于任何潜在客户计划）、phone（仅限美国——如果目标对象不在美国，请提醒用户）、反向查找。输出格式：csv / json / stdout。语言：python、 typescript 或 javascript——按用户选择原样记录（不要默认将选择 JS 的用户设为 TS）。

6. 生成简报。 按照 references/gtm-brief-schema.md 编写 gtm-brief.yaml，并询问用户是否要将其保存到工作目录。然后告知用户运行 blitz-create-script。

规则

• 绝不猜测你使用的枚举值。每次运行时都要实时获取并确保完全匹配（数据集会发生变化）——但应优先使用精简的关键词骨干，这样就能尽量少依赖枚举。
• 绝不要在简介中放入 API 密钥。密钥只保存在 BLITZ_API_KEY / .env 中。
• 如果用户已经了解自己的 ICP，可以跳过前面的步骤——但仍须验证枚举值（步骤 3）。