自动为文章添加参考文献
by @vigorouspp
自动为学术文章添加参考文献。解析文章内容提取主题和关键词， 调用 academic-search 检索相关论文，推荐候选文献供用户确认， 自动插入格式化的引用。支持 Markdown/LaTeX/Word 输入， 输出 BibTeX/GB/T 7714/APA 格式。当用户说"帮我加参考文献"、 "给这篇文章找引...
clawhub install auto-citation📖 About This Skill
name: auto-citation description: | 自动为学术文章添加参考文献。解析文章内容提取主题和关键词， 调用 academic-search 检索相关论文，推荐候选文献供用户确认， 自动插入格式化的引用。支持 Markdown/LaTeX/Word 输入， 输出 BibTeX/GB/T 7714/APA 格式。当用户说"帮我加参考文献"、 "给这篇文章找引用"或处理 .md/.tex/.docx 文件时触发。
自动添加参考文献
触发检测
检测以下信号时激活本 Skill：
意图信号（中文）
意图信号（英文）
文件信号
.md / .tex / .docx前置依赖
必需依赖
本 Skill 依赖 academic-search Skill 进行论文检索。安装命令：
git clone https://github.com/ustc-ai4science/academic-search ~/.cursor/skills/academic-search
bash ~/.cursor/skills/academic-search/scripts/check-deps.sh
Python 依赖
pip install python-docx textract
工作流程
Step 1: 解析文档
运行解析脚本提取文档关键信息：
python ~/.cursor/skills/auto-citation/scripts/parse_document.py <文件路径>
输出内容：
Step 2: 生成搜索策略
基于解析结果，生成 2-4 个互补搜索 query：
策略原则：
Step 3: 并行检索
调用 academic-search Skill 执行多 query 搜索：
子 Agent 任务分发：
├── Query 1: "graph neural network time series" → arXiv + S2
├── Query 2: "GNN temporal data prediction" → arXiv + S2
├── Query 3: "time series forecasting deep learning" → Google Scholar
└── 合并结果，DOI/arXiv ID 去重
搜索参数：
Step 4: 去重与筛选
去重规则（按优先级）： 1. DOI 精确匹配 2. arXiv ID 匹配 3. 标题 + 年份 + 第一作者匹配
筛选逻辑：
Step 5: 推荐候选
向用户展示候选列表，格式如下：
基于你的文章主题（GNN 时间序列预测），我找到以下相关论文：[1] Title A - 被引 150 次 (2023)
作者：Author A, Author B
相关点：与你第 2 节的方法直接相关，可作为主要对比 baseline
[2] Title B - 被引 89 次 (2024) [新]
作者：Author C et al.
相关点：最新 SOTA 方法，建议作为主要引用
[3] Title C - 被引 320 次 (2021)
作者：Author D
相关点：领域经典工作，适合引言背景介绍
请输入你想引用的编号（如：1,3,5），或：
输入 "更多" 查看下一批候选
输入 "调整" 修改搜索方向
输入特定需求（如："找几篇中文文献"）
Step 6: 格式化与插入
格式选择（按以下优先级）：
1. 用户明确指定（"用 GB/T 7714 格式"）
2. 文件内标记（）
3. 环境变量（AUTO_CITATION_STYLE=gb7714）
4. 根据文件类型推断（.tex → BibTeX, .docx → GB7714）
格式化命令：
python ~/.cursor/skills/auto-citation/scripts/format_citation.py \
--style {bibtex|gb7714|apa} \
--papers \
--output <输出路径>
插入命令：
python ~/.cursor/skills/auto-citation/scripts/insert_citation.py \
--document <原文路径> \
--citations <引用文件> \
--output <输出路径>
引用格式说明
BibTeX 格式
适用于 LaTeX 文档。文件组织：
.bib 文件\cite{key} 标记\bibliographystyle 自定义样式示例输出：
@inproceedings{wang2023gnn,
title={Graph Neural Networks for Time Series Prediction},
author={Wang, X. and Li, Y.},
booktitle={NeurIPS},
year={2023}
}
GB/T 7714 格式
适用于中文论文和学位论文。文中引用：上标 [1] 或 [1-3]
文末列表：按引用顺序编号
示例输出：
[1] Wang X, Li Y. Graph Neural Networks for Time Series Prediction[C].
NeurIPS, 2023.
[2] Zhang S. Deep Learning Methods[J]. Journal of AI, 2024, 10(2): 100-120.
APA 格式
适用于社会科学和国际期刊。文中引用：作者-年份制 (Wang & Li, 2023)
文末列表：按作者字母排序
示例输出：
Wang, X., & Li, Y. (2023). Graph neural networks for time series prediction.
In NeurIPS (pp. 1000-1010).
用户交互模式
模式一：全自动推荐
用户未指定具体需求时，AI 自主完成全部流程。模式二：定向补充
用户指定特定位置或主题：模式三：精确匹配
用户提供部分信息：质量检查清单
每次执行后自我检查：
错误处理
情况 1: 文档解析失败
情况 2: 搜索结果为空
情况 3: 用户不满意推荐