reading-agent 是 nealcaren/sociology-skillset 中的技能,用于为学术论文创建结构化阅读笔记。它可独立使用,也可与 lit-synthesis 集成。
用途:为单篇论文撰写阅读笔记、批量将多篇 PDF 转为结构化笔记、跨论文提取一致的元数据与分析、为文献综述做准备。
主要能力:识别论文来源(PDF 路径、citation key、粘贴文本)与标识符(citation key、OpenAlex ID、DOI);将 PDF 或 EPUB 入库转为 markdown,PDF 用 docling,EPUB 用 pandoc,并更新 references.bib;按固定模板生成笔记,包含题录信息、核心论点、理论框架、实证策略、关键发现、贡献声明、局限、关键引文(需页码)、关联与分析笔记;批量模式通过 Task 工具并行派生 haiku 智能体处理。
用法:用 /reading-agent 调用,提供 PDF 路径或 citation key。入库命令为 uv run plugins/sociology-skillset/scripts/ingest.py --file "/path/to/paper.pdf",已存在条目时加 --citekey 与 --update。笔记默认保存到 literature/synthesis/reading-notes/ 或 project.yaml 指定路径,使用 git 提交跟踪版本,不创建 -v2、-final 等副本。检索相关论文可用 uv run plugins/sociology-skillset/scripts/rag.py search "topic"。依赖安装:pip install docling 用于 PDF,brew install pandoc 或 apt-get install pandoc 用于 EPUB。
适用场景与限制:适合质性、量化与混合方法研究,笔记可供理论映射、主题聚类、辩论梳理与写作。需至少一个唯一标识符,引文须带页码;深度分析推荐 Opus,批量提取推荐 Haiku。其他细节资料未提供。