| name | academic-citation |
| description | Search, 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, 引用确认, 全文阅读验证. |
Academic Citation
将此 skill 视为"文献取证代理"，而不是搜索结果搬运器。
Router Protocol
- Read
manifest.yaml. It declares always_load files, axes, and references.on_demand.
- Read every file listed under
always_load. These are the skill's binding rules — not reference material.
- Apply the loaded material as constraints:
stance.md defines non-negotiable rules, source/inference boundary, and scope.red-lines.md defines absolute prohibitions. Do not negotiate these.output-contract.md defines deliverables per mode.anti-patterns.md defines known failure modes and their correct alternatives.
- If the user wants to use a local literature library, first distinguish:
local_ref_md_dir: an existing Markdown library containing _index_ref.json.local_ref_pdf_dir: a PDF directory, or any local library directory that lacks _index_ref.json.
- For
local_ref_pdf_dir, stop before citation search. Tell the user to register a MinerU API token, set MINERU_API_TOKEN, run scripts/convert-pdfs-to-md.py, and return only after they confirm PDF→MD completion. Do not proceed to local reading until the generated MD directory has _index_ref.json.
- Detect the workflow using the manifest's
workflow axis. Literature reading output must separate source quotes from agent inference; only source: 原文 or source: 图片 content may be used as citation evidence.
- Echo the selected mode to the user before executing.
- Reach for
references/ only when the manifest's references.on_demand condition is satisfied.
Modes
| Mode | Use when |
|---|
full-citation-pass | Complete coverage for a full paper or core section |
targeted-citation-search | Specific claim, section, or topic |
exemplar-set-only | Build Exemplar Set only, not full citation list |
citation-verification | Verify metadata of existing candidate list |
local-citation-pass | Local MD library first, then web supplement |
citation-verification-with-reading | Full-text reading after paper draft completion |
Agent Dispatch
| Agent | Purpose |
|---|
agents/citation_agent.md | Literature search strategy (4-class query templates, output schema) |
agents/literature-reader-agent.md | Literature reading & extraction (MD full-text → LiteratureReadingReport) |
Dispatched by academic-paper-writer orchestrator at Step 3. Subagents search and verify only; they must not modify project files or write paper prose independently. literature-reader-agent is dispatched in parallel by citation_agent or the orchestrator at Step 3a/3b.
Independent Use
| Input | Mode | Priority | Behavior |
|---|
| Section + keywords | full-citation-pass | 1 (explicit) | Full 6-step workflow |
| Citation list / seed papers | citation-verification | 1 (explicit) | Metadata only, no extra search |
local_ref_md_dir provided and _index_ref.json exists | local-citation-pass | 2 (path trigger) | Local MD + batch parallel reader agent dispatch |
Local PDF library path provided, or local path lacks _index_ref.json | pdf2md-preflight | 1 (blocking preflight) | Instruct MinerU setup and script command; wait for user confirmation |
| Section only | targeted-citation-search | 3 (single feature) | Auto-keyword, 4-class query |
| Explicit Exemplar Set request | exemplar-set-only | 1 (explicit) | Exemplar Set only |
Multi-condition: lower priority number wins.
| Scenario | Recommended |
|---|
| Just searching/verifying citations | This skill (standalone) |
| Integrating into paper drafting | academic-paper-writer orchestrator |
| Existing draft needs citation review | This skill → academic-reviser |
