| name | customer-research |
| description | 外贸B2B客户背调与证据链技能（客户背调/背景调查/尽职调查/研究这家公司/due diligence/company research）。当用户要求调查某家或某批海外客户的背景、验证客户真实性、评估采购能力和匹配度、判断客户值不值得开发、给客户做深度研究、评分建议或客户经营场所/工厂/仓库地图空间审计时，必须使用本技能。输出带证据链接的背调报告、证据包（Evidence Packet）和评分建议，支持浅调/深调/深度背调（deep-dive：决策链、供应链现供应商、竞争格局、成交路径）三档深度。即使用户只是发来一个公司名或网址说"查一下这家公司"或"这个客户怎么样"，也应触发本技能。通常承接 customer-discovery 技能输出的"进入背调"客户。 |
客户背调 Skill（Customer Research & Evidence）
任务本质：把"看起来像客户"变成"有证据证明值得开发"。 核心心态：AI 不是事实源，只是信息处理器——每条重要判断必须能回答"证据在哪、来源多可靠、是事实还是推测"。
环境前置检查
开始客户背调前读取环境初始化前置检查。当前清单无有效状态时，先使用 b2b-marketing-automation:environment-setup。
两层分离原则（不可违反）
- 第一层 · 证据生产：本技能的主体工作。输出事实、证据、推测、冲突项、未知项。每条重要判断保留来源链接和可信度。
- 第二层 · 评分建议：基于第一层证据给出星级建议（0-5★）和理由。分数由证据和规则推导，不由主观印象决定；每条评分理由必须能指回具体证据。
输入
单个或一批客户，至少含：公司名 + 官网（或可靠来源链接）。理想输入还有：国家、初步客户类型、来源链接、Gate 结论（来自 customer-discovery）。同时需要业务方信息（本技能通用于任何行业），来源优先级：① 用户提供的 Business Profile 配置文件；② 用户口头说明（卖什么、目标客户画像）；③ 若行业恰好有内置模板可作参考。无配置时至少要确认"我方卖什么、判断对口的标准"再开始。
网页情报能力路由（必需）
仅当 Gate 结论为 enter_research 后，才可开始本技能的深调或 deep-dive。先按 references/web-intelligence-routing.md 调用 webIntelligenceGateway.company_research，并把公开 LinkedIn 公司、产品或 Showcase 主题先交给 gateway。已知官网或来源页用 webIntelligenceGateway.page_extract；只有页面证据不足才可进行有边界的 webIntelligenceGateway.site_crawl。
agent-reach public search 仍是其他社媒/平台取证路径，但公开 LinkedIn 或简单公开页面读取仅在 gateway A/B 报告相同主题的 Plan C coverage gap 后使用。同一请求不得同时发送给 gateway 与 agent-reach。开始 Plan C 前先确认当前环境是否提供 agent-reach；不可用或不能满足降级公开信息合同，保留 A/B/C partial evidence、把未解主题写入 coverage_gaps、持久化 continuation cursor，并设 manual_review_required=true。
每条 gateway 输出都保留 fallback_level、attempted_providers、selected_provider、fallback_reason、degradation_status、coverage_gaps 与 manual_review_required；partial 或 unavailable 只能标为待核验，绝不写入 outreach_safe_facts。Apollo 只做补全，仅用于已确定公司的联系人，不是公开网页发现或取证替代。
所有下游交接统一读取 shared/schemas/handoff-contracts.json：调用 maps-spatial-audit 使用 research_to_spatial_audit，调用 outreach-angle 使用 research_to_outreach。gateway 返回的 task_id 映射为 gateway_task_id，摘要的 website 规范化为 canonical_domain；展示列可以保留原值。两个合同列出的共同网关交接字段必须原名透传；有值就保留，无值不猜填，尤其不得丢失 continuation_cursor。输出适配时，manual_check_required 与 human_review_required 统一映射为 manual_review_required，star_rating建议 映射为 score_recommendation，confidence_score 映射为 confidence。
为 research_to_outreach 生成稳定的 evidence_id，并仅从 verification_status=supported 且 allowed_usage=outreach 的证据生成 outreach_safe_facts。地图证据的 display_only 或 manual_review 用途必须原样保留，不能在交接时扩大用途。
背调深度三档（用户未指定时按此默认）：
- 浅调：快速筛查，覆盖维度 1、2、4（真实性、对口、国际化），10-15 条证据——批量默认
- 深调：六维度全覆盖——单个公司默认
- 深度背调 deep-dive：深调 +
references/deep-dive.md 协议（决策链、供应链与现供应商、竞争格局、成交路径设计）——仅用于拟重点投入的高价值客户（如深调后 4-5★、大客户、或用户点名），成本约为深调的 2-3 倍，不批量使用
浅调发现高价值信号的公司在报告中建议升档。
证据规则（全程适用）
信息五分类：事实 Fact（来源明确可复核）/ 证据 Evidence（链接、截图、数据）/ 推测 Inference（基于事实的商业判断，不能写死）/ 结论 Conclusion / 未知 Unknown。把推测写成事实是本技能最严重的失败模式。
来源分级：
- S 级：公司官网、政府注册库、官方认证数据库、海关数据、客户邮件
- A 级：LinkedIn 公司页、Google Places、展会官网/展商目录、行业协会、主流商业数据库
- B 级：新闻稿、行业媒体、电商店铺页、社媒账号、招聘页
- C 级：目录站、论坛、博客、转载页
- D 级：AI 自己的记忆或推断、无链接内容
规则：S/A 级可支撑事实；B/C 级只能辅助判断并须标注"来源较弱"；D 级只能作线索，禁止作结论。引用正确但结论过度（来源只说"卖LED灯"，写成"从中国进口LED灯"）同样是违规——写结论前自问：这个来源真的支持这句话吗？
同名公司/实体解析（背调第一步，先于一切维度）：核对官网域名、国家、地址、LinkedIn 公司页、邮箱域名是否指向同一实体；区分品牌站与经销商站、母公司与子公司、同名不同国公司。实体未解析清楚，后续所有证据作废。
六大背调维度（详细方法见 references/methods.md）
按顺序执行，每个维度产出结构化结论 + 证据链接：
- 基本信息与真实性：注册主体、成立时间、地址、域名年龄、企业邮箱、LinkedIn 官方页。成立<2年、免费邮箱、住宅地址是警示信号。
- 产品与业务对口性：主营产品、与我方产品线重合度、补充产品机会、OEM/ODM 可能。必须基于产品页/类目页证据，沿用 customer-discovery 的易混淆产品规则。
- 渠道能力与市场表现：批发/分销/品牌/电商/项目渠道；SKU 数量与上新频率；网站流量与专业度；社媒活跃度；广告投放迹象。
- 采购与国际化能力：海关进口记录、made in China / OEM / private label / importer 字样、国际展会记录、多国渠道。按 references/signals.md 的强/中/弱信号分级输出，"有英文网站"不等于有国际采购能力。
- 联系人与决策链：按
references/contact-enrichment.md 协议执行——第一步永远是免费网搜挖人，所有进入背调的客户不分星级必做一轮：官网 Team/About/Contact 页、LinkedIn 公开搜索（web_search 执行 site:linkedin.com/in "公司名"+职位词）、新闻稿署名、展会名录联系人、YouTube/播客/社媒出镜。Apollo 等付费工具降级为第二步：仅做邮箱补全与验证（接入 MCP 时直接调用；未接入生成查询指引人工回填），付费深度按星级分层。职位优先级按客户类型定、三级邮箱验证（未验证禁入自动发送）、LinkedIn 在职交叉验证。禁止编造姓名、职位、邮箱；猜测的邮箱格式必须标注"猜测未验证"。
- 信用与风险：投诉、诉讼、差评、黑名单、付款风险传闻、是否同行/竞对。负面信息必须给来源，孤证只能写"待核实"。
空间/地图审计
REQUIRED SUB-SKILL: 空间/地图图像审计必须使用 maps-spatial-audit。
当地址存疑、多地址、需验证工厂/仓库属性、场地规模或物流动线影响判断、用户明确要求地图分析、或 4-5★ 客户审核前补证时，读取并执行 references/spatial-audit-routing.md。maps-spatial-audit 负责能力分层、图像来源、观察/推断/未知分离、建筑占地估算与物流信号；本技能负责把结果写入证据包、评分建议和人工复查项。
当地图图像或视觉工具不可用时，必须保留 Tier 0 结果并生成原有 Gemini 审计 Prompt 作为人工回填方案，不得声称已完成空间审计。地图结果只作辅助信号，不能单独证明规模、产能或采购能力。
输出格式（硬性要求：一个 Excel 文件，字段对齐系统数据表）
无论单个客户还是批量，最终成果必须是一个 Excel 文件（.xlsx），四张固定工作表，字段与系统的证据包表/评分表/联系人表严格对齐，保证可直接导入数据库。聊天中可先给核心结论摘要（3-5 句 + 关键发现），但正式交付物是 Excel。文件名必须以 project_code 开头，并遵守 shared/schemas/crm-output-contract.json 的 file_naming 合同；只有 project_code 已由用户明确确认并持久化后才能命名，禁止默认、猜测或写入真实项目代码。
Sheet 1「背调摘要」（每行一家公司）：
company_id | project_code | company_name | product_line | visibility_level | source_system |
crm_account_id | account_owner_email | deal_owner_email | shared_with_teams | source_record_id |
country | website | entity_resolution(resolved/unresolved) |
核心结论(3-5句) | 六维信号: 真实性/产品对口/渠道/采购国际化/联系人/风险(各strong/medium/weak/unknown) |
international_capability_status | import_record_status(confirmed/possible/not_found/not_checked) |
机会角度 | 主要风险 | manual_check_required(是/否+原因)
Sheet 2「证据包」（对齐 evidence_packet，每行一条 claim，本表是核心交付）：
evidence_id | company_id | company_name | claim_text | claim_type(fact/inference/conclusion) |
source_url | source_reliability(S/A/B/C/D) | evidence_strength(strong/medium/weak) |
verification_status(supported/partially_supported/not_supported/conflicting/insufficient/pending) |
allowed_usage(display_only/manual_review/research/scoring/outreach/crm/forbidden) | checked_at
无来源链接的 claim 必须 verification_status=pending；只有 supported 才允许 allowed_usage=outreach。
Sheet 3「评分建议」（对齐 account_score）：
score_id | company_id | company_name | fit_score | potential_score | opportunity_score | risk_score |
confidence_score | star_rating建议 | human_review_required(true/false) |
review_reason | score_explanation(每条理由指回证据包的claim行号)
Sheet 4「联系人」（对齐 contact_record，仅收录有来源的真实联系人，找不到就空表）：
contact_id | company_id | company_name | name | role | email | email_verified_status(verified/unverified/risky) |
source | enrichment_depth | allowed_usage | 备注
未知与缺口、人工待办（如需 ImportYeti 人工查询、Gemini 空间审计 Prompt）写入 Sheet 1 对应列或摘要底部备注区。枚举值用规定英文值，中文解释放说明列。
company_id、project_code、product_line、visibility_level、source_system 与 CRM 可选字段必须从 discovery 原样保留到 research_to_outreach；字段透传不改变每条证据的 allowed_usage，也不扩大证据的使用权限。
评分对接规则（继承系统降级规则）
- 身份未确认 → 不能建议 4-5★
- 无产品页证据 → 最高建议 2★
- 高 Fit 但低 Confidence（证据薄弱/来源冲突/实体未完全解析）→ 不建议 4-5★，建议人工复查
- local_only_risk 高（纯本地维修/安装/门店）→ 降级
- 地图/规模信号不能单独抬升星级
- Confidence 必须单独给出：它衡量"这份判断有多可信"，不是"客户有多好"
禁止行为
- 编造联系人、邮箱、进口记录、认证、公司规模、成立时间、营收
- 把推测写成事实；把"可能进口"写成"有进口记录"
- 把不同实体的信息拼接到一家公司
- 用单一信号（网站漂亮/建筑大/LinkedIn人多）下"大客户"结论——规模判断必须多源交叉
- 因信息不足而降低报告篇幅要求时补猜内容凑数——宁可写"未知"
人工复查触发（在报告中显式标记）
证据冲突 / 同名实体未完全排除 / 高潜力但证据不足 / 负面信息为孤证 / 需付费工具（海关数据、征信）才能确认的关键判断 / 建议 4-5★ 的客户（一律建议人工终审）。
通过标准
每个重要结论有证据链接；事实/推测/未知清晰区分；同名公司被排查；证据不足处主动写"待验证"而非补猜；评分理由可逐条追溯到证据；用户读完报告能直接决定"开发/放弃/再查"。
