aboutsummaryrefslogtreecommitdiffstats
path: root/.agents/skills/citation-verification/scripts/README.md
diff options
context:
space:
mode:
authorsillylaird <sillyfanboy@gmail.com>2026-09-03 00:33:59 +0000
committersillylaird <sillyfanboy@gmail.com>2026-09-03 00:33:59 +0000
commit898b52edcb47bcb3e9d6106e74ca73e74ea01e70 (patch)
tree85c6ee5ad58b860144551184d4cf86b560c62b91 /.agents/skills/citation-verification/scripts/README.md
downloadwww-898b52edcb47bcb3e9d6106e74ca73e74ea01e70.tar.gz
www-898b52edcb47bcb3e9d6106e74ca73e74ea01e70.zip
import live www.sillylaird.ca webrootHEADmain
Diffstat (limited to '')
-rw-r--r--.agents/skills/citation-verification/scripts/README.md81
1 files changed, 81 insertions, 0 deletions
diff --git a/.agents/skills/citation-verification/scripts/README.md b/.agents/skills/citation-verification/scripts/README.md
new file mode 100644
index 0000000..5f1bd38
--- /dev/null
+++ b/.agents/skills/citation-verification/scripts/README.md
@@ -0,0 +1,81 @@
+# Citation Verification Scripts
+
+## 状态说明
+
+**这些脚本是参考实现,不是主要工作流的一部分。**
+
+本目录中的Python脚本提供了基于API的引用验证实现,但**实际的引用验证工作流使用WebSearch和Google Scholar**,而不是这些脚本。
+
+## 为什么保留这些脚本?
+
+这些脚本作为**参考实现**保留,用于:
+
+1. **理解验证逻辑** - 展示引用验证的完整逻辑和步骤
+2. **学习API使用** - 了解如何使用CrossRef、arXiv、Semantic Scholar等API
+3. **高级用例** - 对于需要批量验证或自动化的场景,可以参考这些实现
+
+## 主要工作流
+
+**实际的引用验证应该使用 `ml-paper-writing` skill 中的 Citation Workflow:**
+
+1. 使用 WebSearch 查找论文
+2. 在 Google Scholar 上验证
+3. 从 Google Scholar 获取 BibTeX
+4. 验证声明(如需要)
+5. 添加到 bibliography
+
+详见 `ml-paper-writing` skill 的 "Citation Workflow (Hallucination Prevention)" 部分。
+
+## 脚本说明
+
+### verify-citations.py
+
+完整的引用验证脚本,包含:
+- 四层验证机制(格式、存在性、信息匹配、内容验证)
+- 多API支持(CrossRef、arXiv、Semantic Scholar)
+- 报告生成
+
+**用途**: 参考实现,了解完整的验证逻辑
+
+### api-clients.py
+
+API客户端库,包含:
+- CrossRefClient - DOI验证
+- ArXivClient - arXiv论文验证
+- SemanticScholarClient - 通用学术搜索
+- CitationAPIManager - 统一API管理
+
+**用途**: 参考实现,了解如何使用学术API
+
+### format-checker.py
+
+BibTeX和LaTeX格式检查工具,包含:
+- BibTeX格式验证
+- LaTeX引用检查
+- 格式错误报告
+
+**用途**: 参考实现,了解格式检查逻辑
+
+## 使用建议
+
+**对于日常论文写作**:
+- ✅ 使用 `ml-paper-writing` skill 的 Citation Workflow
+- ✅ 使用 WebSearch 和 Google Scholar
+- ❌ 不要使用这些Python脚本
+
+**对于批量验证或自动化**:
+- 可以参考这些脚本的实现
+- 根据需要修改和使用
+- 注意API速率限制
+
+## 依赖安装
+
+如果需要运行这些脚本(仅用于参考或高级用例):
+
+```bash
+pip install bibtexparser requests semanticscholar arxiv
+```
+
+## 更多信息
+
+详见 `citation-verification` skill 的 SKILL.md 文件。