email-outreach-run

用途

Email Outreach Agent - Run Skill 用于执行自动化的邮件外联活动，支持批量发送带个性化内容的邮件，并内置人工审批流程。适用于向新线索发送冷邮件、向参与者发送培训提醒、对已联系对象进行跟进等场景。

主要能力

三种发送模式：
- CRM 细分模式：通过 --segment 参数按条件筛选 CRM 线索，例如 "stage=new AND product_id=prod-labeling"。
- 手动 CSV 模式：通过 --recipients 指定收件人 CSV 文件。
- AI 生成模式：通过 --ai-mode 由 AI 生成邮件内容，可配合 --subject 指定主题。
模板系统：内置 cold_outreach.txt（新线索）、follow_up.txt（跟进）、training_reminder.txt（活动/培训提醒）等模板，支持占位符 {name}、{first_name}、{last_name}、{company}/{company_name}、{role}。
审批流程：发送前展示收件人数量、主题行和前 3 封示例邮件，提供 [A] 批准发送、[T] 发送测试、[C] 取消并保存草稿三个选项。
速率限制：每天最多 50 封，每封间隔 1-2 秒，同一人同一产品 7 天冷却。
结果输出：摘要保存至 google-tools/data/email_outreach_summaries/YYYY-MM-DD.md，日志保存至 google-tools/data/email_outreach_log.json，CRM 活动追加至 sales/crm/activities.csv，取消时草稿保存至 google-tools/data/email_outreach_drafts/。

使用方式

前置条件：Gmail API 已认证（如需要可先运行 google-auth 技能），CRM 数据可用（sales/crm/），并准备好模板或使用 AI 模式。

执行步骤：

确定活动类型，选择对应命令。CRM 细分模式示例：

cd $AGENTS_PATH/email-outreach
python3 email-outreach_agent.py \
  --segment "stage=new AND product_id=prod-labeling" \
  --template templates/cold_outreach.txt

手动 CSV 模式示例：

python3 email-outreach_agent.py \
  --recipients /path/to/recipients.csv \
  --template templates/training_reminder.txt

AI 生成模式示例：

python3 email-outreach_agent.py \
  --segment "stage=qualified" \
  --ai-mode \
  --subject "Following up on our conversation"

始终先进行 dry-run：

python3 email-outreach_agent.py \
  --segment "..." \
  --template templates/cold_outreach.txt \
  --dry-run

查看审批提示，选择批准、测试或取消。
检查结果：

# Summary
ls -lh $GOOGLE_TOOLS_PATH/data/email_outreach_summaries/

# Agent log
cat $GOOGLE_TOOLS_PATH/data/email_outreach_log.json | jq '.[-1]'

# CRM activities
tail -10 $CRM_PATH/activities.csv

手动 CSV 格式要求：必需列为 email，可选列为 first_name、last_name、company_name、person_id、product_id。示例：

email,first_name,last_name,company_name
john@example.com,John,Doe,Example Corp
jane@test.com,Jane,Smith,Test Inc

适用场景

冷外联：向新线索发送冷邮件，例如 --segment "stage=new AND product_id=prod-labeling" --template templates/cold_outreach.txt --campaign-name "Q1 Cold Outreach - Labeling"。
培训提醒：使用手动 CSV 列表发送提醒。
AI 生成跟进：对已合格线索使用 --ai-mode 生成跟进邮件。

限制与注意事项

所有外联均需人工审批。
速率限制为每天最多 50 封，每封间隔 1-2 秒，同一人同一产品 7 天冷却。
使用 claude -p --model haiku（非 API 密钥）。
具备幂等性，可安全重复运行。
常见错误处理：Gmail 凭据缺失需运行 google-auth 技能；达到每日上限需等待次日；无匹配收件人需检查 segment 查询和 CRM 数据；无效邮箱将被跳过。
模板占位符区分大小写，例如 {name} 而非 {Name}。
测试发送未到达时可检查 Gmail API 凭据并重新认证。

技能介绍

用途

主要能力

使用方式

适用场景

限制与注意事项

相关文件与技能