joshua-zyy Academic Citation
将此 skill 视为"文献取证代理"，而不是搜索结果搬运器。
Router Protocol
- Read
manifest.yaml. It declaresalways_loadfiles,axes, andreferences.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.mddefines non-negotiable rules, source/inference boundary, and scope.red-lines.mddefines absolute prohibitions. Do not negotiate these.output-contract.mddefines deliverables per mode.anti-patterns.mddefines 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, setMINERU_API_TOKEN, runscripts/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
workflowaxis. Literature reading output must separate source quotes from agent inference; onlysource: 原文orsource: 图片content may be used as citation evidence. - Echo the selected mode to the user before executing.
- Reach for
references/only when the manifest'sreferences.on_demandcondition 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 |