Credits: paper-flow-skill is developed based on sodalone/paper-reading-skill, and the open-source packaging of this repository follows that project's README and skill layout as a starting point.

一个面向单篇精读与多篇综述的可执行 Codex skill 仓库

覆盖 reviewer-level 论文分析、跨论文归纳比较、统一大表格与 HTML 综述导出

paper-flow-skill 是一个面向 GitHub 开源发布的 Codex skill 仓库，包含三个相互配合的论文分析技能：

• paper-arxiv-search：按 topic 检索 arXiv 论文并生成分组 Markdown 清单
• paper-reading：对单篇 AI 论文做 reviewer-level 精读与批判性分析
• paper-reading-synthesis：基于多篇 paper-reading 报告做 topic 级归纳、比较与综述

这三个 skill 都是可执行结构，不只是提示词文件。仓库中保留了 SKILL.md、脚本、模板、引用资料和 agents/openai.yaml，可以直接继续维护并发布到 GitHub。

仓库结构

paper-flow-skill/
├── README.md
├── LICENSE
├── .gitignore
└── skills/
    ├── paper-arxiv-search/
    │   ├── SKILL.md
    │   ├── README.md
    │   ├── agents/
    │   └── references/
    ├── paper-reading/
    │   ├── SKILL.md
    │   ├── README.md
    │   ├── agents/
    │   ├── references/
    │   ├── scripts/
    │   └── templates/
    └── paper-reading-synthesis/
        ├── SKILL.md
        ├── README.md
        ├── agents/
        ├── references/
        ├── scripts/
        └── templates/

适用场景

• 想把本地 Codex skill 整理成可分享、可维护、可发布的 GitHub 仓库
• 想让别人直接安装并使用 paper-arxiv-search、paper-reading 与 paper-reading-synthesis
• 想保留脚本化预处理、模板和引用资料，而不是只分享一份长 prompt

安装方式

方式一：手动复制到本地 Codex skills 目录

把目标 skill 目录复制到：

${CODEX_HOME:-$HOME/.codex}/skills/

例如：

cp -R skills/paper-reading "${CODEX_HOME:-$HOME/.codex}/skills/"
cp -R skills/paper-reading-synthesis "${CODEX_HOME:-$HOME/.codex}/skills/"
cp -R skills/paper-arxiv-search "${CODEX_HOME:-$HOME/.codex}/skills/"

方式二：通过 GitHub 路径安装

发布到 GitHub 后，别人可以用 Codex 的安装脚本按路径安装：

python3 "${CODEX_HOME:-$HOME/.codex}/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
  --repo <owner>/paper-flow-skill \
  --path skills/paper-arxiv-search \
  --path skills/paper-reading \
  --path skills/paper-reading-synthesis

安装后重启 Codex 以识别新 skill。

运行前准备

每个 skill 都有自己的 requirements.txt 和 scripts/bootstrap.sh。首次使用前，在对应 skill 根目录执行：

bash scripts/bootstrap.sh

三个 Skill 的分工

paper-arxiv-search

• 输入：topic 关键词和可选约束
• 输出：一个分组 Markdown 论文清单
• 特点：强调 AlphaXiv 检索、相关性复核、去重和 paper vault 风格导出

paper-reading

• 输入：单篇 arXiv 链接、arXiv ID 或 PDF 论文
• 输出：固定结构、自包含的 Markdown 阅读报告
• 特点：强调 reviewer-level 分析、关键表格落地、图片就地插入、公式解释增强

paper-reading-synthesis

• 输入：多个 paper-reading 生成的 Markdown 阅读报告
• 输出：一个 topic 级 Markdown 综述报告和一个 HTML 网页
• 特点：强调路线梳理、统一大表格、证据整合、mermaid 路线图和问题映射图