From c5fe6a6800f6135aa712f5acd2cac8063e5674a2 Mon Sep 17 00:00:00 2001 From: qyh15 Date: Wed, 27 May 2026 20:11:22 +0800 Subject: [PATCH] Document QQsci workflow orchestration --- README.md | 36 +++++++++++++++++++++++++++++++++--- 1 file changed, 33 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 0d4dd43..f659443 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,9 @@ # QQsci -QQsci is a Codex skill for materials-science manuscript writing, submission-package -audit, literature-grounded revision, and Word DOI-only citation comments. +QQsci is a Codex workflow skill for scientific manuscript projects. It acts as +the top-level orchestrator for materials-science writing, literature-grounded +revision, submission-package audit, Word DOI-only citation comments, and future +specialized modules such as QQwrite, QQfigure, and QQppt. It is designed for workflows that combine: @@ -12,7 +14,29 @@ It is designed for workflows that combine: - target-journal positioning and reviewer-style pre-submission audit - AFM Word article template assets -## Scope +## Workflow Role + +QQsci is the research-writing workflow controller, not a single-purpose writing +tool. It should decide which module to call, pass structured inputs between +modules, and perform final package-level quality control. + +Planned module ecosystem: + +| Module | Role | +|---|---| +| QQnote | Zotero child-note summaries and paper comparison tables | +| QQwrite | Long-form manuscript drafting, section rewriting, and Word template use | +| QQfigure | Materials figures, mechanism diagrams, TOC graphics, and figure QA | +| QQppt | Group meeting, journal club, submission, and defense slides | +| nature-citation | High-quality DOI candidates and claim-reference support | +| nature-data | Data availability, source data, repository, and FAIR checks | +| nature-response | Reviewer-response and revision-letter workflows | +| academic-humanizer | Academic de-AI wording, style naturalization, and consistency checks | + +QQsci's built-in modules remain the quality-control layer until specialized +QQ* modules are developed. + +## Current Scope QQsci owns the manuscript-facing reasoning: @@ -23,6 +47,8 @@ QQsci owns the manuscript-facing reasoning: - check figures, captions, SI consistency, formatting, spelling, and terminology - produce Markdown reviewer reports - add Word native citation comments containing DOI strings only +- route work to QQnote and future QQwrite/QQfigure/QQppt modules +- manage project-level DeepSeek, Zotero, Obsidian, and template configuration QQsci does not directly insert Zotero Word fields. For Word manuscripts, citation suggestions are added as native comments with one DOI per line. @@ -40,6 +66,10 @@ QQsci then consumes those notes/tables and makes the manuscript decisions. QQnot should not decide whether a paper is strongly related, weakly related, necessary for citation, or sufficient as reviewer evidence. +QQnote must remain usable by itself. When QQsci calls QQnote, QQsci can inject +its own DeepSeek and Zotero configuration through +`scripts/run_qqnote_with_qqsci_config.py`. + When QQsci calls QQnote, use: ```powershell