科研 Skill
文献目录整理助手
bibliography
把文献文件夹整理成综述表格
Skill 说明
输入:一个文献文件夹(PDF / MD / DOCX / TXT 混合,数量不限);流程:批量读 → LLM 抽提每篇的 theme / method / conclusion 三类标签;输出:一份 CSV(每行一篇文献,字段:文件名 / 标题 / 主题 / 方法 / 结论 / 关键发现),给文献综述当结构化底稿 | 输入:一个文献文件夹(PDF / MD / DOCX / TXT 混合) | 输出:CSV(每行一篇,字段:文件名 / 标题 / 主题 / 方法 / 结论 / 关键发现)
SKILL.md
Bibliography
When to Use
- You are conducting a literature review and need consistent summaries plus structured metadata (theme/method/conclusion) across many papers.
- You have a mixed-format reading folder (
.pdf,.md,.docx,.txt) and want a single CSV for downstream analysis (e.g., Excel, R, Python). - You need to organize annotations by keywords (theme), experimental methods (method), and key conclusions (conclusion).
- You want a two-step pipeline: first generate a human-readable summary Markdown, then generate a machine-friendly CSV from that Markdown.
- You need robust handling of PDFs by converting them to Markdown first (via
pdf-extract) and then using only Markdown content for extraction.
Key Features
- Batch scans an input directory for
.pdf,.md,.docx, and.txtliterature files. - Converts PDFs to Markdown via
pdf-extract, then ignores non-Markdown artifacts (e.g., image folders). - Extracts and normalizes, per document:
- Title
- Summary (prefer original abstract)
- Keywords (theme)
- Experimental Methods (method names only)
- Key Conclusions (single sentence)
- Commentary (one-sentence, tactful evaluation)
- Produces exactly two outputs:
- A consolidated Summary Markdown saved under
outputs/ - A single CSV generated from that Summary Markdown
- A consolidated Summary Markdown saved under
- Enforces UTF-8 output to prevent garbled characters; fills missing fields with
"Not recognized"instead of leaving blanks. - Uses the CSV field order and headers defined in
assets/bibliography_template.csv.
Dependencies
pdf-extract(version: not specified; required when PDFs are present)- Input formats supported (no external version constraints specified):
- Markdown (
.md) - DOCX (
.docx) - Plain text (
.txt)
Example Usage
Goal
Read all literature files in a folder, generate a consolidated summary Markdown, then generate a CSV following assets/bibliography_template.csv.
Inputs
- Input directory (example):
./inputs/literature/ - Output directory:
./outputs/ - Output CSV path (example):
./outputs/bibliography.csv
Expected Outputs (exactly two files)
./outputs/bibliography_summary.md./outputs/bibliography.csv
Example Summary Markdown Structure (generated first)
# Bibliography Summary
## Document 1
- Title: <Title>
- Summary: <Prefer the original Abstract; if missing, use the closest equivalent section>
- Keywords: keyword1 | keyword2 | keyword3
- Experimental Methods: <method1; method2; ... (names only)>
- Key Conclusions: <one sentence covering all main points>
- Commentary: <one tactful sentence>
## Document 2
...
Example CSV (generated from the Summary Markdown)
The CSV must follow the header order defined in:
assets/bibliography_template.csv
Rules:
- One row per document.
- No empty cells; use
Not recognizedwhen extraction fails. - Save as UTF-8.
Implementation Details
1) Input Reading and Normalization
- Traverse the input directory and process files with extensions:
.pdf,.md,.docx,.txt
PDF handling
- If PDFs exist, convert them to Markdown using
pdf-extract. - Use only the generated
.mdcontent; ignore image directories or other byproducts. - Locate
pdf-extractas follows:- First, look for a sibling skill directory containing
SKILL.mdat the same level as this skill’s parent directory. - If not found, ask the user to confirm the actual
pdf-extractpath.
- First, look for a sibling skill directory containing
DOCX handling
- Extract body text while preserving title/paragraph order as much as possible.
MD/TXT handling
- Read text directly.
- If garbled characters appear or key fields cannot be recognized, attempt to detect and read using the original encoding (commonly
GB18030/GBK) before extraction.
2) Generate the Summary Markdown First (Single Source of Truth)
Before producing the CSV, generate a consolidated Summary Markdown containing, for each document:
- Title
- Summary
- Prefer the original Abstract.
- If no “Abstract” exists, use the closest equivalent section (e.g., “Summary”, “Highlights”, or an “Objective–Method–Result–Conclusion” style segment).
- Keywords
- Experimental Methods
- Key Conclusions
- Commentary
- Exactly one sentence.
- Avoid harsh criticism; if the work has low value, use tactful phrasing.
This Summary Markdown must be saved with UTF-8 encoding and stored under outputs/. The CSV must be generated only from this Markdown (not directly from raw files).
3) Field Extraction Rules (Theme / Method / Conclusion)
- Keywords (theme)
- Prefer the original keywords from the document.
- Separate multiple keywords with
|. - If no keywords are found, generate 3–5 keyword phrases based on the abstract and append:
(generated based on abstract)
- Experimental Methods (method)
- Output method names only (no long descriptions).
- Key Conclusions (conclusion)
- One sentence that covers all main points.
4) CSV Output Constraints
- Output exactly one CSV file at the end.
- CSV field order and headers must match
assets/bibliography_template.csv. - Encoding must be UTF-8 to avoid garbled characters.
- If any field cannot be extracted, write
Not recognized(never leave empty). - Only two files may be generated in total:
- Summary Markdown
- CSV
- No temporary/intermediate/auxiliary files may be left behind (including extracted text dumps, caches, logs, images, backups). If conversion/extraction requires intermediate artifacts, keep them in memory or ensure all non-target files are deleted before final output.
- Do not use PowerShell to directly write/manipulate CSV/Markdown to avoid encoding/newline issues; always generate and save using UTF-8.
Reference
- Detailed rules and field descriptions:
references/guide.md
相关科研 Skill
中药材分子鉴定用ITS2等DNA条形码鉴定药材基原物种,处理多基原与降解样品局限。适用于药材真伪鉴别研究,不替代法定检验。
中药网络药理学用TCMSP等数据库构建成分-靶点-通路网络并做富集分析,批判性讨论方法学局限。适用于中药机制假设生成与论文方法复核。
中医术语标准与知识图谱建立中医药术语与WHO/ICD-11标准的映射,设计本体并用Neo4j构建知识图谱。适用于数据整合与科研检索,不作临床决策系统。
方剂配伍规律挖掘对方剂做药名规范化、关联规则与网络聚类分析,发现候选核心药组。适用于用药规律挖掘,结果仅为待验证假设,不作处方依据。
证候与症状数据分析对症状量表数据做术语规范、潜在类别与因子分析,探索统计学证候模式。适用于证候分型研究,结果不用于个体辨证诊断。
泵用混合物热力学计算Calculates thermodynamic properties and mixture phase behavior for pump applications using the thermo Python library’s DIPPR/NIST correlations. Use for VLE or mixture property calculations.
常见问题
文献目录整理助手能做什么?
输入:一个文献文件夹(PDF / MD / DOCX / TXT 混合,数量不限);流程:批量读 → LLM 抽提每篇的 theme / method / conclusion 三类标签;输出:一份 CSV(每行一篇文献,字段:文件名 / 标题 / 主题 / 方法 / 结论 / 关键发现),给文献综述当结构化底稿 | 输入:一个文献文件夹(PDF / MD / DOCX / TXT 混合) | 输出:CSV(每行一篇,字段:文件名 / 标题 / 主题 / 方法 / 结论 / 关键发现)。
如何安装文献目录整理助手?
在科搭 Codar 左侧点击「插件」,在「组件」页签搜索「文献目录整理助手」并安装;在 Claude Code 或 Codex 中可以发送本页的安装提示词,或下载 Skill 包后解压到 ~/.claude/skills 或 ~/.codex/skills。
文献目录整理助手需要哪些权限?
该科研 Skill声明需要:本地文件。安装前会再次列出,由你确认后才会生效。
文献目录整理助手经过官方审核吗?
是。SpeedSkills 收录的每个版本都会记录内容摘要与权限声明,当前版本已通过安全审核。