Document QQsci workflow orchestration

This commit is contained in:
qyh15 2026-05-27 20:11:22 +08:00
parent 26613f8211
commit c5fe6a6800
1 changed files with 33 additions and 3 deletions

View File

@ -1,7 +1,9 @@
# QQsci # QQsci
QQsci is a Codex skill for materials-science manuscript writing, submission-package QQsci is a Codex workflow skill for scientific manuscript projects. It acts as
audit, literature-grounded revision, and Word DOI-only citation comments. 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: 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 - target-journal positioning and reviewer-style pre-submission audit
- AFM Word article template assets - 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: 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 - check figures, captions, SI consistency, formatting, spelling, and terminology
- produce Markdown reviewer reports - produce Markdown reviewer reports
- add Word native citation comments containing DOI strings only - 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 QQsci does not directly insert Zotero Word fields. For Word manuscripts, citation
suggestions are added as native comments with one DOI per line. 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 should not decide whether a paper is strongly related, weakly related, necessary
for citation, or sufficient as reviewer evidence. 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: When QQsci calls QQnote, use:
```powershell ```powershell