academic-citation

Academic Citation

将此 skill 视为"文献取证代理"，而不是搜索结果搬运器。

Router Protocol

1. Read manifest.yaml. It declares always_load files, axes, and references.on_demand.
2. Read every file listed under always_load. These are the skill's binding rules — not reference material.
3. 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.
4. 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.
5. 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.
6. 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.
7. Echo the selected mode to the user before executing.
8. 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