superlab 0.1.6 → 0.1.8

package/lib/i18n.cjs

@@ -26,79 +26,90 @@ const ZH_CONTENT = {
   [path.join(".codex", "prompts", "lab-idea.md")]: codexPrompt(
     "在进入规格前调研并打磨论文或实验想法",
     "idea 或 research problem",
-    "使用已安装的 `lab` 技能：`.codex/skills/lab/SKILL.md`。\n\n本命令运行 `/lab:idea` 阶段。它必须先用清晰简洁的话定义问题与失败场景，说明现有方法哪里不够、我们的想法为何更好，再做 idea classification、contribution category、breakthrough level 的归类，并收束出至少三个一眼就有意义的点，最后保留进入 `/lab:spec` 前的 approval gate。"
+    "使用已安装的 `lab` 技能：`.codex/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:idea`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:idea` 阶段。它必须先用清晰简洁的话定义问题与失败场景，说明现有方法哪里不够、我们的想法为何更好，再做 idea classification、contribution category、breakthrough level 的归类，并收束出至少三个一眼就有意义的点，最后保留进入 `/lab:spec` 前的 approval gate。"
+  ),
+  [path.join(".codex", "prompts", "lab-framing.md")]: codexPrompt(
+    "在写作前收紧方法名、模块名、论文题目和 contribution framing",
+    "naming、title 或 contribution framing target",
+    "使用已安装的 `lab` 技能：`.codex/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:framing`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:framing` 阶段。它必须围绕 paper-facing framing，收紧方法名、模块名、题目和 contribution bullets，审查术语是否 canonical、对象是否明确，并在进入 `/lab:write` 前保留 approval gate。"
   ),
   [path.join(".codex", "prompts", "lab-spec.md")]: codexPrompt(
     "把已批准的 idea 转成统一的 lab change 目录",
     "approved idea context",
-    "使用已安装的 `lab` 技能：`.codex/skills/lab/SKILL.md`。\n\n本命令运行 `/lab:spec` 阶段。它必须围绕一个 change id，在 `.superlab/changes/<change-id>/` 下生成 proposal/design/spec/tasks，并让这个 change 成为后续 run 和 iterate 的统一入口。"
+    "使用已安装的 `lab` 技能：`.codex/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 的统一入口。"
   ),
   [path.join(".codex", "prompts", "lab-run.md")]: codexPrompt(
     "执行最小可行实验并标准化输出",
     "run context",
-    "使用已安装的 `lab` 技能：`.codex/skills/lab/SKILL.md`。\n\n本命令运行 `/lab:run` 阶段。它必须从最小实验开始，登记 run，生成标准化评估摘要，并验证结果格式。"
+    "使用已安装的 `lab` 技能：`.codex/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:run`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:run` 阶段。它必须从最小实验开始，登记 run，生成标准化评估摘要，并验证结果格式。"
   ),
   [path.join(".codex", "prompts", "lab-iterate.md")]: codexPrompt(
     "在固定成功标准下执行有边界的实验迭代",
     "iteration mission",
-    "使用已安装的 `lab` 技能：`.codex/skills/lab/SKILL.md`。\n\n本命令运行 `/lab:iterate` 阶段。它必须冻结 mission、声明 completion_promise、只做小步改动、每轮生成评估和 iteration report；若风险连续两轮升高则切 diagnostic mode，并在失败结束时记录 blockers 与 next actions。"
+    "使用已安装的 `lab` 技能：`.codex/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:iterate`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:iterate` 阶段。它必须冻结 mission、声明 completion_promise、只做小步改动、每轮生成评估和 iteration report；若风险连续两轮升高则切 diagnostic mode，并在失败结束时记录 blockers 与 next actions。"
   ),
   [path.join(".codex", "prompts", "lab-review.md")]: codexPrompt(
     "以审稿人模式审查研究方案或结果",
     "artifact or result to review",
-    "使用已安装的 `lab` 技能：`.codex/skills/lab/SKILL.md`。\n\n本命令运行 `/lab:review` 阶段。它必须先给简洁摘要，再按 findings -> fatal flaws -> fix priority -> residual risks 的顺序输出，优先检查方法学漏洞、对照公平性、数据泄漏、统计不足和 unsupported claims。"
+    "使用已安装的 `lab` 技能：`.codex/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:review`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:review` 阶段。它必须先给简洁摘要，再按 findings -> fatal flaws -> fix priority -> residual risks 的顺序输出，优先检查方法学漏洞、对照公平性、数据泄漏、统计不足和 unsupported claims。"
   ),
   [path.join(".codex", "prompts", "lab-report.md")]: codexPrompt(
     "基于验证后的迭代工件生成最终报告",
     "report context",
-    "使用已安装的 `lab` 技能：`.codex/skills/lab/SKILL.md`。\n\n本命令运行 `/lab:report` 阶段。它必须汇总标准化摘要、保留失败尝试和局限，并生成最终实验报告。"
+    "使用已安装的 `lab` 技能：`.codex/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:report`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:report` 阶段。它必须汇总标准化摘要、保留失败尝试和局限，并生成最终实验报告。"
   ),
   [path.join(".codex", "prompts", "lab-write.md")]: codexPrompt(
     "把验证过的研究工件转成论文 section，并按小步方式修订",
     "section or writing target",
-    "使用已安装的 `lab` 技能：`.codex/skills/lab/SKILL.md`。\n\n本命令运行 `/lab:write` 阶段。它必须先读取 `.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 对应的参考文件，并结合 `paper-review.md` 与 `does-my-writing-flow-source.md`，先写 mini-outline，再只修改一个 section。"
   ),
   [path.join(".claude", "commands", "lab", "idea.md")]: claudeCommand(
     "LAB: Idea",
     "在进入规格前调研并打磨论文或实验想法",
     "workflow, research, idea",
-    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n本命令运行 `/lab:idea` 阶段。它必须先用清晰简洁的话定义问题与失败场景，说明现有方法哪里不够、我们的想法为何更好，再做 idea classification、contribution category、breakthrough level 的归类，并收束出至少三个一眼就有意义的点，最后保留进入 `/lab:spec` 前的 approval gate。"
+    "使用已安装的 `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。"
+  ),
+  [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。"
   ),
   [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` 阶段。它必须围绕一个 change id，在 `.superlab/changes/<change-id>/` 下生成 proposal/design/spec/tasks，并让这个 change 成为后续 run 和 iterate 的统一入口。"
+    "使用已安装的 `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 的统一入口。"
   ),
   [path.join(".claude", "commands", "lab", "run.md")]: claudeCommand(
     "LAB: Run",
     "执行最小可行实验并标准化输出",
     "workflow, research, run",
-    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n本命令运行 `/lab:run` 阶段。它必须从最小实验开始，登记 run，生成标准化评估摘要，并验证结果格式。"
+    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:run`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:run` 阶段。它必须从最小实验开始，登记 run，生成标准化评估摘要，并验证结果格式。"
   ),
   [path.join(".claude", "commands", "lab", "iterate.md")]: claudeCommand(
     "LAB: Iterate",
     "在固定成功标准下执行有边界的实验迭代",
     "workflow, research, iterate",
-    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n本命令运行 `/lab:iterate` 阶段。它必须冻结 mission、声明 completion_promise、只做小步改动、每轮生成评估和 iteration report；若风险连续两轮升高则切 diagnostic mode，并在失败结束时记录 blockers 与 next actions。"
+    "使用已安装的 `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。"
   ),
   [path.join(".claude", "commands", "lab", "review.md")]: claudeCommand(
     "LAB: Review",
     "以审稿人模式审查研究方案或结果",
     "workflow, research, review",
-    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n本命令运行 `/lab:review` 阶段。它必须先给简洁摘要，再按 findings -> fatal flaws -> fix priority -> residual risks 的顺序输出，优先检查方法学漏洞、对照公平性、数据泄漏、统计不足和 unsupported claims。"
+    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:review`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:review` 阶段。它必须先给简洁摘要，再按 findings -> fatal flaws -> fix priority -> residual risks 的顺序输出，优先检查方法学漏洞、对照公平性、数据泄漏、统计不足和 unsupported claims。"
   ),
   [path.join(".claude", "commands", "lab", "report.md")]: claudeCommand(
     "LAB: Report",
     "基于验证后的迭代工件生成最终报告",
     "workflow, research, report",
-    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n本命令运行 `/lab:report` 阶段。它必须汇总标准化摘要、保留失败尝试和局限，并生成最终实验报告。"
+    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:report`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:report` 阶段。它必须汇总标准化摘要、保留失败尝试和局限，并生成最终实验报告。"
   ),
   [path.join(".claude", "commands", "lab", "write.md")]: claudeCommand(
     "LAB: Write",
     "把验证过的研究工件转成论文 section，并按小步方式修订",
     "workflow, research, writing",
-    "使用已安装的 `lab` 技能：`.claude/skills/lab/SKILL.md`。\n\n本命令运行 `/lab:write` 阶段。它必须先读取 `.claude/skills/lab/references/paper-writing/` 下与当前 section 对应的参考文件，并结合 `paper-review.md` 与 `does-my-writing-flow-source.md`，先写 mini-outline，再只修改一个 section。"
+    "使用已安装的 `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。"
   ),
 };
 
@@ -122,7 +133,7 @@ description: 严格研究工作流，覆盖 idea、spec、run、iterate、review
 - 如果缺少的前提会改变结论，一次只追问一个问题。
 - 如果存在多条可行路径，先给 2-3 个方案、trade-offs 和推荐项，再收敛。
 - 如果某个 stage 会决定后续方向，就要保留明确的 approval gate。
-- 使用 \`.superlab/config/workflow.json\` 作为全局约束，统一管理 workflow language、paper language 和 paper format。
+- 使用 \`.lab/config/workflow.json\` 作为全局约束，统一管理 workflow language、paper language、paper format 和 deliverables_root。
 - 工作流中间工件默认跟随安装语言。
 - 最终论文默认输出为 LaTeX，论文语言与工作流语言分开决定。
 - 区分“来源事实”和“模型假设”。
@@ -132,6 +143,249 @@ description: 严格研究工作流，覆盖 idea、spec、run、iterate、review
 - \`/lab:idea\` 还需要 problem/failure case、idea classification、contribution category、breakthrough level。
 - \`/lab:idea\` 还需要 existing methods 对照、why ours is different、three meaningful points。
 - \`/lab:iterate\` 需要 completion_promise 与失败退出记录。
+`,
+  [path.join(".codex", "skills", "lab", "stages", "spec.md")]:
+`# \`/lab:spec\` 阶段指南
+
+## 必要输出
+
+- 一个 lab change id
+- \`.lab/changes/<change-id>/proposal.md\`
+- \`.lab/changes/<change-id>/design.md\`
+- \`.lab/changes/<change-id>/spec.md\`
+- \`.lab/changes/<change-id>/tasks.md\`
+
+## 配置读取
+
+- \`.lab/config/workflow.json\`
+
+## 上下文读取
+
+- \`.lab/context/mission.md\`
+- \`.lab/context/decisions.md\`
+- \`.lab/context/state.md\`
+
+## 上下文写回
+
+- \`.lab/context/state.md\`
+- \`.lab/context/decisions.md\`
+
+## 必要 change 结构
+
+1. 识别或创建一个 lab change id。
+2. 创建 \`.lab/changes/<change-id>/\`。
+3. 在该目录下写出 \`proposal.md\`、\`design.md\`、\`spec.md\`、\`tasks.md\`。
+4. 保持该 change 自包含，便于后续 stage 只读一个目录加少量上下文。
+
+## 转换规则
+
+- 把已批准的 idea 转成显式要求。
+- 保留 idea 阶段冻结下来的评估边界。
+- 尽可能把风险翻译成具体任务。
+- 任务粒度要足够小，便于 \`/lab:run\` 和 \`/lab:iterate\` 可预测执行。
+- 一个被批准的 idea 只对应一个 lab-native change 目录，不要分散。
+
+## 交互约束
+
+- 开始前先简洁说明：已批准 idea、目标 change、主要 spec 风险。
+- 如果 change 拆分或验证策略存在关键歧义，一次只问一个问题。
+- 如果 change 结构存在多种可行方案，先给 2-3 个方案、trade-offs 和推荐项，再冻结结构。
+- 在会驱动 \`/lab:run\` 和 \`/lab:iterate\` 的关键结构上保留 approval gate。
+
+## 最小任务覆盖
+
+- change setup
+- artifact creation
+- validation run
+- evaluation normalization
+- bounded iteration
+- final report
+`,
+  [path.join(".codex", "skills", "lab", "stages", "run.md")]:
+`# \`/lab:run\` 阶段指南
+
+## 必要输出
+
+- smoke-scale 或 tiny-split 执行
+- run registry entry
+- 标准化评估摘要
+- 标准化摘要的校验结果
+
+## 上下文读取
+
+- \`.lab/context/mission.md\`
+- \`.lab/context/state.md\`
+
+## 上下文写回
+
+- \`.lab/context/state.md\`
+- \`.lab/context/evidence-index.md\`
+
+## 约束
+
+- 优先选择能打通全链路的最小实验。
+- 数据、环境或 metric 接线有问题时要尽快失败。
+- 记录精确启动命令和输出位置。
+
+## 最小流程
+
+1. 校验环境假设
+2. 登记 run
+3. 执行最小有意义实验
+4. 标准化原始指标
+5. 校验标准化摘要
+
+## 交互约束
+
+- 开始前先简洁说明：run 目标、最小候选实验、主要执行风险。
+- 如果下一轮运行依赖未决前提，一次只问一个问题。
+- 如果存在多种 tiny-run 方案，先给 2-3 个方案、trade-offs 和推荐项，优先最省算力但信息量足够的方案。
+- 只有当某条运行路径会明显增加时间或算力成本时，才请求人工批准。
+`,
+  [path.join(".codex", "skills", "lab", "stages", "iterate.md")]:
+`# \`/lab:iterate\` 阶段指南
+
+## 冻结 mission
+
+以下内容必须声明后保持固定：
+
+- dataset 与 split policy
+- baseline
+- 主指标
+- 成功阈值
+- verification commands
+- completion_promise
+- 最大迭代轮次
+
+## 上下文读取
+
+- \`.lab/context/mission.md\`
+- \`.lab/context/state.md\`
+- \`.lab/context/decisions.md\`
+- \`.lab/context/evidence-index.md\`
+
+## 上下文写回
+
+- \`.lab/context/state.md\`
+- \`.lab/context/decisions.md\`
+- \`.lab/context/evidence-index.md\`
+- \`.lab/context/open-questions.md\`
+
+## 每轮必要输出
+
+- 本轮假设
+- 具体代码或配置改动
+- 标准化评估摘要
+- 书面 iteration report
+- continue 或 stop 决策
+- 风险连续两轮升高时触发 diagnostic mode
+
+## 停止条件
+
+- 达到阈值
+- 达到轮次上限
+- 发现致命方法学问题
+
+## 失败退出契约
+
+如果循环在未达标时结束，必须记录：
+
+- 哪些部分有效
+- 哪些部分失败
+- top 3 blockers
+- next best actions
+
+## 交互约束
+
+- 每轮开始前先简洁说明：当前状态、主导假设、主要风险。
+- 如果下一步依赖未决前提，一次只问一个问题。
+- 如果下一个可测假设不止一个，先给 2-3 个方案、trade-offs 和推荐项，再推进下一个有边界实验。
+- 如果拟议改动会改变冻结的 mission，而不是只改变实现假设，必须经过 approval gate。
+`,
+  [path.join(".codex", "skills", "lab", "stages", "review.md")]:
+`# \`/lab:review\` 阶段指南
+
+## 必要流程
+
+1. 先给简洁摘要，说明审查对象与最关键风险。
+2. 进入 reviewer mode，而不是实现 mode。
+3. 如果存在 fatal flaws，优先列出。
+4. 明确 fix priority。
+5. 最后给 residual risks 和下一步建议。
+
+## 上下文读取
+
+- \`.lab/context/mission.md\`
+- \`.lab/context/decisions.md\`
+- \`.lab/context/evidence-index.md\`
+
+## 上下文写回
+
+- \`.lab/context/state.md\`
+- \`.lab/context/open-questions.md\`
+
+## 审稿优先级
+
+- baseline 是否弱或不公平
+- 是否存在泄漏风险
+- metric 是否错配
+- 是否存在 unsupported causal 或 statistical claims
+- 是否缺关键消融
+- 报告是否不可复现
+
+## 输出风格
+
+- concise summary first
+- findings first
+- fatal flaws 必须显式标出
+- fix priority 必须清楚排序
+- critique 必须绑定证据
+- residual risks 不能省略
+
+## 交互约束
+
+- 开始前先简洁说明：审查目标和主要 reviewer 问题。
+- 只有当审查范围歧义会改变 findings 或严重性时，才一次问一个问题。
+- 如果存在多种合理审查框架，先给 2-3 个方案、trade-offs 和推荐项，但一旦范围明确就保持 reviewer mode，不要弱化批评。
+`,
+  [path.join(".codex", "skills", "lab", "stages", "report.md")]:
+`# \`/lab:report\` 阶段指南
+
+## 必要输出
+
+- 方法概述
+- 实验设置
+- 已验证主结果
+- 消融
+- 失败尝试
+- 局限性
+- 下一步
+
+## 上下文读取
+
+- \`.lab/context/mission.md\`
+- \`.lab/context/state.md\`
+- \`.lab/context/decisions.md\`
+- \`.lab/context/evidence-index.md\`
+
+## 上下文写回
+
+- \`.lab/context/state.md\`
+- \`.lab/context/evidence-index.md\`
+
+## 证据规则
+
+- 不能隐藏失败迭代。
+- 每个主要 claim 都要指向已记录的 summary 或 iteration artifact。
+- 解释优先保守，不要写成营销文案。
+- 要给 \`/lab:write\` 留下清晰 handoff，尤其是 section draft 可以直接引用的证据链接。
+
+## 交互约束
+
+- 开始前先简洁说明：campaign outcome、最强已支撑 claim、最大的报告风险。
+- 如果某个未决前提会改变报告解释，一次只问一个问题。
+- 如果存在多种报告 framing，先给 2-3 个方案、trade-offs 和推荐项，优先最忠于证据的 framing。
+- 如果某种 framing 会实质影响后续论文 claim，要保留 approval gate。
 `,
   [path.join(".codex", "skills", "lab", "stages", "idea.md")]:
 `# \`/lab:idea\` 阶段指南
@@ -188,6 +442,47 @@ description: 严格研究工作流，覆盖 idea、spec、run、iterate、review
 - fix priority 要排序
 - critique 必须绑定证据
 - residual risks 不能省略
+`,
+  [path.join(".codex", "skills", "lab", "references", "workflow.md")]:
+`# /lab 工作流参考
+
+## 冻结 mission
+
+在 \`/lab:iterate\` 中，campaign target 必须跨轮次保持固定。
+
+需要保持固定：
+
+- dataset 与 split
+- 主指标
+- 成功阈值
+- baseline comparison
+- verification commands
+- maximum iteration count
+
+循环内部允许调整：
+
+- 实现细节
+- 模型组件
+- 训练设置
+- 消融
+
+如果当前 campaign 本身无效，应升级到更高层设计调整，而不是悄悄篡改 mission。
+
+## 必要工件
+
+- 一个基于 \`.lab/.managed/templates/idea.md\` 的已批准 idea 工件
+- 一个位于 \`.lab/changes/<change-id>/\` 下的 lab change 目录
+- 来自 \`scripts/eval_report.py\` 的标准化 JSON 摘要
+- 位于 \`.lab/iterations/\` 的逐轮报告
+- 位于 \`deliverables_root\` 下的最终报告
+
+## 审稿优先级
+
+- baseline 是否公平且足够新
+- datasets 和 splits 是否可信
+- 主指标是否符合顶会惯例
+- claims 是否有记录在案的证据支撑
+- failures 和 limitations 是否被保留
 `,
   [path.join(".codex", "skills", "lab", "stages", "write.md")]:
 `# \`/lab:write\` 阶段指南
@@ -227,7 +522,7 @@ description: 严格研究工作流，覆盖 idea、spec、run、iterate、review
 - 若 claim 没有结果支撑，必须削弱或删除。
 - 每轮结束前都要补五维自评并处理未解决问题。
 `,
-  [path.join(".superlab", "templates", "idea.md")]:
+  [path.join(".lab", ".managed", "templates", "idea.md")]:
 `# Idea 工件
 
 ## 一句话问题定义
@@ -332,13 +627,13 @@ description: 严格研究工作流，覆盖 idea、spec、run、iterate、review
 - 用户批准的方向：
 - 进入 \`/lab:spec\` 前还有哪些开放问题：
 `,
-  [path.join(".superlab", "templates", "proposal.md")]:
+  [path.join(".lab", ".managed", "templates", "proposal.md")]:
 `# Proposal
 
 ## Lab Change
 
 - Change id:
-- Target path: \`.superlab/changes/<change-id>/proposal.md\`
+- Target path: \`.lab/changes/<change-id>/proposal.md\`
 
 ## 范围
 
@@ -365,13 +660,13 @@ description: 严格研究工作流，覆盖 idea、spec、run、iterate、review
 - 是否完成 change 目录初始化：
 - 是否检查 proposal/design/spec/tasks 一致性：
 `,
-  [path.join(".superlab", "templates", "design.md")]:
+  [path.join(".lab", ".managed", "templates", "design.md")]:
 `# Design
 
 ## Lab Change
 
 - Change id:
-- Target path: \`.superlab/changes/<change-id>/design.md\`
+- Target path: \`.lab/changes/<change-id>/design.md\`
 
 ## 研究方案
 
@@ -397,16 +692,16 @@ description: 严格研究工作流，覆盖 idea、spec、run、iterate、review
 
 ## Change Links
 
-- Spec path: \`.superlab/changes/<change-id>/spec.md\`
-- Tasks path: \`.superlab/changes/<change-id>/tasks.md\`
+- Spec path: \`.lab/changes/<change-id>/spec.md\`
+- Tasks path: \`.lab/changes/<change-id>/tasks.md\`
 `,
-  [path.join(".superlab", "templates", "spec.md")]:
+  [path.join(".lab", ".managed", "templates", "spec.md")]:
 `# Spec
 
 ## Lab Change
 
 - Change id:
-- Target path: \`.superlab/changes/<change-id>/spec.md\`
+- Target path: \`.lab/changes/<change-id>/spec.md\`
 
 ## 要求
 
@@ -418,24 +713,24 @@ description: 严格研究工作流，覆盖 idea、spec、run、iterate、review
 ## 验收
 
 - Idea 工件已写
-- 已在 \`.superlab/changes/<change-id>/\` 下写出 change 工件
+- 已在 \`.lab/changes/<change-id>/\` 下写出 change 工件
 - Validation run 已执行
 - Iteration reports 已生成
 - Final report 已生成
 `,
-  [path.join(".superlab", "templates", "tasks.md")]:
+  [path.join(".lab", ".managed", "templates", "tasks.md")]:
 `# Tasks
 
 - [ ] 确认批准后的 lab change id。
-- [ ] 创建 \`.superlab/changes/<change-id>/\`。
+- [ ] 创建 \`.lab/changes/<change-id>/\`。
 - [ ] 写 idea 工件。
-- [ ] 把 idea 转成 \`.superlab/changes/<change-id>/proposal.md\`、\`.superlab/changes/<change-id>/design.md\`、\`.superlab/changes/<change-id>/spec.md\`、\`.superlab/changes/<change-id>/tasks.md\`。
+- [ ] 把 idea 转成 \`.lab/changes/<change-id>/proposal.md\`、\`.lab/changes/<change-id>/design.md\`、\`.lab/changes/<change-id>/spec.md\`、\`.lab/changes/<change-id>/tasks.md\`。
 - [ ] 跑第一轮 validation experiment。
 - [ ] 标准化并验证评估摘要。
 - [ ] 执行有边界的 iteration rounds。
 - [ ] 产出 final report。
 `,
-  [path.join(".superlab", "templates", "iteration-report.md")]:
+  [path.join(".lab", ".managed", "templates", "iteration-report.md")]:
 `# Iteration Report
 
 ## 轮次
@@ -476,7 +771,7 @@ description: 严格研究工作流，覆盖 idea、spec、run、iterate、review
 - Top blockers:
 - Next best actions:
 `,
-  [path.join(".superlab", "templates", "review-checklist.md")]:
+  [path.join(".lab", ".managed", "templates", "review-checklist.md")]:
 `# Review Checklist
 
 ## 简洁摘要
@@ -509,7 +804,7 @@ description: 严格研究工作流，覆盖 idea、spec、run、iterate、review
 - 消融是否足够？
 - 方差和显著性问题是否交代清楚？
 `,
-  [path.join(".superlab", "templates", "final-report.md")]:
+  [path.join(".lab", ".managed", "templates", "final-report.md")]:
 `# Final Report
 
 ## 目标
@@ -532,7 +827,7 @@ description: 严格研究工作流，覆盖 idea、spec、run、iterate、review
 - Claim:
 - Missing support:
 `,
-  [path.join(".superlab", "templates", "paper-plan.md")]:
+  [path.join(".lab", ".managed", "templates", "paper-plan.md")]:
 `# 论文计划
 
 ## 目标
@@ -572,7 +867,7 @@ description: 严格研究工作流，覆盖 idea、spec、run、iterate、review
 - Evaluation completeness:
 - Method design soundness:
 `,
-  [path.join(".superlab", "templates", "paper-section.md")]:
+  [path.join(".lab", ".managed", "templates", "paper-section.md")]:
 `# 论文 Section 草稿
 
 ## Section
@@ -617,7 +912,7 @@ description: 严格研究工作流，覆盖 idea、spec、run、iterate、review
 - 五维自评总结：
 - Next revision target:
 `,
-  [path.join(".superlab", "templates", "write-iteration.md")]:
+  [path.join(".lab", ".managed", "templates", "write-iteration.md")]:
 `# 写作迭代
 
 ## 轮次
@@ -652,13 +947,14 @@ description: 严格研究工作流，覆盖 idea、spec、run、iterate、review
 - Next writing target:
 - 是否需要回退到 \`review\` 或 \`iterate\`：
 `,
-  [path.join(".superlab", "config", "workflow.json")]:
+  [path.join(".lab", "config", "workflow.json")]:
 `{
   "workflow_language": "zh",
   "paper_language": "en",
-  "paper_format": "latex"
+  "paper_format": "latex",
+  "deliverables_root": "docs/research"
 }`,
-  [path.join(".superlab", "context", "mission.md")]:
+  [path.join(".lab", "context", "mission.md")]:
 `# 研究主线
 
 ## 核心问题
@@ -687,7 +983,7 @@ description: 严格研究工作流，覆盖 idea、spec、run、iterate、review
 - 当前 owner 或会话：
 - 最近更新该 mission 的 stage：
 `,
-  [path.join(".superlab", "context", "state.md")]:
+  [path.join(".lab", "context", "state.md")]:
 `# 工作流状态
 
 ## 当前阶段
@@ -708,7 +1004,7 @@ description: 严格研究工作流，覆盖 idea、spec、run、iterate、review
 - 当前阻塞：
 - 是否需要人工决策：
 `,
-  [path.join(".superlab", "context", "decisions.md")]:
+  [path.join(".lab", "context", "decisions.md")]:
 `# 决策记录
 
 记录后续阶段不应悄悄推翻的稳定决策。
@@ -721,7 +1017,7 @@ description: 严格研究工作流，覆盖 idea、spec、run、iterate、review
    证据：
    何时允许重开：
 `,
-  [path.join(".superlab", "context", "evidence-index.md")]:
+  [path.join(".lab", "context", "evidence-index.md")]:
 `# 证据索引
 
 把重要 claim 映射到具体工件。
@@ -739,7 +1035,7 @@ description: 严格研究工作流，覆盖 idea、spec、run、iterate、review
    为什么被削弱或删除：
    对应失败工件：
 `,
-  [path.join(".superlab", "context", "open-questions.md")]:
+  [path.join(".lab", "context", "open-questions.md")]:
 `# 未决问题
 
 追踪尚未解决的问题，避免工作流静默脑补。
@@ -759,6 +1055,342 @@ for (const [relativePath, content] of Object.entries(ZH_SKILL_FILES)) {
   ZH_CONTENT[relativePath.replace(".codex", ".claude")] = content;
 }
 
+ZH_CONTENT[path.join(".lab", "system", "core.md")] = `# Lab 系统核心
+
+本项目使用 \`.lab/\` 作为持久研究工作流根目录。
+
+## 默认读取顺序
+
+新 AI 会话按以下顺序读取：
+
+1. \`.lab/context/session-brief.md\`
+2. \`.lab/context/mission.md\`
+3. \`.lab/context/state.md\`
+4. \`.lab/context/evidence-index.md\`
+
+只有当简报明确要求时才继续扩展读取。
+
+## 工作流边界
+
+- \`.lab/context/\` 保存持久研究状态。
+- \`.lab/changes/\`、\`.lab/iterations/\`、\`.lab/writing/\` 保存工作流控制工件。
+- \`.lab/.managed/\` 保存工具托管模板和脚本。
+- 最终交付物应写到 \`deliverables_root\`，不要写进 \`.lab/context/\`。
+
+## 路由规则
+
+只有 research、experiment、report、paper-writing 任务才进入 \`/lab:*\`。
+普通工程任务不要强行走 \`/lab:*\`。
+
+## 状态纪律
+
+- 把 \`.lab/context/*\` 当作持久项目状态。
+- 不要静默覆盖上下文文件。
+- 让来源证据与生成假设保持分离。
+`;
+
+ZH_CONTENT[path.join(".lab", "context", "summary.md")] = `# 研究摘要
+
+## 当前方向
+
+用 5-10 行总结当前批准方向。
+
+## 最强证据
+
+- Claim:
+- Supporting artifact:
+- Caveat:
+
+## 最大风险
+
+- 风险：
+- 为什么重要：
+
+## 当前缺口
+
+- 缺失证据：
+- 缺失工件：
+`;
+
+ZH_CONTENT[path.join(".lab", "context", "next-action.md")] = `# 下一步动作
+
+## 当前动作
+
+- Action:
+- Success signal:
+
+## 如果成功
+
+- Next action:
+
+## 如果失败
+
+- Fallback action:
+
+## 是否需要人工决策
+
+- Question:
+- 为什么会阻塞：
+`;
+
+ZH_CONTENT[path.join(".lab", "context", "session-brief.md")] = `# 会话简报
+
+## 当前阶段
+
+- Stage:
+
+## 主线任务
+
+一句话描述当前研究主线。
+
+## 当前最优路径
+
+- 已批准方向：
+- 为什么它是当前主路径：
+
+## 主要风险
+
+- Risk:
+- Evidence gap:
+
+## 先读这些文件
+
+1. \`.lab/context/mission.md\`
+2. \`.lab/context/state.md\`
+3. \`.lab/context/evidence-index.md\`
+
+## 不要静默修改
+
+- Frozen boundary:
+- Approval gate:
+`;
+
+ZH_CONTENT[path.join(".lab", "context", "terminology-lock.md")] = `# 已批准术语
+
+记录后续 stage 必须复用的 paper-facing 命名和 wording。
+
+## Approved Terms
+
+- 论文题目：
+- 方法名：
+- 简称或 acronym：
+- 模块名：
+- Contribution bullets：
+
+## Allowed Variants
+
+- 可接受短写：
+- 可接受小节别名：
+
+## Forbidden Terms
+
+- 应避免术语：
+- 不该 claim 的内容：
+
+## Source Audit
+
+- 查阅过的近期学术论文：
+- 查阅过的 primary sources：
+- 为什么当前 wording 可以接受：
+`;
+
+ZH_CONTENT[path.join(".codex", "skills", "lab", "SKILL.md")] = `---
+name: lab
+description: 严格研究工作流，覆盖 idea、framing、spec、run、iterate、review、report 和 paper-writing。
+---
+
+# /lab Skill
+
+当用户调用 \`/lab:*\` 或要求结构化研究工作流时使用本技能。
+
+## 全局规则
+
+- 把 idea、framing、spec、execution、review、report、write 分成明确阶段。
+- 论文写作阶段要与实验执行阶段分离。
+- 用户显式调用某个 \`/lab:stage\` 时，要直接执行该 stage，而不是只推荐别的 stage。
+- 关键决策必须落盘，不能只留在聊天里。
+- 每个 stage 都要先给用户一个简洁简介，再决定是否落盘；如果落盘，最后必须回报路径和下一步。
+- 如果缺少的前提会改变结论，一次只追问一个问题。
+- 如果存在多条可行路径，先给 2-3 个方案、trade-offs 和推荐项，再收敛。
+- 如果某个 stage 会决定后续方向，就要保留明确的 approval gate。
+- 使用 \`.lab/config/workflow.json\` 作为全局约束，统一管理 workflow language、paper language、paper format 和 deliverables_root。
+- 工作流中间工件默认跟随安装语言。
+- 最终论文默认输出为 LaTeX，论文语言与工作流语言分开决定。
+- 区分“来源事实”和“模型假设”。
+- 保留失败实验、失败想法和局限性。
+- \`/lab:framing\` 负责方法名、模块名、题目和 contribution wording 的 paper-facing 收束。
+- \`/lab:write\` 使用内置 vendored paper-writing references，不依赖外部写作 skill 路径。
+- \`/lab:write\` 前必须已有经批准的 framing artifact。
+`;
+
+ZH_CONTENT[path.join(".claude", "skills", "lab", "SKILL.md")] =
+  ZH_CONTENT[path.join(".codex", "skills", "lab", "SKILL.md")];
+
+ZH_CONTENT[path.join(".codex", "skills", "lab", "stages", "framing.md")] = `# \`/lab:framing\` 阶段指南
+
+## 必要输出
+
+- 方法名
+- 可选简称或 acronym
+- 模块名
+- 论文题目
+- contribution bullets
+- 不该 claim 的术语与表述
+- 进入 \`/lab:write\` 前的 approval gate
+
+## 配置读取
+
+- \`.lab/config/workflow.json\`
+
+## 上下文读取
+
+- \`.lab/context/mission.md\`
+- \`.lab/context/decisions.md\`
+- \`.lab/context/evidence-index.md\`
+
+## 上下文写回
+
+- \`.lab/context/state.md\`
+- \`.lab/context/decisions.md\`
+
+## 必要工件
+
+- \`.lab/writing/framing.md\`
+
+## 命名审计规则
+
+- 术语要说明是 canonical、adapted 还是 newly coined。
+- 尽量把对象说清楚：到底在 calibrate、rank、estimate 什么。
+- 不要用 acronym-first 命名。
+- 不要写成 AI 包装词、营销词或实现补丁名。
+- contribution bullets 必须和现有证据边界一致。
+
+## 交互约束
+
+- 开始前先简洁说明：当前 framing 问题、最强已支撑 claim、最大命名风险。
+- 如果某个缺失前提会改变命名边界或 wording，一次只问一个问题。
+- 先给 2-3 套 framing packs、trade-offs 和推荐项，再收敛。
+- 在进入 \`/lab:write\` 前保留 approval gate。
+`;
+
+ZH_CONTENT[path.join(".claude", "skills", "lab", "stages", "framing.md")] =
+  ZH_CONTENT[path.join(".codex", "skills", "lab", "stages", "framing.md")];
+
+ZH_CONTENT[path.join(".codex", "skills", "lab", "stages", "write.md")] = `# \`/lab:write\` 阶段指南
+
+## 必要输入
+
+- 稳定的 \`report\` 工件
+- 已批准的 framing artifact：\`.lab/writing/framing.md\`
+- iteration reports
+- normalized summaries
+- reviewer notes（如果有）
+- \`skills/lab/references/paper-writing/\` 下的 vendored 参考
+
+## 配置读取
+
+- \`.lab/config/workflow.json\`
+
+## 上下文读取
+
+- \`.lab/context/mission.md\`
+- \`.lab/context/decisions.md\`
+- \`.lab/context/evidence-index.md\`
+
+## 上下文写回
+
+- \`.lab/context/state.md\`
+- \`.lab/context/evidence-index.md\`
+
+## 小步写作规则
+
+- 每轮只改一个 section 或一个明确子问题。
+- 最终稿必须是 LaTeX。
+- 只加载当前 section guide，不要一次加载全部章节参考。
+- 先写 mini-outline 再写 prose。
+- 如果缺少 framing artifact，不要继续写作，直接回到 \`/lab:framing\`。
+- 如果某个 claim 没有证据支撑，就削弱或删除。
+
+## 必要工件
+
+- \`.lab/writing/framing.md\`
+- \`.lab/writing/plan.md\`
+- \`.lab/writing/iterations/<n>.md\`
+- \`<deliverables_root>/paper/main.tex\`
+- \`<deliverables_root>/paper/sections/<section>.tex\`
+`;
+
+ZH_CONTENT[path.join(".claude", "skills", "lab", "stages", "write.md")] =
+  ZH_CONTENT[path.join(".codex", "skills", "lab", "stages", "write.md")];
+
+ZH_CONTENT[path.join(".lab", ".managed", "templates", "framing.md")] = `# 论文 Framing
+
+## 目标
+
+- 范围：
+- 当前 paper-facing 问题：
+- 证据边界：
+
+## Canonical Terminology Audit
+
+- 应复用的标准术语：
+- 可接受的改写术语：
+- 需要谨慎的新造术语：
+- 必须说清楚的对象：
+- 应避免的术语：
+
+## Candidate Framing Packs
+
+### 方案 1
+
+- 论文题目：
+- 方法名：
+- 简称或 acronym：
+- 模块名：
+- Contribution bullets：
+- 优点：
+- 风险：
+
+### 方案 2
+
+- 论文题目：
+- 方法名：
+- 简称或 acronym：
+- 模块名：
+- Contribution bullets：
+- 优点：
+- 风险：
+
+### 方案 3
+
+- 论文题目：
+- 方法名：
+- 简称或 acronym：
+- 模块名：
+- Contribution bullets：
+- 优点：
+- 风险：
+
+## 推荐方案
+
+- 论文题目：
+- 方法名：
+- 简称或 acronym：
+- 模块名：
+- Contribution bullets：
+
+## Forbidden Claims And Terms
+
+- 不该 claim 的内容：
+- 不该使用的术语：
+- 原因：
+
+## Approval Gate
+
+- 已批准 framing：
+- 进入 \`/lab:write\` 前剩余问题：
+`;
+
 function getLocalizedContent(relativePath, lang) {
   if (lang !== "zh") {
     return null;