superlab 0.1.14 → 0.1.15

package/lib/install.cjs

@@ -538,6 +538,7 @@ function localizeInstalledAssets(targetDir, lang, { newlyCreatedProjectOwnedPath
     path.join(".lab", ".managed", "templates", "iteration-report.md"),
     path.join(".lab", ".managed", "templates", "review-checklist.md"),
     path.join(".lab", ".managed", "templates", "final-report.md"),
+    path.join(".lab", ".managed", "templates", "main-tables.md"),
     path.join(".lab", ".managed", "templates", "paper-plan.md"),
     path.join(".lab", ".managed", "templates", "paper-section.md"),
     path.join(".lab", ".managed", "templates", "write-iteration.md"),

package/package-assets/claude/commands/lab/write.md

@@ -8,4 +8,4 @@ tags: [workflow, research, writing]
 Use the installed `lab` skill at `.claude/skills/lab/SKILL.md`.
 
 Execute the requested `/lab:write` stage against the user's argument now. Do not only recommend another lab stage. If a blocking prerequisite is missing, say exactly what is missing and ask at most one clarifying question.
-This command runs the `/lab:write` stage. It requires an approved framing artifact from `/lab:framing`, must read the matching section reference from `.claude/skills/lab/references/paper-writing/`, plus `paper-review.md` and `does-my-writing-flow-source.md`, build a mini-outline, and then revise only one section.
+This command runs the `/lab:write` stage. It requires an approved framing artifact from `/lab:framing`, must read the matching section reference from `.claude/skills/lab/references/paper-writing/`, and for `abstract`, `introduction`, or `method` it must also read `.claude/skills/lab/references/paper-writing/examples/index.md` plus the matching examples index and 1-2 concrete example files. Then it should run `paper-review.md` and `does-my-writing-flow-source.md`, build a mini-outline, and revise only one section.

package/package-assets/claude/commands/lab.md

@@ -40,6 +40,7 @@ tags: [workflow, research, overview]
 
 - `/lab:write`
   Turn stable report artifacts into paper sections through small, evidence-bound writing rounds using the vendored paper-writing references under the installed `lab` skill.
+  On the first manuscript-writing round, if `paper_template_root` is empty, explicitly ask once whether to stay on the managed default LaTeX scaffold or attach a template directory first; persist the user's default-scaffold choice before continuing.
 
 ## Dispatch Rules
 

package/package-assets/codex/prompts/lab-write.md

@@ -6,4 +6,4 @@ argument-hint: section or writing target
 Use the installed `lab` skill at `.codex/skills/lab/SKILL.md`.
 
 Execute the requested `/lab:write` stage against the user's argument now. Do not only recommend another lab stage. If a blocking prerequisite is missing, say exactly what is missing and ask at most one clarifying question.
-This command runs the `/lab:write` stage. It requires an approved framing artifact from `/lab:framing`, must read the matching section reference from `.codex/skills/lab/references/paper-writing/`, plus `paper-review.md` and `does-my-writing-flow-source.md`, build a mini-outline, and then revise only one section.
+This command runs the `/lab:write` stage. It requires an approved framing artifact from `/lab:framing`, must read the matching section reference from `.codex/skills/lab/references/paper-writing/`, and for `abstract`, `introduction`, or `method` it must also read `.codex/skills/lab/references/paper-writing/examples/index.md` plus the matching examples index and 1-2 concrete example files. Then it should run `paper-review.md` and `does-my-writing-flow-source.md`, build a mini-outline, and revise only one section.

package/package-assets/codex/prompts/lab.md

@@ -38,6 +38,7 @@ argument-hint: workflow question or stage choice
 
 - `/lab:write`
   Turn stable report artifacts into paper sections through small, evidence-bound writing rounds using the vendored paper-writing references under the installed `lab` skill.
+  On the first manuscript-writing round, if `paper_template_root` is empty, explicitly ask once whether to stay on the managed default LaTeX scaffold or attach a template directory first; persist the user's default-scaffold choice before continuing.
 
 ## Dispatch Rules
 

package/package-assets/shared/lab/.managed/templates/final-report.md

@@ -4,6 +4,12 @@
 
 Summarize the method and overall outcome.
 
+## Selected Metrics
+
+- Primary metrics:
+- Secondary metrics:
+- Required terminal evidence:
+
 ## Experiment Setup
 
 - Datasets:
@@ -11,6 +17,12 @@ Summarize the method and overall outcome.
 - Baselines:
 - Metrics:
 
+## Main Tables
+
+- Managed main tables artifact: `<deliverables_root>/main-tables.md`
+- Final performance summary:
+- Table coverage:
+
 ## Main Results
 
 Summarize validated iteration outcomes.

package/package-assets/shared/lab/.managed/templates/main-tables.md

@@ -0,0 +1,37 @@
+# Main Tables
+
+## Selected Metrics
+
+- Primary metrics:
+- Secondary metrics:
+- Required terminal evidence:
+
+## Final Performance Summary
+
+- Main result summary:
+- Most important numbers:
+- Reporting caveat:
+
+## Table 1
+
+- Purpose:
+- Metrics used:
+- Strongest supported claim:
+
+## Table 2
+
+- Purpose:
+- Metrics used:
+- Strongest supported claim:
+
+## Table 3
+
+- Purpose:
+- Metrics used:
+- Strongest supported claim:
+
+## Table 4
+
+- Purpose:
+- Metrics used:
+- Strongest supported claim:

package/package-assets/shared/lab/config/workflow.json

@@ -5,5 +5,7 @@
   "results_root": "results",
   "figures_root": "figures",
   "deliverables_root": "docs/research",
-  "paper_template_root": ""
+  "paper_template_root": "",
+  "paper_template_decision": "unconfirmed",
+  "paper_template_final_reminder_acknowledged": false
 }

package/package-assets/shared/lab/context/auto-outcome.md

@@ -3,6 +3,9 @@
 ## Goal
 
 - Objective:
+- Primary metrics:
+- Secondary metrics:
+- Required terminal evidence:
 - Experiment ladder:
 - Metric glossary:
 - Metric source papers:

package/package-assets/shared/skills/lab/SKILL.md

@@ -151,7 +151,7 @@ Use this skill when the user invokes `/lab:*` or asks for the structured researc
 - Read `.lab/context/eval-protocol.md` before choosing tables, thresholds, or final result framing.
 - Keep metric definitions, comparison semantics, and implementation references anchored to the approved evaluation protocol instead of re-deriving them during reporting.
 - Aggregate them with `.lab/.managed/scripts/summarize_iterations.py`.
-- Write the final document with `.lab/.managed/templates/final-report.md`.
+- Write the final document with `.lab/.managed/templates/final-report.md` and the managed table summary with `.lab/.managed/templates/main-tables.md`.
 - Keep failed attempts and limitations visible.
 - Update `.lab/context/state.md` and `.lab/context/evidence-index.md` with report-level handoff notes.
 
@@ -160,13 +160,16 @@ Use this skill when the user invokes `/lab:*` or asks for the structured researc
 - Start only after `report` artifacts are stable enough to support paper claims.
 - Start only after an approved framing artifact exists at `.lab/writing/framing.md`.
 - Read `.lab/config/workflow.json` before drafting and enforce its `paper_language` and `paper_format`.
+- If `paper_template_root` is empty and `paper_template_decision` is `unconfirmed`, ask once whether to continue with the managed default scaffold or attach a template directory first; persist the answer before drafting `.tex`.
+- If the project is still on the default scaffold at a final export or final-draft boundary and `paper_template_final_reminder_acknowledged` is `false`, ask one final reminder question before finalizing.
 - Read `.lab/context/mission.md`, `.lab/context/decisions.md`, `.lab/context/evidence-index.md`, and `.lab/context/data-decisions.md` before drafting.
 - Write one paper section or one explicit subproblem per round.
 - Bind each claim to evidence from `report`, iteration reports, or normalized summaries.
 - Write planning artifacts with `.lab/.managed/templates/paper-plan.md`, `.lab/.managed/templates/paper-section.md`, and `.lab/.managed/templates/write-iteration.md`.
 - Write final manuscript artifacts with `.lab/.managed/templates/paper.tex` and `.lab/.managed/templates/paper-section.tex`.
 - Use the vendored paper-writing references under `skills/lab/references/paper-writing/`.
-- Load only the current section guide, plus `paper-review.md` and `does-my-writing-flow-source.md`.
+- For `abstract`, `introduction`, and `method`, also use the vendored example-bank files under `skills/lab/references/paper-writing/examples/`.
+- Load only the current section guide, the matching examples index when one exists, 1-2 matching concrete example files, plus `paper-review.md` and `does-my-writing-flow-source.md`.
 - Build a compact mini-outline before prose.
 - For each subsection, explicitly cover motivation, design, and technical advantage when applicable.
 - Keep terminology stable across rounds and sections.
@@ -203,6 +206,7 @@ Use this skill when the user invokes `/lab:*` or asks for the structured researc
 - Write stage guide: `.codex/skills/lab/stages/write.md` or `.claude/skills/lab/stages/write.md`
 - Paper-writing integration: `.codex/skills/lab/references/paper-writing-integration.md` or `.claude/skills/lab/references/paper-writing-integration.md`
 - Vendored paper-writing references: `.codex/skills/lab/references/paper-writing/{abstract,introduction,related-work,method,experiments,conclusion,paper-review,does-my-writing-flow-source}.md` or `.claude/skills/lab/references/paper-writing/{abstract,introduction,related-work,method,experiments,conclusion,paper-review,does-my-writing-flow-source}.md`
+- Vendored paper-writing example bank: `.codex/skills/lab/references/paper-writing/examples/{index,abstract-examples,introduction-examples,method-examples}.md` or `.claude/skills/lab/references/paper-writing/examples/{index,abstract-examples,introduction-examples,method-examples}.md`, plus the matching section subdirectories
 - Command adapters: the installed `/lab:*` command assets
 - Shared workflow config: `.lab/config/workflow.json`
 - Shared project context: `.lab/context/{mission,state,decisions,evidence-index,open-questions,data-decisions,eval-protocol,auto-mode,auto-status}.md`

package/package-assets/shared/skills/lab/references/paper-writing/abstract.md

@@ -77,7 +77,13 @@ Version 3: When there are multiple technical contributions, describe each contri
 
 ## Usage Note
 
-This vendored guide is intentionally self-contained. The original example-bank files are not bundled in `superlab`, so use the structures and checklists in this document directly rather than chasing external example paths.
+This vendored guide should be paired with the local abstract example bank:
+
+- `references/examples/index.md`
+- `references/examples/abstract-examples.md`
+- one matching file under `references/examples/abstract/`
+
+Use the structures and checklists here first, then use the example files to choose a concrete abstract shape and sentence logic. Reuse structure, not wording.
 
 ## Abstract Quality Checklist
 

package/package-assets/shared/skills/lab/references/paper-writing/examples/abstract/template-a.md

@@ -0,0 +1,21 @@
+# Abstract Template A Examples (Challenge -> Contribution)
+
+Source scope: your original notes, "Version 1".
+
+```latex
+\section{Abstract}
+% Task
+% Technical challenge for previous methods (discuss around the technical challenge that we solved)
+% Introduce the technical contribution for solving the challenge in one to two sentences (usually mention the technical term/name only, without describing every detailed step. The term should be easy to understand and should not create a jump in reading. This ability is very important for writing a good abstract.)
+% Introduce the benefits of the technical contribution
+% Experiment
+```
+
+## Reusable skeleton
+
+1. `[Task sentence]`
+2. `However, previous methods suffer from [technical challenge].`
+3. `To solve this challenge, we propose [technical contribution name].`
+4. `[One more contribution sentence if needed].`
+5. `This contribution brings [technical benefit].`
+6. `Experiments show [main result].`

package/package-assets/shared/skills/lab/references/paper-writing/examples/abstract/template-b.md

@@ -0,0 +1,34 @@
+# Abstract Template B Examples (Challenge -> Insight -> Contribution)
+
+```latex
+\section{Abstract}
+% Task
+%% Example 1: In recent years, generative models have undergone significant advancement due to the success of diffusion models.
+%% Example 2: This paper addresses the challenge of novel view synthesis for a human performer from a very sparse set of camera views.
+
+% Technical challenge for previous methods (discuss around the technical challenge that we solved)
+%% Example 1: The success of these models is often attributed to their use of guidance techniques, such as classifier and classifier-free methods, which provides effective mechanisms to tradeoff between fidelity and diversity. However, these methods are not capable of guiding a generated image to be aware of its geometric configuration, e.g., depth, which hinders the application of diffusion models to areas that require a certain level of depth awareness.
+%% Example 2: Some recent works have shown that learning implicit neural representations of 3D scenes achieves remarkable view synthesis quality given dense input views. However, the representation learning will be ill-posed if the views are highly sparse.
+
+% Introduce the insight for solving the challenge in one sentence
+%% Example 1: To address this limitation, we propose a novel guidance approach for diffusion models that uses estimated depth information derived from the rich intermediate representations of diffusion models.
+%% Example 2: To solve this ill-posed problem, our key idea is to integrate observations over video frames.
+
+% Introduce the technical contribution that implements the insight in one to two sentences (usually mention the technical term/name only, without describing every detailed step. The term should be easy to understand and should not create a jump in reading. This ability is very important for writing a good abstract.)
+%% Example 1: To do this, we first present a label-efficient depth estimation framework using the internal representations of diffusion models. At the sampling phase, we utilize two guidance techniques to self-condition the generated image using the estimated depth map, the first of which uses pseudo-labeling, and the subsequent one uses a depth-domain diffusion prior.
+%% Example 2: To this end, we propose Neural Body, a new human body representation which assumes that the learned neural representations at different frames share the same set of latent codes anchored to a deformable mesh
+
+% Introduce the benefits of technical novelty
+%% Example 2: so that the observations across frames can be naturally integrated. The deformable mesh also provides geometric guidance for the network to learn 3D representations more efficiently.
+
+% Experiment
+```
+
+## Given example pattern 2
+
+1. `This paper addresses the challenge of novel view synthesis for a human performer from a very sparse set of camera views.`
+2. `... representation learning will be ill-posed if the views are highly sparse.`
+3. `To solve this ill-posed problem, our key idea is to integrate observations over video frames.`
+4. `To this end, we propose Neural Body ...`
+5. `... observations across frames can be naturally integrated ... provides geometric guidance ...`
+6. `Experiments show [main result].`

package/package-assets/shared/skills/lab/references/paper-writing/examples/abstract/template-c.md

@@ -0,0 +1,28 @@
+# Abstract Template C Examples (Multiple Contributions)
+
+```latex
+% Task
+%% This paper introduces a novel contour-based approach named deep snake for real-time instance segmentation.
+
+%% Unlike some recent methods that directly regress the coordinates of the object boundary points from an image
+
+% Introduce technical contribution and technical advantage in one sentence (this ability is very important for writing a good abstract.)
+%% deep snake uses a neural network to iteratively deform an initial contour to match the object boundary, which implements the classic idea of snake algorithms with a learning-based approach.
+
+% Introduce technical contribution and technical advantage in one sentence
+%% For structured feature learning on the contour, we propose to use circular convolution in deep snake, which better exploits the cycle-graph structure of a contour compared against generic graph convolution.
+
+% Introduce technical contribution and technical advantage in one sentence
+%% Based on deep snake, we develop a two-stage pipeline for instance segmentation: initial contour proposal and contour deformation, which can handle errors in object localization.
+
+% Experiment
+```
+
+## Given example pattern (Deep Snake style from your text)
+
+1. `This paper introduces a novel contour-based approach named deep snake for real-time instance segmentation.`
+2. `Unlike some recent methods that directly regress the coordinates of the object boundary points from an image ...`
+3. `deep snake uses a neural network to iteratively deform an initial contour ...`
+4. `For structured feature learning on the contour, we propose circular convolution ...`
+5. `Based on deep snake, we develop a two-stage pipeline ...`
+6. `Experiments show [main result].`

package/package-assets/shared/skills/lab/references/paper-writing/examples/abstract-examples.md

@@ -0,0 +1,13 @@
+# Abstract Examples Index
+
+All abstract example cites should point to the local files below.
+
+1. Version 1 (Challenge -> Contribution)
+`Version 1: Introduce the technical challenge, then use one to two sentences to present the technical contribution that solves the challenge.`
+`references/examples/abstract/template-a.md`
+2. Version 2 (Challenge -> Insight -> Contribution)
+`Version 2: Introduce the technical challenge, then use one to two sentences to present the insight for solving the challenge, and then one sentence to present the technical contribution that implements this insight. (Personally recommended.)`
+`references/examples/abstract/template-b.md`
+3. Version 3 (Multiple Contributions)
+`Version 3: When there are multiple technical contributions, describe each contribution together with its technical advantage.`
+`references/examples/abstract/template-c.md`

package/package-assets/shared/skills/lab/references/paper-writing/examples/index.md

@@ -0,0 +1,21 @@
+# Example Bank Index
+
+Use this folder for concrete writing patterns and locally organized cite targets.
+
+## Files
+
+1. Abstract examples index: `references/examples/abstract-examples.md`
+2. Introduction examples index: `references/examples/introduction-examples.md`
+3. Abstract template files: `references/examples/abstract/template-a.md`, `references/examples/abstract/template-b.md`, `references/examples/abstract/template-c.md`
+4. Introduction task/application files: `references/examples/introduction/version-1-task-then-application.md`, `references/examples/introduction/version-2-application-first.md`, `references/examples/introduction/version-3-general-to-specific-setting.md`, `references/examples/introduction/version-4-open-with-challenge.md`
+5. Introduction technical-challenge files: `references/examples/introduction/technical-challenge-version-1-existing-task.md`, `references/examples/introduction/technical-challenge-version-2-existing-task-insight-backed-by-traditional.md`, `references/examples/introduction/technical-challenge-version-3-novel-task.md`, `references/examples/introduction/novel-task-challenge-decomposition.md`
+6. Introduction pipeline files: `references/examples/introduction/pipeline-version-1-one-contribution-multi-advantages.md`, `references/examples/introduction/pipeline-version-2-two-contributions.md`, `references/examples/introduction/pipeline-version-3-new-module-on-existing-pipeline.md`, `references/examples/introduction/pipeline-version-4-observation-driven.md`, `references/examples/introduction/pipeline-not-recommended-abstract-only.md`
+7. Method examples index: `references/examples/method-examples.md`
+8. Method detail files: `references/examples/method/pre-writing-questions.md`, `references/examples/method/module-triad-neural-body.md`, `references/examples/method/neural-body-annotated-figure-text.md`, `references/examples/method/module-design-instant-ngp.md`, `references/examples/method/module-motivation-patterns.md`, `references/examples/method/section-skeleton.md`, `references/examples/method/overview-template.md`, `references/examples/method/example-of-the-three-elements.md`, `references/examples/method/method-writing-common-issues-note.md`
+
+## Usage
+
+1. Pick one template from a section guide.
+2. Open the matching examples file.
+3. Reuse the sentence logic, not exact wording.
+4. Keep citation links in your notes for traceability.

package/package-assets/shared/skills/lab/references/paper-writing/examples/introduction/novel-task-challenge-decomposition.md

@@ -0,0 +1,18 @@
+# Introduction Novel-Task Challenge Decomposition
+
+
+`For novel tasks without direct methods, decompose the challenge into clear requirement/challenge points.`
+
+```latex
+% To achieve xx goal, several requirements must be satisfied (or several challenges must be handled).
+%% Example: In this work, our goal is to build a model that captures such object intrinsics from a single image. This problem is challenging for three reasons.
+
+% Describe point 1
+%% Example: First, we only have a single image. This makes our work fundamentally different from existing works on 3D-aware image generation models [8, 9, 27, 28], which typically require a large dataset of thousands of instances for training. In comparison, the single image contains at most a few dozen instances, making the inference problem highly under-constrained.
+
+% Describe point 2
+%% Example: Second, these already limited instances may vary significantly in pixel values. This is because they have different poses and illumination conditions, but neither of these factors are annotated or known. We also cannot resort to existing tools for pose estimation based on structure from motion, such as COLMAP [35], because the appearance variations violate the assumptions of epipolar geometry.
+
+% Describe point 3
+%% Example: Finally, the object intrinsics we aim to infer are probabilistic, not deterministic: no two roses in the natural world are identical, and we want to capture a distribution of their geometry, texture, and material to exploit the underlying multi-view information.
+```

package/package-assets/shared/skills/lab/references/paper-writing/examples/introduction/pipeline-not-recommended-abstract-only.md

@@ -0,0 +1,30 @@
+# Not Recommended: Abstract-Only Method Description in Introduction
+
+
+`Not recommended: If the method is simple, do not avoid concrete method details in Introduction and only discuss abstract insight to make it look novel.`
+
+Expert note (faithful translation):
+
+1. The craft of this writing template is how to make a simple pipeline look novel.
+2. Note: this is not about making the insight look novel, but about making the pipeline steps look novel.
+3. In most cases this is not recommended.
+4. The better target is to clearly explain how the core contribution is implemented in Introduction.
+
+```latex
+% To tackle this problem, we propose a novel 3D GAN training method to generate photo-realistic images irrespective of the viewing angle.
+
+% Introduce key idea
+% Our key idea is as follows. To ease the challenging problem of learning photorealistic and multi-view consistent image synthesis, we cast the problem into two subproblems, each of which can be solved more easily.
+
+% Explain why the key idea works, but without concretely discussing the full pipeline (or only discuss abstract benefit)
+%% Example: Specifically, we formulate the problem as a combination of two simple discrimination problems, one of which learns to discriminate whether a synthesized image looks real or not, and the other learns to discriminate whether a synthesized image agrees with the camera pose. Unlike the formulations of the previous methods, which try to learn the real image distribution for each pose, or to learn pose estimation, our subproblems are much easier as each of them is analogous to a basic binary classification problem.
+
+% Introduce pipeline modules with new terms but without clearly explaining the full pipeline (or skip concrete pipeline details)
+%% Example: Based on this key idea, we propose a dual-branched discriminator, which has two branches for learning photorealism and pose consistency, respectively. As these branches are supervised explicitly for their respective purposes, high-quality images with pose consistency can be produced at each viewing angle, and consequently, the generator creates high-quality images and shapes. (This paragraph does not clearly explain how the pipeline works.)
+
+% Introduce another contribution
+%% Example: In addition, we propose a pose-matching loss to give supervision to the discriminator for the pose consistency, by considering a positive pose (i.e., rendering pose or ground truth pose) and a negative pose (i.e., irrelevant pose) for a given image. (This paragraph does not clearly explain how the pipeline works.)
+
+% Explain expected benefit over prior methods
+%% Example: For example, the frontal viewpoint is one of the irrelevant poses for a side-view image. As reported in the experiments, this loss helps improve image and shape quality. This can be interpreted as a simplification of a classification problem from a large number of classes into binary, which is composed of positive and negative pairs.
+```

package/package-assets/shared/skills/lab/references/paper-writing/examples/introduction/pipeline-version-1-one-contribution-multi-advantages.md

@@ -0,0 +1,30 @@
+# Pipeline Version 1 (One Contribution, Multiple Advantages)
+
+
+`Version 1: One contribution with multiple advantages, and one teaser figure to present the basic idea.`
+
+```latex
+% In this paper, we propose a novel framework …
+%% Example: In this paper, we introduce a novel implicit neural representation for dynamic humans, named Neural Body, to solve the challenge of novel view synthesis from sparse views.
+In this paper, we propose a novel framework/representation, named [method name] for [xxx task].
+
+% Teaser for basic idea
+%% Example: The basic idea is illustrated in Figure 2.
+The basic idea is illustrated in [xxx Figure].
+
+% One-sentence key novelty/contribution (very important ability)
+%% Example: For the implicit fields at different frames, instead of learning them separately, Neural Body generates them from the same set of latent codes.
+Our innovation is in [one sentence for key novelty].
+
+% Method details
+%% Example: Specifically, we anchor a set of latent codes to the vertices of a deformable human model (SMPL in this work), namely that their spatial locations vary with the human pose. To obtain the 3D representation at a frame, we first transform the code locations based on the human pose, which can be reliably estimated from sparse camera views. Then, a network is designed to regress the density and color for any 3D point based on these latent codes. Both the latent codes and the network are jointly learned from images of all video frames during the reconstruction.
+Specifically, [how it works in detail].
+
+% Advantage 1
+%% Example: This model is inspired by the latent variable model in statistics, which enables us to effectively integrate observations at different frames.
+In contrast to previous methods, [our advantage].
+
+% Advantage 2
+%% Example: Another advantage of the proposed method is that the deformable model provides a geometric prior (rough surface location) to enable more efficient learning of implicit fields.
+Another advantage of the proposed method is that [another advantage].
+```

package/package-assets/shared/skills/lab/references/paper-writing/examples/introduction/pipeline-version-2-two-contributions.md

@@ -0,0 +1,34 @@
+# Pipeline Version 2 (Two Contributions)
+
+
+`Version 2: Two contributions, and one teaser figure to present the basic idea.`
+
+```latex
+% In this paper, we propose a novel framework …
+%% Example: In this paper, we introduce a novel implicit neural representation for dynamic humans, named Neural Body, to solve the challenge of novel view synthesis from sparse views.
+In this paper, we propose a novel framework/representation, named [method name] for [xxx task].
+
+% One-sentence key novelty
+%% Example: To that end, we propose techniques to represent a given subject with rare token identifiers and fine-tune a pre-trained, diffusion-based text-to-image framework that operates in two steps; generating a low-resolution image from text and subsequently applying super-resolution (SR) diffusion models.
+Our innovation is in [one sentence for key novelty].
+
+% Teaser
+%% Example: The basic idea is illustrated in Figure 2.
+The basic idea is illustrated in [xxx Figure].
+
+% Contribution 1 details
+%% Example: We first fine-tune the low-resolution text-to-image model with the input images and text prompts containing a unique identifier followed by the class name of the subject (e.g., “A [V] dog”).
+Specifically, [how contribution 1 works].
+
+% Advantage of contribution 1
+%% Example: This model is inspired by the latent variable model in statistics, which enables us to effectively integrate observations at different frames.
+In contrast to previous methods, [advantage of contribution 1].
+
+% Challenge motivating contribution 2
+%% Example: In order to prevent overfitting and language drift [35, 40] that cause the model to associate the class name (e.g., “dog”) with the specific instance
+However, [another technical challenge].
+
+% Contribution 2 details
+%% Example: we propose an autogenous, class-specific prior preservation loss, which leverages the semantic prior on the class that is embedded in the model, and encourages it to generate diverse instances of the same class as our subject.
+Specifically, [how contribution 2 works].
+```

package/package-assets/shared/skills/lab/references/paper-writing/examples/introduction/pipeline-version-3-new-module-on-existing-pipeline.md

@@ -0,0 +1,18 @@
+# Pipeline Version 3 (New Module on Existing Pipeline)
+
+
+`Version 3: Build on a prior pipeline and introduce one new module, with a teaser figure for the basic idea.`
+
+```latex
+% In this paper, we propose a learning-based snake algorithm, named deep snake, for real-time instance segmentation.
+
+% Inspired by previous methods [21, 25], deep snake takes an initial contour as input and deforms it by regressing vertex-wise offsets.
+
+% Our innovation is introducing the circular convolution for efficient feature learning on a contour, as illustrated in Figure 1.
+
+% We observe that the contour is a cycle graph that consists of a sequence of vertices connected in a closed cycle. Since every vertex has the same degree equal to two, we can apply the standard 1D convolution on the vertex features.
+
+% Considering that the contour is periodic, deep snake introduces the circular convolution, which indicates that an aperiodic function (1D kernel) is convolved in the standard way with a periodic function (features defined on the contour).
+
+% The kernel of circular convolution encodes not only the feature of each vertex but also the relationship among neighboring vertices. In contrast, the generic GCN performs pooling to aggregate information from neighboring vertices. The kernel function in our circular convolution amounts to a learnable aggregation function, which is more expressive and results in better performance than using a generic GCN, as demonstrated by our experimental results in Section 5.2.
+```

package/package-assets/shared/skills/lab/references/paper-writing/examples/introduction/pipeline-version-4-observation-driven.md

@@ -0,0 +1,16 @@
+# Pipeline Version 4 (Observation-Driven Contribution)
+
+
+`Version 4: Contribution comes from one important observation. Introduce key innovation first, then intuitive observation as motivation, then method details, then benefits.`
+
+```latex
+% In this paper, we propose a learning-based snake algorithm, named deep snake, for real-time instance segmentation.
+
+% Our innovation is introducing the circular convolution for efficient feature learning on a contour, as illustrated in Figure 1.
+
+% We observe that the contour is a cycle graph that consists of a sequence of vertices connected in a closed cycle. Since every vertex has the same degree equal to two, we can apply the standard 1D convolution on the vertex features.
+
+% Considering that the contour is periodic, deep snake introduces the circular convolution, which indicates that an aperiodic function (1D kernel) is convolved in the standard way with a periodic function (features defined on the contour).
+
+% The kernel of circular convolution encodes not only the feature of each vertex but also the relationship among neighboring vertices. In contrast, the generic GCN performs pooling to aggregate information from neighboring vertices. The kernel function in our circular convolution amounts to a learnable aggregation function, which is more expressive and results in better performance than using a generic GCN, as demonstrated by our experimental results in Section 5.2.
+```

package/package-assets/shared/skills/lab/references/paper-writing/examples/introduction/technical-challenge-version-1-existing-task.md

@@ -0,0 +1,32 @@
+# Technical Challenge Version 1 (Existing Task, Existing Methods)
+
+
+`Version 1: For existing tasks with existing methods, discuss the challenge chain from traditional methods to recent methods and finally to the challenge we solve.`
+
+```latex
+% Discuss general technical challenges of this task (to lead into recent methods)
+%% Example 1: This problem is quite challenging from many perspectives, including object detection under severe occlusions, variations in lighting and appearance, and cluttered background objects.
+%% Example 2: This problem is particularly challenging due to the inherent ambiguity on acquiring human geometry, materials and motions from images.
+This problem is particularly challenging due to several factors, including [xxx reason], [xxx reason], and [xxx reason].
+
+% Briefly introduce one class of traditional methods, then discuss their technical challenge
+%% Example: Traditional methods have shown that pose estimation can be achieved by establishing the correspondences between an object image and the object model.
+To overcome these challenges, traditional methods [how they work], [what they achieve].
+
+%% Example: They rely on hand-crafted features, which are not robust to image variations and background clutters.
+However, they [technical challenge they face].
+
+% Briefly introduce one class of recent methods 1 (optional), then discuss their challenge
+%% Example: Deep learning based methods train end-to-end neural networks that take an image as input and output its corresponding pose.
+Recently, [xxx methods] [how they work], [what they achieve].
+
+%% Example: However, generalization remains as an issue, as it is unclear that such end-to-end methods learn sufficient feature representations for pose estimation.
+However, they [limitation], because [xxx technical reason].
+
+% Briefly introduce one class of recent methods 2, then discuss their challenge (must lead to our solved challenge)
+%% Example: Some recent methods use CNNs to first regress 2D keypoints and then compute 6D pose parameters using the Perspective-n-Point (PnP) algorithm. In other words, the detected keypoints serve as an intermediate representation for pose estimation. Such two-stage approaches achieve state-of-the-art performance, thanks to robust detection of keypoints.
+To overcome this challenge, [xxx methods] [how they work], [what they achieve].
+
+%% Example: However, these methods have difficulty in tackling occluded and truncated objects, since part of their keypoints are invisible. Although CNNs may predict these unseen keypoints by memorizing similar patterns, generalization remains difficult.
+However, they [limitation], because [xxx technical reason].
+```

package/package-assets/shared/skills/lab/references/paper-writing/examples/introduction/technical-challenge-version-2-existing-task-insight-backed-by-traditional.md

@@ -0,0 +1,33 @@
+# Technical Challenge Version 2 (Existing Task, Insight Backed by Traditional Methods)
+
+
+`Version 2: For existing tasks, if our technical insight was used in traditional methods, discuss that line to provide conceptual backing.`
+
+```latex
+% Introduce one class of traditional/recent methods and discuss their technical challenge (to lead to our insight)
+%% Example (Deep Snake): Most of the state-of-the-art instance segmentation methods perform pixel-wise segmentation within a bounding box given by an object detector.
+%% Example (ManhattanSDF): Given input images, traditional methods generally estimate the depth map for each image based on the multi-view stereo (MVS) algorithms and then fuse estimated depth maps into 3D models.
+Traditional/recent methods [how they work], [what they achieve].
+
+%% Example (Deep Snake): They may be sensitive to the inaccurate bounding box. Moreover, representing an object shape as dense binary pixels generally results in costly post-processing.
+%% Example (ManhattanSDF): Although these methods achieve successful reconstruction in most cases, they have difficulty in handling low-textured regions, e.g., floors and walls of indoor scenes, due to the unreliable stereo matching in these regions.
+However, they [limitation], because [xxx technical reason].
+
+% Discuss traditional methods that used an insight similar to ours (implicitly backing our idea)
+%% Example (Deep Snake): An alternative shape representation is the object contour, which is a set of vertices along the object silhouette. In contrast to pixel-based representation, a contour is not limited within a bounding box and has fewer parameters. Such a contour-based representation has long been used in image segmentation since the seminal work by Kass et al., which is well known as snakes or active contours.
+%% Example (ManhattanSDF): To improve the reconstruction of low-textured regions, a typical approach is leveraging the planar prior of manmade scenes, which has long been explored in literature. A renowned example is the Manhattanworld assumption, i.e., the surfaces of man-made scenes should be aligned with three dominant directions.
+To overcome this problem, a typical approach is [xxx insight], which has long been explored in literature.
+
+These methods [how they work].
+
+%% Example (Deep Snake): While many variants have been developed in literature, these methods are prone to local optima as the objective functions are handcrafted and typically nonconvex.
+%% Example (ManhattanSDF): However, all of them focus on optimizing per-view depth maps instead of the full scene models in 3D space. As a result, depth estimation and plane segmentation could still be inconsistent among views, yielding suboptimal reconstruction quality as demonstrated by our experimental results in Section 5.3.
+However, they [limitation], because [xxx technical reason].
+
+% Then discuss newer methods and their remaining challenge (must lead to our solved challenge)
+%% Example: There is a recent trend to represent 3D scenes as implicit neural representations and learn the representations from images with differentiable renderers. In particular, [49, 54, 55] use a signed distance field (SDF) to represent the scene and render it into images based on the sphere tracing or volume rendering. Thanks to the well-defined surfaces of SDFs, they recover high-quality 3D geometries from images.
+To overcome this challenge, [xxx methods] [how they work], [what they achieve].
+
+%% Example: However, these methods essentially rely on the multi-view photometric consistency to learn the SDFs. So they still suffer from poor performance in low-textured planar regions, as shown in Figure 1, as many plausible solutions may satisfy the photometric constraint in low-textured planar regions.
+However, they [limitation], because [xxx technical reason].
+```

package/package-assets/shared/skills/lab/references/paper-writing/examples/introduction/technical-challenge-version-3-novel-task.md

@@ -0,0 +1,21 @@
+# Technical Challenge Version 3 (Novel Task)
+
+
+`Version 3: For novel tasks without direct methods, define the challenge directly and decompose it by requirement/challenge points.`
+
+```latex
+% To achieve xx goal, several requirements/challenges must be satisfied.
+%% Example: In this work, our goal is to build a model that captures such object intrinsics from a single image. This problem is challenging for three reasons.
+
+% Describe point 1
+%% Example: First, we only have a single image. This makes our work fundamentally different from existing works on 3D-aware image generation models [8, 9, 27, 28], which typically require a large dataset of thousands of instances for training. In comparison, the single image contains at most a few dozen instances, making the inference problem highly under-constrained.
+
+% Describe point 2
+%% Example: Second, these already limited instances may vary significantly in pixel values. This is because they have different poses and illumination conditions, but neither of these factors are annotated or known. We also cannot resort to existing tools for pose estimation based on structure from motion, such as COLMAP [35], because the appearance variations violate the assumptions of epipolar geometry.
+
+% Describe point 3
+%% Example: Finally, the object intrinsics we aim to infer are probabilistic, not deterministic: no two roses in the natural world are identical, and we want to capture a distribution of their geometry, texture, and material to exploit the underlying multi-view information.
+```
+
+See also:
+1. `references/examples/introduction/novel-task-challenge-decomposition.md`

package/package-assets/shared/skills/lab/references/paper-writing/examples/introduction/version-1-task-then-application.md

@@ -0,0 +1,14 @@
+# Introduction Version 1: Task First, Then Application
+
+
+`Version 1: If the task is relatively niche, introduce the task first, then introduce applications.`
+
+```latex
+% Introduce Task (if the task is very familiar, this part can be skipped)
+%% Example: Object pose estimation aims to estimate object's orientation and translation relative to a canonical frame from a single image.
+[xxx task] targets at recovering/reconstructing/estimating [xxx output] from [xxx input].
+
+% Introduce Application
+%% Example: Accurate pose estimation is essential for a variety of applications such as augmented reality, autonomous driving and robotic manipulation.
+[xxx task] has a variety of applications such as [xxx], [xxx], and [xxx].
+```

package/package-assets/shared/skills/lab/references/paper-writing/examples/introduction/version-2-application-first.md

@@ -0,0 +1,10 @@
+# Introduction Version 2: Application First
+
+
+`Version 2: If the task is already familiar to most readers, introduce applications directly.`
+
+```latex
+% Introduce Application
+%% Example: Accurate pose estimation is essential for a variety of applications such as augmented reality, autonomous driving and robotic manipulation.
+[xxx task] has a variety of applications such as [xxx], [xxx], and [xxx].
+```

package/package-assets/shared/skills/lab/references/paper-writing/examples/introduction/version-3-general-to-specific-setting.md

@@ -0,0 +1,14 @@
+# Introduction Version 3: General Application -> Specific Setting
+
+
+`Version 3: Introduce applications of the general task first, then introduce the specific task setting. (Personally recommended when the setting is relatively new.)`
+
+```latex
+% Introduce applications of the general task
+%% Example: Accurate pose estimation is essential for a variety of applications such as augmented reality, autonomous driving and robotic manipulation.
+[xxx task] has a variety of applications such as [xxx], [xxx], and [xxx].
+
+% Introduce the specific task setting
+%% Example: This paper focuses on the specific setting of recovering the 6DoF pose of an object, i.e., rotation and translation in 3D, from a single RGB image of that object.
+This paper focuses on the specific setting of recovering/reconstructing/estimating [xxx output] from [xxx input].
+```