arxiv-speech-skill

name	arxiv-speech-skill
description	Use when: 生成、获取、测试 AcouLab 语音论文速递；从 arXiv cs.SD/eess.AS 抓取当日语音/音频论文；按 ML 顶会口径筛选并撰写毒舌评审报告。

语音论文速递 Skill

功能定位

从 arXiv cs.SD + eess.AS 获取指定 UTC 日期的新投稿，解析成结构化 JSON，下载 arXiv HTML 正文到本地缓存，再由 Agent 按「AcouLab 语音论文速递」格式筛选高价值论文并撰写报告。

脚本负责 拉取元数据、解析元数据、下载 HTML 正文并抽取纯文本；元数据只能用于初筛。最终评分、赛道判断、毒舌评审和成稿必须由 Agent 逐篇阅读候选论文正文后完成，优先使用 scripts/fetch_arxiv_html.py 生成的 fulltext.text_path，必要时再打开 arXiv 摘要页或 PDF。不要声称脚本已经自动完成主观评分，也不要把只看摘要的判断包装成全文评审。

---

标准执行流程

1. 确定目标日期

• 用户指定日期时，使用用户日期。
• 用户未指定日期时，使用当前 UTC 日期：date -u +%F。
• 日期语义以 arXiv Atom XML 的 published 字段为准，格式为 YYYY-MM-DD。

2. 获取、解析元数据并下载 HTML 正文

推荐一条命令跑通：

TARGET_DATE="$(date -u +%F)"
OUTPUT_DIR=".cache/arxiv-html/$TARGET_DATE"
bash scripts/fetch_arxiv.sh --date "$TARGET_DATE" --max-results 2000 \
  | python3 scripts/parse_arxiv.py --date "$TARGET_DATE" \
  | python3 scripts/fetch_arxiv_html.py --output-dir "$OUTPUT_DIR" --clear-output-dir --pretty

调试时可以拆开：

bash scripts/fetch_arxiv.sh --date 2026-04-29 > /tmp/arxiv_speech.xml
python3 scripts/parse_arxiv.py --date 2026-04-29 --input /tmp/arxiv_speech.xml > /tmp/arxiv_speech.json
python3 scripts/fetch_arxiv_html.py --input /tmp/arxiv_speech.json --output-dir .cache/arxiv-html/2026-04-29 --clear-output-dir --pretty

解析输出字段：

• total_count：arXiv API 返回的原始 entry 数。
• filtered_count：按 published 日期过滤并按 arXiv base id 去重后的论文数。
• target_date：本次过滤日期。
• papers[]：论文元数据，包括 arxiv_id、arxiv_base_id、version、title、authors、summary、comment、journal_ref、abs_link、pdf_link、code_urls、related_urls、published、updated、categories。
• papers[].fulltext：HTML 正文下载和抽取状态。status == "ok" 时会包含 html_url、html_path、text_path、text_chars、section_titles；失败时包含 error。

本次处理了哪些论文必须以 JSON 的 papers[] 为准，不要用 ls .cache/arxiv-html/*.txt 反推；缓存目录可能残留旧运行结果。标准命令应使用按日期划分的 --output-dir，并加 --clear-output-dir 清掉该日期目录中的旧 .html/.txt。

如果 filtered_count == 0，直接输出：

今日无新投稿，休息一天。

3. 读取论文内容

打分前必须区分两种证据等级：

• 初筛级：只看 title、summary、comment、categories、code_urls、related_urls。只能用于排除明显不相关或明显偏弱的论文，不能输出最终评分。
• 评审级：fulltext.status == "ok"，并且 Agent 已阅读 fulltext.text_path 中的方法、实验、消融、局限性和结论；必要时再核对 abs_link、pdf_link 或 fulltext.html_url。只有达到评审级证据，才能进入最终精选和毒舌评审。

执行要求：

• 对所有可能入选的候选论文，必须逐篇读取 fulltext.text_path 后再评分。
• 如果 HTML/PDF 无法访问或 fulltext.status != "ok"，只能标注「摘要级判断」，原则上不进入精选；除非用户明确接受摘要级速览。
• 实验数字、SOTA 对比、消融结论只能来自论文正文或摘要明确文本，不能凭题目和领域常识补全。
• 如果论文数量很多，可以用元数据决定阅读和打分顺序，但凡 fulltext.status == "ok" 的论文都必须进入最终评分；不可读的才标为摘要级，且不得给最终分。

---

论文筛选与分类

赛道

赛道	标记	覆盖范围
语音大模型 / 语音理解	🤖	音频 LLM、语音推理、语音对话、ASR/TTS with LLM、多模态语音理解
语音前端 / 音频系统 / 声学	🎧	音频基础模型、声音识别、音乐生成、声学建模、说话人识别、语音增强、降噪、分离

分类规则

优先依据标题和摘要，不确定时结合 categories、comment 和论文链接判断。

• LLM、large language model、audio-language、speech-language、multimodal、spoken dialogue：偏 🤖。
• ASR、automatic speech recognition、speech recognition：偏 🤖，但纯前端声学建模可归 🎧。
• TTS、text-to-speech、speech synthesis：与 LLM/对话结合归 🤖，声码器/声学模型细节归 🎧。
• music、audio generation、sound event、acoustic、speaker、diarization、speech enhancement、noise reduction：偏 🎧。

---

量化评分

对每篇达到评审级证据的候选论文独立打分，总分 10 分。正文可读的论文都要打分，不要只打前几篇。最终详细展示总分 > 7 的论文；总分 <= 7 的论文不写完整评审，只在「一句话速览」里给一句价值判断。未读正文的论文不得给最终分，只能作为「摘要级候选」记录。

维度	分值	评分标准
新意	0-3	3=开创新方向 / 解决公认难题；2=重要改进 / 新场景首次验证；1=增量式改进；0=完全照搬
影响力	0-3	3=可能改变业界实践 / 高引用潜力；2=推动子领域进展；1=局部优化；0=关注面很窄
证据强度	0-2	2=多数据集验证 + 关键消融 + 代码/模型/数据可复现；1=证据部分缺失；0=只有 claim
受众匹配度	0-2	2=语音/Audio ML 从业者必看；1=相关研究者可参考；0=过窄或偏离本栏目

评分校准：

• 6 分：合格但偏增量。
• 7 分：接近 Strong Accept，值得进精选。
• 8 分及以上：当天少见的强稿。

---

毒舌评审要求

风格可以尖锐，但必须基于论文内容，不做人身攻击，不编造实验数字。摘要里没出现的指标要写成「摘要未交代」，不要硬补。

每篇入选论文的点评必须能追溯到已阅读内容：方法来自论文方法部分，实验来自论文实验/结果部分，局限来自论文讨论、实验边界或明确可见的缺口。没有读到的内容要写「正文未核验」或「摘要未交代」，不要猜。

固定结构：

### [序号]. [论文标题]

【评分】：X/10（新意 X | 影响力 X | 证据 X | 受众 X）

【作者】：作者列表

【链接】：
- 论文：https://arxiv.org/abs/XXXX.XXXXX
- PDF：https://arxiv.org/pdf/XXXX.XXXXX
- 代码：https://...（暂无）
- 项目/资料：https://...（如有）

📌 简介：
[1-2 段概述核心研究问题、研究对象、主要贡献]

☠️ 毒舌点评：
[直白指出亮点和硬伤。可以吐槽 claim、实验设计、泛化边界，但结论要有依据]

🔧 技术方案：
- **模型架构**：[摘要能支持的架构描述；不确定就说明摘要未交代]
- **核心创新**：[1-2 个核心点]
- **训练/推理策略**：[训练、损失、数据、推理流程；缺失则标注]

📊 实验结果：
[提炼摘要中的实验数据、对比对象、适用边界。没有数据就明确说证据不足]

💡 为什么值得看：
[目标受众、参考价值、阅读建议]

---

---

最终输出格式

# 语音论文速递 | [YYYY-MM-DD] | 精选版

> 数据源：arXiv cs.SD + eess.AS 当日新投稿
> 日期口径：arXiv published UTC 日期
> 评审口径：NeurIPS / ICML / ICLR 毒舌审稿
> 入选规则：4 维度量化评分 > 7 分进入精选详情，其余论文一句话速览

## 📊 本期概览

- 总投稿数：[X] 篇
- 已读正文：[X] 篇 | 正文不可用：[X] 篇
- 精选详情（>7 分）：[X] 篇
- 一句话速览（<=7 分或摘要级）：[X] 篇
- 赛道分布：🤖 语音大模型 [X] 篇 | 🎧 语音前端 [X] 篇

## 📋 精选论文总览（>7 分）

| 序号 | 论文标题 | 评分 | 关键词 |
|------|----------|------|--------|
| 1 | ... | 8/10 | ... |

---

## 🤖 语音大模型 / 语音理解

[该赛道入选论文]

---

## 🎧 语音前端 / 音频系统 / 声学

[该赛道入选论文]

---

## 🎯 本期总结

**值得精读的论文**：
- [论文标题]：[理由]

**共性趋势**：
- [趋势]

**阅读建议**：
- 时间有限？优先看 [论文]
- 做工程的？重点关注 [论文]
- 做理论的？如果本期没有硬核理论贡献，就别硬凑推荐

## 📝 其余论文一句话速览

| 论文标题 | 评分/状态 | 一句话总结 |
|----------|-----------|------------|
| ... | 6/10 | ... |
| ... | 摘要级 | HTML/PDF 未读到，只能基于摘要判断：... |

---

可用性测试

修改脚本后必须至少运行：

python3 -m unittest discover -s tests
bash -n scripts/fetch_arxiv.sh
python3 scripts/parse_arxiv.py --date 2026-04-29 --input tests/fixtures/arxiv_atom_mixed_dates.xml --pretty
python3 scripts/parse_arxiv.py --date 2026-04-29 --input tests/fixtures/arxiv_atom_mixed_dates.xml \
  | python3 scripts/fetch_arxiv_html.py --offline-html-dir tests/fixtures/html --max-papers 1 --pretty

联网验收：

TARGET_DATE="$(date -u +%F)"
OUTPUT_DIR=".cache/arxiv-html/$TARGET_DATE"
bash scripts/fetch_arxiv.sh --date "$TARGET_DATE" --max-results 2000 \
  | python3 scripts/parse_arxiv.py --date "$TARGET_DATE" \
  | python3 scripts/fetch_arxiv_html.py --output-dir "$OUTPUT_DIR" --clear-output-dir --pretty

联网验收中 filtered_count 为 0 是正常情况，不代表脚本失败；如果个别论文 fulltext.status == "error"，说明对应 HTML 页面暂不可用或解析失败，应降级为摘要级候选。只有命令非零退出、stderr 报错或 JSON 不可解析才算脚本失败。

---

文件清单

文件	功能
SKILL.md	Skill 逻辑、评分口径和输出格式
README.md	用户使用说明、命令和排错
scripts/fetch_arxiv.sh	arXiv API 获取器，stdout 输出 Atom XML
scripts/parse_arxiv.py	Atom XML 解析器，stdout 输出 JSON
scripts/fetch_arxiv_html.py	arXiv HTML 正文下载器，缓存 HTML 和纯文本
tests/test_cli.py	CLI 和解析行为测试
tests/fixtures/arxiv_atom_mixed_dates.xml	离线测试 fixture
tests/fixtures/html/2604.00001.html	HTML 正文抽取测试 fixture

---

最后更新：2026-04-29