From 04e7090f28f421c3a747ed175654e86bd4e116af Mon Sep 17 00:00:00 2001 From: qyh15 Date: Wed, 27 May 2026 22:44:13 +0800 Subject: [PATCH] Consume QQsci writing briefs --- README.md | 12 +++++++++--- SKILL.md | 5 ++++- references/brief-consumption.md | 32 ++++++++++++++++++++++++++++++++ 3 files changed, 45 insertions(+), 4 deletions(-) create mode 100644 references/brief-consumption.md diff --git a/README.md b/README.md index 59d7e3c..5f8de78 100644 --- a/README.md +++ b/README.md @@ -10,6 +10,8 @@ template-adjust-docx 也就是根据本地模板库里的 `.docx` 模板，帮助用户调整论文主稿的结构和格式。 +如果 QQsci 提供已经复核过的 `qqwrite_brief.json`，QQwrite 可以用它来指导章节顺序、claim 放置、DOI 批注占位和缺失证据报告。 + ## 当前能力 - 读取用户提供的 manuscript `.docx` @@ -17,6 +19,7 @@ template-adjust-docx - 对比主稿和模板的标题页、摘要、关键词、章节顺序、标题层级、图表 caption、参考文献区和常见投稿字段 - 生成调整后的 Word 副本 - 生成 Markdown 报告，说明调整内容和仍需作者确认的问题 +- 消费 QQsci 复核后的 `qqwrite_brief.json` 默认不覆盖原稿。 @@ -38,9 +41,12 @@ QQwrite 负责 Word 模板库和模板化 `.docx` 调整。 推荐流程： -1. QQsci 先判断文章逻辑、证据链、目标期刊和投稿包问题。 -2. QQwrite 根据选定 Word 模板调整主稿格式。 -3. QQsci 再复查调整后的整包一致性。 +1. QQnote 生成候选文献笔记。 +2. QQsci 调用 DeepSeek 筛选强/弱相关文献。 +3. DeepSeek 生成 `qqwrite_brief.json` 初稿。 +4. QQsci 复核 brief。 +5. QQwrite 根据复核后的 brief 和 Word 模板调整主稿。 +6. QQsci 再复查调整后的整包一致性。 ## 安装位置 diff --git a/SKILL.md b/SKILL.md index 421b7f6..f0fe40f 100644 --- a/SKILL.md +++ b/SKILL.md @@ -5,7 +5,7 @@ description: Adjust manuscript Word documents to match journal or group writing # QQwrite -QQwrite is the Word-template execution skill for manuscript writing workflows. Its current scope is intentionally narrow: use a template from the local template library to adjust a user's manuscript Word file while preserving scientific meaning. +QQwrite is the Word-template execution skill for manuscript writing workflows. Its current scope is intentionally narrow: use a template from the local template library to adjust a user's manuscript Word file while preserving scientific meaning. When available, consume a QQsci-checked `qqwrite_brief.json` to guide section order, claim placement, DOI placeholders, and missing-input reporting. ## Core Rule @@ -31,6 +31,7 @@ For template handling details, read `references/template-adjustment.md`. 1. Identify inputs: - source manuscript `.docx` - template `.docx` + - optional QQsci-checked `qqwrite_brief.json` - target journal or template name if provided - output directory @@ -39,6 +40,7 @@ For template handling details, read `references/template-adjustment.md`. - compare title page fields, abstract, keywords, main text, methods, references, captions, acknowledgements, and supporting information pointers - inspect paragraph styles, table count, figure-caption patterns, references section, and obvious empty or duplicated sections - run `scripts/docx_template_audit.py` when a quick structural report is useful + - if a `qqwrite_brief.json` is provided, read `references/brief-consumption.md` 3. Adjust only formatting and template structure unless the user explicitly asks for rewriting: - move or relabel sections to match the template @@ -62,6 +64,7 @@ For template handling details, read `references/template-adjustment.md`. ## Boundaries - QQwrite does not decide manuscript novelty, literature strength, or reviewer risk. Route those tasks to QQsci. +- QQwrite does not generate or repair `qqwrite_brief.json`; DeepSeek drafts it and QQsci checks it. - QQwrite does not generate Zotero/DeepSeek literature notes. Route those tasks to QQnote. - QQwrite may lightly fix obvious Word-format inconsistencies, but substantial scientific rewriting belongs in QQsci or a future writing module expansion. - For citation suggestions inside Word, follow QQsci's DOI-only comment convention if the task explicitly involves citation comments. diff --git a/references/brief-consumption.md b/references/brief-consumption.md new file mode 100644 index 0000000..b901bf7 --- /dev/null +++ b/references/brief-consumption.md @@ -0,0 +1,32 @@ +# Consuming QQwrite Briefs + +Use this file when QQwrite receives a QQsci-checked `qqwrite_brief.json`. + +## Role + +The brief is a writing and formatting input, not a literature-screening task. +QQwrite must not reclassify strong/weak papers or invent missing evidence. + +## How To Use The Brief + +- Use `recommended_word_template` to select the template. +- Use `section_plan` to order manuscript sections and create headings. +- Use `central_claim`, `novelty_gap`, and `design_principle` to guide title, + abstract, introduction, and conclusion placement. +- Use `key_author_evidence` as the only source for experimental results and + mechanism claims. +- Use `claim_reference_map` to decide where DOI-only citation comments or + placeholders should appear. +- Use `must_not_overclaim` to avoid inflated wording. +- Use `missing_inputs` in the Markdown report and do not hide those gaps. + +## Stop Conditions + +Stop and route back to QQsci if: + +- the brief is missing `central_claim`, `section_plan`, or + `claim_reference_map` +- the brief uses weak papers as direct benchmark papers +- a major claim has neither author evidence nor DOI support +- DOI strings appear malformed or inconsistent +- the requested template is not available in QQwrite's template library