邮件外联自动化 Skill

本 Skill 提供一套可复用的邮件外联流程与脚本：

• 输入联系人（CSV）
• 使用可读模板（支持 {{变量}} 合并）
• 选择发送提供方（SMTP / SendGrid / Mailgun；Gmail/Outlook 支持见参考）
• 节流（每分钟/每小时限速）、重试与结果日志
• 合规与送达最佳实践（退订语/域名与身份配置）

适用触发语示例（供模型触发参考）

• “邮件外联自动化/发外联邮件/批量发邮件”
• “把这份 CSV 的联系人发一封模板邮件”
• “用 SMTP/SendGrid/Mailgun/Gmail 发外联，注意限流和退订”
• “生成第一封冷启动外联模板并发送”

快速开始

1. 准备数据与模板

• CSV 格式参考：see references/csv-format.md（至少包含 email 列，建议 name/company 等）
• 邮件模板：支持 {{name}}、{{company}} 等占位符（示例见 assets/templates/first-touch.txt）

2. 选择发送方式

• SMTP：配置主机、端口、用户名/密码（或 App Password），支持 STARTTLS
• ESP（SendGrid/Mailgun）：准备 API Key（见 references/templates.md 中的示例与说明）
• Gmail/Outlook：推荐使用 OAuth 或 App Password（见 references/tips.md）

3. 运行脚本（使用 uv 调用 Python）

• 示例（SMTP）： uv run python skills/outreach-pipeline/scripts/send.py
  --csv path/to/contacts.csv
  --template skills/outreach-pipeline/assets/templates/first-touch.txt
  --subject "你好 {{name}}，关于{{company}}的合作想法"
  --from-name "你的姓名"
  --from-email "you@your-domain.com"
  --provider smtp
  --smtp-host smtp.your-domain.com
  --smtp-port 587
  --smtp-user you@your-domain.com
  --smtp-pass ""
  --rate-limit 15
  --out-log out/send_results.csv

• 示例（SendGrid）： 设置环境变量 SENDGRID_API_KEY 后： uv run python skills/outreach-pipeline/scripts/send.py
  --csv path/to/contacts.csv
  --template skills/outreach-pipeline/assets/templates/first-touch.txt
  --subject "Hi {{name}}"
  --from-name "你的姓名"
  --from-email "you@your-domain.com"
  --provider sendgrid
  --rate-limit 25

4. 查看结果

• 发送过程与每个收件人的状态写入 --out-log 指定的 CSV（默认 send_results.csv）

输入约定

• CSV 标题至少包含：email；可选列将作为模板变量（如 name/company/title 等）
• 模板文件为纯文本或轻度 Markdown，变量格式 {{var}}
• 主题也支持 {{变量}} 合并

核心动作（给调用者的流程指引）

• 校验输入：CSV 列、模板变量、主题变量是否匹配（缺失变量将置为空字符串）
• 发送策略：
  • 节流：--rate-limit（每分钟最多 N 封），避免触发提供方或 ISP 限制
  • 批次控制：--max-per-run 限制本次运行数量；先小批测试（如 10 封）再放大
  • 重试：轻度网络错误可在脚本层面第2次尝试；硬错误记录日志并跳过
• 退订与合规：
  • 模板底部附上退订说明（见 references/risks.md）
  • 优先使用独立域名、正确的 From/Reply-To、SPF/DKIM/DMARC 合规（见 references/tips.md）

提供方说明（摘要）

• SMTP：通用，适合小批量与自有域；需配置 SPF/DKIM 提升送达
• SendGrid/Mailgun：适合批量与稳定送达；使用 API Key；注意速率与信誉
• Gmail/Outlook：建议 App Password 或 OAuth；免费额度有限，节流严格

目录结构

• scripts/send.py — 主脚本（CSV 导入、模板合并、SMTP/ESP 发送、节流、日志）
• references/
  • csv-format.md — CSV 列格式说明与示例
  • tips.md — 送达与账号配置（SPF/DKIM/DMARC、OAuth/App Password）
  • risks.md — 合规、反垃圾与退订建议
  • templates.md — 模板与变量示例、常见序列骨架
• assets/templates/first-touch.txt — 冷启动外联模板示例

注意与限制

• 本 Skill 不提供“邮箱列表抓取/购买”；仅面向有来源与同意基础的 B2B 合法外联
• 法规合规：遵守当地法律（例如 CAN-SPAM/GDPR/各平台政策）；不可群发骚扰邮件
• 初次运行请用自己的邮箱进行自测（3–5 封）确认显示与追踪无误

示例交互

• 用户：“把这份 contacts.csv 的联系人用 SMTP 发一封冷启动外联，速率 10/分钟，主题和正文按模板。”
• 代理：校验 CSV→渲染 3 封样例→提示确认→开始发送→输出日志路径与统计

扩展

• 如需序列化跟进（Day 1/3/7），可用 cron 或外部调度每次调用脚本并传入不同模板与过滤条件。