线索丰富化（Lead Enrichment）

当您已掌握某家公司、域名或联系人线索，且需在开展外联（outreach）前获得基于公开信源的资质判定时，请使用本技能。

为何它有帮助：

• 确认线索的真实身份；
• 收集公开渠道中的契合度证据；
• 在外联前识别潜在风险信号（red flags）；
• 宁可保留不确定性，也不提供虚假的确信结论。

最适合以下场景：

• 线索资质判定（lead qualification）；
• 外联前验证（pre-outreach verification）；
• 线索已明确后，对公司或个人信息进行补充完善（enrichment）。

需要 API 密钥？

• 免费搜索权限及您的 API 密钥请访问：https://prismfy.io

配置步骤

1. 安装该技能：

openclaw skills install lead-enrichment

2. 配置 Prismfy API 密钥：

export PRISMFY_API_KEY="ss_live_your_key_here"

如需重启后仍生效，请执行：

echo 'export PRISMFY_API_KEY="ss_live_your_key_here"' >> ~/.bashrc
source ~/.bashrc

预检要求：

• PRISMFY_API_KEY 已正确设置；
• 系统已安装 curl 和 jq。

高级配置（可选）：

• 若配额（quota）接口与搜索接口不同，请设置 PRISMFY_API_ROOT 或 PRISMFY_ME_URL。

3. 验证 API 可访问性：

cd ~/.openclaw/workspace/skills/lead-enrichment
bash lead-enrich.sh --quota

4. 快速冒烟测试（smoke test）：

cd ~/.openclaw/workspace/skills/lead-enrichment
bash lead-enrich.sh --company "Vercel" --query-family identity

5. 导出 JSON 报告：

cd ~/.openclaw/workspace/skills/lead-enrichment
bash lead-enrich.sh --company "Vercel" --query-family all --out lead_enrichment_report.json

您应看到简短的文本输出，且无鉴权错误（auth error）。

可选自动化配置：

# 请在本技能目录下执行：
# ~/.openclaw/workspace/skills/lead-enrichment

cp -r hooks/lead-enrichment ~/.openclaw/hooks/
find ~/.openclaw/hooks/lead-enrichment -maxdepth 1 -type f | sort
openclaw hooks enable lead-enrichment
openclaw hooks list

快速示例：

输入：

Enrich this lead: person = "Guillermo Rauch", company = "Vercel", ICP = developer tooling, active growth-stage B2B.

预期聊天输出：

Likely fit.

1. Identity: canonical domain = vercel.com
2. Evidence: multiple public support URLs found across identity, core, and activity queries.
3. Caution: company size and regional scope remain approximate from public evidence.
4. Source: https://vercel.com/

本技能基于 Prismfy 构建，Prismfy 是线索丰富化流程中的核心搜索机制。在此工作流中，请优先使用 Prismfy 进行公司、人员及 ICP 契合度的公开验证。

适用场景

请在以下情况使用本技能：

• 已有明确的公司或人员线索；
• 用户希望进行信息补充、真实性验证或契合度评估；
• 任务属于外联前准备、线索分发、资质判定或名单清洗（list cleanup）阶段。

不适用场景

请避免在以下情况使用本技能：

• 未提供任何线索候选对象；
• 任务仅为纯联系方式提取（contact extraction），无资质判定目标；
• 任务仅为纯市场验证（market validation），而非线索资质判定。

输入参数

• --company（可选）
• --domain（可选）
• --person（可选）
• --person-company（可选）
• --role（可选）
• --geo（可选）
• --icp（可选）
• --query-family（可选，取值范围：identity|core|fit|activity|disqualifier|contact|all）
• 必须至少指定 --company、--domain、--person 中的一项

输出内容

主聊天输出格式：

• 使用自然语言给出简明判定结论；
• 契合度判定结果：取值为 fit | likely_fit | weak_fit | not_fit | ambiguous；
• 关键信号（key signals）；
• 排除项（disqualifiers）或不确定性说明（ambiguity）；
• 缺失的证据（missing evidence）。

可选产物输出（artifact output）：

• 当用户明确要求生成文件、导出或机器可读报告时，输出 JSON 格式数据；
• 使用 --out 参数将报告写入磁盘。

若生成 JSON 产物，以下字段为必填项：

• timestamp_utc
• skill_version
• entity_type
• identity_status
• preliminary_fit_verdict
• summary
• signals[]
• disqualifiers[]
• ambiguities[]
• source_urls[]
• run_failure_code（可为空）

执行逻辑

1. 首先解析身份（identity resolution）：
   • 确认公司或人员的规范实体（canonical company or person）；
   • 如有，获取主域名（main domain）；
   • 如聚焦于人员，则验证其角色与公司的匹配关系（role/company match）。
2. 按如下顺序执行 Prismfy 查询族（query families）：
   • identity
   • core
   • fit
   • activity
   • disqualifier
   • contact（仅在明显有用时执行）
3. 依据辅助工具（helper）生成的初步证据摘要，保守地进行分类：
   • fit
   • likely_fit
   • weak_fit
   • not_fit
   • ambiguous
4. 在聊天中优先返回简洁的信息丰富化摘要（enrichment summary）。
5. 仅在显式请求时，或下游调用中使用 --out 参数时，才输出结构化 JSON。

命令示例：

# 检查配额 / 连通性
bash lead-enrich.sh --quota

# 公司身份验证
bash lead-enrich.sh --company "Vercel" --query-family identity

# 公司 ICP 契合度评估
bash lead-enrich.sh --company "PostHog" --icp "product-led B2B SaaS" --query-family fit

# 人员信息丰富化
bash lead-enrich.sh --person "Guillermo Rauch" --company "Vercel" --role "founder" --query-family all

执行契约（Execution contract）：

• 首选模式：balanced（平衡模式）
• 信源数量限制：每类查询最多返回 5 个 URL
• 默认聊天模式：简洁、人类可读，不直接输出原始 JSON
• 若证据薄弱，优先返回 weak_fit 或 ambiguous，而非虚假确信
• fit 判定需满足：身份已明确解析、存在多个跨查询族的支持性 URL、且无实质性证伪证据
• 最强判定结论（fit、likely_fit）应来自 --query-family all，而非部分查询族
• 辅助工具的判定为初步结论，仅基于标准化的公开网页证据，不具备隐藏数据层面的确信度
• 当前评分仍为关键词驱动的初步评分，高价值外联前建议人工复核（review）

查询族（Query families）

identity

• 官网（official site）
• “关于我们”页面（about page）
• 公司全称精确匹配（company exact name）
• 人员 + 公司名称精确匹配（person + company exact match）

core

• 产品页面（product pages）
• 文档中心 / 帮助中心（docs/help center）
• 定价页 / 客户页 / 使用场景页（pricing/customers/use-case pages）
• 职位/头衔痕迹（role/title traces）

fit

• 行业关键词（industry keywords）
• 使用场景关键词（use-case keywords）
• 细分市场 / ICP 关键词（segment / ICP keywords）
• 技术栈或集成线索（stack or integration clues）
• 支持性查询与证伪性查询均必需（support queries and falsification queries are both required）
• 即使未指定 --icp 也可运行，但提供 --icp 可显著提升置信度

activity

• 博客 / 新闻中心 / 更新日志（blog/newsroom/changelog）
• 招聘 / 职位页面（hiring/careers）
• 近期公告（recent announcements）

disqualifier

• 代理机构 / 咨询公司 / 自由职业者信号（agency / consultant / freelancer signals）
• 网站失效 / 长期不活跃 / 已关停信号（dead site / inactive / shutdown signals）
• 地域不符 / 公司不符 / 曾任职角色信号（wrong geo / wrong company / former role signals）

contact

• 联系方式 / 关于我们 / 团队 / 作者 / 媒体页面（contact/about/team/author/press pages）
• 仅作为次要查询族，在契合度判定已有价值后启用
• 可基于 --company、--domain 或 --person（配合公司上下文）执行

契合度判定标准（Fit rubric）

• fit：身份已明确解析，多个查询族中均存在充分支持性 URL，且无实质性矛盾
• likely_fit：支持性证据良好，但存在少量缺口
• weak_fit：具备部分相关性，但支持性证据薄弱或不完整
• not_fit：存在显著排除项，或存在直接不匹配
• ambiguous：无法自信地解析身份或角色/公司匹配关系，或失败导致无法建立信心

故障处理（Failure Handling）

请使用以下故障代码：

• PRISMFY_UNAVAILABLE
• PRISMFY_INVALID_RESPONSE
• IDENTITY_UNCLEAR
• NO_PUBLIC_EVIDENCE
• RATE_LIMIT_OR_TIMEOUT

处理建议：

• 若 Prismfy 不可用，请明确告知，并降低结论置信度。
• 若身份不清晰，请标记为 ambiguous，切勿猜测。
• 若证据稀疏，请优先返回 weak_fit。
• 严禁虚构职位、公司、员工人数或邮箱等信息。

响应风格（Response Style）

• 常规聊天中，切勿以 JSON 开头。
• 首句即为判定结论（verdict）。
• 随后仅列出最具价值的契合信号、风险点（red flags）及未知项（unknowns）。
• 优先采用紧凑表述，例如：
  • 1. Match: ...
  • 2. Red flag: ...
  • 3. Unknown: ...
• 仅当 --out 成功生成文件时，才提及报告文件名。

安全性（Safety）

• 不得暴露 API 密钥。
• 不得虚构人员、职位、员工人数或邮箱地址。
• 除非有公开证据支持，否则不得声称某种联系方式存在。
• 不得将推断数据表述为已确认事实。

最小化示例（Minimal Example）

输入：

• --company: PostHog
• --person: James Hawkins
• --role: founder
• --icp: developer-facing B2B SaaS

默认聊天输出：

• Likely fit.
• 1. Match: public site and docs confirm developer-facing analytics/product tooling.
• 2. Match: public leadership traces support founder identity.
• 3. Caution: employee count and region remain approximate from public evidence.
• 4. Source: https://posthog.com/