联系人发现（Contact Discovery）

当您需要查找某家公司或该公司中特定人员的公开联系信息时，请使用此技能。

它为何有用：

• 在公开网页上实际暴露了邮箱地址时，可找到该公开邮箱；
• 在无直接邮箱可见的情况下，可发现可行的联系路径；
• 无需猜测即可揭示公司邮箱格式线索；
• 防止智能体虚构私有联系信息。

最适合以下场景：

• 外联前的联系人信息挖掘；
• 查找公开的媒体/支持/团队联系页面；
• 核查某人是否拥有公开的邮箱痕迹；
• 为后续人工审核提取公司邮箱格式线索。

需要 API 密钥？

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

安装与配置

1. 安装技能：

openclaw skills install contact-discovery

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/contact-discovery
bash contact-find.sh --quota

4. 快速冒烟测试：

cd ~/.openclaw/workspace/skills/contact-discovery
bash contact-find.sh --company "Vercel" --query-family company

5. 导出 JSON 报告：

cd ~/.openclaw/workspace/skills/contact-discovery
bash contact-find.sh --person "Guillermo Rauch" --company "Vercel" --query-family all --out contact_discovery_report.json

可选自动化配置：

# 请从本技能目录下运行：
# ~/.openclaw/workspace/skills/contact-discovery

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

适用场景

当出现以下情况时，请使用本技能：

• 用户请求某人的公开邮箱或其它公开联系方式；
• 用户希望获取某人或某公司的有效联系路径；
• 下一步是发起外联，而联系人信息缺失成为当前瓶颈；
• 潜在客户（lead）已确认存在，仅缺具体触达方式。

不适用场景

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

• 任务目标是线索甄别（lead qualification），而非联系人发现；
• 用户明确需要私有邮箱或推测性联系方式；
• 任务仅需验证公司/人员是否存在，无需获取联系方式；
• 输入中完全缺乏公司、人员或域名等锚点信息。

输入参数

• --company（可选）
• --domain（可选）
• --person（可选）
• --role（可选）
• --query-family（可选，取值范围：identity|direct|company|pattern|all）
• 必须至少提供 --company、--domain、--person 中的一项

关于 query-family 的说明：

• 仅提供 --person 时，推荐使用 direct、identity 或 all 模式，效果最强；
• 若仅提供 --person 却指定 company 或 pattern，工具将退化为依赖较弱的公开网页线索，结果应视为低置信度。

输出内容

主聊天输出（Primary chat output）：

• 简洁明了的自然语言结论；
• 六种可能的判定状态之一：public_email_found | contact_path_found | company_contact_found | company_email_pattern_found | not_found | ambiguous；
• 最可靠的公开联系线索；
• 一个具体可信的来源 URL。

可选产物输出（Optional artifact output）：

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

若生成 JSON 产物，其必需字段包括：

• timestamp_utc
• skill_version
• entity_type
• identity_status
• contact_verdict
• summary
• public_emails[]
• contact_paths[]
• email_pattern_clues[]
• source_urls[]
• run_failure_code

执行逻辑

1. 优先完成身份解析（identity resolution）：
   • 尽可能确定公司的标准域名（canonical domain）；
   • 若聚焦于个人，则尝试匹配“人员 + 公司”组合。
2. 按如下顺序执行 Prismfy 查询族（query families）：
   • identity
   • direct
   • company
   • pattern
3. 返回最强且安全的判定结果（strongest safe verdict）：
   • public_email_found
   • contact_path_found
   • company_contact_found
   • company_email_pattern_found
   • not_found
   • ambiguous
4. 首先在聊天界面中回复结论；
5. 仅当用户显式请求或使用 --out 参数时，才输出 JSON。

命令示例：

# 检查配额 / 连通性
bash contact-find.sh --quota

# 公司级联系人发现
bash contact-find.sh --company "Vercel" --query-family company

# 人员 + 公司联合联系人发现
bash contact-find.sh --person "Guillermo Rauch" --company "Vercel" --query-family all

# 导出完整报告
bash contact-find.sh --person "Guillermo Rauch" --company "Vercel" --query-family all --out contact_discovery_report.json

执行契约（Execution contract）：

• 默认模式：平衡型（balanced）
• 单次查询最大源链接数：5 个 URL
• 默认聊天输出模式：简洁、人类可读，不输出原始 JSON
• 仅当邮箱地址在公开证据中被明确展示时，才认定为“已找到”
• 不得仅凭邮箱格式线索推断私有邮箱
• 最强判定结果来自 --query-family all
• 对高价值外联对象，仍建议人工复核后再行动

查询族说明（Query families）

identity

• 官网主页
• 联系页 / 关于页 / 团队页
• 人员 + 公司精确匹配结果

direct

• 人员 + 公司 + 邮箱/联系方式
• 人员 + 公司 + 作者/媒体页面
• 人员 + 域名线索

company

• 公司或域名对应的联系页面
• 媒体/支持/帮助/团队类页面
• 公司层面通用联系邮箱痕迹
• 在仅提供人员信息（person-only）模式下，回退至公开联系页/个人资料页发现

pattern

• 公司邮箱格式说明页或相关提及
• 域名邮箱格式线索
• 仅含格式线索的证据，供后续人工审查
• 在仅提供人员信息（person-only）模式下，仅能产出弱线索，须保持保守判断

异常处理（Failure Handling）

使用如下失败代码：

• PRISMFY_UNAVAILABLE
• PRISMFY_INVALID_RESPONSE
• IDENTITY_UNCLEAR
• NO_PUBLIC_EVIDENCE
• RATE_LIMIT_OR_TIMEOUT

处理建议：

• 若 Prismfy 不可用，请明确告知用户；
• 若身份无法清晰界定，请标记为 ambiguous；
• 若仅有邮箱格式线索，请清晰说明，且不可将其作为真实邮箱呈现；
• 严禁虚构或猜测个人邮箱。

响应风格（Response Style）

• 常规聊天中，切勿以 JSON 开头；
• 首句即为判定结论；
• 其次展示最佳公开邮箱或最佳联系路径；
• 保持响应紧凑；
• 仅当 --out 成功生成文件时，才提及报告文件名。

安全性要求（Safety）

• 禁止泄露任何 API 密钥；
• 禁止基于邮箱格式线索猜测个人邮箱；
• 除非有公开证据支撑，否则不得声称某种联系方式存在；
• 不得将“可能可送达”等同于“已确认可送达”。

最小化示例（Minimal Example）

输入：

• --person：Guillermo Rauch
• --company：Vercel

默认聊天输出：

• Contact path found.
• 1. Identity: canonical domain = vercel.com
• 2. Evidence: emails=0, direct_hits=2, company_hits=3, pattern_hits=1, official_hits=2
• 3. Path: https://vercel.com/contact
• 4. Source: https://vercel.com/contact