scientify 1.2.0 → 1.2.2

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.
@@ -0,0 +1,51 @@
1
+ # Code Survey & Implementation Mapping
2
+
3
+ Map selected idea concepts to actual code implementations.
4
+
5
+ ## Step 1: Extract Atomic Concepts
6
+
7
+ From `selected_idea.md`, list concepts needing implementation.
8
+
9
+ ## Step 2: Survey Codebases
10
+
11
+ ```bash
12
+ grep -r "class.*Attention" $WORKSPACE/repos/
13
+ grep -r "def forward" $WORKSPACE/repos/
14
+ ```
15
+
16
+ ## Step 3: Implementation Report
17
+
18
+ Write to `$WORKSPACE/ideas/implementation_report.md`:
19
+
20
+ ```markdown
21
+ # Implementation Report
22
+
23
+ ## Concept-to-Code Mapping
24
+
25
+ ### Concept 1: [Name]
26
+
27
+ **Math:**
28
+ $$\text{Formula}$$
29
+
30
+ **Reference:**
31
+ - File: `repos/<repo>/path/to/file.py`
32
+ - Class: `ClassName`
33
+
34
+ **Adaptation needed:**
35
+ - [Modifications for our idea]
36
+
37
+ ## Implementation Roadmap
38
+
39
+ 1. [ ] Concept X (foundational)
40
+ 2. [ ] Concept Y
41
+ 3. [ ] Integration
42
+
43
+ ## Recommended Base Repository
44
+ [repo_name] - [reason]
45
+ ```
46
+
47
+ ## Quality Checklist
48
+
49
+ - [ ] Every concept has code reference
50
+ - [ ] No placeholders
51
+ - [ ] Clear roadmap order
@@ -1,217 +1,82 @@
1
1
  # Idea Template
2
2
 
3
- Use this template for each idea in `~/.openclaw/workspace/ideas/`.
3
+ Use this template for each generated idea (`$WORKSPACE/ideas/idea_N.md`).
4
4
 
5
- ---
5
+ ## Required Sections
6
6
 
7
- # Idea N: [Short Descriptive Title]
7
+ ```markdown
8
+ # Idea N: [Title]
8
9
 
9
- ## One-Line Summary
10
-
11
- [A single sentence that captures the core innovation. Should be understandable without context.]
12
-
13
- ---
10
+ ## One-line Summary
11
+ [Single sentence describing the core innovation]
14
12
 
15
13
  ## Challenges Addressed
14
+ 1. [Challenge 1]
15
+ 2. [Challenge 2]
16
16
 
17
- What problems in the current research landscape does this idea solve?
18
-
19
- - **[Challenge 1]**: [Brief description of the technical limitation]
20
- - **[Challenge 2]**: [Brief description of unsolved problem]
21
- - **[Challenge 3]**: [Brief description of key bottleneck]
22
-
23
- ---
17
+ ## Existing Methods & Limitations
24
18
 
25
- ## Existing Methods & Their Limitations
19
+ ### Method A [arXiv:XXXX.XXXXX]
20
+ - **Approach**: [Brief description]
21
+ - **Limitation**: [Why insufficient]
26
22
 
27
- | Method | Paper/Source | Strength | Weakness This Idea Addresses |
28
- |--------|--------------|----------|------------------------------|
29
- | [Method A] | [Citation] | [What it does well] | [Limitation] |
30
- | [Method B] | [Citation] | [What it does well] | [Limitation] |
31
- | [Method C] | [Citation] | [What it does well] | [Limitation] |
32
-
33
- ---
23
+ ### Method B [arXiv:XXXX.XXXXX]
24
+ - **Approach**: [Brief description]
25
+ - **Limitation**: [Why insufficient]
34
26
 
35
27
  ## Motivation
36
-
37
- ### Why is this problem important?
38
-
39
- [Explain the significance of solving this problem. Who benefits? What applications are enabled?]
40
-
41
- ### What gap does this fill?
42
-
43
- [Describe the specific research gap this idea addresses. Reference the limitations above.]
44
-
45
- ### Potential impact
46
-
47
- [Quantify if possible: "Could improve X metric by Y%" or "Enables new application Z"]
48
-
49
- ---
28
+ [Why this gap matters, what opportunity exists]
50
29
 
51
30
  ## Proposed Method
52
31
 
53
- ### Core Insight
54
-
55
- [2-3 sentences describing the key innovation. What is the "aha" moment?]
32
+ ### Core Idea
33
+ [Main innovation in 2-3 sentences]
56
34
 
57
35
  ### Technical Approach
36
+ [Detailed description]
58
37
 
59
- **Overview:**
60
-
61
- [1 paragraph high-level description]
62
-
63
- **Step-by-step methodology:**
64
-
65
- 1. **[Step 1 Name]**: [Description]
66
- - Input: [what this step takes]
67
- - Output: [what this step produces]
68
- - Key operation: [main computation]
69
-
70
- 2. **[Step 2 Name]**: [Description]
71
- - Input: ...
72
- - Output: ...
73
- - Key operation: ...
74
-
75
- 3. **[Step 3 Name]**: [Description]
76
- - ...
77
-
78
- ### Mathematical Formulation
79
-
80
- **Problem Setup:**
81
-
82
- Let $X \in \mathbb{R}^{n \times d}$ denote [description]...
83
-
84
- **Core Equations:**
85
-
86
- ```latex
87
- % Main loss function
88
- \mathcal{L} = \mathcal{L}_{task} + \lambda \mathcal{L}_{reg}
89
-
90
- % Where task loss is:
91
- \mathcal{L}_{task} = ...
92
-
93
- % And regularization term is:
94
- \mathcal{L}_{reg} = ...
95
- ```
96
-
97
- **Key derivations (if applicable):**
98
-
99
- [Show important mathematical steps that justify the approach]
100
-
101
- ### Architecture / Algorithm
102
-
103
- ```
104
- Algorithm: [Name]
105
- Input: [inputs]
106
- Output: [outputs]
107
-
108
- 1. Initialize [parameters]
109
- 2. For each [iteration]:
110
- a. Compute [something]
111
- b. Update [something]
112
- 3. Return [result]
113
- ```
114
-
115
- Or for neural architectures:
116
-
117
- ```
118
- [Input] → [Layer 1] → [Layer 2] → ... → [Output]
119
- (dim: ...) (dim: ...) (dim: ...)
120
- ```
38
+ ### Key Equations
39
+ $$
40
+ \mathcal{L} = ...
41
+ $$
121
42
 
122
- ---
43
+ ## How This Improves on Cited Papers
44
+ | Paper | Their Limitation | Our Improvement |
45
+ |-------|------------------|-----------------|
46
+ | [A] | ... | ... |
47
+ | [B] | ... | ... |
123
48
 
124
49
  ## Expected Advantages
125
-
126
- Why should this approach work better than existing methods?
127
-
128
- - **[Advantage 1]**: [Explanation with reasoning]
129
- - **[Advantage 2]**: [Explanation with reasoning]
130
- - **[Advantage 3]**: [Explanation with reasoning]
131
-
132
- **Theoretical justification (if applicable):**
133
-
134
- [Brief argument for why this should work]
135
-
136
- ---
137
-
138
- ## Potential Challenges
139
-
140
- What could go wrong? How to mitigate?
141
-
142
- | Challenge | Risk Level | Mitigation Strategy |
143
- |-----------|------------|---------------------|
144
- | [Challenge 1] | High/Med/Low | [How to address] |
145
- | [Challenge 2] | High/Med/Low | [How to address] |
146
- | [Challenge 3] | High/Med/Low | [How to address] |
147
-
148
- ---
50
+ 1. [Advantage 1]
51
+ 2. [Advantage 2]
149
52
 
150
53
  ## Evaluation Plan
151
54
 
152
55
  ### Datasets
153
-
154
- | Dataset | Task | Size | Why Chosen |
155
- |---------|------|------|------------|
156
- | [Dataset 1] | [Task] | [Size] | [Reason] |
157
- | [Dataset 2] | [Task] | [Size] | [Reason] |
56
+ - [Dataset 1]: [Why chosen]
158
57
 
159
58
  ### Baselines
160
-
161
- | Method | Paper | Why Compare |
162
- |--------|-------|-------------|
163
- | [Baseline 1] | [Citation] | [Reason] |
164
- | [Baseline 2] | [Citation] | [Reason] |
59
+ - [Method from Paper A]
60
+ - [Method from Paper B]
165
61
 
166
62
  ### Metrics
63
+ - [Metric 1]: [What it measures]
167
64
 
168
- | Metric | Description | Expected Improvement |
169
- |--------|-------------|---------------------|
170
- | [Metric 1] | [What it measures] | [X% over baseline] |
171
- | [Metric 2] | [What it measures] | [Y% over baseline] |
172
-
173
- ### Ablation Studies
174
-
175
- What components to ablate to understand contribution?
176
-
177
- 1. [Component 1]: Remove/replace to test [hypothesis]
178
- 2. [Component 2]: Remove/replace to test [hypothesis]
179
-
180
- ---
181
-
182
- ## Scores
183
-
184
- | Criterion | Score (1-5) | Justification |
185
- |-----------|-------------|---------------|
186
- | **Novelty** | [X] | [Why this score] |
187
- | **Feasibility** | [X] | [Why this score] |
188
- | **Impact** | [X] | [Why this score] |
189
- | **Total** | [Sum] | |
190
-
191
- ---
192
-
193
- ## Implementation Notes
194
-
195
- ### Recommended Libraries
196
-
197
- - [Library 1]: For [purpose]
198
- - [Library 2]: For [purpose]
199
-
200
- ### Reference Code
201
-
202
- - [Repo 1](URL): [What to reference]
203
- - [Repo 2](URL): [What to reference]
204
-
205
- ### Estimated Effort
206
-
207
- - Model implementation: [X days]
208
- - Data pipeline: [X days]
209
- - Training & evaluation: [X days]
210
- - Total: [X days]
65
+ ## Scores (1-5)
66
+ - **Novelty**: X/5 - [Justification]
67
+ - **Feasibility**: X/5 - [Justification]
68
+ - **Impact**: X/5 - [Justification]
69
+ - **Total**: XX/15
70
+ ```
211
71
 
212
- ---
72
+ ## Idea Strategies
213
73
 
214
- ## Related Ideas
74
+ Generate 5 ideas using different strategies:
215
75
 
216
- - **Idea [M]**: [How it relates - could be combined? alternative approach?]
217
- - **Future extension**: [What could come next after this idea]
76
+ | Idea | Strategy | Description |
77
+ |------|----------|-------------|
78
+ | 1 | Combination | Merge techniques from 2+ papers |
79
+ | 2 | Simplification | Simplify complex method |
80
+ | 3 | Generalization | Extend to new domain/task |
81
+ | 4 | Constraint Relaxation | Remove limiting assumption |
82
+ | 5 | Architecture Innovation | Novel model design |
@@ -0,0 +1,43 @@
1
+ # Reading Long Papers Strategy
2
+
3
+ For papers >50KB or >15k tokens, use chunked reading.
4
+
5
+ ## Step 1: Structure Scan
6
+
7
+ ```bash
8
+ ls -la $WORKSPACE/papers/{arxiv_id}/
9
+ wc -l $WORKSPACE/papers/{arxiv_id}/*.tex
10
+ ```
11
+
12
+ ## Step 2: Chunked Reading
13
+
14
+ Use Read tool with `offset` and `limit`:
15
+
16
+ ```
17
+ Tool: Read
18
+ Arguments:
19
+ file_path: "$WORKSPACE/papers/2404.04429/main.tex"
20
+ offset: 1
21
+ limit: 500 # First 500 lines
22
+ ```
23
+
24
+ ## Priority Sections
25
+
26
+ | Priority | Section | Why |
27
+ |----------|---------|-----|
28
+ | 1 | Abstract | Core contribution |
29
+ | 2 | Method | Technical details |
30
+ | 3 | Experiments | Results |
31
+ | 4 | Conclusion | Limitations |
32
+
33
+ ## Skip These
34
+
35
+ - Appendix, Acknowledgments
36
+ - Detailed hyperparameter tables
37
+
38
+ ## Quick Extraction
39
+
40
+ ```bash
41
+ grep -n "\\\\section{" main.tex
42
+ sed -n '/\\begin{abstract}/,/\\end{abstract}/p' main.tex
43
+ ```
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: literature-survey
3
- description: "Comprehensive literature survey for a research domain. Automatically searches, filters, clusters, and iterates to discover relevant papers. Use for: exploring a new research area, collecting papers for a topic, building a literature database."
3
+ description: "Comprehensive literature survey (100+ papers). Searches, filters, clusters, and iterates for complete coverage. Use for: exploring new research areas, collecting papers systematically, building literature databases. NOT for: summarizing papers you have (use /write-review-paper), finding a specific paper (use arxiv_search), generating ideas (use /idea-generation)."
4
4
  metadata:
5
5
  {
6
6
  "openclaw":
@@ -14,19 +14,6 @@ metadata:
14
14
 
15
15
  Comprehensive literature discovery workflow for a research domain. This skill searches broadly, filters by relevance, clusters by direction, and iterates to ensure complete coverage.
16
16
 
17
- **Use this skill when:**
18
- - Exploring a new research area
19
- - Collecting all relevant papers for a topic
20
- - Building a comprehensive literature database
21
- - Need to understand the landscape of a field
22
-
23
- **NOT for:**
24
- - Summarizing papers you already have (use `/literature-review`)
25
- - Finding a specific paper (use `arxiv_search` directly)
26
- - Generating research ideas (use `/idea-generation`)
27
-
28
- ---
29
-
30
17
  ## Architecture: Isolated Sub-agent
31
18
 
32
19
  This survey runs in an **isolated sub-session** to avoid context pollution. The main session only receives the final report.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: research-pipeline
3
- description: "End-to-end research automation: from idea to code implementation with literature review, planning, and iterative refinement. Use arxiv, github_search, and exec tools."
3
+ description: "End-to-end research automation: idea literature plan implement → review → iterate. Use for: implementing a specific research idea, full ML research workflow. NOT for: just exploring literature (use /literature-survey), just generating ideas (use /idea-generation), just writing review (use /write-review-paper)."
4
4
  metadata:
5
5
  {
6
6
  "openclaw":
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: write-review-paper
3
- description: "Write a literature review or survey paper from EXISTING papers. Guides through reading, note-taking, synthesis, and structured writing. Use after /literature-survey has collected papers."
3
+ description: "Write literature review or survey paper from EXISTING papers. Guides reading strategy, note-taking, synthesis, and academic writing. Use for: writing thesis lit review, standalone survey papers, synthesizing findings. NOT for: searching new papers (use /literature-survey), generating research ideas (use /idea-generation)."
4
4
  metadata:
5
5
  {
6
6
  "openclaw":
@@ -14,18 +14,6 @@ metadata:
14
14
 
15
15
  Guide for writing a structured literature review or survey paper from papers you've already collected. This skill helps with reading strategy, note organization, and academic writing.
16
16
 
17
- **Use this skill when:**
18
- - You have collected papers (via `/literature-survey` or manually)
19
- - Need to write a literature review section for a thesis/paper
20
- - Writing a standalone survey paper
21
- - Synthesizing findings across multiple papers
22
-
23
- **NOT for:**
24
- - Searching and discovering new papers (use `/literature-survey`)
25
- - Generating research ideas (use `/idea-generation`)
26
-
27
- ---
28
-
29
17
  ## Prerequisites
30
18
 
31
19
  Before starting, ensure you have:
@@ -70,62 +58,7 @@ Create `$WORKSPACE/review/reading_plan.md`:
70
58
 
71
59
  ### 1.2 Reading Notes Template
72
60
 
73
- For each paper, create `$WORKSPACE/review/notes/{paper_id}.md`:
74
-
75
- ```markdown
76
- # [Paper Title]
77
-
78
- **ID**: [arxiv_id / DOI]
79
- **Authors**: [author list]
80
- **Year**: [year]
81
- **Venue**: [conference/journal]
82
- **Priority**: P1/P2/P3
83
-
84
- ## One-sentence Summary
85
- [用一句话概括这篇论文的核心贡献]
86
-
87
- ## Problem & Motivation
88
- - 研究什么问题?
89
- - 为什么重要?
90
- - 现有方法的不足?
91
-
92
- ## Method
93
- ### Core Idea
94
- [核心创新点]
95
-
96
- ### Technical Approach
97
- [关键技术细节]
98
-
99
- ### Key Equations
100
- ```latex
101
- [重要公式]
102
- ```
103
-
104
- ## Experiments
105
- - **Datasets**: [使用的数据集]
106
- - **Baselines**: [对比方法]
107
- - **Metrics**: [评价指标]
108
- - **Key Results**: [主要结论]
109
-
110
- ## Strengths
111
- 1. [优点1]
112
- 2. [优点2]
113
-
114
- ## Limitations
115
- 1. [局限1]
116
- 2. [局限2]
117
-
118
- ## Connections
119
- - 与 [paper_x] 的关系:[描述]
120
- - 改进了 [method_y]:[如何改进]
121
- - 被 [paper_z] 引用/扩展:[描述]
122
-
123
- ## Quotes for Citation
124
- > "[重要原文]" (Section X, Page Y)
125
-
126
- ## My Comments
127
- [你的思考、疑问、可能的改进方向]
128
- ```
61
+ For each paper, create `$WORKSPACE/review/notes/{paper_id}.md` using template in `references/note-template.md`.
129
62
 
130
63
  ---
131
64
 
@@ -203,126 +136,19 @@ Create `$WORKSPACE/review/taxonomy.md`:
203
136
 
204
137
  ### 3.1 Survey Paper Template
205
138
 
206
- Create `$WORKSPACE/review/draft.md`:
207
-
208
- ```markdown
209
- # [Survey Title]: A Comprehensive Review
210
-
211
- ## Abstract
212
- [Background - 1 sentence]
213
- [Problem - 1 sentence]
214
- [What this survey covers - 2 sentences]
215
- [Key findings - 2 sentences]
216
- [Conclusion - 1 sentence]
217
-
218
- ## 1. Introduction
219
-
220
- ### 1.1 Background and Motivation
221
- [为什么这个领域重要?]
222
- [当前研究的热度和趋势]
223
-
224
- ### 1.2 Scope of This Survey
225
- [本综述覆盖的范围]
226
- [与已有综述的区别]
227
-
228
- ### 1.3 Contributions
229
- 本文的主要贡献:
230
- 1. [贡献1]
231
- 2. [贡献2]
232
- 3. [贡献3]
233
-
234
- ### 1.4 Organization
235
- 本文结构如下:
236
- - Section 2: [内容]
237
- - Section 3: [内容]
238
- - ...
239
-
240
- ## 2. Background and Preliminaries
241
-
242
- ### 2.1 Problem Definition
243
- [正式定义研究问题]
139
+ Create `$WORKSPACE/review/draft.md` using template in `references/survey-template.md`.
244
140
 
245
- ### 2.2 Key Concepts
246
- [核心概念解释]
247
-
248
- ### 2.3 Evaluation Metrics
249
- [常用评价指标]
250
-
251
- ## 3. Taxonomy of Methods
252
-
253
- ### 3.1 Category A: [Name]
254
-
255
- #### 3.1.1 Subcategory A.1
256
- [方法描述]
257
- [代表性工作]
258
-
259
- #### 3.1.2 Subcategory A.2
260
- ...
261
-
262
- ### 3.2 Category B: [Name]
263
- ...
264
-
265
- ## 4. Comparative Analysis
266
-
267
- ### 4.1 Quantitative Comparison
268
- [对比表格]
269
- [结果分析]
270
-
271
- ### 4.2 Qualitative Comparison
272
- [方法特点对比]
273
- [适用场景分析]
274
-
275
- ## 5. Datasets and Benchmarks
276
-
277
- ### 5.1 Public Datasets
278
- | Dataset | Size | Source | Features |
279
- |---------|------|--------|----------|
280
- | ... | ... | ... | ... |
281
-
282
- ### 5.2 Benchmark Protocols
283
- [常用的实验设置]
284
-
285
- ## 6. Challenges and Future Directions
286
-
287
- ### 6.1 Open Challenges
288
- 1. **Challenge 1**: [描述]
289
- 2. **Challenge 2**: [描述]
290
-
291
- ### 6.2 Emerging Trends
292
- 1. **Trend 1**: [描述]
293
- 2. **Trend 2**: [描述]
294
-
295
- ### 6.3 Recommended Research Directions
296
- 1. [方向1]
297
- 2. [方向2]
298
-
299
- ## 7. Conclusion
300
- [总结主要发现]
301
- [对领域的展望]
302
-
303
- ## References
304
- [BibTeX entries]
305
- ```
141
+ Key sections: Abstract → Introduction → Background → Taxonomy → Comparison → Datasets → Future Directions → Conclusion
306
142
 
307
143
  ### 3.2 Thesis Literature Review Template
308
144
 
309
- For a thesis chapter, use this structure:
310
-
145
+ For a thesis chapter:
311
146
  ```markdown
312
147
  # Chapter 2: Literature Review
313
-
314
148
  ## 2.1 Introduction
315
- [本章目标和结构]
316
-
317
149
  ## 2.2 [Topic Area 1]
318
- [相关工作综述]
319
-
320
150
  ## 2.3 [Topic Area 2]
321
- [相关工作综述]
322
-
323
151
  ## 2.4 Summary and Research Gaps
324
- [总结现有工作的不足]
325
- [引出你的研究问题]
326
152
  ```
327
153
 
328
154
  ---
@@ -0,0 +1,70 @@
1
+ # Survey Paper Template
2
+
3
+ Use this template for `$WORKSPACE/review/draft.md`:
4
+
5
+ ```markdown
6
+ # [Survey Title]: A Comprehensive Review
7
+
8
+ ## Abstract
9
+ [Background - 1 sentence]
10
+ [Problem - 1 sentence]
11
+ [What this survey covers - 2 sentences]
12
+ [Key findings - 2 sentences]
13
+ [Conclusion - 1 sentence]
14
+ ## 1. Introduction
15
+
16
+ ### 1.1 Background and Motivation
17
+ [Why this field matters]
18
+
19
+ ### 1.2 Scope of This Survey
20
+ [Coverage and differentiation from existing surveys]
21
+
22
+ ### 1.3 Contributions
23
+ 1. [Contribution 1]
24
+ 2. [Contribution 2]
25
+
26
+ ### 1.4 Organization
27
+ - Section 2: [content]
28
+ - Section 3: [content]
29
+
30
+ ## 2. Background and Preliminaries
31
+
32
+ ### 2.1 Problem Definition
33
+ ### 2.2 Key Concepts
34
+ ### 2.3 Evaluation Metrics
35
+
36
+ ## 3. Taxonomy of Methods
37
+
38
+ ### 3.1 Category A: [Name]
39
+ #### 3.1.1 Subcategory A.1
40
+ [Method description, representative works]
41
+
42
+ ### 3.2 Category B: [Name]
43
+ ...
44
+
45
+ ## 4. Comparative Analysis
46
+
47
+ ### 4.1 Quantitative Comparison
48
+ [Tables, results analysis]
49
+
50
+ ### 4.2 Qualitative Comparison
51
+ [Method characteristics, suitable scenarios]
52
+
53
+ ## 5. Datasets and Benchmarks
54
+
55
+ ### 5.1 Public Datasets
56
+ | Dataset | Size | Source | Features |
57
+ |---------|------|--------|----------|
58
+
59
+ ### 5.2 Benchmark Protocols
60
+
61
+ ## 6. Challenges and Future Directions
62
+
63
+ ### 6.1 Open Challenges
64
+ ### 6.2 Emerging Trends
65
+ ### 6.3 Recommended Research Directions
66
+
67
+ ## 7. Conclusion
68
+
69
+ ## References
70
+ ```