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/citation-mapping.md
View on GitHub# 引用映射指南
## Citation-to-Claim 映射
对每条正文使用的文献,至少记录:
| 字段 | 说明 |
|------|------|
| `title` | 论文标题 |
| `authors` | 作者列表 |
| `venue` | 发表会议/期刊 |
| `year` | 发表年份 |
| `source link` | 一级来源链接 |
| `status` | VERIFIED / UNVERIFIED |
| `why it matters` | 为什么这篇文献与本文相关 |
| `used in` | 在哪个 section 使用(Introduction / Related Work / Baseline comparison / Discussion) |
| `inline citation marker` | 正文中的引用标记(如 [1]) |
## 推荐输出格式
```md
## Verified References
1. Title: ...
Authors: ...
Venue: ...
Year: ...
Source Link: ...
Status: VERIFIED
Why It Matters: ...
Used In: Introduction / Related Work / Baseline comparison / Discussion
Inline Citation Marker: [1]
```
若只是候选而非正文已用文献,放在 `Candidate References` 中,不与 Verified References 混写。
## Exemplar Set 维护
用于章节组织学习而非直接正文引用的论文,可额外维护:
```md
## Exemplar Set
1. Title: ...
Why exemplar: ...
Observed structure: ...
Reusable moves: ...
Not reusable: ...
```
Exemplar Set 的用途是帮助写出更像该领域论文的 Introduction 或 Related Work,不是提供可复制原文。
## 正文映射规则
- 若一条文献已进入 `Verified References` 且被正文使用,则正文中**必须**出现对应的 inline citation marker
- 若正文中存在需要文献支撑的背景事实、方法比较或数据来源说明,却没有可用文献,则在该处直接保留 `[REF_NEEDED: ...]`
- 不要先生成 bibliography 再假设读者会自己猜哪些句子对应哪些参考文献
- 若目标 venue 未知,优先使用简单一致的 numeric style,例如 `[1]`, `[2]`
## 引用闭合检查
完成当前 section 后,检查:
- 需要文献支撑的段落是否有 inline citation 或 `[REF_NEEDED: ...]`
- 参考文献列表中的条目是否真的在正文中被引用
- 引用格式是否前后一致
- 是否存在"有参考文献列表但正文没有任何 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 |