Hlzd Cold Outreach

HLZD Cold Outreach

把"已通过背调的买家名单 + 产品 context"批量变成可发的开发信 + 跟进序列。

When to use

调用本 Skill 当用户：

• 拿到 hlzd-customer-due-diligence 的 grade A/B 买家清单
• 想批量生成邮件草稿（不是自动发）
• 想要 en + es 双语（西语国家覆盖拉美 / 西班牙 / 部分美国客户）
• 跟进 7/14 天未读 → 自动 day_7 / day_14 邮件

不要调用本 Skill 当：

• 想自动 send（v0.1 只生成草稿，不发）；发邮件请用 SendGrid / Mailgun 单独 Skill（v0.2 计划）
• 客户已在合作（v0.1 针对 cold outreach）
• 询盘评级 B+ 但已经在你的 CRM 跟进中

How this skill is invoked

# 接 diligence 输出
py scripts/cli.py --input diligence.json \
    --product "OCTG casing" \
    --sender-company "HLZD" \
    --sender-name "Alex" \
    --output outreach.json --pretty

# 手动指定 buyer + product context
cat << 'EOF' | py scripts/cli.py --stdin --product "Solar Panel"
[{"importer_name": "Sun Co", "country": "US", "customer_type": "Distributor"}]
EOF

CLI 参数：

Template system

6 类买家 × 2 种语言 = 12 个模板：

每模板含：subject / opening / value_prop / cta / signature 四段。

变量替换

模板里变量 {{var}} 来自 3 层 merge：

1. Built-in defaults（HLZD 营业默认值）
2. product_context（CLI 传的）
3. Buyer-derived：recipient_company / recipient_region / sector / project_name / contact_name

未知变量保留 {{var}} 占位，运行后输出会列在 missing_variables[]。

Output schema

{
  "$schema": "hlzd/cold-outreach/v1-batch",
  "default_language": "en",
  "default_customer_type": "Manufacturer",
  "generated": 3,
  "failed": 0,
  "emails": [
    {
      "email": {
        "to": {"company": "Aramco", "contact": "Mr. Ahmed", "country": "Saudi Arabia"},
        "language": "en",
        "customer_type_used": "EPC",
        "subject": "EPC partner for your project - OCTG casing supply",
        "body": "Dear Mr. Ahmed,\n\nWe understand Aramco is executing your project...",
        "word_count": 69,
        "within_word_limit": true,
        "missing_variables": ["past_project_references"]
      },
      "followup_sequence": [
        {"day": 7, "subject": "Re: ...", "body": "...", "word_count": 32},
        {"day": 14, "subject": "Closing the loop - ...", "body": "...", "word_count": 25}
      ],
      "recommendation_next_step": "hlzd-cold-outreach"
    }
  ],
  "errors": []
}

Word limits

within_word_limit: bool 字段辅助检查。不会硬阻断，仅 advisory（人工 review 时关注）。

Sample integration

# 1. 找买家
py ../hlzd-buyer-finder/scripts/cli.py --product "OCTG casing" --country SA

# 2. 背调
py ../hlzd-customer-due-diligence/scripts/cli.py --input buyers.json

# 3. 写邮件
py scripts/cli.py --input diligence.json \
    --product "OCTG casing" --sender-company "HLZD" \
    --output outreach.json --pretty

完整闭环：调研 → 买家 → 背调 → 邮件。

Voice Contract (继承自 hlzd-market-report)

继承 LAWS：

• LAW 1 / LAW 2 (em-dash → -) 已强制
• LAW 3 (inline link) — 邮件正文未强制（邮件体格式更灵活）
• LAW 5 (claim 需 evidence) — 模板中 [past project references] 占位让人工填证据
• LAW 7 (no brand assumption) — 默认 sender 用 cli 参数显式指定，不假设

Anti-patterns / Limitations

Related Skills

┌────────────────────────┐
│  hlzd-customer-due-    │  ← 上游：buyer A/B 级
│  diligence              │
└────────────┬───────────┘
             │
             ▼
┌────────────────────────┐
│ ★ hlzd-cold-outreach ★ │  ← 本 Skill
│  5 类模板 + 跟进序列    │
└────────────────────────┘
             │
             ├── 内部流转：人工 review + SendGrid
             └── v0.2：自动 send / 多语种 / LinkedIn template

前置：hlzd-customer-due-diligence（Grade A/B 买家） 后继：人工 review + 邮件 send 工具

Versioning

Crafted for B2B industrial exporters — HLZD Cross-Border AI Platform · 2026