Mapping-Skill

面向 Claude Code 与 OpenClaw 的 AI/ML 人才搜索与触达执行手册。

项目链接

• GitHub: https://github.com/16Miku/Mapping-Skill
• ClawHub: https://clawhub.ai/16Miku/mapping-skill

这个 skill 具备的能力

当用户提出以下任务时，应优先启用本 skill：

1. 搜索 AI/ML PhD、研究员、工程师
2. 抓取实验室成员主页并提取结构化信息
3. 抓取 OpenReview / CVF 论文作者信息
4. 从 GitHub following/followers 网络中发现研究者
5. 对给定 URL 执行全量学者信息抽取
6. 识别华人候选人、分类、去重、标准化研究方向
7. 基于候选人信息生成个性化招聘邮件
8. 将 CSV 或爬取结果导入飞书多维表格
9. 在飞书表格中批量生成并回写推荐邮件

执行原则

1. 先判定任务类型，再选方法
• Topic search
• Lab search
• Conference author search
• GitHub network discovery
• Given-URL extraction
• Feishu email workflow

1. 优先复用已有 references 与 scripts

不要从零发明流程。先检查 references/ 与 scripts/ 是否已有成熟模式。

1. 优先选择最稳定的数据入口
• OpenReview 会议优先 API
• CVF 会议优先 HTML + PDF
• Hugo Academic 页面优先模板化解析
• 页面结构混乱但邮箱明显时，使用邮箱反向定位法

1. 抽取与清洗并重

结果必须尽量结构化，并在输出前做分类、去重与字段标准化。

1. 邮件必须基于真实信息个性化

technical_hook 和 talk_track_paragraph 不能空泛，必须和候选人论文、研究方向或主页内容关联。

1. 如用户涉及 OpenClaw / 飞书场景，要显式考虑导表和字段回写

对此类需求，结果不应只停留在本地 CSV。

平台使用说明

Claude Code

适用于：

• 本地脚本执行
• MCP 工具调用
• CSV 导出
• 以本地文件和结构化结果为主要交付物

安装方式通常是把 skill 放到 ~/.claude/skills/ 目录。

OpenClaw

适用于：

• skill 目录托管与刷新
• slash commands 调用
• ClawHub 分发
• 飞书、多工具联动工作流

OpenClaw 常见技能加载位置：

• /skills
• ~/.openclaw/skills
• 内置 skills

也可通过 ClawHub 安装，并通过“刷新 skills”或重启网关重新索引。

工作流

Step 1：识别输入任务与目标输出

先明确：

• 搜索范围是 topic、lab、conference、GitHub network 还是给定 URL
• 输出要求是候选人列表、CSV、飞书入表、邮件生成，还是全流程都要
• 是否需要识别华人、是否需要邮箱、是否需要导入飞书

Step 2：选择数据源与抓取方式

方法选择矩阵

| 场景 | 首选方案 | 备用方案 |

|------|----------|----------|

| OpenReview 会议 | scripts/openreview_scraper.py + API | 搜索 + 主页回补 |

| CVF 会议 | scripts/cvf_paper_scraper.py | 补抓 PDF / 页面回退 |

| Hugo Academic 单页卡片 | lab_member_scraper.py 的 card 模式 | BrightData |

| 实验室列表页 + 个人页 | lab_member_scraper.py 的两阶段模式 | BrightData |

| 无固定结构但含邮箱 | 邮箱反向定位法 | BrightData / 手工规则 |

| GitHub 研究者网络 | scripts/github_network_scraper.py | 网页搜索辅助 |

| LinkedIn / 强反爬站点 | BrightData MCP | 降级到公开网页信息 |

| 给定任意 URL | BrightData MCP 或定制脚本 | 多源补充 |

Step 3：执行抽取

根据场景读取相应脚本或 reference：

• 搜索模板：references/search-templates.md
• Python 爬取：references/python-scraping-guide.md
• 反爬处理：references/anti-scraping-solutions.md
• URL 优先级：references/url-priority-rules.md
• 会议抓取：references/conference-paper-scraping.md

Step 4：结构化与标准化

至少尽量抽取这些字段：

• 中文名 / 英文名
• title / role
• affiliation
• research_interests / research_field
• education / experience
• publications
• homepage / Google Scholar / GitHub / LinkedIn / Zhihu / Bilibili
• email

然后继续做：

• 华人识别：references/chinese-surnames.md
• 候选人分类：references/candidate-classifier.md
• 去重：references/deduplication-rules.md
• 研究方向标准化：references/field-mappings.md

Step 5：邮件生成

读取：

• references/email-templates.md
• references/talk-tracks.md

生成邮件时必须填充：

• researcher_name
• context_affiliation
• research_field
• technical_hook
• talk_track_paragraph

Step 6：结果交付

根据用户要求输出为：

• Markdown 结构化表格
• CSV 文件
• 飞书多维表格
• 飞书表格中的“推荐邮件”字段

OpenClaw / 飞书工作流要点

如果用户明确提到 OpenClaw、飞书、多维表格、导表或批量写邮件，应把这些步骤视为本 skill 的标准能力，而不是额外加分项。

标准能力

1. 解析飞书多维表格链接
2. 提取 app_token / table_id
3. 批量读取记录
4. 依据论文标题或候选人关键词映射研究方向
5. 批量生成个性化邮件
6. 创建新字段并批量更新记录
7. 返回飞书链接、成功/失败统计与原因

最佳实践提示词

后续如果有新的实践文档，应继续沉淀到 references/prompt-best-practices.md。当前优先复用下面几类高价值提示词模式。

1. OpenReview 论文爬取 + 飞书入表

请执行 OpenReview 论文爬取任务：
1. 使用 Mapping-Skill skill 根目录下的 `scripts/openreview_scraper.py` 脚本
2. 初始化爬虫时使用 api2.openreview.net 端点：
   scraper = OpenReviewScraper(
       username='XXXXXXX',
       password='XXXXXXX',
       baseurl='https://api2.openreview.net'
   )
3. 爬取 ICLR2025 的 5 篇论文（测试）+ https://openreview.net/group?id=ICLR.cc/2025/Conference#tab-accept-oral（记着替换链接）
4. 保存 CSV 到 /tmp/ 目录
5. 创建新的飞书多维表格，按照 Mapping-Skill skill 根目录下的 `scripts/openreview_scraper.py` 脚本中爬取的数据来创建相应字段
6. 批量导入数据到多维表格
7. 返回多维表格链接和统计信息

2. CVF 论文爬取 + 邮箱提取 + 飞书入表

请执行 CVF 论文爬取任务：
1. 使用 Mapping-Skill skill 根目录下的 `scripts/cvf_paper_scraper.py` 脚本
2. 严格按照脚本中的 extract_emails_from_text() 函数提取邮箱
3. 爬取 ICCV2025 的 5 篇论文（测试）+ https://openaccess.thecvf.com/ICCV2025?day=all（记着替换链接）
4. 保存 CSV 到 /tmp/ 目录
5. 创建新的飞书多维表格，按照 Mapping-Skill skill 根目录下的 `scripts/cvf_paper_scraper.py` 脚本中爬取的数据来创建相应字段
6. 批量导入数据到多维表格
7. 返回多维表格链接和邮箱提取统计

3. 飞书表格批量写邮件

请执行论文作者邮件生成任务：
【数据源】
表格链接：
【第一步：解析表格链接】
1. 从链接中提取 app_token（格式：/base/{app_token}）
2. 调用 feishu_bitable_app_table 的 list 接口获取 table_id
3. 验证表格可访问性
【第二步：分批读取论文数据】
1. 使用 feishu_bitable_app_table_record 的 list 操作
2. 分批读取（每批50条），使用 page_token 分页
3. 只提取必要字段：记录ID、论文标题、作者、邮箱、机构
4. 过滤条件：只处理有邮箱的记录
【第三步：确定研究领域】
1. 读取 Mapping-Skill skill 根目录下的 `references/field-mappings.md`
2. 根据论文标题和关键词，使用映射规则确定研究领域
3. 示例：
   - "Symmetry Understanding of 3D Shapes" → Computer Vision
   - "Efficient Adaptation of Vision Transformer" → NLP
【第四步：生成个性化邮件】
1. 读取 Mapping-Skill skill 根目录下的 `references/email-templates.md`
2. 根据研究领域选择对应模板（共22个领域）
3. 填充占位符：
   - {{researcher_name}} → 第一作者姓名
   - {{context_affiliation}} → 机构
   - {{research_field}} → 研究领域
   - {{technical_hook}} → 基于论文标题生成
   - {{talk_track_paragraph}} → 从 talk-tracks.md 选择
【第五步：批量更新多维表格】
1. 在多维表格中创建新字段："推荐邮件"（多行文本）
2. 使用 batch_update 批量更新每条记录
3. 每批最多 500 条
【第六步：验证和统计】
1. 验证邮件内容个性化
2. 返回统计：总计 X 条 / 成功 Y 条 / 失败 Z 条
3. 列出失败原因
【输出】
- 多维表格链接
- 生成统计
- 失败原因列表

4. 给定某 URL 全量抽取并入表

1、请你调用BrightData-MCP工具，或者编写爬虫脚本，爬取 <某网站URL> 页面中的所有人员信息。
2、提取信息包括中文名，英文名，个人介绍信息、学术方向、学校和专业信息、工作经历、近期论文著作信息（包含论文名和论文链接）、github链接、个人主页链接、谷歌学术链接、领英链接、知乎链接、B站链接、邮箱等。
3、当前页面缺少邮箱的话，需要进入学者主页或论文链接页面，从里面提取作者们的邮箱。
4、保存到csv文件，然后将csv导入飞书多维表格。

输出格式

候选人摘要表

| Name | Type | Affiliation | Field | Chinese? | Email |

|------|------|-------------|-------|----------|-------|

| Wei Zhang | PhD | Tsinghua | RL | Yes (0.92) | wei@tsinghua.edu |

单个候选人详细输出

## Candidate: Wei Zhang (张伟)

- Type: PhD Student
- Affiliation: Tsinghua University
- Research Field: Reinforcement Learning
- Chinese: Yes (0.92)
- Email: wei.zhang@tsinghua.edu.cn
- Homepage: ...
- Scholar: ...
- GitHub: ...

### Research Summary
- RLHF
- Reward modeling
- Policy optimization

### Publications
1. ...
2. ...

### Outreach Email
...

飞书工作流输出

至少返回：

• 飞书多维表格链接
• 总记录数 / 成功数 / 失败数
• 邮箱提取统计（如有）
• 失败原因摘要

References guide

按场景加载：

• 通用搜索：references/search-templates.md
• 候选人字段：references/profile-schema.md
• 分类：references/candidate-classifier.md
• 华人识别：references/chinese-surnames.md
• 去重：references/deduplication-rules.md
• 邮件模板：references/email-templates.md
• talk tracks：references/talk-tracks.md
• Python 抓取：references/python-scraping-guide.md
• 反爬处理：references/anti-scraping-solutions.md
• 会议抓取：references/conference-paper-scraping.md
• 后续实践复盘：references/practice-cases.md
• 后续最佳提示词：references/prompt-best-practices.md
• 后续用户反馈：references/user-feedback-notes.md

Scripts guide

• scripts/openreview_scraper.py：OpenReview 会议论文与作者抓取
• scripts/cvf_paper_scraper.py：CVF 论文页面 + PDF 邮箱提取
• scripts/lab_member_scraper.py：实验室成员抓取（两阶段 / Hugo Academic / 邮箱反向定位）
• scripts/github_network_scraper.py：GitHub 研究者网络抽取
• scripts/cloudflare_email_decoder.py：Cloudflare XOR 邮箱解密
• scripts/httpx_scraper.py：通用异步 HTTP 抓取
• scripts/serper_search.py：搜索入口模板

不要遗漏的经验

1. OpenReview 优先 API，不要一上来就网页搜索
2. CVF 邮箱提取优先 PDF 首页文本
3. Hugo Academic 要先判断是 card 模式还是两阶段模式
4. 中国高校站点要考虑 [at] 混淆和 SSL 问题
5. 页面结构混乱时，优先尝试邮箱反向定位法
6. GitHub README 往往能补齐 Scholar / Homepage / LinkedIn
7. 若用户要求飞书结果，必须考虑表字段创建与批量更新

后续迭代入口

后续收到新的实践文档后：

1. 把高价值提示词加入 references/prompt-best-practices.md
2. 在本 SKILL.md 的“最佳实践提示词”部分补充该功能已支持的明确说明
3. 将踩坑与修复沉淀到 references/user-feedback-notes.md
4. 必要时补充 evals/evals.json 做后续测试