superlab 0.1.0 → 0.1.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.
- package/README.md +23 -23
- package/README.zh-CN.md +22 -21
- package/lib/i18n.cjs +626 -23
- package/lib/install.cjs +31 -0
- package/package-assets/claude/commands/lab/spec.md +1 -1
- package/package-assets/claude/commands/lab/write.md +1 -1
- package/package-assets/codex/prompts/lab-spec.md +1 -1
- package/package-assets/codex/prompts/lab-write.md +1 -1
- package/package-assets/shared/changes/README.md +10 -0
- package/package-assets/shared/config/workflow.json +5 -0
- package/package-assets/shared/context/decisions.md +11 -0
- package/package-assets/shared/context/evidence-index.md +16 -0
- package/package-assets/shared/context/mission.md +27 -0
- package/package-assets/shared/context/open-questions.md +11 -0
- package/package-assets/shared/context/state.md +19 -0
- package/package-assets/shared/examples/minimal-uplift-workflow.md +4 -4
- package/package-assets/shared/skills/lab/SKILL.md +54 -9
- package/package-assets/shared/skills/lab/references/brainstorming-integration.md +21 -0
- package/package-assets/shared/skills/lab/references/paper-writing/abstract.md +102 -0
- package/package-assets/shared/skills/lab/references/paper-writing/conclusion.md +35 -0
- package/package-assets/shared/skills/lab/references/paper-writing/does-my-writing-flow-source.md +45 -0
- package/package-assets/shared/skills/lab/references/paper-writing/experiments.md +102 -0
- package/package-assets/shared/skills/lab/references/paper-writing/introduction.md +408 -0
- package/package-assets/shared/skills/lab/references/paper-writing/method.md +196 -0
- package/package-assets/shared/skills/lab/references/paper-writing/paper-review.md +86 -0
- package/package-assets/shared/skills/lab/references/paper-writing/related-work.md +41 -0
- package/package-assets/shared/skills/lab/references/paper-writing-integration.md +29 -28
- package/package-assets/shared/skills/lab/references/workflow.md +1 -1
- package/package-assets/shared/skills/lab/stages/idea.md +43 -7
- package/package-assets/shared/skills/lab/stages/iterate.md +32 -0
- package/package-assets/shared/skills/lab/stages/report.md +19 -0
- package/package-assets/shared/skills/lab/stages/review.md +30 -0
- package/package-assets/shared/skills/lab/stages/run.md +17 -0
- package/package-assets/shared/skills/lab/stages/spec.md +36 -4
- package/package-assets/shared/skills/lab/stages/write.md +47 -15
- package/package-assets/shared/templates/design.md +10 -0
- package/package-assets/shared/templates/idea.md +76 -8
- package/package-assets/shared/templates/iteration-report.md +4 -0
- package/package-assets/shared/templates/paper-plan.md +12 -0
- package/package-assets/shared/templates/paper-section.md +24 -6
- package/package-assets/shared/templates/paper-section.tex +10 -0
- package/package-assets/shared/templates/paper.tex +29 -0
- package/package-assets/shared/templates/proposal.md +10 -0
- package/package-assets/shared/templates/review-checklist.md +23 -0
- package/package-assets/shared/templates/spec.md +7 -2
- package/package-assets/shared/templates/tasks.md +3 -1
- package/package-assets/shared/templates/write-iteration.md +5 -0
- package/package.json +3 -3
- package/package-assets/shared/scripts/check_openspec.sh +0 -10
|
@@ -1,12 +1,65 @@
|
|
|
1
1
|
# Idea Artifact
|
|
2
2
|
|
|
3
|
-
## Problem
|
|
3
|
+
## One-Sentence Problem
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
State the problem in one short sentence.
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## Failure Case
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
- Where current methods fail:
|
|
10
|
+
- Why the failure matters:
|
|
11
|
+
|
|
12
|
+
## Idea Classification
|
|
13
|
+
|
|
14
|
+
- Problem type:
|
|
15
|
+
- Research setting:
|
|
16
|
+
- Why this is not a trivial tweak:
|
|
17
|
+
|
|
18
|
+
## Contribution Category
|
|
19
|
+
|
|
20
|
+
- Primary category:
|
|
21
|
+
- Secondary category:
|
|
22
|
+
|
|
23
|
+
Typical categories:
|
|
24
|
+
- new task
|
|
25
|
+
- new setting
|
|
26
|
+
- new dataset or evaluation
|
|
27
|
+
- new method or module
|
|
28
|
+
- new training strategy
|
|
29
|
+
- new empirical finding
|
|
30
|
+
- new theory or explanation
|
|
31
|
+
- engineering enhancement
|
|
32
|
+
|
|
33
|
+
## Breakthrough Level
|
|
34
|
+
|
|
35
|
+
- Level:
|
|
36
|
+
- Justification:
|
|
37
|
+
|
|
38
|
+
Suggested levels:
|
|
39
|
+
- L0: engineering or tuning
|
|
40
|
+
- L1: incremental improvement
|
|
41
|
+
- L2: clear methodological novelty
|
|
42
|
+
- L3: potential paradigm or problem-setting shift
|
|
43
|
+
|
|
44
|
+
## Existing Methods
|
|
45
|
+
|
|
46
|
+
- Mainstream line 1:
|
|
47
|
+
- Mainstream line 2:
|
|
48
|
+
- Shared assumption:
|
|
49
|
+
- Why that assumption breaks here:
|
|
50
|
+
|
|
51
|
+
## Why Ours Is Different
|
|
52
|
+
|
|
53
|
+
- Existing methods rely on:
|
|
54
|
+
- Our idea changes:
|
|
55
|
+
- Expected advantage:
|
|
56
|
+
- Evidence needed to prove the advantage:
|
|
57
|
+
|
|
58
|
+
## Three Meaningful Points
|
|
59
|
+
|
|
60
|
+
1. Significance:
|
|
61
|
+
2. Difference:
|
|
62
|
+
3. Expected payoff:
|
|
10
63
|
|
|
11
64
|
## Sourced Evidence
|
|
12
65
|
|
|
@@ -15,11 +68,20 @@ Explain why the problem matters.
|
|
|
15
68
|
- Typical datasets:
|
|
16
69
|
- Typical metrics:
|
|
17
70
|
|
|
18
|
-
##
|
|
71
|
+
## Candidate Approaches
|
|
19
72
|
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
-
|
|
73
|
+
- Approach 1:
|
|
74
|
+
Trade-offs:
|
|
75
|
+
- Approach 2:
|
|
76
|
+
Trade-offs:
|
|
77
|
+
- Approach 3:
|
|
78
|
+
Trade-offs:
|
|
79
|
+
- Recommended approach:
|
|
80
|
+
|
|
81
|
+
## Falsifiable Hypothesis
|
|
82
|
+
|
|
83
|
+
- If the idea is correct:
|
|
84
|
+
- If the idea is wrong:
|
|
23
85
|
|
|
24
86
|
## Candidate Experiment
|
|
25
87
|
|
|
@@ -33,3 +95,9 @@ Explain why the problem matters.
|
|
|
33
95
|
|
|
34
96
|
- Main weaknesses:
|
|
35
97
|
- What must be validated before implementation:
|
|
98
|
+
- Kill criteria:
|
|
99
|
+
|
|
100
|
+
## Approval Gate
|
|
101
|
+
|
|
102
|
+
- User-approved direction:
|
|
103
|
+
- Open questions before `/lab:spec`:
|
|
@@ -4,6 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
- Iteration number:
|
|
6
6
|
- Run id:
|
|
7
|
+
- Completion Promise:
|
|
7
8
|
|
|
8
9
|
## Hypothesis
|
|
9
10
|
|
|
@@ -28,8 +29,11 @@ List the concrete implementation or experiment changes.
|
|
|
28
29
|
- Main concerns:
|
|
29
30
|
- Methodology concerns:
|
|
30
31
|
- Interpretation concerns:
|
|
32
|
+
- Diagnostic mode needed:
|
|
31
33
|
|
|
32
34
|
## Decision
|
|
33
35
|
|
|
34
36
|
- Continue or stop:
|
|
35
37
|
- Next action:
|
|
38
|
+
- Top blockers:
|
|
39
|
+
- Next best actions:
|
|
@@ -4,11 +4,14 @@
|
|
|
4
4
|
|
|
5
5
|
- Venue or audience:
|
|
6
6
|
- Paper status:
|
|
7
|
+
- Core story in one sentence:
|
|
8
|
+
- Terminology lock:
|
|
7
9
|
|
|
8
10
|
## Section Status
|
|
9
11
|
|
|
10
12
|
- Abstract:
|
|
11
13
|
- Introduction:
|
|
14
|
+
- Related Work:
|
|
12
15
|
- Method:
|
|
13
16
|
- Experiments:
|
|
14
17
|
- Conclusion:
|
|
@@ -18,9 +21,18 @@
|
|
|
18
21
|
- Main result sources:
|
|
19
22
|
- Ablation sources:
|
|
20
23
|
- Limitation sources:
|
|
24
|
+
- Claims that still need more evidence:
|
|
21
25
|
|
|
22
26
|
## Writing Order
|
|
23
27
|
|
|
24
28
|
1. First section target:
|
|
25
29
|
2. Second section target:
|
|
26
30
|
3. Deferred sections:
|
|
31
|
+
|
|
32
|
+
## Five-Dimension Self-Review Status
|
|
33
|
+
|
|
34
|
+
- Contribution:
|
|
35
|
+
- Writing clarity:
|
|
36
|
+
- Experimental strength:
|
|
37
|
+
- Evaluation completeness:
|
|
38
|
+
- Method design soundness:
|
|
@@ -4,22 +4,40 @@
|
|
|
4
4
|
|
|
5
5
|
- Name:
|
|
6
6
|
- Goal for this round:
|
|
7
|
+
- Source guide loaded:
|
|
7
8
|
|
|
8
|
-
##
|
|
9
|
+
## Mini-Outline
|
|
9
10
|
|
|
10
|
-
-
|
|
11
|
-
-
|
|
11
|
+
- Point 1:
|
|
12
|
+
- Point 2:
|
|
13
|
+
- Point 3:
|
|
12
14
|
|
|
13
|
-
## Evidence
|
|
15
|
+
## Claim-Evidence Map
|
|
14
16
|
|
|
15
|
-
-
|
|
16
|
-
|
|
17
|
+
- Claim 1:
|
|
18
|
+
Evidence:
|
|
19
|
+
Status:
|
|
20
|
+
- Claim 2:
|
|
21
|
+
Evidence:
|
|
22
|
+
Status:
|
|
17
23
|
|
|
18
24
|
## Draft
|
|
19
25
|
|
|
20
26
|
Write the current section text here.
|
|
21
27
|
|
|
28
|
+
## Paragraph Roles
|
|
29
|
+
|
|
30
|
+
- Paragraph 1:
|
|
31
|
+
- Paragraph 2:
|
|
32
|
+
- Paragraph 3:
|
|
33
|
+
|
|
34
|
+
## Terminology Check
|
|
35
|
+
|
|
36
|
+
- Terms that must stay fixed:
|
|
37
|
+
- New terms introduced this round:
|
|
38
|
+
|
|
22
39
|
## Reviewer Notes
|
|
23
40
|
|
|
24
41
|
- Main concerns:
|
|
42
|
+
- Five-dimension self-review summary:
|
|
25
43
|
- Next revision target:
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
\documentclass{article}
|
|
2
|
+
\usepackage[utf8]{inputenc}
|
|
3
|
+
\usepackage[T1]{fontenc}
|
|
4
|
+
\usepackage{hyperref}
|
|
5
|
+
\usepackage{graphicx}
|
|
6
|
+
\usepackage{booktabs}
|
|
7
|
+
|
|
8
|
+
\title{Paper Title}
|
|
9
|
+
\author{Author Name}
|
|
10
|
+
\date{}
|
|
11
|
+
|
|
12
|
+
\begin{document}
|
|
13
|
+
\maketitle
|
|
14
|
+
|
|
15
|
+
\begin{abstract}
|
|
16
|
+
% Keep the final paper language independent from the workflow language.
|
|
17
|
+
\input{sections/abstract}
|
|
18
|
+
\end{abstract}
|
|
19
|
+
|
|
20
|
+
\input{sections/introduction}
|
|
21
|
+
\input{sections/related_work}
|
|
22
|
+
\input{sections/method}
|
|
23
|
+
\input{sections/experiments}
|
|
24
|
+
\input{sections/conclusion}
|
|
25
|
+
|
|
26
|
+
\bibliographystyle{plain}
|
|
27
|
+
\bibliography{references}
|
|
28
|
+
|
|
29
|
+
\end{document}
|
|
@@ -1,5 +1,10 @@
|
|
|
1
1
|
# Proposal
|
|
2
2
|
|
|
3
|
+
## Lab Change
|
|
4
|
+
|
|
5
|
+
- Change id:
|
|
6
|
+
- Target path: `.superlab/changes/<change-id>/proposal.md`
|
|
7
|
+
|
|
3
8
|
## Scope
|
|
4
9
|
|
|
5
10
|
State the research change being proposed.
|
|
@@ -19,3 +24,8 @@ Why this change is worth evaluating.
|
|
|
19
24
|
- Methodology risk:
|
|
20
25
|
- Reproducibility risk:
|
|
21
26
|
- Execution risk:
|
|
27
|
+
|
|
28
|
+
## Validation
|
|
29
|
+
|
|
30
|
+
- Change directory created:
|
|
31
|
+
- Proposal/design/spec/tasks consistency checked:
|
|
@@ -1,5 +1,28 @@
|
|
|
1
1
|
# Review Checklist
|
|
2
2
|
|
|
3
|
+
## Concise Summary
|
|
4
|
+
|
|
5
|
+
- Artifact under review:
|
|
6
|
+
- Top review question:
|
|
7
|
+
|
|
8
|
+
## Fatal Flaws
|
|
9
|
+
|
|
10
|
+
- Fatal flaw 1:
|
|
11
|
+
- Fatal flaw 2:
|
|
12
|
+
|
|
13
|
+
## Fix Priority
|
|
14
|
+
|
|
15
|
+
1. Highest-priority fix:
|
|
16
|
+
2. Second-priority fix:
|
|
17
|
+
3. Deferred fix:
|
|
18
|
+
|
|
19
|
+
## Residual Risks
|
|
20
|
+
|
|
21
|
+
- Risk 1:
|
|
22
|
+
- Risk 2:
|
|
23
|
+
|
|
24
|
+
## Checklist
|
|
25
|
+
|
|
3
26
|
- Are the dataset and split choices stated clearly?
|
|
4
27
|
- Is the baseline fair, current, and reproducible?
|
|
5
28
|
- Are the primary and secondary metrics justified?
|
|
@@ -1,16 +1,21 @@
|
|
|
1
1
|
# Spec
|
|
2
2
|
|
|
3
|
+
## Lab Change
|
|
4
|
+
|
|
5
|
+
- Change id:
|
|
6
|
+
- Target path: `.superlab/changes/<change-id>/spec.md`
|
|
7
|
+
|
|
3
8
|
## Requirements
|
|
4
9
|
|
|
5
10
|
- The workflow must preserve sourced evidence separately from generated hypotheses.
|
|
6
|
-
- The workflow must generate
|
|
11
|
+
- The workflow must generate lab-native change artifacts under one change directory.
|
|
7
12
|
- The workflow must support bounded experiment iteration.
|
|
8
13
|
- The workflow must produce normalized evaluation summaries.
|
|
9
14
|
|
|
10
15
|
## Acceptance
|
|
11
16
|
|
|
12
17
|
- Idea artifact written
|
|
13
|
-
-
|
|
18
|
+
- Lab change artifacts written in `.superlab/changes/<change-id>/`
|
|
14
19
|
- Validation run executed
|
|
15
20
|
- Iteration reports generated
|
|
16
21
|
- Final report generated
|
|
@@ -1,7 +1,9 @@
|
|
|
1
1
|
# Tasks
|
|
2
2
|
|
|
3
|
+
- [ ] Identify the approved lab change id.
|
|
4
|
+
- [ ] Create `.superlab/changes/<change-id>/`.
|
|
3
5
|
- [ ] Write the idea artifact.
|
|
4
|
-
- [ ] Convert the idea into
|
|
6
|
+
- [ ] Convert the idea into `.superlab/changes/<change-id>/proposal.md`, `.superlab/changes/<change-id>/design.md`, `.superlab/changes/<change-id>/spec.md`, and `.superlab/changes/<change-id>/tasks.md`.
|
|
5
7
|
- [ ] Run the first validation experiment.
|
|
6
8
|
- [ ] Normalize and validate the evaluation summary.
|
|
7
9
|
- [ ] Execute bounded iteration rounds.
|
|
@@ -4,6 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
- Iteration number:
|
|
6
6
|
- Section target:
|
|
7
|
+
- Section guide used:
|
|
7
8
|
|
|
8
9
|
## Inputs
|
|
9
10
|
|
|
@@ -15,14 +16,18 @@
|
|
|
15
16
|
|
|
16
17
|
- What changed:
|
|
17
18
|
- Why it changed:
|
|
19
|
+
- Mini-outline used:
|
|
18
20
|
|
|
19
21
|
## Review Check
|
|
20
22
|
|
|
21
23
|
- Claim-evidence alignment:
|
|
22
24
|
- Overstatement risk:
|
|
23
25
|
- Missing support:
|
|
26
|
+
- Terminology consistency:
|
|
27
|
+
- Five-dimension self-review outcome:
|
|
24
28
|
|
|
25
29
|
## Decision
|
|
26
30
|
|
|
27
31
|
- Continue or stop:
|
|
28
32
|
- Next writing target:
|
|
33
|
+
- Route back to `review` or `iterate` if needed:
|
package/package.json
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "superlab",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"description": "Strict /lab research workflow installer for Codex and Claude",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"codex",
|
|
7
7
|
"claude",
|
|
8
8
|
"research",
|
|
9
9
|
"workflow",
|
|
10
|
-
"
|
|
11
|
-
"
|
|
10
|
+
"experiments",
|
|
11
|
+
"latex"
|
|
12
12
|
],
|
|
13
13
|
"author": "zhouhaoUCAS",
|
|
14
14
|
"license": "MIT",
|