psyclaw 0.28.1 → 0.28.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -5
- package/agents/recommended/catalog.json +1 -1
- package/dist/src/adapters/pi/extension.js +79 -25
- package/dist/src/adapters/pi/extension.js.map +1 -1
- package/dist/src/ars/keybindings.d.ts +13 -0
- package/dist/src/ars/keybindings.js +50 -0
- package/dist/src/ars/keybindings.js.map +1 -0
- package/dist/src/ars/mode-editor.d.ts +25 -0
- package/dist/src/ars/mode-editor.js +78 -0
- package/dist/src/ars/mode-editor.js.map +1 -0
- package/dist/src/ars/profile.d.ts +4 -1
- package/dist/src/ars/profile.js +23 -6
- package/dist/src/ars/profile.js.map +1 -1
- package/dist/src/chat.js +3 -0
- package/dist/src/chat.js.map +1 -1
- package/dist/src/panel/server.js +1 -1
- package/dist/src/panel/server.js.map +1 -1
- package/package.json +10 -3
- package/vendor/academic-paper-skills/LICENSE +21 -0
- package/vendor/academic-paper-skills/NOTICE.md +7 -0
- package/vendor/academic-paper-skills/PSYCLAW_SOURCE.json +14 -0
- package/vendor/academic-paper-skills/academic-paper-composer/SKILL.md +840 -0
- package/vendor/academic-paper-skills/academic-paper-composer/references/section_guides.md +675 -0
- package/vendor/academic-paper-skills/academic-paper-composer/references/writing_standards.md +629 -0
- package/vendor/academic-paper-skills/academic-paper-composer/scripts/chapter_quality_check.py +470 -0
- package/vendor/academic-paper-skills/academic-paper-composer/scripts/final_evaluation.py +550 -0
- package/vendor/academic-paper-skills/academic-paper-strategist/SKILL.md +670 -0
- package/vendor/academic-paper-skills/academic-paper-strategist/references/quality_standards.md +336 -0
- package/vendor/academic-paper-skills/academic-paper-strategist/references/search_strategy.md +459 -0
- package/vendor/academic-paper-skills/academic-paper-strategist/scripts/evaluate_samples.py +300 -0
- package/vendor/academic-paper-skills/academic-paper-strategist/scripts/gap_analysis.py +399 -0
- package/vendor/ars/pi/wrapper.js +9 -0
- package/vendor/nature-skills/LICENSE +201 -0
- package/vendor/nature-skills/NOTICE.md +7 -0
- package/vendor/nature-skills/PSYCLAW_SOURCE.json +19 -0
- package/vendor/nature-skills/skills/nature-figure/README.md +107 -0
- package/vendor/nature-skills/skills/nature-figure/README_EN.md +107 -0
- package/vendor/nature-skills/skills/nature-figure/SKILL.md +154 -0
- package/vendor/nature-skills/skills/nature-figure/agents/openai.yaml +4 -0
- package/vendor/nature-skills/skills/nature-figure/evals/evals.json +325 -0
- package/vendor/nature-skills/skills/nature-figure/manifest.yaml +103 -0
- package/vendor/nature-skills/skills/nature-figure/references/ai-graphical-abstract-workflow.md +129 -0
- package/vendor/nature-skills/skills/nature-figure/references/api.md +576 -0
- package/vendor/nature-skills/skills/nature-figure/references/asset-adaptation.md +72 -0
- package/vendor/nature-skills/skills/nature-figure/references/backend-selection.md +118 -0
- package/vendor/nature-skills/skills/nature-figure/references/chart-types.md +348 -0
- package/vendor/nature-skills/skills/nature-figure/references/common-patterns.md +371 -0
- package/vendor/nature-skills/skills/nature-figure/references/demos.md +58 -0
- package/vendor/nature-skills/skills/nature-figure/references/design-theory.md +467 -0
- package/vendor/nature-skills/skills/nature-figure/references/figure-contract.md +122 -0
- package/vendor/nature-skills/skills/nature-figure/references/figure-legend-conventions.md +90 -0
- package/vendor/nature-skills/skills/nature-figure/references/multipanel-evidence-architecture.md +268 -0
- package/vendor/nature-skills/skills/nature-figure/references/nature-2026-observations.md +124 -0
- package/vendor/nature-skills/skills/nature-figure/references/nature-article-requirements.md +149 -0
- package/vendor/nature-skills/skills/nature-figure/references/openrouter-image-generation.md +141 -0
- package/vendor/nature-skills/skills/nature-figure/references/qa-contract.md +344 -0
- package/vendor/nature-skills/skills/nature-figure/references/r-template-index.md +66 -0
- package/vendor/nature-skills/skills/nature-figure/references/r-workflow.md +234 -0
- package/vendor/nature-skills/skills/nature-figure/references/template-catalog.md +33 -0
- package/vendor/nature-skills/skills/nature-figure/references/tutorials.md +260 -0
- package/vendor/nature-skills/skills/nature-figure/requirements.txt +1 -0
- package/vendor/nature-skills/skills/nature-figure/scripts/audit_figure_collisions.py +742 -0
- package/vendor/nature-skills/skills/nature-figure/scripts/audit_panel_alignment.py +933 -0
- package/vendor/nature-skills/skills/nature-figure/scripts/audit_pdf_text.py +152 -0
- package/vendor/nature-skills/skills/nature-figure/scripts/figure_safety.py +50 -0
- package/vendor/nature-skills/skills/nature-figure/scripts/generate_openrouter_schematic.py +260 -0
- package/vendor/nature-skills/skills/nature-figure/scripts/nature_figure_backend.py +93 -0
- package/vendor/nature-skills/skills/nature-figure/scripts/panel_alignment.R +188 -0
- package/vendor/nature-skills/skills/nature-figure/scripts/plot_templates.py +604 -0
- package/vendor/nature-skills/skills/nature-figure/scripts/validate_figure.py +835 -0
- package/vendor/nature-skills/skills/nature-figure/static/core/contract.md +55 -0
- package/vendor/nature-skills/skills/nature-figure/static/core/stance.md +41 -0
- package/vendor/nature-skills/skills/nature-figure/static/fragments/backend/python.md +56 -0
- package/vendor/nature-skills/skills/nature-figure/static/fragments/backend/r.md +63 -0
- package/vendor/nature-skills/skills/nature-figure/tests/test_figure_safety.py +209 -0
- package/vendor/nature-skills/skills/nature-polishing/README.md +58 -0
- package/vendor/nature-skills/skills/nature-polishing/README_EN.md +58 -0
- package/vendor/nature-skills/skills/nature-polishing/SKILL.md +111 -0
- package/vendor/nature-skills/skills/nature-polishing/agents/openai.yaml +4 -0
- package/vendor/nature-skills/skills/nature-polishing/manifest.yaml +101 -0
- package/vendor/nature-skills/skills/nature-polishing/references/latex-layout.md +211 -0
- package/vendor/nature-skills/skills/nature-polishing/references/nat-comms-2025-diction.md +73 -0
- package/vendor/nature-skills/skills/nature-polishing/references/phrasebank-playbook.md +175 -0
- package/vendor/nature-skills/skills/nature-polishing/references/published-article-patterns.md +126 -0
- package/vendor/nature-skills/skills/nature-polishing/references/section-moves.md +252 -0
- package/vendor/nature-skills/skills/nature-polishing/references/style-guardrails.md +94 -0
- package/vendor/nature-skills/skills/nature-polishing/references/writing-strategy.md +160 -0
- package/vendor/nature-skills/skills/nature-polishing/static/core/failure-modes.md +29 -0
- package/vendor/nature-skills/skills/nature-polishing/static/core/output-format.md +21 -0
- package/vendor/nature-skills/skills/nature-polishing/static/core/stance.md +26 -0
- package/vendor/nature-skills/skills/nature-polishing/static/fragments/journal/generic.md +17 -0
- package/vendor/nature-skills/skills/nature-polishing/static/fragments/journal/nat-comms.md +38 -0
- package/vendor/nature-skills/skills/nature-polishing/static/fragments/journal/nat-mach-intell.md +102 -0
- package/vendor/nature-skills/skills/nature-polishing/static/fragments/journal/nature.md +19 -0
- package/vendor/nature-skills/skills/nature-polishing/static/fragments/language/en.md +19 -0
- package/vendor/nature-skills/skills/nature-polishing/static/fragments/language/zh-to-en.md +19 -0
- package/vendor/nature-skills/skills/nature-polishing/static/fragments/paper_type/algorithmic.md +18 -0
- package/vendor/nature-skills/skills/nature-polishing/static/fragments/paper_type/hypothesis.md +17 -0
- package/vendor/nature-skills/skills/nature-polishing/static/fragments/paper_type/methods.md +35 -0
- package/vendor/nature-skills/skills/nature-polishing/static/fragments/paper_type/research.md +29 -0
- package/vendor/nature-skills/skills/nature-polishing/static/fragments/paper_type/review.md +17 -0
- package/vendor/nature-skills/skills/nature-polishing/static/fragments/section/abstract.md +26 -0
- package/vendor/nature-skills/skills/nature-polishing/static/fragments/section/conclusion.md +15 -0
- package/vendor/nature-skills/skills/nature-polishing/static/fragments/section/discussion.md +48 -0
- package/vendor/nature-skills/skills/nature-polishing/static/fragments/section/intro.md +33 -0
- package/vendor/nature-skills/skills/nature-polishing/static/fragments/section/methods.md +26 -0
- package/vendor/nature-skills/skills/nature-polishing/static/fragments/section/results.md +61 -0
- package/vendor/nature-skills/skills/nature-polishing/static/fragments/section/title.md +17 -0
- package/vendor/nature-skills/skills/nature-ref-verifier/README.md +44 -0
- package/vendor/nature-skills/skills/nature-ref-verifier/README_EN.md +44 -0
- package/vendor/nature-skills/skills/nature-ref-verifier/SKILL.md +196 -0
- package/vendor/nature-skills/skills/nature-ref-verifier/agents/openai.yaml +4 -0
- package/vendor/nature-skills/skills/nature-ref-verifier/manifest.yaml +19 -0
- package/vendor/nature-skills/skills/nature-ref-verifier/references/common-patterns.md +96 -0
- package/vendor/nature-skills/skills/nature-shared/README.md +43 -0
- package/vendor/nature-skills/skills/nature-shared/README_EN.md +43 -0
- package/vendor/nature-skills/skills/nature-shared/SKILL.md +33 -0
- package/vendor/nature-skills/skills/nature-shared/agents/openai.yaml +6 -0
- package/vendor/nature-skills/skills/nature-shared/core/consistency-sweep.md +122 -0
- package/vendor/nature-skills/skills/nature-shared/core/discussion-argument-language.md +192 -0
- package/vendor/nature-skills/skills/nature-shared/core/ethics.md +88 -0
- package/vendor/nature-skills/skills/nature-shared/core/main-text-discipline.md +179 -0
- package/vendor/nature-skills/skills/nature-shared/core/nature-abstract.md +171 -0
- package/vendor/nature-skills/skills/nature-shared/core/nature-introduction.md +164 -0
- package/vendor/nature-skills/skills/nature-shared/core/nature-results-discussion.md +215 -0
- package/vendor/nature-skills/skills/nature-shared/core/paper-type-taxonomy.md +41 -0
- package/vendor/nature-skills/skills/nature-shared/core/reader-workflow.md +21 -0
- package/vendor/nature-skills/skills/nature-shared/core/research-compliance.md +192 -0
- package/vendor/nature-skills/skills/nature-shared/core/terminology-ledger.md +58 -0
- package/vendor/nature-skills/skills/nature-shared/journal-formats/nat-comms.md +139 -0
- package/vendor/nature-skills/skills/nature-shared/journal-formats/nature-machine-intelligence.md +431 -0
- package/vendor/nature-skills/skills/nature-shared/journal-formats/nature.md +313 -0
- package/vendor/nature-skills/skills/nature-shared/manifest.yaml +52 -0
- package/vendor/nature-skills/skills/nature-shared/scripts/check_consistency.py +273 -0
- package/vendor/nature-skills/skills/nature-shared/tests/test_check_consistency.py +63 -0
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
# Writing Strategy
|
|
2
|
+
|
|
3
|
+
## Contents
|
|
4
|
+
|
|
5
|
+
- [Core stance](#core-stance)
|
|
6
|
+
- [Hourglass structure](#hourglass-structure)
|
|
7
|
+
- [Writing order is not reading order](#writing-order-is-not-reading-order)
|
|
8
|
+
- [Claim, evidence, boundary](#claim-evidence-boundary)
|
|
9
|
+
- [Section responsibilities](#section-responsibilities)
|
|
10
|
+
- [Citation as positioning](#citation-as-positioning)
|
|
11
|
+
- [Fairness to earlier work](#fairness-to-earlier-work)
|
|
12
|
+
- [Overclaim control](#overclaim-control)
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
Use this file when the user is not just asking for cleaner English, but for better scientific writing logic. This is the layer that should govern all paragraph- and section-level rewriting.
|
|
16
|
+
|
|
17
|
+
## Core stance
|
|
18
|
+
|
|
19
|
+
Academic polishing is not only about style. It is also about making the reasoning legible. A polished paragraph that still performs the wrong rhetorical job is a failed edit.
|
|
20
|
+
|
|
21
|
+
## Hourglass structure
|
|
22
|
+
|
|
23
|
+
Most strong research writing follows a `broad -> narrow -> broad` pattern:
|
|
24
|
+
|
|
25
|
+
- `Introduction`: open the territory, narrow to the gap, then state the study
|
|
26
|
+
- `Discussion/Conclusion`: start from the specific findings, then widen to implications and limits
|
|
27
|
+
|
|
28
|
+
Use this pattern when deciding paragraph order and section scope. If a draft jumps between background, results, and implications without control, rebuild the progression first.
|
|
29
|
+
|
|
30
|
+
## Writing order is not reading order
|
|
31
|
+
|
|
32
|
+
The author may draft in one order and the reader may consume in another. A useful planning sequence is:
|
|
33
|
+
|
|
34
|
+
1. results
|
|
35
|
+
2. introduction and conclusion
|
|
36
|
+
3. title
|
|
37
|
+
4. discussion
|
|
38
|
+
5. methods
|
|
39
|
+
6. abstract
|
|
40
|
+
|
|
41
|
+
The practical rule for this skill is simple: organize around evidence and argumentative function, not around the chronology of the raw draft.
|
|
42
|
+
|
|
43
|
+
## Claim, evidence, boundary
|
|
44
|
+
|
|
45
|
+
Every important scientific statement should have three parts:
|
|
46
|
+
|
|
47
|
+
1. `claim`: what is being said
|
|
48
|
+
2. `evidence`: what supports it
|
|
49
|
+
3. `boundary`: where the claim stops, or what uncertainty remains
|
|
50
|
+
|
|
51
|
+
Typical failures:
|
|
52
|
+
|
|
53
|
+
- claim without evidence
|
|
54
|
+
- data without an explicit point
|
|
55
|
+
- implication without a scope condition
|
|
56
|
+
- correlation rewritten as mechanism
|
|
57
|
+
|
|
58
|
+
When polishing, repair these failures before polishing rhythm.
|
|
59
|
+
|
|
60
|
+
## Section responsibilities
|
|
61
|
+
|
|
62
|
+
### Introduction
|
|
63
|
+
|
|
64
|
+
The Introduction should answer four questions:
|
|
65
|
+
|
|
66
|
+
1. What is already known?
|
|
67
|
+
2. What remains unresolved?
|
|
68
|
+
3. What exact question does this study ask?
|
|
69
|
+
4. How does the study address it?
|
|
70
|
+
|
|
71
|
+
Do not summarize results or conclusions here.
|
|
72
|
+
|
|
73
|
+
### Results
|
|
74
|
+
|
|
75
|
+
Results state what was observed. They should provide:
|
|
76
|
+
|
|
77
|
+
- object or system
|
|
78
|
+
- condition
|
|
79
|
+
- quantitative support
|
|
80
|
+
- direct result
|
|
81
|
+
|
|
82
|
+
Do not turn Results into a Discussion section by adding long mechanistic interpretation.
|
|
83
|
+
|
|
84
|
+
### Discussion
|
|
85
|
+
|
|
86
|
+
Discussion explains what the findings mean. It should address:
|
|
87
|
+
|
|
88
|
+
- how the work fits the broader field
|
|
89
|
+
- what has been added to understanding
|
|
90
|
+
- which earlier work is being supported, revised, or complicated
|
|
91
|
+
- which explanations are plausible
|
|
92
|
+
- which limitations constrain the interpretation
|
|
93
|
+
|
|
94
|
+
Discussion is the natural home for hedging.
|
|
95
|
+
|
|
96
|
+
### Methods
|
|
97
|
+
|
|
98
|
+
Methods should pass a reproducibility test: could another group repeat the work from this description, or from this description plus a clearly cited prior protocol?
|
|
99
|
+
|
|
100
|
+
Reject vague writing such as:
|
|
101
|
+
|
|
102
|
+
- `under standard conditions`
|
|
103
|
+
- `using routine methods`
|
|
104
|
+
- `data were analysed statistically`
|
|
105
|
+
|
|
106
|
+
### Conclusion
|
|
107
|
+
|
|
108
|
+
Conclusion is not a mini-discussion. A strong closing usually does three things:
|
|
109
|
+
|
|
110
|
+
1. restates the central contribution
|
|
111
|
+
2. identifies the decisive evidence
|
|
112
|
+
3. states the implication with a boundary
|
|
113
|
+
|
|
114
|
+
Do not introduce new data here.
|
|
115
|
+
|
|
116
|
+
### Abstract
|
|
117
|
+
|
|
118
|
+
The abstract is a mini-paper:
|
|
119
|
+
|
|
120
|
+
1. context or problem
|
|
121
|
+
2. gap
|
|
122
|
+
3. approach
|
|
123
|
+
4. key result
|
|
124
|
+
5. implication
|
|
125
|
+
|
|
126
|
+
It should help the reader decide whether the paper is relevant, credible, and potentially important.
|
|
127
|
+
|
|
128
|
+
## Citation as positioning
|
|
129
|
+
|
|
130
|
+
Citation is not just a formatting issue. It tells the reader how the current work stands relative to earlier work.
|
|
131
|
+
|
|
132
|
+
Useful categories:
|
|
133
|
+
|
|
134
|
+
- `support`: prior work supports the premise
|
|
135
|
+
- `borrow`: current work adopts a method, framework, or protocol
|
|
136
|
+
- `contrast`: current work differs in result, setting, or interpretation
|
|
137
|
+
- `reuse/adaptation`: material, data, code, or images come from elsewhere
|
|
138
|
+
|
|
139
|
+
Always cite the source actually read and verified. Do not cite a paper as direct support if you only know it through another paper's summary.
|
|
140
|
+
|
|
141
|
+
## Fairness to earlier work
|
|
142
|
+
|
|
143
|
+
Do not manufacture novelty by flattening previous studies into a weak baseline. Prefer language like:
|
|
144
|
+
|
|
145
|
+
- `Although previous studies showed ..., their performance in ... remains unclear.`
|
|
146
|
+
- `Earlier work established ..., but did not address ...`
|
|
147
|
+
|
|
148
|
+
This preserves intellectual honesty while still making the gap explicit.
|
|
149
|
+
|
|
150
|
+
## Overclaim control
|
|
151
|
+
|
|
152
|
+
Watch for:
|
|
153
|
+
|
|
154
|
+
- `prove`
|
|
155
|
+
- `conclusively`
|
|
156
|
+
- `unprecedented`
|
|
157
|
+
- `best`
|
|
158
|
+
- unqualified `first`
|
|
159
|
+
|
|
160
|
+
Replace or qualify them unless the evidence is unusually strong and the scope is tightly defined.
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# Diagnose failure mode before editing
|
|
2
|
+
|
|
3
|
+
Before rewriting, identify the main problem:
|
|
4
|
+
|
|
5
|
+
- wrong paper type logic
|
|
6
|
+
- missing gap or poor positioning
|
|
7
|
+
- claim without evidence
|
|
8
|
+
- evidence without a clear claim
|
|
9
|
+
- missing boundary or limitation
|
|
10
|
+
- Results and Discussion mixed together
|
|
11
|
+
- weak title or abstract signal
|
|
12
|
+
- inconsistent terminology, abbreviations, units, or notation across sections
|
|
13
|
+
- evidence-complete but main-text-bloated Results
|
|
14
|
+
- reviewer-driven additions appended without deleting redundant prose
|
|
15
|
+
- the same claim or full statistical report repeated across Results and captions
|
|
16
|
+
- sentence-level clutter only
|
|
17
|
+
|
|
18
|
+
Prioritize fixes in this order:
|
|
19
|
+
|
|
20
|
+
`paper type -> section job -> evidence placement -> paragraph necessity -> claim/evidence/boundary -> sentence polish`
|
|
21
|
+
|
|
22
|
+
Do not sentence-polish a draft whose section job is wrong. Surface the structural problem first, then polish.
|
|
23
|
+
|
|
24
|
+
For Results or full-main-text work, load
|
|
25
|
+
`../../../nature-shared/core/main-text-discipline.md`. Resolve evidence placement,
|
|
26
|
+
revision accretion, explanatory recursion, and claim repetition before editing
|
|
27
|
+
sentence rhythm.
|
|
28
|
+
|
|
29
|
+
Terminology consistency is a cross-cutting check that runs at every level: build the Terminology Ledger on first contact (see `../../../nature-shared/core/terminology-ledger.md`) and enforce its canonical forms throughout the polish.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# Output format
|
|
2
|
+
|
|
3
|
+
Default output:
|
|
4
|
+
|
|
5
|
+
1. The polished text as plain prose, not in a code block.
|
|
6
|
+
2. `Revision notes:` with `3-5` short bullets on the major structural and stylistic changes.
|
|
7
|
+
3. If the rewrite changed section logic, say so explicitly.
|
|
8
|
+
|
|
9
|
+
If the user asks for side-by-side revision, provide:
|
|
10
|
+
|
|
11
|
+
- `Original`
|
|
12
|
+
- `Polished`
|
|
13
|
+
- `Why changed`
|
|
14
|
+
|
|
15
|
+
If any paragraph's structural problem could not be fixed without inventing content, say so under `Revision notes:` instead of papering over it.
|
|
16
|
+
|
|
17
|
+
When the main-text discipline is triggered, add a compact
|
|
18
|
+
`Main-text discipline audit:` that identifies material kept, replaced,
|
|
19
|
+
compressed, relocated to SI/caption, or deleted; states which descriptive and
|
|
20
|
+
primary inferential quantities remain in the main text; and reports the
|
|
21
|
+
before/after word count. Do not bury the polished prose under the audit.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# Default stance
|
|
2
|
+
|
|
3
|
+
- Language serves argument. Do not polish sentences while leaving the reasoning broken.
|
|
4
|
+
- Write with empathy for the reader: relevance first, then novelty, then trust, then reuse, then meaning.
|
|
5
|
+
- There should be no mystery for the writer, but there may be one for the reader.
|
|
6
|
+
- Do not invent data, references, mechanisms, or novelty claims.
|
|
7
|
+
- Do not let AI draft the paper's core scientific argument from scratch.
|
|
8
|
+
- If the draft is Chinese or structurally rough, reconstruct the logic first and the prose second.
|
|
9
|
+
- On first contact with the draft, build a Terminology Ledger and keep terms, abbreviations, units, and notation consistent across every section. Do not introduce synonyms to vary the prose. See `../../../nature-shared/core/terminology-ledger.md`.
|
|
10
|
+
- Avoid em dashes in polished output by default. Prefer commas, parentheses, or full stops. Use colons sparingly unless the user explicitly asks to preserve dash-based punctuation or wants a colon-led style.
|
|
11
|
+
|
|
12
|
+
## Reader workflow
|
|
13
|
+
|
|
14
|
+
See `../../../nature-shared/core/reader-workflow.md` (loaded via manifest `always_load`) for the 5-step reader question sequence. Polishing should help the paper answer those questions in order.
|
|
15
|
+
|
|
16
|
+
## Protect the core argument
|
|
17
|
+
|
|
18
|
+
The paper's core argument includes:
|
|
19
|
+
|
|
20
|
+
- the scientific question the paper actually answers
|
|
21
|
+
- why that question matters
|
|
22
|
+
- how the work differs from existing research
|
|
23
|
+
- what the results imply
|
|
24
|
+
- how the main line of reasoning unfolds
|
|
25
|
+
|
|
26
|
+
AI may help polish, structure, or compare phrasings. AI should not invent or author the core argument. If the argument is weak or unclear, expose that weakness rather than hiding it under polished language.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# Journal: generic
|
|
2
|
+
|
|
3
|
+
Used when the user has not named a target journal, or the journal is not specifically modeled by another fragment.
|
|
4
|
+
|
|
5
|
+
## Defaults
|
|
6
|
+
|
|
7
|
+
- Apply Nature-leaning style without enforcing Nature's strictest length or significance-framing demands.
|
|
8
|
+
- Keep the em-dash and hedging defaults from `core/stance.md`.
|
|
9
|
+
- If the user later names a journal, apply that journal's fragment to the ongoing request; ask only if the intended scope of revision remains materially ambiguous.
|
|
10
|
+
|
|
11
|
+
## Optional context
|
|
12
|
+
|
|
13
|
+
Use these details when supplied; otherwise proceed with the generic defaults and state material assumptions. Ask only when missing information changes scientific meaning or a required deliverable. Do not turn these preferences into an intake checklist.
|
|
14
|
+
|
|
15
|
+
- Target journal and section format (structured vs unstructured abstract; word limits; reference style).
|
|
16
|
+
- Audience breadth: subfield vs broad readership.
|
|
17
|
+
- Whether the draft will go through a separate copy-edit pass (affects how aggressively to rewrite vs flag).
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# Journal: Nature Communications (polishing)
|
|
2
|
+
|
|
3
|
+
## Read the shared facts first
|
|
4
|
+
|
|
5
|
+
Open `../../../../nature-shared/journal-formats/nat-comms.md` for the authoritative formatting facts: word limits, abstract rules, figure specs, reference style, mandatory statements, and common desk-rejection patterns.
|
|
6
|
+
|
|
7
|
+
The notes below are the **polishing action layer** on top of those facts.
|
|
8
|
+
|
|
9
|
+
## Audience
|
|
10
|
+
|
|
11
|
+
Open-access, broader than a subfield journal but more specialist-tolerant than Nature. The reader is typically an active researcher in an adjacent area.
|
|
12
|
+
|
|
13
|
+
## Polishing priorities
|
|
14
|
+
|
|
15
|
+
- Significance framing matters, but a less aggressive opening than Nature is acceptable.
|
|
16
|
+
- Word count is more forgiving than Nature, but **the ~5,000-word cap includes Methods**. If polishing brings the manuscript near the limit, surface a word-budget check rather than just compressing prose.
|
|
17
|
+
- Methods can stay more detailed in-line; do not strip reproducibility content just to hit length.
|
|
18
|
+
- Same em-dash and hedging defaults as Nature.
|
|
19
|
+
- Abstract is unstructured, 150 words, no citations. If the user's abstract has citations or is structured (Background/Methods/Results), restructure before sentence polishing.
|
|
20
|
+
|
|
21
|
+
## Length-aware polishing checks
|
|
22
|
+
|
|
23
|
+
When polishing a Nature Communications Article, run these word-budget checks before sentence-level work:
|
|
24
|
+
|
|
25
|
+
1. Estimate total word count **including Methods**. Verify the current journal limit when submission compliance is requested. If over the applicable limit, continue meaning-preserving polishing and flag the gap in Revision notes. Obtain approval before substantive cuts to results, methods, or argument; length diagnosis does not block language edits.
|
|
26
|
+
2. If display items > 10, flag for redistribution into Supplementary Information before deeper edits.
|
|
27
|
+
3. If references > ~60, flag for trimming or consolidation.
|
|
28
|
+
4. If the abstract is > 150 words or contains citations, restructure first.
|
|
29
|
+
|
|
30
|
+
These are diagnostic, not destructive — surface the problem in `Revision notes:` rather than silently cutting.
|
|
31
|
+
|
|
32
|
+
## Things the shared facts already cover
|
|
33
|
+
|
|
34
|
+
Do not restate facts that live in `nature-shared/journal-formats/nat-comms.md`. Reference them when the user asks. Examples Claude should respond by reading shared facts:
|
|
35
|
+
|
|
36
|
+
- "What's the reference style?" → cite the format example from shared
|
|
37
|
+
- "How many figures can I have?" → cite the 10-item cap from shared
|
|
38
|
+
- "What's the abstract limit?" → 150 words, unstructured, no citations
|
package/vendor/nature-skills/skills/nature-polishing/static/fragments/journal/nat-mach-intell.md
ADDED
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
# Journal: Nature Machine Intelligence — polishing
|
|
2
|
+
|
|
3
|
+
## Read the shared contract first
|
|
4
|
+
|
|
5
|
+
Open
|
|
6
|
+
`../../../../nature-shared/journal-formats/nature-machine-intelligence.md` for
|
|
7
|
+
the exact, stage-aware NMI facts. This fragment controls polishing decisions,
|
|
8
|
+
not the submission numbers themselves.
|
|
9
|
+
|
|
10
|
+
For Results or Discussion, also open
|
|
11
|
+
`../../../../nature-shared/core/nature-results-discussion.md`. It is
|
|
12
|
+
corpus-derived Nature-style writing guidance, not an official NMI requirement.
|
|
13
|
+
|
|
14
|
+
For Introduction polishing, also open
|
|
15
|
+
`../../../../nature-shared/core/nature-introduction.md`. It is corpus-derived
|
|
16
|
+
Nature-style writing guidance, not an official NMI requirement.
|
|
17
|
+
|
|
18
|
+
For abstract polishing, also open
|
|
19
|
+
`../../../../nature-shared/core/nature-abstract.md`. It is corpus-derived
|
|
20
|
+
Nature-style writing guidance, not an official NMI requirement.
|
|
21
|
+
|
|
22
|
+
## Audience and stance
|
|
23
|
+
|
|
24
|
+
Polish for readers across AI, robotics, machine learning and the scientific or
|
|
25
|
+
societal application domain. Preserve technical precision while making the
|
|
26
|
+
question, evidence and consequence understandable outside one specialist
|
|
27
|
+
benchmark community.
|
|
28
|
+
|
|
29
|
+
## Structure before sentence polish
|
|
30
|
+
|
|
31
|
+
For an Article, check these before line editing:
|
|
32
|
+
|
|
33
|
+
1. Count Introduction + Results + Discussion against the 3,500-word main-text
|
|
34
|
+
limit; exclude abstract, Methods, references and legends.
|
|
35
|
+
2. Keep the unreferenced abstract at or below 150 words.
|
|
36
|
+
3. Check that figures and tables total no more than six.
|
|
37
|
+
4. Keep the introduction unheaded; allow topical subheadings in Results and
|
|
38
|
+
Methods but not in Discussion.
|
|
39
|
+
5. Preserve enough Methods detail for replication; NMI does not publish a
|
|
40
|
+
fixed Methods word limit on the current pages.
|
|
41
|
+
|
|
42
|
+
Report an over-limit or wrong-structure manuscript under `Revision notes:`.
|
|
43
|
+
Do not silently delete evidence, uncertainty or reproducibility detail to make
|
|
44
|
+
the prose fit.
|
|
45
|
+
|
|
46
|
+
## Claim calibration
|
|
47
|
+
|
|
48
|
+
- Replace benchmark-only claims of general intelligence or deployment
|
|
49
|
+
readiness with the evaluated scope.
|
|
50
|
+
- Separate gains due to architecture from data, supervision, compute or tuning
|
|
51
|
+
differences.
|
|
52
|
+
- Name robustness and transfer boundaries when the prose currently hides them.
|
|
53
|
+
- Do not convert association, retrospective performance or simulation results
|
|
54
|
+
into causal, clinical or societal effectiveness.
|
|
55
|
+
- Define specialist abbreviations and remove jargon that is not needed for
|
|
56
|
+
technical accuracy.
|
|
57
|
+
|
|
58
|
+
## Results–Discussion calibration
|
|
59
|
+
|
|
60
|
+
- Preserve a claim-escalating Results sequence rather than flattening related
|
|
61
|
+
subsections into parallel experiment reports.
|
|
62
|
+
- Keep a bounded local inference in Results when it directly resolves the
|
|
63
|
+
current experiment; move cross-result synthesis and broader implications to
|
|
64
|
+
Discussion.
|
|
65
|
+
- Keep conclusion-changing robustness and failure boundaries visible in the
|
|
66
|
+
main text; move reassurance-only variants to SI.
|
|
67
|
+
- Permit a brief finding anchor in Discussion, but remove repeated evidence,
|
|
68
|
+
effect sizes, and tests that merely re-demonstrate the Results claim.
|
|
69
|
+
|
|
70
|
+
## Introduction calibration
|
|
71
|
+
|
|
72
|
+
- Compress broad context until the specific unresolved problem appears early.
|
|
73
|
+
- Replace vague limitation language with the exact unknown, condition,
|
|
74
|
+
mechanism, boundary, or literature tension.
|
|
75
|
+
- Reorganize citation catalogues into a known–unknown argument.
|
|
76
|
+
- Replace novelty adjectives with the research question and the design that can
|
|
77
|
+
answer it.
|
|
78
|
+
- Check that each Introduction question maps to a Results answer and that the
|
|
79
|
+
closing paragraph previews this route without replaying the paper.
|
|
80
|
+
|
|
81
|
+
## Abstract calibration
|
|
82
|
+
|
|
83
|
+
- Rebuild the abstract around one main discovery rather than a list of
|
|
84
|
+
datasets, models, metrics, and completed analyses.
|
|
85
|
+
- Keep only enough method information to show why the design answers the gap.
|
|
86
|
+
- Retain no more than one or two decisive supporting claims or boundaries.
|
|
87
|
+
- Keep a number only when it defines, supports, or bounds the main discovery.
|
|
88
|
+
- Make the final sentence state the bounded conceptual or field-level payoff,
|
|
89
|
+
not merely superior performance.
|
|
90
|
+
|
|
91
|
+
## Submission-sensitive checks
|
|
92
|
+
|
|
93
|
+
- Preserve explicit disclosure of a substantially extended conference paper.
|
|
94
|
+
- Preserve Data Availability and the separate Code availability section.
|
|
95
|
+
- Flag missing reviewer access or a missing Software Submission Checklist when
|
|
96
|
+
new code is central to the conclusions.
|
|
97
|
+
- Do not apply a flagship Nature title, Methods or legend limit. NMI's current
|
|
98
|
+
public pages state no current fixed number for those items. For figure
|
|
99
|
+
legends, use the official 2018 NMI below-300-word instruction only as a
|
|
100
|
+
historical advisory ceiling: count the complete legend, not each panel, aim
|
|
101
|
+
for 150–250 English words, and obey any newer editor or submission-system
|
|
102
|
+
instruction.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Journal: Nature (and Nature subjournals)
|
|
2
|
+
|
|
3
|
+
## Audience
|
|
4
|
+
|
|
5
|
+
A broad, multi-disciplinary readership. A reader outside the immediate subfield must be able to grasp the claim, the gap, and the significance from the first paragraph and the abstract.
|
|
6
|
+
|
|
7
|
+
## Polishing priorities
|
|
8
|
+
|
|
9
|
+
- The opening sentence must signal significance for a non-specialist audience without overclaiming.
|
|
10
|
+
- Avoid jargon that does not appear in the headline of a typical Nature News piece. Define or replace.
|
|
11
|
+
- Abstract is unstructured prose for many Nature titles; check the target journal's current guideline if the user names one.
|
|
12
|
+
- Length discipline: Nature articles are unforgiving on word count. Prefer cuts to compressions.
|
|
13
|
+
- No em dashes in body prose. Use commas, parentheses, or shorter sentences.
|
|
14
|
+
- Hedging should be calibrated. Avoid both overclaim (`proves`, `definitive`) and timidity (`might possibly suggest`).
|
|
15
|
+
|
|
16
|
+
## Things to flag, not silently fix
|
|
17
|
+
|
|
18
|
+
- If the manuscript leans on a specialist mechanism the broad audience would not follow, flag it for the author rather than over-translate.
|
|
19
|
+
- If significance for a non-specialist is genuinely thin, surface that as a structural problem in `Revision notes:`.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Language: English source
|
|
2
|
+
|
|
3
|
+
## Sentence rules
|
|
4
|
+
|
|
5
|
+
- In polished prose, aim for sentences in the `10-30` word range.
|
|
6
|
+
- Keep every sentence at `<= 30` words.
|
|
7
|
+
- Do not produce full sentences under `10` words unless the user explicitly asks for terse style or the item is a heading, label, or fixed technical expression.
|
|
8
|
+
- If any sentence exceeds `20` words, check whether it contains more than one main proposition.
|
|
9
|
+
- Split overloaded sentences rather than polishing them cosmetically.
|
|
10
|
+
- The last sentence of a paragraph often becomes the longest and weakest. Check it explicitly.
|
|
11
|
+
- Prefer one core subject-verb proposition per sentence.
|
|
12
|
+
- Do not use em dashes as prose punctuation in the polished version unless the user explicitly requests them. Rewrite with commas, parentheses, or shorter sentences instead. Use colons only when they add clear structural value.
|
|
13
|
+
|
|
14
|
+
## Paragraph rules
|
|
15
|
+
|
|
16
|
+
- Each paragraph should have one controlling idea followed by support.
|
|
17
|
+
- Supporting material may include data, comparison, explanation, consequence, literature, or limitation.
|
|
18
|
+
- If a new idea appears, start a new paragraph instead of stacking it onto the old one.
|
|
19
|
+
- Use thematic linking, not repetitive `This suggests ...` openings.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Language: Chinese-to-English
|
|
2
|
+
|
|
3
|
+
When the source is Chinese or strongly Chinese-influenced English, do not translate clause-by-clause.
|
|
4
|
+
|
|
5
|
+
## Workflow
|
|
6
|
+
|
|
7
|
+
1. Extract the core propositions first. List them in plain English before drafting prose.
|
|
8
|
+
2. Reconstruct explicit logical links: contrast, cause, implication, limitation. Chinese academic prose often elides these connectives — restore them.
|
|
9
|
+
3. Verify terminology, causality, and hedging strength against the source.
|
|
10
|
+
4. Keep technical terms, gene/protein names, model names, dataset names, and statistical terms stable; do not "translate" them into rough paraphrases.
|
|
11
|
+
5. Apply the English sentence and paragraph rules from `language/en.md` only after the logic is rebuilt.
|
|
12
|
+
|
|
13
|
+
## Common Chinese-influenced patterns to fix
|
|
14
|
+
|
|
15
|
+
- Topic-comment chains rewritten as subject-verb sentences.
|
|
16
|
+
- Strings of short clauses joined by commas — split or add connectives.
|
|
17
|
+
- Vague generalizations (`many studies have shown`) — convert to specific citations or remove.
|
|
18
|
+
- Hedging asymmetry: Chinese drafts often understate; English Nature-style asks for precise hedging matched to evidence strength, neither over- nor under-claiming.
|
|
19
|
+
- Repetition of the topic noun where English would use a pronoun or omit it.
|
package/vendor/nature-skills/skills/nature-polishing/static/fragments/paper_type/algorithmic.md
ADDED
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Paper type: algorithmic or device
|
|
2
|
+
|
|
3
|
+
The argument proposes a procedure, tool, or system and must show that it performs reliably and advantageously.
|
|
4
|
+
|
|
5
|
+
## What the reader expects
|
|
6
|
+
|
|
7
|
+
- a clear problem formulation and the precise scope being claimed
|
|
8
|
+
- the proposed procedure or device, described to a level a peer could re-implement
|
|
9
|
+
- a fair comparison against credible baselines under matched conditions
|
|
10
|
+
- ablations or controls that isolate why the new approach works
|
|
11
|
+
- failure modes, runtime/cost characteristics, and applicability boundaries
|
|
12
|
+
|
|
13
|
+
## Polishing priorities
|
|
14
|
+
|
|
15
|
+
- Separate "what the system is" from "why it works" from "how well it works"; do not braid them.
|
|
16
|
+
- Performance claims must specify the dataset, metric, baseline, and conditions, not stand as bare numbers.
|
|
17
|
+
- Avoid marketing verbs (`leverages`, `enables`, `empowers`) unless they carry information.
|
|
18
|
+
- The Discussion should name the failure modes the experiments revealed, not only the wins.
|
package/vendor/nature-skills/skills/nature-polishing/static/fragments/paper_type/hypothesis.md
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# Paper type: hypothesis-based
|
|
2
|
+
|
|
3
|
+
The argument tries to establish or rule out a causal explanation.
|
|
4
|
+
|
|
5
|
+
## What the reader expects
|
|
6
|
+
|
|
7
|
+
- a clearly stated hypothesis, framed before the evidence
|
|
8
|
+
- a falsification path: what observations would refute it
|
|
9
|
+
- evidence presented in support, against, or as boundary conditions
|
|
10
|
+
- alternative explanations addressed, not ignored
|
|
11
|
+
|
|
12
|
+
## Polishing priorities
|
|
13
|
+
|
|
14
|
+
- Make the hypothesis statement explicit and locatable; do not bury it in the third paragraph of the Introduction.
|
|
15
|
+
- Distinguish supporting evidence from consistent-but-non-discriminating evidence.
|
|
16
|
+
- In the Discussion, address rival explanations before generalizing.
|
|
17
|
+
- Hedging should match the strength of the causal claim. Avoid overclaiming mechanism from correlational data.
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# Paper type: methods
|
|
2
|
+
|
|
3
|
+
The reader of a methods paper asks:
|
|
4
|
+
|
|
5
|
+
- whether the method works
|
|
6
|
+
- whether it is reproducible
|
|
7
|
+
- whether it is better under a fair comparison
|
|
8
|
+
|
|
9
|
+
## Results section job
|
|
10
|
+
|
|
11
|
+
The Results section must show the advantages of the method over existing methods. Typical questions are:
|
|
12
|
+
|
|
13
|
+
- Is it more reliable?
|
|
14
|
+
- Is it faster?
|
|
15
|
+
- Does it require fewer resources?
|
|
16
|
+
- Is the comparison fair and reproducible?
|
|
17
|
+
|
|
18
|
+
## Methods section detail
|
|
19
|
+
|
|
20
|
+
The Methods section in a methods paper may need additional detail such as:
|
|
21
|
+
|
|
22
|
+
- axioms, conditions, and assumptions
|
|
23
|
+
- hardware and software environment
|
|
24
|
+
- mathematical derivations
|
|
25
|
+
- evaluation protocol
|
|
26
|
+
- datasets, baselines, metrics, splits, and hyperparameters
|
|
27
|
+
|
|
28
|
+
## Productive writing order
|
|
29
|
+
|
|
30
|
+
1. Methods
|
|
31
|
+
2. Results
|
|
32
|
+
3. Introduction
|
|
33
|
+
4. Conclusion
|
|
34
|
+
5. Discussion
|
|
35
|
+
6. Abstract
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# Paper type: research
|
|
2
|
+
|
|
3
|
+
The reader of a research paper asks:
|
|
4
|
+
|
|
5
|
+
- why the phenomenon matters
|
|
6
|
+
- what was done
|
|
7
|
+
- what was found
|
|
8
|
+
- what it means
|
|
9
|
+
|
|
10
|
+
## Hourglass structure
|
|
11
|
+
|
|
12
|
+
Strong research papers mirror an hourglass:
|
|
13
|
+
|
|
14
|
+
- `Introduction`: open broadly, then narrow to the specific gap, question, hypothesis, methods, and study
|
|
15
|
+
- `Discussion/Conclusion`: widen again, connecting the findings back to the literature and explaining how the knowledge gap was filled
|
|
16
|
+
|
|
17
|
+
If a paragraph or section violates this architecture, rebuild it before polishing wording.
|
|
18
|
+
|
|
19
|
+
## Productive writing order
|
|
20
|
+
|
|
21
|
+
1. Results
|
|
22
|
+
2. Introduction and Conclusion
|
|
23
|
+
3. Title
|
|
24
|
+
4. Discussion
|
|
25
|
+
5. Materials and Methods
|
|
26
|
+
6. Authors
|
|
27
|
+
7. Abstract
|
|
28
|
+
|
|
29
|
+
Follow the logic of evidence and argument, not the raw order in which the user drafted sentences.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# Paper type: review
|
|
2
|
+
|
|
3
|
+
The reader asks: what is the state of the field, where is the disagreement, and what is the path forward.
|
|
4
|
+
|
|
5
|
+
## What the reader expects
|
|
6
|
+
|
|
7
|
+
- a clear scope statement (which sub-area, which time window, which inclusion criteria)
|
|
8
|
+
- a synthesis that organizes the literature by argument, not by paper
|
|
9
|
+
- explicit positioning of disagreements and gaps
|
|
10
|
+
- an outlook that names the most informative open questions
|
|
11
|
+
|
|
12
|
+
## Polishing priorities
|
|
13
|
+
|
|
14
|
+
- A review is not a survey list. Replace `Author A reported X. Author B reported Y.` with synthesis that groups claims by mechanism, method, or conclusion.
|
|
15
|
+
- Position the reviewer's own stance carefully: a review can take a view, but it must show its reasoning.
|
|
16
|
+
- Avoid generic transitions (`furthermore`, `additionally`). Use connectives that signal the logical relation (`in contrast`, `building on this`, `the remaining disagreement is`).
|
|
17
|
+
- The closing section should leave the reader with a usable map, not a summary of what was just read.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# Section: Abstract
|
|
2
|
+
|
|
3
|
+
The abstract is the manuscript's shortest evidence chain, not a compressed
|
|
4
|
+
Introduction:
|
|
5
|
+
|
|
6
|
+
`precise problem/gap -> answer-enabling design -> main discovery -> decisive support/boundary -> implication`
|
|
7
|
+
|
|
8
|
+
It should answer:
|
|
9
|
+
|
|
10
|
+
1. What question was addressed?
|
|
11
|
+
2. How was it addressed?
|
|
12
|
+
3. What was found?
|
|
13
|
+
4. Why should anyone care?
|
|
14
|
+
|
|
15
|
+
Some journals require a strict abstract format. Follow the journal if it conflicts with the generic pattern. (See the loaded `journal/*.md` fragment for journal-specific constraints.)
|
|
16
|
+
|
|
17
|
+
## Polishing priorities
|
|
18
|
+
|
|
19
|
+
- Cut sentences that summarize background that the title already implies.
|
|
20
|
+
- Make the gap and the contribution one short, locatable sentence each.
|
|
21
|
+
- Organize the abstract around one main claim and at most one or two decisive
|
|
22
|
+
supporting claims or boundaries; do not inventory every Results subsection.
|
|
23
|
+
- Keep method detail only when it explains why the question is answerable.
|
|
24
|
+
- Keep a number only when it defines, supports, or materially bounds the main
|
|
25
|
+
discovery; numeric reporting is not mandatory by itself.
|
|
26
|
+
- The last sentence should state significance, not repeat the result.
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# Section: Conclusion
|
|
2
|
+
|
|
3
|
+
Use the three-part close:
|
|
4
|
+
|
|
5
|
+
1. restate the central contribution
|
|
6
|
+
2. summarize the key evidence or outcome
|
|
7
|
+
3. state the implication with a boundary
|
|
8
|
+
|
|
9
|
+
Do not introduce new data in the conclusion. Always run an overclaim check here.
|
|
10
|
+
|
|
11
|
+
## Overclaim check
|
|
12
|
+
|
|
13
|
+
- Does each claim trace back to evidence in this paper?
|
|
14
|
+
- Are mechanism words (`demonstrates`, `proves`, `establishes`) backed by the right study design?
|
|
15
|
+
- Is the scope of the implication narrower than or equal to the scope of the evidence?
|