Source-first
优先寻找 arXiv 或会议页面的 LaTeX source，避免把 PDF 强行转回不可维护的 TeX。
不是摘要，是章节前导读
这个 WeHub Skill 保留原文，把中文 Q&A 导读插入到每个关键章节开头，并默认编译成 `main_with_guides.tex` 与 `guide.pdf`。读者不会被替代阅读，而是在进入原文前知道这一节为什么重要、该看什么、哪里可能有假设和证据边界。
Guide blocks
在摘要、正文 section 和 appendix 前插入中文问题导向导读，帮助读者先建立阅读框架。
Build report
输出可编译 PDF、guide block 数量、引用状态、错误和失败原因，而不是只给一段聊天总结。
HTML fallback
如果主机没有合适的 LaTeX 编译工具或无法取得 source，生成 `paper-guide.zh.html`，并明确记录 fallback 原因。
Golden test case
`Attention Is All You Need` / arXiv `1706.03762` 是这个 skill 的 canonical regression 和 demo case：source 稳定、章节清晰、引用和图片能检验真实编译链。
1
Find source
`find_arxiv.sh "Attention Is All You Need"` 应返回 `1706.03762`，source 解包后应包含 `ms.tex`。
2
Build guided PDF
插入 8 个导读块，覆盖 Abstract、Introduction、Background、Model Architecture、Why Self-Attention、Training、Results、Conclusion。
3
Check quality
baseline 是 17 页 `guide.pdf`，0 LaTeX errors，0 unresolved refs，0 undefined citations。
公开 Skill，增强服务
基础版 skill 可以公开发布，让任何 agent 在本地生成导读版论文。更高质量的导读、读者画像适配、复杂修复和质量审核，则通过 WeHub research-reading agent API 增强。
1
Install skill
用户安装 `add-chinese-guides-to-paper-sections`，提供论文标题、arXiv、PDF URL 或本地 LaTeX source。
2
Generate local guide
skill 完成 source discovery、guide insertion、LaTeX build 和质量报告。
3
Request enhanced mode
需要更好的章节讲解或失败修复时，申请调用 WeHub agent API 返回增强导读 blocks。
Agent API contract
v0 API 只做一件事：让外部 skill 把论文 section 交给 WeHub research-reading agent，拿回结构化中文导读、LaTeX block 和质量信号。
POST /v1/skills/add-chinese-guides-to-paper-sections/guide-blocks
Authorization: Bearer <WEHUB_SKILLS_API_KEY>
{
"reader_profile": { "background": "grad_student", "goal": "deep_read" },
"section": { "kind": "method", "title": "Model", "latex": "..." },
"constraints": { "max_questions": 4, "style": "concise_qa" }
}