用途:为学术论文生成详细的 Markdown 讲解文档,目标是忠实描述论文内容,而非批判性评审。使用前需先阅读 documenting-with-sources 中的引用写作约定。
主要能力:输出文件固定写入项目根目录下的 reports/{paper-filename-base}.md,项目根为包含论文 PDF 的目录。开头依次为标题、文献信息(作者、机构、会议、年份、arXiv/DOI、URL)和完整摘要(原文置于代码块,非工作语言附译文)。正文章节结构镜像论文自身结构,之后可追加讲解专属章节(如优点、局限、来源列表)。内容以“原文引用+翻译”块为主,散文仅用于衔接逻辑或补充变量定义、前置知识、图表读法。公式用 LaTeX(行内 $...$,行间 $$...$$),禁止放入代码块或写成纯文本;公式出现前须定义所有符号,公式密集章节在开头放变量表。数值结果尽量用表格,方法与被比较基线并列,数字照抄不四舍五入,表前列出各列与指标定义。实验部分需写清任务步骤、数据划分、搜索或优化过程,各实验章节独立且粒度一致。
使用方式:用捆绑脚本提取图表,命令为 uv run {this-skill-dir}/scripts/extract_images.py <PDF path>,默认输出到 {project-root}/images-from-papers/,命名如 {base}-fig{N}.png、{base}-table{N}.png,清单记录在 {base}-manifest.json。禁止手工重绘图表,须以图片插入,并在图下另起一段放译文说明。引用本论文用 [p.X, Section Y.Z],引用其他工作用 [author-short (YYYY)]。完成后用子代理逐节审计,结果写入 {cwd}/subagent-reviews/{NN-section-name}.md,每个审计文件含总体评估、发现、建议修改三部分,再据论文原文核对后应用修改。
适用场景:需要把单篇学术论文整理成可核对原文的详细中文讲解文档时。
限制:不用于批判性评审;图表须从 PDF 提取而非重建;输出路径由规则机械确定,不询问用户;审计与讲解是不同产物,不可混称。其他细节暂未提供。