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.
Files changed (49) hide show
  1. package/README.md +23 -23
  2. package/README.zh-CN.md +22 -21
  3. package/lib/i18n.cjs +626 -23
  4. package/lib/install.cjs +31 -0
  5. package/package-assets/claude/commands/lab/spec.md +1 -1
  6. package/package-assets/claude/commands/lab/write.md +1 -1
  7. package/package-assets/codex/prompts/lab-spec.md +1 -1
  8. package/package-assets/codex/prompts/lab-write.md +1 -1
  9. package/package-assets/shared/changes/README.md +10 -0
  10. package/package-assets/shared/config/workflow.json +5 -0
  11. package/package-assets/shared/context/decisions.md +11 -0
  12. package/package-assets/shared/context/evidence-index.md +16 -0
  13. package/package-assets/shared/context/mission.md +27 -0
  14. package/package-assets/shared/context/open-questions.md +11 -0
  15. package/package-assets/shared/context/state.md +19 -0
  16. package/package-assets/shared/examples/minimal-uplift-workflow.md +4 -4
  17. package/package-assets/shared/skills/lab/SKILL.md +54 -9
  18. package/package-assets/shared/skills/lab/references/brainstorming-integration.md +21 -0
  19. package/package-assets/shared/skills/lab/references/paper-writing/abstract.md +102 -0
  20. package/package-assets/shared/skills/lab/references/paper-writing/conclusion.md +35 -0
  21. package/package-assets/shared/skills/lab/references/paper-writing/does-my-writing-flow-source.md +45 -0
  22. package/package-assets/shared/skills/lab/references/paper-writing/experiments.md +102 -0
  23. package/package-assets/shared/skills/lab/references/paper-writing/introduction.md +408 -0
  24. package/package-assets/shared/skills/lab/references/paper-writing/method.md +196 -0
  25. package/package-assets/shared/skills/lab/references/paper-writing/paper-review.md +86 -0
  26. package/package-assets/shared/skills/lab/references/paper-writing/related-work.md +41 -0
  27. package/package-assets/shared/skills/lab/references/paper-writing-integration.md +29 -28
  28. package/package-assets/shared/skills/lab/references/workflow.md +1 -1
  29. package/package-assets/shared/skills/lab/stages/idea.md +43 -7
  30. package/package-assets/shared/skills/lab/stages/iterate.md +32 -0
  31. package/package-assets/shared/skills/lab/stages/report.md +19 -0
  32. package/package-assets/shared/skills/lab/stages/review.md +30 -0
  33. package/package-assets/shared/skills/lab/stages/run.md +17 -0
  34. package/package-assets/shared/skills/lab/stages/spec.md +36 -4
  35. package/package-assets/shared/skills/lab/stages/write.md +47 -15
  36. package/package-assets/shared/templates/design.md +10 -0
  37. package/package-assets/shared/templates/idea.md +76 -8
  38. package/package-assets/shared/templates/iteration-report.md +4 -0
  39. package/package-assets/shared/templates/paper-plan.md +12 -0
  40. package/package-assets/shared/templates/paper-section.md +24 -6
  41. package/package-assets/shared/templates/paper-section.tex +10 -0
  42. package/package-assets/shared/templates/paper.tex +29 -0
  43. package/package-assets/shared/templates/proposal.md +10 -0
  44. package/package-assets/shared/templates/review-checklist.md +23 -0
  45. package/package-assets/shared/templates/spec.md +7 -2
  46. package/package-assets/shared/templates/tasks.md +3 -1
  47. package/package-assets/shared/templates/write-iteration.md +5 -0
  48. package/package.json +3 -3
  49. 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
- Describe the problem being addressed.
5
+ State the problem in one short sentence.
6
6
 
7
- ## Motivation
7
+ ## Failure Case
8
8
 
9
- Explain why the problem matters.
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
- ## Generated Hypotheses
71
+ ## Candidate Approaches
19
72
 
20
- - Proposed innovation:
21
- - Why it might work:
22
- - Expected risks:
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
- ## Claims
9
+ ## Mini-Outline
9
10
 
10
- - Claim 1:
11
- - Claim 2:
11
+ - Point 1:
12
+ - Point 2:
13
+ - Point 3:
12
14
 
13
- ## Evidence Links
15
+ ## Claim-Evidence Map
14
16
 
15
- - Supporting artifact 1:
16
- - Supporting artifact 2:
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,10 @@
1
+ % Section file generated by /lab:write
2
+ % Final manuscript language should be chosen for the paper itself.
3
+
4
+ \section{Section Title}
5
+
6
+ % Paragraph 1
7
+
8
+ % Paragraph 2
9
+
10
+ % Paragraph 3
@@ -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 OpenSpec-compatible artifacts.
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
- - OpenSpec artifacts written
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 OpenSpec `spec-driven` artifacts.
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.0",
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
- "openspec",
11
- "experiments"
10
+ "experiments",
11
+ "latex"
12
12
  ],
13
13
  "author": "zhouhaoUCAS",
14
14
  "license": "MIT",
@@ -1,10 +0,0 @@
1
- #!/usr/bin/env bash
2
- set -euo pipefail
3
-
4
- if command -v openspec-cn >/dev/null 2>&1; then
5
- echo "OpenSpec CLI detected: openspec-cn"
6
- exit 0
7
- fi
8
-
9
- echo "OpenSpec CLI not found. Install and expose 'openspec-cn' before using /lab." >&2
10
- exit 1