SKILL.md 9.0 KB
name: wuling-overseas-dealer-expansion
description: 为五菱汽车海外经销商拓展提供端到端自动化能力：使用 AdsPower/Playwright 搜索海外经销商线索，去重、评分并直接写入客户信息汇总表，生成邮件和社交建联预览，执行经确认的建联，读取匹配的 Facebook Messenger 对话、翻译成中文、分析合作意向、更新建联表、生成客户中台看板，并在配置后同步飞书云表格。Use when Codex needs to find overseas Wuling dealer leads, assess dealer fit, prepare/send confirmed outreach, synchronize Facebook replies, translate customer conversations, record unified Facebook reply status, update the outreach workbook, sync Lark/Feishu sheets, or build the customer dashboard.
五菱汽车海外经销商拓展
文件边界
这个目录是独立 skill 包，只放可复用文件：SKILL.md、references/、assets/、scripts/。不要把真实客户表、采集结果、发送日志、预览 HTML/JSON、截图、缓存、SMTP 授权码或账号凭证放进 skill 包。唯一允许放进 assets/ 的 Excel 是空白兜底模板 assets/blank_customer_outreach_workbook.xlsx。
核心工作流
- 先生成预览，再写表、发邮件或发社交私信。
- 搜索和浏览器操作必须使用 AdsPower + Playwright；不得用截图坐标或系统级鼠标键盘模拟。脚本不得关闭 AdsPower 指纹浏览器。
- 客户资料入表默认直接写入
客户信息汇总表，不再按 Facebook、LinkedIn、Google Maps、当地汽车网站等渠道分 Sheet 新增客户。 - 旧渠道 Sheet 只作为历史数据和兼容输入读取；新采集结果写表时，渠道名只写入对应链接列或
备注的来源证据。 - 写表后如配置
feishu_sync_config.json且enabled=true，必须自动调用 WorkBuddy 飞书表格插件同步；未配置时说明“本地写表完成，飞书同步待配置”。 - 对话流水仍单独写入
Facebook对话记录，它是消息事件表，不是客户资料渠道分表。
客户信息汇总表
所有新增、补充、状态更新和深搜补充，都以 客户信息汇总表 为主数据表。标准表头固定为：
公司姓名、国家、城市、客户类型、官网链接、联系人、职位、个人邮箱、联系人电话、Facebook主页链接、linkined主页链接、google map链接、公共电话/WhatsApp、公共邮箱、客户属性、线索等级、需人工确认、建联状态、下次跟进、备注
字段规则：
客户属性：五大客户属性之一。客户类型：必须是对应客户属性下的细分客户类型。线索等级：A/B/C，用于判断线索质量。需人工确认：无风险写否；有价值但缺少关键确认点时写具体原因，例如主体归属待确认；新车业务待确认。备注：写中文结构化证据、来源、风险和批量采购潜力；专业词如 showroom、importation、fleet、location、vehicules neufs 可保留原文。- 来源平台不新增独立列；来源通过 Facebook/LinkedIn/Google Maps 链接列和
备注中的客户来源：...保存。
重复客户合并规则：优先按邮箱、电话、Facebook/LinkedIn/Google Maps 链接、官网链接匹配；其次按标准化公司名匹配。重复资料不新建行，只补充空字段，并将多个电话、邮箱、联系人、链接和备注用 ； 去重合并。
客户分类
五大客户属性和细分客户类型必须严格使用下面的值：
| 客户属性 | 细分客户类型 |
|---|---|
汽车渠道合作伙伴 |
汽车进口商、全国代理商、全国分销商、区域分销商、多品牌经销商、商用车渠道商、中国品牌经销商、新能源或小型车渠道商 |
批量采购与运营客户 |
汽车租赁公司、长期租赁公司、企业车队、物流配送企业、政府或机构采购方 |
二手车转型候选 |
连锁二手车企业、实体二手车企业、进口二手车企业、新车与二手车综合企业 |
平台与行业渠道 |
汽车交易平台、汽车协会、商会、车商联盟、经销商资源引荐机构 |
生态支持资源 |
售后服务网络、备件供应与仓储企业、进口认证与上牌机构、金融保险机构、车辆物流企业 |
重点搜索 汽车渠道合作伙伴 和 平台与行业渠道。其他三类保留用于完整分层和后续触达。
汽车渠道筛选和评级
汽车渠道合作伙伴必须满足：有实际新整车销售或分销业务；具有独立经营主体；存在新增品牌可能性；至少有一个可建联入口。纯维修、配件、轮胎、个人卖家不纳入；纯租车公司转入 批量采购与运营客户 / 汽车租赁公司；品牌当地分公司、官方主页、进口商直营网点及普通分店跳过。
评级标准：
A：明确拥有进口、代理、分销、多品牌渠道、全国网络或平台/行业资源能力。B：明确是独立目标客户，但规模、覆盖或新增品牌权限证据较弱，例如独立单品牌新车经销商、区域 showroom、较小经销主体。C：客户有一定价值信号，但主体、新车业务、渠道作用或资料完整度仍无法确认。
人工确认不是低质量兜底。只有客户已经表现出目标价值，同时缺少关键确认点时，才在 需人工确认 写具体原因。低价值或无关客户应跳过或标低优先级，不要包装成“需人工确认”。
脚本入口
| 任务 | 脚本 | 入表规则 |
|---|---|---|
| Facebook 搜索/深搜 | scripts/scraper/search_active_dealers.py、scripts/scraper/search_facebook.py、scripts/scraper/scrape_single_page.py |
--write-excel 时直接写 客户信息汇总表 |
| LinkedIn 搜索 | scripts/scraper/search_linkedin.py |
默认写 客户信息汇总表，LinkedIn 链接进入 linkined主页链接 |
| Google Maps 搜索 | scripts/scraper/search_google_maps.py |
默认写 客户信息汇总表，Maps 链接进入 google map链接 |
| 当地汽车网站 | scripts/scraper/search_auto_websites.py |
默认写 客户信息汇总表，来源网站进入 备注 |
| 总表修复/兼容导入 | scripts/common/build_customer_summary.py |
读取现有总表和历史渠道 Sheet，合并后重建总表 |
| 邮件预览/发送 | scripts/email_outreach/prepare_outreach_emails.py、scripts/email_outreach/send_outreach_emails.py |
按总表筛选、预览、确认后发送并更新总表 |
| Facebook 建联 | scripts/social/prepare_facebook_outreach.py、scripts/social/run_facebook_follow_dm.py、scripts/social/send_facebook_outreach.py |
从总表读取 Facebook 链接，确认后更新总表状态 |
| Facebook 回复同步 | scripts/social/collect_facebook_conversations.py、scripts/social/write_facebook_conversations.py |
对话进 Facebook对话记录，客户状态/摘要回写总表 |
| 客户中台看板 | scripts/dashboard/build_dashboard.py |
读取总表生成 HTML/JSON，不写 Excel |
旧命令里的 --sheet Facebook、--sheet LinkedIn、--sheet Google Maps 仍可兼容，但只作为来源标签；公共写表层会路由到 客户信息汇总表。
Facebook 建联规则
Facebook 对外话术只用英文，中文只用于内部判断和预览。必须先在聊天框展示整批预览，用户确认一次后才允许 --confirm --batch-confirmed 批量执行，不再逐条确认。真实执行默认每轮 3 个客户，每日 Follow/DM 以账号账本控制。大层级操作等待 90-200 秒，小层级页面操作等待 30-90 秒，技术等待 0.5-8 秒。遇到验证、限流、异常活动或 Messenger 定位不匹配，立即停止，不关闭浏览器。
私信必须定位 Facebook Page 顶部 Follow/追蹤 和 Message/發送訊息 按钮，再定位匹配客户名称的 Messenger 小窗或 Messenger 页面输入框。禁止把帖子评论框、页面底部输入框或推荐区评论框当作私信目标。
邮件规则
邮件模板与社交话术分开。正式邮件固定使用 Chris Chen，社交私信才根据当前 Facebook/LinkedIn 账号询问 sender_name。发送邮件前必须生成 HTML 预览；模板图片应按邮件端尺寸控制，不能把 Markdown ** 原样发给客户。SMTP 授权码只在本次发送中使用，不落盘。
Facebook 对话同步
读取 Messenger 对话时只采集能可靠匹配到总表客户的线程。保存双方原文，翻译成中文，只分析客户回复。合作意向采用五级：明确有意向、潜在意向、需澄清、暂不考虑、明确拒绝。先展示同步摘要和高意向客户，再由用户确认是否写入。不得自动回复客户。
运行产物和模板
预览、搜索结果、发送日志和报告默认进入 runs/YYYYMMDD/<run_id>/；Excel 备份进入 backups/YYYYMMDD/；Facebook 额度账本进入 logs/。预览和 dry-run 不备份 Excel。空白模板仅在全新环境找不到建联表且用户明确写表时复制出来，禁止直接写入 skill 内模板。