---
name: qqcites
description: Find and rank reference candidates for manuscript sentences by using the user's QQnote-skill, Zotero/Obsidian literature notes, and DeepSeek-assisted local literature screening. Use when the user sends article sentences, claims, paragraphs, or Chinese/English manuscript text and asks for references, citations, supporting papers, related literature, Obsidian-note matches, review-first citation suggestions, or locally grounded citation ranking.
---

# QQcites

Use this skill to turn a manuscript sentence or claim into a ranked list of citation candidates from the user's existing literature notes. Treat QQnote-skill as the first source of local literature context, and use DeepSeek for semantic screening when searching or judging local literature relevance.

## Workflow

1. Identify the citation need.
   - Split long input into one claim per search unit.
   - Extract mechanism, material system, method, performance metric, disease/application, and comparison terms.
   - Preserve the user's wording so the final answer can map references back to the exact sentence.

2. Check the current manuscript citation ledger before searching.
   - If a manuscript-specific `used_references.md`, `used_references.csv`, or extracted citation list is available, read it before ranking candidates.
   - Treat DOI, Zotero item key, title, and normalized first-author/year as duplicate-detection keys.
   - If no ledger exists, infer recent used references from the current conversation and recommend creating a ledger rather than relying on memory.
   - Zotero and Obsidian identify candidate papers; the ledger or manuscript citation fields identify papers already used in this manuscript.

3. Load QQnote-skill before searching.
   - Read `C:\Users\qyh15\.codex\skills\QQnote-skill\SKILL.md` if available.
   - If that installed path is unavailable, read the project copy at `E:\11 AI\01 Codex\01 Skills\QQnote-skill\SKILL.md`.
   - Use QQnote's documented Zotero/Obsidian workflow and scripts rather than inventing a separate literature-note pipeline.

4. Search local Obsidian literature notes first.
   - Default vault: `C:\Users\qyh15\Documents\Obsidian Vault`.
   - Prefer generated literature notes under QQnote's literature-note folders.
   - Use exact keywords, translated Chinese/English equivalents, acronyms, material names, and mechanism terms.
   - Prefer `rg` for text search when the vault is accessible.

5. Use web search only when local literature is insufficient.
   - Default to local QQnote/Obsidian/Zotero evidence first.
   - If local notes produce too few or weak candidates, supplement with web literature search and clearly label web-only candidates.
   - Do not replace strong local evidence with web results unless the web result is clearly more relevant or more authoritative.

6. Use DeepSeek for local semantic screening.
   - When deciding which local notes or papers are relevant, send the manuscript claim plus candidate note snippets to DeepSeek through the user's configured QQnote/AwesomeGPT/DeepSeek route.
   - Ask DeepSeek to classify each candidate as direct support, partial support, background/review support, contradictory/weak, or unrelated.
   - Do not use DeepSeek to fabricate citations. It may rank and explain local candidates only from supplied note text, Zotero metadata, abstracts, or extracted local PDF text.
   - If DeepSeek access is unavailable, report that screening was not run and provide the best deterministic local-search ranking.

7. Rank candidates by manuscript usefulness.
   - Rank by direct claim support first.
   - Within similar relevance, put review articles before primary research when the user needs background, broad motivation, mechanism overview, or field status.
   - Put primary research before reviews when the sentence makes a specific experimental, material, performance, or mechanistic claim that needs original evidence.
   - Force review-only or review-priority ranking only when the user explicitly asks for reviews, "需要综述", or "综述优先".
   - Apply citation-ledger duplicate control before final ranking: when the user says "不要重复", "不重复", or flags a repeated item, exclude previously used DOI/Zotero keys unless the item is explicitly unavoidable.
   - When repetition is allowed but discouraged, demote previously used papers and prefer unused local candidates with comparable relevance.
   - Penalize papers that only match broad keywords without supporting the sentence.

8. Verify citation metadata.
   - Prefer Zotero metadata from QQnote/Zotero when available.
   - Include DOI when available.
   - Do not invent missing DOI, year, journal, or title.
   - Mark uncertain metadata as `metadata incomplete`.

9. Update or propose updates to the citation ledger after recommending references.
   - For every recommended paper, record sentence/claim, DOI, Zotero key, title, year, type, source (`local`, `web`, or `uncertain`), and why it was used.
   - If file editing is not requested or the ledger path is unknown, include a compact "used-reference log" block in the answer so it can be appended later.
   - Keep the ledger manuscript-specific; do not globally ban papers across unrelated manuscripts or projects.

## Output

For each user sentence, return:

- `Sentence`: the exact sentence or claim being supported.
- `Best citations`: ranked candidates with title, year, journal, DOI if available, and source note path or Zotero key when available.
- `Why relevant`: one concise reason tied to the sentence.
- `Type`: `review`, `primary research`, `method`, `dataset`, or `unclear`.
- `Strength`: `direct`, `partial`, `background`, or `weak`.
- `Suggested citation use`: where the paper should be cited in the sentence or paragraph.

Read [references/citation-ranking.md](references/citation-ranking.md) when the task involves multiple sentences, many candidate notes, tie-breaking, or final table formatting.
Also read it when the user asks for performance comparison tables, literature tables, parameter extraction from original papers, unit normalization, graph-derived values, or inclusion/exclusion decisions for main-table versus supplemental-table references.

## Operating Rules

- For manuscript citation work, avoid duplicate references by checking a manuscript-specific ledger or citation-field extraction before ranking. Zotero library membership alone is not evidence that a paper has already been cited in the manuscript.
- Default duplicate policy: exact DOI/Zotero-key repeats are disallowed when the user asks for non-repetition; otherwise they are allowed only when the repeated paper is clearly the best or only support, and must be labeled as repeated.
- Keep results grounded in local QQnote/Obsidian/Zotero evidence first; if local notes are insufficient, supplement with web literature search and label those candidates as web-sourced.
- Only force review articles when the user explicitly says "需要综述", "综述优先", or otherwise asks for reviews; otherwise rank by the citation need and allow primary research to outrank reviews for specific experimental or mechanistic claims.
- If local notes are thin, say so and suggest generating or refreshing QQnote notes for the relevant Zotero items.
- Never expose API keys, AwesomeGPT settings, Zotero API keys, or private vault contents unrelated to the user's query.
- When citing Word manuscripts later, keep Word comments DOI-only if the user asks for inline citation comments; put explanations in Markdown.