joshua-zyy/academic-paper-writer / skills/academic-citation
academic-citation
VerifiedSearch, verify, and map citations for CS/AI/ML papers. Produces VERIFIED/UNVERIFIED reference lists with Citation-to-Claim maps and Exemplar Sets. Use when: finding references for a paper section, verifying citation accuracy, building exemplar sets for introduction/related work learning, checking if existing citations are real and accurate, supplementing local literature library. Triggers on: 找引用, 文献检索, citation pass, find references, reference check, 补文献, citation verification, Exemplar Set, search papers, verify citation, 核验文献, 查引用, literature search, reference verification, citation verification with reading, 引用确认, 全文阅读验证.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.4 KB |
| agents/citation_agent.md | markdown | 8.9 KB |
| agents/literature-reader-agent.md | markdown | 11.2 KB |
| manifest.yaml | config | 1.8 KB |
| references/citation-mapping.md | markdown | 2.1 KB |
| references/search-strategy.md | markdown | 2.9 KB |
| references/verification-protocol.md | markdown | 2.8 KB |
| references/workflow-citation-pass.md | markdown | 6.0 KB |
| scripts/citation_audit.py | script | 3.5 KB |
| scripts/convert-pdfs-to-md.py | script | 2.2 KB |
| scripts/convert_pdfs_to_md_mineru_api.py | script | 23.2 KB |
| static/core/anti-patterns.md | markdown | 603 B |
| static/core/output-contract.md | markdown | 1.1 KB |
| static/core/red-lines.md | markdown | 391 B |
| static/core/stance.md | markdown | 3.5 KB |
references/verification-protocol.md
View on GitHub# 文献核验协议
## VERIFIED 判定标准
只有在以下信息**全部**能从可信来源确认时,才可标为 `VERIFIED`:
- 标题准确
- 作者列表准确
- venue 准确
- 年份准确
- 来源链接可定位到原始论文页面或权威索引页面
核验时逐项确认,不得跳过任何一项。
## UNVERIFIED 判定标准
出现以下**任一**情况时,标为 `UNVERIFIED`:
- 只能从搜索结果或摘要卡片看到标题,未打开原始来源
- 作者、venue、年份存在不一致
- 只有博客、二手网页或截图
- 仅凭模型记忆生成条目
`UNVERIFIED` 条目不得直接写成正文中的确定性引用。
## 核验流程
1. 对每篇候选文献,先定位到一级来源页面
2. 逐一核对:标题 → 作者列表 → venue → 年份
3. 确认来源链接指向原始论文页面或权威索引
4. 若任何一项无法确认,标记为 `UNVERIFIED`,放入候选列表而非正文引用
5. 只有全部通过核验的条目才能标记为 `VERIFIED` 并写入正文
## 利用本地 PDF 或现有草稿
若仓库中已有 PDF、BibTeX、旧草稿或参考文献列表:
- 将它们作为 seed sources,提取题目、作者、年份和方法关键词
- 再回到一级来源核验,而不是直接照抄旧草稿
- 旧草稿里的引文不是天然可信,只能视为检索线索
## 本地 MD 文献库核验规则
当从本地文献库(`refs_md/`)读取 PDF 转 MD 版本进行引用时,适用以下规则:
1. **MD 内容仅为 PDF 的转换产物,核验标准等同一级来源**:
- MD 中的 title、authors 等信息来源于 PDF 本身,仍须与一级来源(DOI、arXiv 页面等)交叉验证
- 仅凭 MD 文件中的元数据不足以独立标记 VERIFIED
2. **MD 文件只能作为"全文内容可读"的载体,不能替代元数据核验**:
- MD 中提取的 core claims、key results 可直接用于判断「该论文与本文的相关性」
- 但引用该论文时仍须确认元数据(标题、作者、venue 等)的准确性
3. **增量转换的时效保证**:
- 使用 `convert-pdfs-to-md.py` 时确保 MD 和图片目录不比对应 PDF 旧(脚本默认检查 mtime,包含图片目录)
- 若用户更新了 PDF 但未重新运行脚本,agent 应提示"MD 可能过期,建议重新转换"
4. **多源冲突处理**:
- MD 内容与一级来源元数据不一致 → 以一级来源为准
- 在 `verified_references.items.notes` 中标注"MD 内容与元数据存在差异"
## 禁止行为
- 编造并不存在的论文
- 猜测作者列表、年份或 venue
- 只因为"这句话看起来需要引用"就随意补一篇文献
- 只引用与你最相似的方法,故意忽略强基线或不利比较
- 把未核验候选文献伪装成已确认引用
- 在正文没有任何 inline citation 的情况下输出完整参考文献列表
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |