Academic Citation Agent Skill

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 |