paper-pdf-flow

Category: Docs & Knowledge | Uploader: 41shuyuliu | Downloads: 0 | Version: v1.0（Latest）

Build a structured paper workflow note from an uploaded PDF. Use when the user asks to summarize a paper by figures, generate a minimal README note, extract an end-to-end experimental flow, or convert a paper PDF into a reusable markdown record for project folders.

Changelog: Source: GitHub https://github.com/41shuyuliu/paper-pdf-flow

Directory Structure

Current level: Root

📁 assets/
- 📄 minimal_flow_template_zh.md 296 B
📁 scripts/
- 📄 pdf_to_flow_note.py 24.0 KB
📄 .gitignore 35 B
📄 LICENSE 1.0 KB
📄 README.md 2.0 KB
📄 requirements.txt 13 B
📄 SKILL.md 2.0 KB

SKILL.md

---
name: paper-pdf-flow
description: Build a structured paper workflow note from an uploaded PDF. Use when the user asks to summarize a paper by figures, generate a minimal README note, extract an end-to-end experimental flow, or convert a paper PDF into a reusable markdown record for project folders.
---

# Paper PDF Flow Skill

使用本技能可将单篇论文 PDF 转换为“按图梳理”的结构化 Markdown 笔记。
默认生成“自动最终版”（`--mode final`），固定结构如下：
- `# <pdf_stem> 极简梳理`
- `## 文献信息`
- `## 这篇论文要解决什么问题`
- `## 按图看整篇流程（Fig.1~Fig.N）`
- `## 关键结论（一句话）`

## Workflow

1. 校验输入 PDF 是否存在。
2. 执行 `scripts/pdf_to_flow_note.py` 生成最终版 Markdown（默认 `--mode final`）。
3. 可选人工快检：
- 核对标题、DOI、图序；
- 若提取不完整，补充时间线、分组与统计细节。
4. 仅输出到 `--out` 指定路径。

## Single-File Contract (Strict)

- `--out` 是唯一输出目标。
- 再次生成时覆盖 `--out`。
- 禁止创建任何副本或镜像文件，包括：
  - `README.md` mirror files,
  - `*_backup.md`,
  - `*_en.md`,
  - `*_copy.md`,
  - `同步副本` or any duplicate note.
- 如需翻译或重写，也必须复用同一 `--out` 路径覆盖写入。

## Commands

```powershell
python .\scripts\pdf_to_flow_note.py `
  --pdf "path\to\paper.pdf" `
  --out "path\to\README.md" `
  --lang zh `
  --mode final
```

若系统使用 `python3`，将 `python` 替换为 `python3`。
若存在多 Python 环境，建议显式指定解释器路径后再执行。

## Output Contract

生成结果至少包含：
- 文献元信息（标题/期刊线索/DOI，若可识别）
- 问题定义
- 按图流程（`Fig.1 -> Fig.N`）
- 关键结论（一句话）
- 单文件输出（禁止副本）

对于排版复杂或噪声较高 PDF，建议在生成后做一次快速事实核对。
仅在你明确需要轻量草稿时使用 `--mode draft`。

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

paper-pdf-flow

Directory Structure

SKILL.md

Report

Notice