Communitygithub.com

ScholarFlow 技能 - 学术文档处理

用于文献综述、学术写作、图表处理、生物信息学和研究交付物的可复用 AI Agent 技能。

ScholarFlow 技能 - 学术文档处理 是什么?

ScholarFlow Skills 是一套针对学术研究和文档处理的 AI Agent 可复用技能集,专为 Claude Code、Cursor 等支持 SKILL.md 的平台设计。该技能主要涵盖 PDF 文档的读取与生成,强调布局和视觉元素的保真度,通过“渲染为 PNG 进行视觉检查”的工作流程确保输出质量。它推荐使用 `pdftoppm`(需安装 Poppler)进行页面渲染,使用 `reportlab` 生成 PDF,使用 `pdfplumber` 或 `pypdf` 进行文本提取。技能还规定了清晰的文件组织规范(中间文件存放于 `tmp/pdfs/`,最终产物存放于 `output/pdf/`),依赖管理推荐使用 `uv`,并提供了完整的环境安装指南。其核心价值在于帮助 AI Agent 在无法直接查看 PDF 时,通过图像化检查实现高质量、无视觉缺陷的文档交付。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add zhoy0409-debug/scholarflow-skills

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

PDF 技能

使用时机

  • 需要读取或审阅 PDF 内容,且布局和视觉元素至关重要时。
  • 需要以可靠的格式程序化创建 PDF 时。
  • 在最终交付前验证渲染效果。

工作流程

  1. 优先进行视觉审阅:将 PDF 页面渲染为 PNG 并检查。
    • 如果可用,使用 pdftoppm。
    • 如果不可用,安装 Poppler 或请用户在本地审阅输出。
  2. 创建新文档时,使用 reportlab 生成 PDF。
  3. 使用 pdfplumber(或 pypdf)进行文本提取和快速检查;不要依赖它来保证布局保真度。
  4. 每次有意义的更新后,重新渲染页面并验证对齐、间距和可读性。

临时文件和输出规范

  • 使用 tmp/pdfs/ 存放中间文件;完成后删除。
  • 在此仓库中工作时,将最终产物写入 output/pdf/。
  • 保持文件名稳定且具有描述性。

依赖项(如果缺失则安装)

推荐使用 uv 进行依赖管理。

Python 包:

uv pip install reportlab pdfplumber pypdf

如果 uv 不可用:

python3 -m pip install reportlab pdfplumber pypdf

系统工具(用于渲染):

# macOS(Homebrew)
brew install poppler

# Ubuntu/Debian
sudo apt-get install -y poppler-utils

如果在此环境中无法安装,请告知用户缺少哪个依赖项以及如何在本地安装。

环境

无需设置环境变量。

渲染命令

pdftoppm -png $INPUT_PDF $OUTPUT_PREFIX

质量标准

  • 保持精美的视觉设计:一致的字体、间距、页边距和章节层级。
  • 避免渲染问题:文字被裁剪、元素重叠、表格损坏、黑色方块或无法辨认的字形。
  • 图表、表格和图片必须清晰、对齐且标签明确。
  • 仅使用 ASCII 连字符。避免使用 U+2011(不间断连字符)和其他 Unicode 破折号。
  • 引用和参考文献必须可读;切勿保留工具令牌或占位符字符串。

最终检查

  • 在最新的 PNG 检查显示没有任何视觉或格式缺陷之前,不要交付。
  • 确认页眉/页脚、页码和章节过渡看起来精美。
  • 保持中间文件有序,或在最终批准后将其移除。

相关技能