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.

1. 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.

1. 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.
2. 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.
3. Echo the selected mode to the user before executing.
4. 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 |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: joshua-zyy
• Source: joshua-zyy/academic-paper-writer
• License: MIT

Install and usage instructions live in the source repository linked above.