QQsci-skill/references/qqwrite-brief.md

3.2 KiB

QQwrite Brief

Use this file when DeepSeek screening results need to become an input package for QQwrite.

Ownership

DeepSeek may generate the qqwrite_brief draft from:

  • the manuscript profile
  • author evidence and figure notes
  • QQnote/Zotero/Obsidian note candidates
  • DeepSeek-screened strong/weak related papers
  • target journal and template choice

QQsci owns:

  • the brief schema
  • the prompt that asks DeepSeek to generate the brief
  • schema validation
  • obvious overclaim and DOI-preservation checks
  • handoff to QQwrite

QQwrite consumes the brief. QQwrite should not re-screen literature or decide which papers are strong/weak.

Required Schema

Ask DeepSeek to return JSON whenever possible:

{
  "target_journal": "",
  "article_type": "",
  "recommended_word_template": "afm/article-template.docx",
  "material_system": "",
  "application": "",
  "central_claim": "",
  "novelty_gap": "",
  "design_principle": "",
  "key_author_evidence": [
    {
      "evidence": "",
      "source": "manuscript / figure / SI / author note",
      "supports": ""
    }
  ],
  "strong_related_papers": [
    {
      "doi": "",
      "title": "",
      "usable_for": [],
      "must_cite_near": [],
      "reason": ""
    }
  ],
  "weak_related_papers": [
    {
      "doi": "",
      "title": "",
      "usable_for": [],
      "reason": ""
    }
  ],
  "section_plan": {
    "Title": [],
    "Abstract": [],
    "Introduction": [],
    "Results and Discussion": [],
    "Conclusion": [],
    "Experimental Section": []
  },
  "claim_reference_map": [
    {
      "claim": "",
      "author_evidence": "",
      "supporting_dois": [],
      "writing_location": "",
      "status": "supported / needs author evidence / citation only / do not claim"
    }
  ],
  "must_not_overclaim": [],
  "missing_inputs": [],
  "qqwrite_instructions": []
}

DeepSeek Prompt

Give DeepSeek the screened-paper JSON and ask:

Using the screened strong/weak related papers and the author-provided manuscript
evidence, generate a QQwrite writing brief.

Rules:
1. Do not invent experimental results, mechanisms, references, DOI values, or
   figure numbers.
2. Strong papers may define novelty, direct comparison, benchmark, and citation
   placement.
3. Weak papers may support field framing, mechanism language, or writing
   structure, but must not be treated as direct benchmark papers.
4. Every major claim must include author evidence, supporting DOI, or a clear
   status explaining that it still needs evidence.
5. Preserve DOI strings exactly as provided.
6. Return JSON only, following the QQwrite brief schema.

QQsci Check Before Handoff

Before passing the brief to QQwrite, check:

  • required top-level fields are present
  • central_claim is backed by author evidence
  • every DOI came from the screened output or user input
  • weak papers are not used as direct benchmark unless justified
  • must_not_overclaim and missing_inputs are not empty when evidence is incomplete
  • recommended_word_template points to a QQwrite-owned template

If the brief fails checks, mark the issue in missing_inputs or ask DeepSeek to repair only the failed fields. Do not let QQwrite consume a malformed brief.