Document QQsci workflow orchestration
This commit is contained in:
parent
26613f8211
commit
c5fe6a6800
36
README.md
36
README.md
|
|
@ -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
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue