superlab 0.1.14 → 0.1.16

package/lib/i18n.cjs

@@ -10,12 +10,11 @@ ${body}
 `;
 }
 
-function claudeCommand(name, description, tags, body) {
+function claudeCommand(name, description, argumentHint, body) {
   return `---
 name: "${name}"
 description: ${description}
-category: 工作流
-tags: [${tags}]
+argument-hint: ${argumentHint}
 ---
 
 ${body}
@@ -61,55 +60,55 @@ const ZH_CONTENT = {
   [path.join(".codex", "prompts", "lab-write.md")]: codexPrompt(
     "把验证过的研究工件转成论文 section，并按小步方式修订",
     "section or writing target",
-    "使用已安装的 `lab` 技能：`.codex/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:write`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:write` 阶段。它必须先有来自 `/lab:framing` 的已批准 framing artifact，再读取 `.codex/skills/lab/references/paper-writing/` 下与当前 section 对应的参考文件，并结合 `paper-review.md` 与 `does-my-writing-flow-source.md`，先写 mini-outline，再只修改一个 section。"
+    "使用已安装的 `lab` 技能：`.codex/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:write`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:write` 阶段。它必须先有来自 `/lab:framing` 的已批准 framing artifact，再读取 `.codex/skills/lab/references/paper-writing/` 下与当前 section 对应的参考文件；如果当前是 `abstract`、`introduction` 或 `method`，还必须继续读取 `.codex/skills/lab/references/paper-writing/examples/index.md`、对应的 examples index，以及 1-2 个具体 example 文件。然后结合 `paper-review.md` 与 `does-my-writing-flow-source.md`，先写 mini-outline，再只修改一个 section。第一次进入会产出论文 `.tex` 的路径时，如果 `paper_template_root` 为空，必须先问一次：继续使用默认 LaTeX scaffold，还是先接入模板目录。"
   ),
-  [path.join(".claude", "commands", "lab", "idea.md")]: claudeCommand(
-    "LAB: Idea",
+  [path.join(".claude", "commands", "lab-idea.md")]: claudeCommand(
+    "lab-idea",
     "在进入规格前调研并打磨论文或实验想法",
-    "workflow, research, idea",
-    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:idea`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:idea` 阶段。它必须先用清晰简洁的话定义问题与失败场景，说明现有方法哪里不够、我们的想法为何更好，再做 idea classification、contribution category、breakthrough level 的归类，并收束出至少三个一眼就有意义的点，最后保留进入 `/lab:spec` 前的 approval gate。"
+    "idea 或 research problem",
+    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `idea` 阶段，不要只推荐别的 lab 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 lab workflow 的 `idea` 阶段。它必须先用清晰简洁的话定义问题与失败场景，说明现有方法哪里不够、我们的想法为何更好，再做 idea classification、contribution category、breakthrough level 的归类，并收束出至少三个一眼就有意义的点，最后保留进入 `spec` 前的 approval gate。"
   ),
-  [path.join(".claude", "commands", "lab", "framing.md")]: claudeCommand(
-    "LAB: Framing",
+  [path.join(".claude", "commands", "lab-framing.md")]: claudeCommand(
+    "lab-framing",
     "在写作前收紧方法名、模块名、论文题目和 contribution framing",
-    "workflow, research, framing",
-    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:framing`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:framing` 阶段。它必须围绕 paper-facing framing，收紧方法名、模块名、题目和 contribution bullets，审查当前领域与相邻领域的术语是否 canonical、对象是否明确，并在进入 `/lab:write` 前保留 approval gate。"
+    "naming、title 或 contribution framing target",
+    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `framing` 阶段，不要只推荐别的 lab 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 lab workflow 的 `framing` 阶段。它必须围绕 paper-facing framing，收紧方法名、模块名、题目和 contribution bullets，审查当前领域与相邻领域的术语是否 canonical、对象是否明确，并在进入 `write` 前保留 approval gate。"
   ),
-  [path.join(".claude", "commands", "lab", "spec.md")]: claudeCommand(
-    "LAB: Spec",
+  [path.join(".claude", "commands", "lab-spec.md")]: claudeCommand(
+    "lab-spec",
     "把已批准的 idea 转成统一的 lab change 目录",
-    "workflow, research, spec",
-    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:spec`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:spec` 阶段。它必须围绕一个 change id，在 `.lab/changes/<change-id>/` 下生成 proposal/design/spec/tasks，并让这个 change 成为后续 run 和 iterate 的统一入口。"
+    "approved idea context",
+    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `spec` 阶段，不要只推荐别的 lab 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 lab workflow 的 `spec` 阶段。它必须围绕一个 change id，在 `.lab/changes/<change-id>/` 下生成 proposal/design/spec/tasks，并让这个 change 成为后续 run 和 iterate 的统一入口。"
   ),
-  [path.join(".claude", "commands", "lab", "run.md")]: claudeCommand(
-    "LAB: Run",
+  [path.join(".claude", "commands", "lab-run.md")]: claudeCommand(
+    "lab-run",
     "执行最小可行实验并标准化输出",
-    "workflow, research, run",
-    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:run`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:run` 阶段。它必须从最小实验开始，登记 run，生成标准化评估摘要，并验证结果格式。"
+    "run context",
+    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `run` 阶段，不要只推荐别的 lab 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 lab workflow 的 `run` 阶段。它必须从最小实验开始，登记 run，生成标准化评估摘要，并验证结果格式。"
   ),
-  [path.join(".claude", "commands", "lab", "iterate.md")]: claudeCommand(
-    "LAB: Iterate",
+  [path.join(".claude", "commands", "lab-iterate.md")]: claudeCommand(
+    "lab-iterate",
     "在固定成功标准下执行有边界的实验迭代",
-    "workflow, research, iterate",
-    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:iterate`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:iterate` 阶段。它必须冻结 mission、声明 completion_promise、只做小步改动、每轮生成评估和 iteration report；若风险连续两轮升高则切 diagnostic mode，并在失败结束时记录 blockers 与 next actions。"
+    "iteration mission",
+    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `iterate` 阶段，不要只推荐别的 lab 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 lab workflow 的 `iterate` 阶段。它必须冻结 mission、声明 completion_promise、只做小步改动、每轮生成评估和 iteration report；若风险连续两轮升高则切 diagnostic mode，并在失败结束时记录 blockers 与 next actions。"
   ),
-  [path.join(".claude", "commands", "lab", "review.md")]: claudeCommand(
-    "LAB: Review",
+  [path.join(".claude", "commands", "lab-review.md")]: claudeCommand(
+    "lab-review",
     "以审稿人模式审查研究方案或结果",
-    "workflow, research, review",
-    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:review`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:review` 阶段。它必须先给简洁摘要，再按 findings -> fatal flaws -> fix priority -> residual risks 的顺序输出，优先检查方法学漏洞、对照公平性、数据泄漏、统计不足和 unsupported claims。"
+    "artifact or result to review",
+    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `review` 阶段，不要只推荐别的 lab 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 lab workflow 的 `review` 阶段。它必须先给简洁摘要，再按 findings -> fatal flaws -> fix priority -> residual risks 的顺序输出，优先检查方法学漏洞、对照公平性、数据泄漏、统计不足和 unsupported claims。"
   ),
-  [path.join(".claude", "commands", "lab", "report.md")]: claudeCommand(
-    "LAB: Report",
+  [path.join(".claude", "commands", "lab-report.md")]: claudeCommand(
+    "lab-report",
     "基于验证后的迭代工件生成最终报告",
-    "workflow, research, report",
-    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:report`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:report` 阶段。它必须汇总标准化摘要、保留失败尝试和局限，并生成最终实验报告。"
+    "report context",
+    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `report` 阶段，不要只推荐别的 lab 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 lab workflow 的 `report` 阶段。它必须汇总标准化摘要、保留失败尝试和局限，并生成最终实验报告。"
   ),
-  [path.join(".claude", "commands", "lab", "write.md")]: claudeCommand(
-    "LAB: Write",
+  [path.join(".claude", "commands", "lab-write.md")]: claudeCommand(
+    "lab-write",
     "把验证过的研究工件转成论文 section，并按小步方式修订",
-    "workflow, research, writing",
-    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:write`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:write` 阶段。它必须先有来自 `/lab:framing` 的已批准 framing artifact，再读取 `.claude/skills/lab/references/paper-writing/` 下与当前 section 对应的参考文件，并结合 `paper-review.md` 与 `does-my-writing-flow-source.md`，先写 mini-outline，再只修改一个 section。"
+    "section or writing target",
+    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `write` 阶段，不要只推荐别的 lab 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 lab workflow 的 `write` 阶段。它必须先有来自 `framing` 阶段的已批准 framing artifact，再读取 `.claude/skills/lab/references/paper-writing/` 下与当前 section 对应的参考文件；如果当前是 `abstract`、`introduction` 或 `method`，还必须继续读取 `.claude/skills/lab/references/paper-writing/examples/index.md`、对应的 examples index，以及 1-2 个具体 example 文件。然后结合 `paper-review.md` 与 `does-my-writing-flow-source.md`，先写 mini-outline，再只修改一个 section。第一次进入会产出论文 `.tex` 的路径时，如果 `paper_template_root` 为空，必须先问一次：继续使用默认 LaTeX scaffold，还是先接入模板目录。"
   ),
 };
 
@@ -291,8 +290,10 @@ const ZH_SKILL_FILES = {
 ## 必要输出
 
 - 方法概述
+- 选定指标摘要
 - 实验设置
 - 已验证主结果
+- 位于 \`<deliverables_root>/main-tables.md\` 的受管主表工件
 - 消融
 - 失败尝试
 - 局限性
@@ -317,13 +318,15 @@ const ZH_SKILL_FILES = {
 - 每个主要 claim 都要指向已记录的 summary 或 iteration artifact。
 - 主表结构、gate 和最终结果 framing 必须对齐已批准的评估协议。
 - 不要凭记忆重述指标定义、baseline 行为或对比方法实现；直接引用评估协议里记录的来源。
+- 必须把已批准的主指标、次级指标和必要终局证据明确写进 \`report.md\` 与受管的 \`main-tables.md\`。
 - 如果报告依赖了对原始指标或原始实现的偏差，必须明确写出这个偏差。
+- 如果 workflow language 是中文，\`report.md\` 和 \`<deliverables_root>/main-tables.md\` 也应使用中文，除非文件路径、代码标识符或字面指标名必须保持原样。
 - 解释优先保守，不要写成营销文案。
 - 要给 \`/lab:write\` 留下清晰 handoff，尤其是 section draft 可以直接引用的证据链接。
 
 ## 交互约束
 
-- 开始前先简洁说明：campaign outcome、最强已支撑 claim、最大的报告风险。
+- 开始前先简洁说明：campaign outcome、选定的主指标和次级指标、最强已支撑 claim、最大的报告风险。
 - 如果某个未决前提会改变报告解释，一次只问一个问题。
 - 如果存在多种报告 framing，先给 2-3 个方案、trade-offs 和推荐项，优先最忠于证据的 framing。
 - 如果某种 framing 会实质影响后续论文 claim，要保留 approval gate。
@@ -679,27 +682,78 @@ const ZH_SKILL_FILES = {
 - 方差和显著性问题是否交代清楚？
 `,
   [path.join(".lab", ".managed", "templates", "final-report.md")]:
-`# Final Report
+`# 最终报告
 
 ## 目标
 
 - 本轮研究目标：
 - 是否达标：
 
+## 选定指标
+
+- 主指标：
+- 次级指标：
+- 必要终局证据：
+
+## 主表工件
+
+- 受管主表路径：\`<deliverables_root>/main-tables.md\`
+- 最终表现摘要：
+- 主表覆盖情况：
+
 ## 主要结果
 
-- Main finding 1:
-- Main finding 2:
+- 主要发现 1：
+- 主要发现 2：
 
 ## 失败尝试与局限
 
-- Failed attempt:
-- Limitation:
+- 失败尝试：
+- 局限：
 
 ## 仍需加强的 claims
 
-- Claim:
-- Missing support:
+- Claim：
+- 缺失支持：
+`,
+  [path.join(".lab", ".managed", "templates", "main-tables.md")]:
+`# 主表工件
+
+## 选定指标
+
+- 主指标：
+- 次级指标：
+- 必要终局证据：
+
+## 最终表现摘要
+
+- 主要结果摘要：
+- 最重要数字：
+- 报告边界：
+
+## Table 1
+
+- 作用：
+- 使用指标：
+- 最强支撑 claim：
+
+## Table 2
+
+- 作用：
+- 使用指标：
+- 最强支撑 claim：
+
+## Table 3
+
+- 作用：
+- 使用指标：
+- 最强支撑 claim：
+
+## Table 4
+
+- 作用：
+- 使用指标：
+- 最强支撑 claim：
 `,
   [path.join(".lab", ".managed", "templates", "paper-plan.md")]:
 `# 论文计划
@@ -829,7 +883,9 @@ const ZH_SKILL_FILES = {
   "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
 }`,
   [path.join(".lab", "context", "mission.md")]:
 `# 研究主线
@@ -995,30 +1051,33 @@ const ZH_SKILL_FILES = {
 
 ## 目标
 
-- Objective:
-- Experiment ladder:
-- Metric glossary:
-- Metric source papers:
-- Metric implementation source:
-- Comparison source papers:
-- Comparison implementation source:
-- Deviation from original implementation:
-- Terminal goal type:
-- Terminal goal target:
-- Required terminal artifact:
+- 目标:
+- 主指标:
+- 次级指标:
+- 必要终局证据:
+- 实验阶梯:
+- 指标释义:
+- 指标来源论文:
+- 指标实现来源:
+- 对比方法来源论文:
+- 对比方法实现来源:
+- 与原始实现的偏差:
+- 终止目标类型:
+- 终止目标目标值:
+- 必要终止工件:
 
 ## 结果
 
-- Status: idle
-- Goal reached: no
-- Stop reason:
-- Promotion applied: no
-- Final artifact:
-- Final rung:
-- Executed stages:
-- Iterations completed: 0
-- Started at:
-- Finished at:
+- 状态: idle
+- 目标是否达成: 否
+- 停止原因:
+- 是否已升格: 否
+- 最终工件:
+- 最终 rung:
+- 已执行阶段:
+- 已完成迭代数: 0
+- 开始时间:
+- 结束时间:
 `,
   [path.join(".lab", "context", "auto-status.md")]:
 `# 自动模式状态
@@ -1299,8 +1358,15 @@ ZH_CONTENT[path.join(".codex", "skills", "lab", "stages", "write.md")] = `# \`/l
 - 最终稿必须是 LaTeX。
 - 如果配置了 \`paper_template_root\`，先检查该模板目录，再按其结构起草论文。
 - 已接入的模板目录可能包含用户或上游修改，默认不要改模板文件。
-- 如果没有配置模板，就使用交付目录下的默认 LaTeX scaffold。
+- 如果没有配置模板且 \`paper_template_decision\` 是 \`unconfirmed\`，在第一次起草 \`.tex\` 之前必须先追问一次：继续使用默认 LaTeX scaffold，还是先接入模板目录。
+- 如果用户选择默认 scaffold，就把该决定持久化到 \`.lab/config/workflow.json\`，写成 \`paper_template_decision: default-scaffold\`。
+- 如果用户选择接入模板，就停止当前写作回合，先转到 \`superlab paper attach-template --path <dir>\`。
+- 如果 \`paper_template_decision\` 已经是 \`default-scaffold\`，就使用交付目录下的默认 LaTeX scaffold。
+- 如果当前是最终导出或最终定稿轮次、\`paper_template_root\` 仍为空、\`paper_template_decision\` 是 \`default-scaffold\`，且 \`paper_template_final_reminder_acknowledged\` 是 \`false\`，就在最终定稿前再提醒一次是否切到模板。
+- 如果用户在最终提醒里仍确认继续使用默认 scaffold，就把 \`paper_template_final_reminder_acknowledged\` 持久化为 \`true\`。
 - 只加载当前 section guide，不要一次加载全部章节参考。
+- 如果当前 section 是 \`abstract\`、\`introduction\` 或 \`method\`，还必须继续读取本地 example bank：\`references/paper-writing/examples/index.md\`、对应的 examples index，以及 1-2 个具体 example 文件。
+- 例子只能复用结构、段落角色和句法逻辑，不能直接复用原句。
 - 先写 mini-outline 再写 prose。
 - 如果缺少 framing artifact，不要继续写作，直接回到 \`/lab:framing\`。
 - 如果某个 claim 没有证据支撑，就削弱或删除。
@@ -1406,24 +1472,24 @@ ZH_CONTENT[path.join(".codex", "prompts", "lab-auto.md")] = codexPrompt(
 );
 
 ZH_CONTENT[path.join(".claude", "commands", "lab.md")] = claudeCommand(
-  "LAB",
+  "lab",
   "查看 /lab 研究工作流总览并选择合适阶段",
-  "workflow, research, overview",
-  "# `/lab` for Claude\n\n`/lab` 是严格的研究工作流命令族。每次都使用同一套仓库工件和阶段边界。\n\n## 子命令\n\n- `/lab:idea`\n  调研 idea，定义问题与 failure case，归类 contribution 与 breakthrough level，对比现有方法，收束三个一眼就有意义的点，并在实现前保留 approval gate。\n\n- `/lab:data`\n  把已批准的 idea 转成数据集与 benchmark 方案，记录数据集年份、使用过该数据集的论文、下载来源、许可或访问限制，以及 classic-public、recent-strong-public、claim-specific 三类 benchmark 的纳入理由，和 canonical baselines、strong historical baselines、recent strong public methods、closest prior work 四类对比方法的纳入理由。\n\n- `/lab:auto`\n  在不改变 mission、framing 和核心 claims 的前提下，读取 eval-protocol 与 auto-mode 契约并自动编排 `run`、`iterate`、`review`、`report`，必要时扩展数据集、benchmark 和 comparison methods，并在满足升格策略时自动升级 primary package。启动前必须选定 autonomy level、声明 terminal goal，并显式批准契约。\n\n- `/lab:framing`\n  通过审计当前领域与相邻领域的术语，锁定 paper-facing 的方法名、模块名、论文题目和 contribution bullets，并在 section 起草前保留 approval gate。\n\n- `/lab:spec`\n  把已批准的 idea 转成 `.lab/changes/<change-id>/` 下的一个 lab change 目录，并在其中写出 `proposal`、`design`、`spec`、`tasks`。\n\n- `/lab:run`\n  执行最小有意义验证运行，登记 run，并生成第一版标准化评估摘要。\n\n- `/lab:iterate`\n  在冻结 mission、阈值、verification commands 与 `completion_promise` 的前提下执行有边界的实验迭代。\n\n- `/lab:review`\n  以 reviewer mode 审查文档或结果，先给短摘要，再输出 findings、fatal flaws、fix priority 和 residual risks。\n\n- `/lab:report`\n  从 runs 和 iterations 工件生成最终研究报告。\n\n- `/lab:write`\n  使用已安装 `lab` skill 下 vendored 的 paper-writing references，把稳定 report 工件转成论文 section。\n\n## 调度规则\n\n- 始终使用 `skills/lab/SKILL.md` 作为工作流合同。\n- 用户显式调用 `/lab:<stage>` 时，要立刻执行该 stage，而不是只推荐别的 `/lab` stage。\n- 先给简洁摘要，再决定是否写工件，最后回报输出路径和下一步。\n- 如果歧义会影响结论，一次只问一个问题；如果有多条可行路径，先给 2-3 个方案再收敛。\n- `/lab:spec` 前应已有经批准的数据集与 benchmark 方案。\n- `/lab:run`、`/lab:iterate`、`/lab:auto`、`/lab:report` 都应遵循 `.lab/context/eval-protocol.md`。\n- `.lab/context/eval-protocol.md` 不只定义主指标和主表，也应定义指标释义、实验阶梯，以及指标和对比实现的来源。\n- `/lab:auto` 只编排已批准边界内的执行阶段，不替代手动的 idea/data/framing/spec 决策。\n- `/lab:write` 前必须已有经批准的 `/lab:framing` 工件。\n\n## 如何输入 `/lab:auto`\n\n- 把 `Autonomy level L1/L2/L3` 视为执行权限级别，不要和论文里的 layer、phase、table 编号混用。\n- 把 `paper layer`、`phase`、`table` 视为实验目标。例如 `paper layer 3` 或 `Phase 1 reviewer fidelity` 不是 `Autonomy level L3`。\n- 一条好的 `/lab:auto` 输入应至少说清：objective、自治级别、terminal goal、scope、allowed modifications。\n- 如果 workflow language 是中文，摘要、清单条目、任务标签和进度更新都应使用中文，除非文件路径、代码标识符或字面指标名必须保持原样。\n- 示例：`/lab:auto 自治级别 L2。目标：推进 paper layer 3 的 organizer enforcement。终止条件：完成 bounded protocol、测试、最小实现和一轮小规模结果。允许修改：evaluator prompt registry、ingestion、parser。`\n"
+  "[stage] [target]",
+  "# `/lab` for Claude\n\n`/lab` 是 Claude Code 里的 lab 工作流分发入口。调用方式有两种：\n\n- `/lab <stage> ...`\n- `/lab-idea`、`/lab-data`、`/lab-auto`、`/lab-framing`、`/lab-spec`、`/lab-run`、`/lab-iterate`、`/lab-review`、`/lab-report`、`/lab-write`\n\n## 阶段别名\n\n- `/lab idea ...` 或 `/lab-idea`\n- `/lab data ...` 或 `/lab-data`\n- `/lab auto ...` 或 `/lab-auto`\n- `/lab framing ...` 或 `/lab-framing`\n- `/lab spec ...` 或 `/lab-spec`\n- `/lab run ...` 或 `/lab-run`\n- `/lab iterate ...` 或 `/lab-iterate`\n- `/lab review ...` 或 `/lab-review`\n- `/lab report ...` 或 `/lab-report`\n- `/lab write ...` 或 `/lab-write`\n\n## 调度规则\n\n- 始终使用 `skills/lab/SKILL.md` 作为工作流合同。\n- 用户显式调用 `/lab <stage> ...` 或 `/lab-<stage>` 时，要立刻执行该 stage，而不是只推荐别的阶段。\n- 先给简洁摘要，再决定是否写工件，最后回报输出路径和下一步。\n- 如果歧义会影响结论，一次只问一个问题；如果有多条可行路径，先给 2-3 个方案再收敛。\n- `spec` 前应已有经批准的数据集与 benchmark 方案。\n- `run`、`iterate`、`auto`、`report` 都应遵循 `.lab/context/eval-protocol.md`。\n- `auto` 只编排已批准边界内的执行阶段，不替代手动的 idea/data/framing/spec 决策。\n- `write` 前必须已有经批准的 `framing` 工件。\n\n## 如何输入 `/lab auto`\n\n- 把 `Autonomy level L1/L2/L3` 视为执行权限级别，不要和论文里的 layer、phase、table 编号混用。\n- 把 `paper layer`、`phase`、`table` 视为实验目标。例如 `paper layer 3` 或 `Phase 1 reviewer fidelity` 不是 `Autonomy level L3`。\n- 一条好的 `/lab auto` 输入应至少说清：objective、自治级别、terminal goal、scope、allowed modifications。\n- 如果 workflow language 是中文，摘要、清单条目、任务标签和进度更新都应使用中文，除非文件路径、代码标识符或字面指标名必须保持原样。\n- 示例：`/lab auto 自治级别 L2。目标：推进 paper layer 3 的 organizer enforcement。终止条件：完成 bounded protocol、测试、最小实现和一轮小规模结果。允许修改：evaluator prompt registry、ingestion、parser。`\n"
 );
 
-ZH_CONTENT[path.join(".claude", "commands", "lab", "data.md")] = claudeCommand(
-  "LAB: Data",
+ZH_CONTENT[path.join(".claude", "commands", "lab-data.md")] = claudeCommand(
+  "lab-data",
   "在进入规格前锁定数据集、下载来源和 benchmark 组合",
-  "workflow, research, data",
-  "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:data`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:data` 阶段。它必须把已批准的 idea 转成数据集与 benchmark 方案，记录每个候选数据集的年份、使用过它的论文、下载来源、许可或访问限制，以及 classic-public、recent-strong-public、claim-specific 三类 benchmark 的纳入理由，和 canonical baselines、strong historical baselines、recent strong public methods、closest prior work 四类对比方法的纳入理由。"
+  "dataset 或 benchmark target",
+  "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `data` 阶段，不要只推荐别的 lab 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 lab workflow 的 `data` 阶段。它必须把已批准的 idea 转成数据集与 benchmark 方案，记录每个候选数据集的年份、使用过它的论文、下载来源、许可或访问限制，以及 classic-public、recent-strong-public、claim-specific 三类 benchmark 的纳入理由，和 canonical baselines、strong historical baselines、recent strong public methods、closest prior work 四类对比方法的纳入理由。"
 );
 
-ZH_CONTENT[path.join(".claude", "commands", "lab", "auto.md")] = claudeCommand(
-  "LAB: Auto",
+ZH_CONTENT[path.join(".claude", "commands", "lab-auto.md")] = claudeCommand(
+  "lab-auto",
   "在已批准边界内编排自动实验循环",
-  "workflow, research, auto",
-  "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:auto`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:auto` 阶段。它必须读取 `.lab/context/eval-protocol.md`、`.lab/context/auto-mode.md`、`.lab/context/auto-status.md` 与 `.lab/context/auto-outcome.md`，先确认 autonomy level、approval status 与 terminal goal schema，再把 eval-protocol 里的指标释义、主表计划、来源约束与结构化实验阶梯当作执行依据，在不修改 mission、framing 和核心 claims 的前提下编排已批准的 `run`、`iterate`、`review`、`report`，轮询长任务完成情况；如果声明了 rung，就保持会话活着并按 rung 转移继续推进。\n如果仓库的 workflow language 是中文，摘要、清单条目、任务标签和进度更新都必须使用中文，除非某个文件路径、代码标识符或字面指标名必须保持原样。\n把 `Layer 3`、`Phase 1`、`Table 2` 这类表达视为论文范围目标；只有显式写成 `Autonomy level L3` 或 `自治级别 L3` 时，才把它当成执行权限级别。\n不要用 `sleep 30`、单次 `pgrep` 或一次性的 `metrics.json` 探针来代替真实长任务命令；当真实实验进程还活着时，只允许发进度更新并继续等待。"
+  "auto mode objective",
+  "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `auto` 阶段，不要只推荐别的 lab 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 lab workflow 的 `auto` 阶段。它必须读取 `.lab/context/eval-protocol.md`、`.lab/context/auto-mode.md`、`.lab/context/auto-status.md` 与 `.lab/context/auto-outcome.md`，先确认 autonomy level、approval status 与 terminal goal schema，再把 eval-protocol 里的指标释义、主表计划、来源约束与结构化实验阶梯当作执行依据，在不修改 mission、framing 和核心 claims 的前提下编排已批准的 `run`、`iterate`、`review`、`report`，轮询长任务完成情况；如果声明了 rung，就保持会话活着并按 rung 转移继续推进。\n如果仓库的 workflow language 是中文，摘要、清单条目、任务标签和进度更新都必须使用中文，除非某个文件路径、代码标识符或字面指标名必须保持原样。\n把 `Layer 3`、`Phase 1`、`Table 2` 这类表达视为论文范围目标；只有显式写成 `Autonomy level L3` 或 `自治级别 L3` 时，才把它当成执行权限级别。\n不要用 `sleep 30`、单次 `pgrep` 或一次性的 `metrics.json` 探针来代替真实长任务命令；当真实实验进程还活着时，只允许发进度更新并继续等待。"
 );
 
 ZH_CONTENT[path.join(".codex", "skills", "lab", "SKILL.md")] = `---
@@ -1949,6 +2015,12 @@ ZH_CONTENT[path.join(".codex", "skills", "lab", "stages", "auto.md")] = `# \`/la
 - 先做输入归一化：把 \`Autonomy level L1/L2/L3\` 视为执行权限级别，把 \`Layer 3\`、\`Phase 1\`、\`Table 2\` 视为论文范围目标。
 - 如果用户同时提了论文层、实验 phase 和自治级别，先用一句话重述：objective、自治级别、terminal goal、scope、allowed modifications。
 - 如果 workflow language 是中文，摘要、清单条目、任务标签和进度更新都应使用中文，除非文件路径、代码标识符或字面指标名必须保持原样。
+- 当循环即将进入 \`write\`，且 \`paper_template_root\` 为空时：
+  - 如果 \`paper_template_decision\` 是 \`unconfirmed\`，必须先追问一次：继续使用默认 scaffold，还是先接入模板目录
+  - 如果用户选择默认 scaffold，就持久化 \`paper_template_decision: default-scaffold\`
+  - 如果用户选择模板，就停止当前循环并转到 \`superlab paper attach-template --path <dir>\`
+  - 如果当前是最终导出或最终定稿、\`paper_template_decision\` 是 \`default-scaffold\`，且 \`paper_template_final_reminder_acknowledged\` 是 \`false\`，就在最终定稿前再提醒一次
+  - 如果用户在最终提醒里仍确认继续使用默认 scaffold，就持久化 \`paper_template_final_reminder_acknowledged: true\`
 - 不要把 \`sleep 30\`、单次 \`pgrep\` 或一次性的 \`metrics.json\` 探针当成 rung 主命令；这些只能算进度检查。
 - 当真实实验进程还活着时，只允许发进度更新并继续等待，不能把这一 rung 当作已经完成。
 `;

package/lib/install.cjs

@@ -326,6 +326,8 @@ function detectLegacyPlatform(targetDir) {
     fs.existsSync(path.join(targetDir, ".codex", "prompts")) ||
     fs.existsSync(path.join(targetDir, ".codex", "skills", "lab"));
   const hasClaude =
+    fs.existsSync(path.join(targetDir, ".claude", "commands", "lab.md")) ||
+    fs.existsSync(path.join(targetDir, ".claude", "commands", "lab-idea.md")) ||
     fs.existsSync(path.join(targetDir, ".claude", "commands", "lab")) ||
     fs.existsSync(path.join(targetDir, ".claude", "skills", "lab"));
 
@@ -366,6 +368,7 @@ function detectLegacyLanguage(targetDir) {
 
   const probeFiles = [
     path.join(targetDir, ".codex", "prompts", "lab-idea.md"),
+    path.join(targetDir, ".claude", "commands", "lab-idea.md"),
     path.join(targetDir, ".claude", "commands", "lab", "idea.md"),
     path.join(targetDir, ".lab", ".managed", "templates", "idea.md"),
     path.join(targetDir, ".superlab", "templates", "idea.md"),
@@ -494,16 +497,16 @@ function localizeInstalledAssets(targetDir, lang, { newlyCreatedProjectOwnedPath
     path.join(".codex", "prompts", "lab-report.md"),
     path.join(".codex", "prompts", "lab-write.md"),
     path.join(".claude", "commands", "lab.md"),
-    path.join(".claude", "commands", "lab", "idea.md"),
-    path.join(".claude", "commands", "lab", "data.md"),
-    path.join(".claude", "commands", "lab", "auto.md"),
-    path.join(".claude", "commands", "lab", "framing.md"),
-    path.join(".claude", "commands", "lab", "spec.md"),
-    path.join(".claude", "commands", "lab", "run.md"),
-    path.join(".claude", "commands", "lab", "iterate.md"),
-    path.join(".claude", "commands", "lab", "review.md"),
-    path.join(".claude", "commands", "lab", "report.md"),
-    path.join(".claude", "commands", "lab", "write.md"),
+    path.join(".claude", "commands", "lab-idea.md"),
+    path.join(".claude", "commands", "lab-data.md"),
+    path.join(".claude", "commands", "lab-auto.md"),
+    path.join(".claude", "commands", "lab-framing.md"),
+    path.join(".claude", "commands", "lab-spec.md"),
+    path.join(".claude", "commands", "lab-run.md"),
+    path.join(".claude", "commands", "lab-iterate.md"),
+    path.join(".claude", "commands", "lab-review.md"),
+    path.join(".claude", "commands", "lab-report.md"),
+    path.join(".claude", "commands", "lab-write.md"),
     path.join(".codex", "skills", "lab", "SKILL.md"),
     path.join(".codex", "skills", "lab", "stages", "idea.md"),
     path.join(".codex", "skills", "lab", "stages", "data.md"),
@@ -538,6 +541,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-auto.md

@@ -0,0 +1,13 @@
+---
+name: "lab-auto"
+description: Orchestrate approved lab execution stages inside a bounded autonomous loop
+argument-hint: autonomous campaign target
+---
+
+Use the installed `lab` skill at `.claude/skills/lab/SKILL.md`.
+
+Execute the requested `/lab-auto` command 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 `auto` stage of the lab workflow. It must read `.lab/context/eval-protocol.md`, `.lab/context/auto-mode.md`, `.lab/context/auto-status.md`, and `.lab/context/auto-outcome.md`, enforce the declared terminal goal schema, orchestrate approved run, iterate, review, and report stages inside that contract, poll long-running work until completion or stop conditions, and write progress plus the final outcome back into `.lab/context/auto-status.md` and `.lab/context/auto-outcome.md`.
+When the repository workflow language is Chinese, summaries, checklist items, task labels, and progress updates should be written in Chinese unless a literal identifier must stay unchanged.
+Treat `Layer 3`, `Phase 1`, or `Table 2` as paper-scope targets. Treat `Autonomy level L3` as the execution permission level.
+Do not replace the real long-running experiment command with a short watcher such as `sleep 30`, `pgrep`, or a one-shot `metrics.json` probe. While the real experiment process is still alive, emit only a progress update and keep waiting.

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

@@ -0,0 +1,10 @@
+---
+name: "lab-data"
+description: Select datasets and benchmark packages with explicit source, year, and paper-usage audit
+argument-hint: dataset or benchmark selection target
+---
+
+Use the installed `lab` skill at `.claude/skills/lab/SKILL.md`.
+
+Execute the requested `/lab-data` command 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 `data` stage of the lab workflow. It must turn the approved idea into an approved dataset package with dataset year, papers that used each dataset, source audit, download plan, explicit benchmark-role rationale for classic-public, recent-strong-public, and claim-specific benchmarks, and explicit comparison rationale for canonical baselines, strong historical baselines, recent strong public methods, and closest prior work.

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

@@ -0,0 +1,10 @@
+---
+name: "lab-framing"
+description: Lock paper-facing naming, title, and contribution framing before drafting
+argument-hint: naming, title, or contribution framing target
+---
+
+Use the installed `lab` skill at `.claude/skills/lab/SKILL.md`.
+
+Execute the requested `/lab-framing` command 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 `framing` stage of the lab workflow. Follow the installed skill, stage guide, and the project assets under `.lab/`.

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

@@ -0,0 +1,10 @@
+---
+name: "lab-idea"
+description: Research and refine a paper or experiment idea before specification
+argument-hint: idea or research problem
+---
+
+Use the installed `lab` skill at `.claude/skills/lab/SKILL.md`.
+
+Execute the requested `/lab-idea` command 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 `idea` stage of the lab workflow. Follow the installed skill, stage guide, and the project assets under `.lab/`.

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

@@ -0,0 +1,10 @@
+---
+name: "lab-iterate"
+description: Run bounded Ralph-style experiment iterations with fixed success criteria
+argument-hint: iteration mission
+---
+
+Use the installed `lab` skill at `.claude/skills/lab/SKILL.md`.
+
+Execute the requested `/lab-iterate` command 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 `iterate` stage of the lab workflow. Follow the installed skill, stage guide, and the project assets under `.lab/`.

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

@@ -0,0 +1,10 @@
+---
+name: "lab-report"
+description: Produce the final report from validated iteration artifacts
+argument-hint: report context
+---
+
+Use the installed `lab` skill at `.claude/skills/lab/SKILL.md`.
+
+Execute the requested `/lab-report` command 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 `report` stage of the lab workflow. Follow the installed skill, stage guide, and the project assets under `.lab/`.

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

@@ -0,0 +1,10 @@
+---
+name: "lab-review"
+description: Review a research plan or result in reviewer mode
+argument-hint: artifact or result to review
+---
+
+Use the installed `lab` skill at `.claude/skills/lab/SKILL.md`.
+
+Execute the requested `/lab-review` command 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 `review` stage of the lab workflow. Follow the installed skill, stage guide, and the project assets under `.lab/`.

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

@@ -0,0 +1,10 @@
+---
+name: "lab-run"
+description: Execute the smallest meaningful experiment and normalize its output
+argument-hint: run context
+---
+
+Use the installed `lab` skill at `.claude/skills/lab/SKILL.md`.
+
+Execute the requested `/lab-run` command 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 `run` stage of the lab workflow. Follow the installed skill, stage guide, and the project assets under `.lab/`.

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

@@ -0,0 +1,10 @@
+---
+name: "lab-spec"
+description: Convert an approved idea into a lab change directory
+argument-hint: approved idea context
+---
+
+Use the installed `lab` skill at `.claude/skills/lab/SKILL.md`.
+
+Execute the requested `/lab-spec` command 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 `spec` stage of the lab workflow. Follow the installed skill, stage guide, and the project assets under `.lab/`.

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

@@ -0,0 +1,10 @@
+---
+name: "lab-write"
+description: Turn validated research artifacts into paper sections with small evidence-bound revisions
+argument-hint: section or writing target
+---
+
+Use the installed `lab` skill at `.claude/skills/lab/SKILL.md`.
+
+Execute the requested `/lab-write` command 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 `write` stage of the lab workflow. It requires an approved framing artifact from the `framing` stage, 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.