create-yss-spec 3.5.2 → 3.5.4

package/template/.pi/skills/yss-product-lifecycle/references/orchestration.md

@@ -131,7 +131,7 @@ tracker 选择和冲突按 `.template-spec/agents/issue-tracker.md` 裁决：已
 
 Decision ticket 产生决策，不是实现切片，不得标记 `ready-for-agent`。
 
-## `grill-with-docs` 退出判定
+## `work-unit.plan-requirements` 退出判定
 
 进入 `to-spec` 前必须区分已确认项与未决项，并确认用户、问题、MVP、非目标、成功标准、术语/ADR 候选和测试 seam。事实问题走 `yss-research`；需 runnable 反馈的问题走 `handoff → prototype → handoff`。存在未回流 blocker 时不得进入 Spec baseline。
 
@@ -139,7 +139,7 @@ Prototype 回流必须有可核验证据：来源 handoff、prototype 资产或
 
 Matt `prototype` 的回流还必须注明 `prototype_branch`，并保留单文件 HTML 主来源；该结果只能作为 YSS 原型输入，仍须完成阶段 4 的低保真评审、H1/H2 档位路由、schema v4 验证和用户确认，不得用 throwaway prototype 替代。
 
-`to-questionnaire` 未收到答案时使用 `external-input-required` 暂停，记录问卷、接收人、所需输出和恢复路由；收到答案后记录 response、重新分类影响面和更新后的权威资产，再回到 `grill-with-docs` 或 `to-spec`。
+生命周期外部输入问卷 未收到答案时使用 `external-input-required` 暂停，记录问卷、接收人、所需输出和恢复路由；收到答案后记录 response、重新分类影响面和更新后的权威资产，再回到 `work-unit.plan-requirements` 或 `to-spec`。
 
 Release 与 Retrospective 属于生命周期编排器拥有的工作单元。发布和复盘前都必须重新取得 fresh verification；发布还需要发布/回滚证据和独立审查，复盘还需要复盘记录和治理回流判断，再回流权威资产。
 

package/template/.pi/skills/yss-product-lifecycle/references/plan-requirements.md

@@ -0,0 +1,12 @@
+# 需求澄清与 Context 对账
+
+`work-unit.plan-requirements` 由 `yss-product-lifecycle` 或当前 profile 编排器执行，按需使用 `grilling` 和 `domain-modeling`，不另建批准入口。
+
+1. 读取 yss-project.yaml 与唯一根 CONTEXT.md，执行 `scripts/verify-context-contract --root . --json`。缺失、大小写错误、嵌套合同、跨仓路径、伪锚点或不支持的 schema 都阻断；格式消费 `domain-modeling/CONTEXT-FORMAT.md`。
+2. 先查可发现事实；真正用户决定才组成当前决策前沿，每个问题给出建议，保留原始回复。未确认的术语留在 Plan，不能写成稳定事实。
+3. 确认后由 domain-modeling 维护五列业务词汇表，以 `<ContextId>/<EnglishIdentifier>` 标识；非 Global 的 ContextId 来自已确认业务责任区。只有难以逆转、非显然且有真实取舍的决定才形成 ADR。研究和实际验证保留可读证据。
+4. `project-instance` 批准或返回下一工作单元前生成 `context_reconciliation`，保存可读 ref、document_digest、referenced_terms_digest 与 term_refs，并执行对账验证。候选、别名、范围冲突或摘要漂移均阻断；对账不另增门禁。`template-source` 仅校验模板合同并记录有原因的 `not-applicable`，不虚构业务术语。
+5. 结束时列出已确认决定、未决假设、变更文档、对账状态与引用、下一授权动作。按既有退出判定确认用户、问题、MVP、非目标、成功标准及测试 seam，未回流 blocker 不得进入 Spec。
+6. 共享理解与变更范围未确认前不改实现合同或代码；澄清结果不能批准资产、设置 ready-for-agent 或自行推进阶段，交回当前编排器验收。
+
+起草 Plan 使用 `.template-spec/plan/templates/plan-template.md`，Spec 使用 `.template-spec/templates/spec-template.md`；显式 `to-spec` 使用同一模板。可选只读诊断及未评估项见 `.template-spec/process/plan-spec-quality.md`，不增加阶段门禁。

package/template/.pi/skills/yss-product-lifecycle/references/state-model.md

@@ -33,7 +33,7 @@ phase_boundary:
 
 `handoff` 必须有来源和目的地；subagent 必须有任务包和汇合证据；`compact` 必须有下一阶段。`Continue`、`clear` 不要求跨上下文引用，但仍应记录判断理由。
 
-`to-questionnaire` 的暂停使用 `pause.reason_code: external-input-required`，并保存 `questionnaire_ref`、`recipient_role`、`requested_outputs` 和 `resume_route`。答案回流后补 `response_ref`、`reclassified_impact` 和 `updated_authoritative_asset`，然后重新计算 `stale`、门禁和可执行 frontier。
+生命周期外部输入问卷 的暂停使用 `pause.reason_code: external-input-required`，并保存 `questionnaire_ref`、`recipient_role`、`requested_outputs` 和 `resume_route`。答案回流后补 `response_ref`、`reclassified_impact` 和 `updated_authoritative_asset`，然后重新计算 `stale`、门禁和可执行 frontier。
 
 ## `ready-for-agent` 公式
 
@@ -77,7 +77,7 @@ Git 动作分别保存 `commit_authorized`、`commit_scope`、`commit_authorizat
 
 ## 状态块
 
-状态块位于主 tracker 的功能父 Ticket，并使用 `.template-spec/process/templates/lifecycle-checkpoint-template.yaml` 的结构化形状和 `lifecycle-checkpoint.schema.json` 校验；Local Markdown 使用 `docs/.scratch/<feature>/parent-ticket.md`，可将完整 checkpoint 保存在 `docs/.scratch/<feature>/gates/lifecycle-checkpoint.yaml` 后由父 Ticket 引用，远程 tracker 使用 Issue 并在本地功能包保留引用。平台不可用时才位于 stage checkpoint。只保存索引、状态、引用和因果关系：
+父 Ticket 是主 tracker 的追踪入口。新功能将机器状态持久化在实际 checkpoint 文件，由父 Ticket 明确引用；使用 `.template-spec/process/templates/lifecycle-checkpoint-template.yaml` 的结构及原 schema 校验。阶段、阻塞和下一工作单元通过 `scripts/lifecycle-status --root <项目> --checkpoint <ref>` 查询，阶段工作进度通过 `scripts/stage-tracking check` 查询。父 Ticket 保留 Ticket 五态、业务说明、资产和会签入口，不另填机器状态表；批准记录仍是批准依据。远程 tracker 同样引用本地 checkpoint，不自动生成阅读包。以下字段示意位于 checkpoint，不再复制到父 Ticket：
 
 ```yaml
 lifecycle:
@@ -111,7 +111,7 @@ pause:
 
 - 当前只支持 `schema_version: 1`，支持版本列表以 `orchestration-contract.yaml` 为准。
 - 版本缺失、解析失败或版本不在支持列表时，必须暂停并进入迁移检查；不得按 v1 猜测、覆盖或降级写回。
-- 主 tracker 的父 Ticket 状态块优先作为主索引；Local Markdown 的 `docs/.scratch/<feature>/parent-ticket.md` 是主载体，远程 Issue 只是显式选择远程 tracker 时的主载体。根 `.scratch/` 与 `docs/requirements/tickets/` 只作为旧路径迁移来源。stage checkpoint 只在选定平台不可用时降级。两者版本或内容冲突时，不做字段级静默合并：读取真实资产重建新状态，保留旧块引用和迁移记录，再由人工确认主载体。
+- 旧父 Ticket 内嵌状态块继续只读兼容；不按标题批量迁移。改造前保存原文并展示精确差异，明确既有 checkpoint 路径。双方字段冲突时列出两侧原值，保留原始证据，不自动裁定、不回写 checkpoint、不改变 Ticket 五态或批准状态。由已授权的单项迁移将父 Ticket 改为引用入口；业务状态纠偏单独处理。根 `.scratch/` 与 `docs/requirements/tickets/` 仍只作旧路径迁移来源。
 - 不得用旧版本状态覆盖较新版本。迁移记录至少包含来源版本、目标版本、来源载体、冲突、真实资产证据、迁移人和时间。
 
 ## Resume

package/template/.pi/skills/yss-prototype-stage/SKILL.md

@@ -26,17 +26,17 @@ description: Use when a YSS feature has product-design impact on a primary flow,
 
 ## 执行顺序
 
-1. 形成交互说明、低保真与状态矩阵；状态至少包含事件、转换、guard、动作与可退出路径。
+1. 形成简短设计输入（用户任务、保持项、可调整项、状态与适用 Token），再整理内容优先级、长度变化、数据来源和动作结果。形成交互说明、低保真与状态矩阵；状态至少包含事件、转换、guard、动作与可退出路径。信息架构或交互不确定时，先按 [方案比较方法](references/concept-comparison.md) 比较三个候选并取得用户选择，再进入低保真评审。
 2. 完成独立 `prototype-review`，提取仍需由原型回答的风险。
-3. 计算并记录 `prototype_profile`。新视觉方向或信息架构不确定时比较三个候选方案并由用户选择；可用低保真或 HTML 比较，图片 ideation 按需使用。已有规范和页面模式足够时记录 `not-applicable`、规范依据与理由。
-4. H1 使用 `prototype-contract.mjs prepare-static`；H2 默认使用 `prepare-flow`，条件真实组件路线使用 `build-antd-prototype.mjs`。二者都交付 `index.html` 与本地 CSS/JS/资源。按 `references/product-design-adapter.md` 完成场景、离线复验和 `seal-project`，不把 starter 示例当作业务验收。
+3. 计算并记录 `prototype_profile`。仅视觉方向仍未确定时比较三个高保真候选并由用户选择，保持已评审行为；已解决的问题不重复探索。已有规范和页面模式足够时记录 `not-applicable`、规范依据与理由。发现行为变化，返回受影响的低保真评审。
+4. 高保真 H1/H2 优先使用 `build-shadcn-vue-prototype.mjs --profile H1|H2`（Vue 3 + shadcn-vue）；React 作者路线已退役，旧包仅显式 legacy 只读校验；轻量原生路线分别使用 `prototype-contract.mjs prepare-static` / `prepare-flow`。二者都交付 `index.html` 与本地 CSS/JS/资源。按 `references/product-design-adapter.md` 完成场景、离线复验和 `seal-project`，不把 starter 示例当作业务验收。
 5. 自动采集版本、digest、视口、截图、console 与扫描结果。截图按 `route + page + state + viewport + theme + locale + data_scenario` 写入 `Visual Baseline Bundle`，执行 `visual-baseline-contract.mjs seal` 后由 feature 级 schema v4 `prototype-evidence.yaml` 引用；人工只补决策、风险、允许差异和用户确认。
-6. 以统一六轴 Design QA 和档位验证矩阵完成浏览器/无障碍验证。用户确认后才可校准 Spec、分析 API 影响或进入 实现合同编译器 readiness。
+6. 完整构建后集中检查桌面/窄屏，统一修整并复验受影响场景；对明确的保持项与原页面做同视口、同状态的前后核对，不能仅凭操作仍可用判定布局已保持，窄屏适配也不得扩大本次变更范围；迭代预算耗尽仍有关键缺陷时保留阻塞，不以轮次数代替通过。以统一六轴 Design QA 和档位验证矩阵完成浏览器/无障碍验证。用户确认后才可校准 Spec、分析 API 影响或进入 实现合同编译器 readiness。
 
 ## 档位边界
 
-- H1 `visual-review`：浏览器可复验的 HTML/CSS/少量 JS 或设计工具导出；不得要求 `package.json`、lockfile、Node 或 AntD CLI。
-- H2 `flow-review`：默认使用 `html-css-js`，主流程与关键异常状态可操作；场景可重复触发并重置。制作阶段允许必要工具，接收者无需安装 Node 或组件库，也不依赖网络。复杂控件只模拟当前决策需要的行为；简化会改变关键结论时，按 AntD 集成说明选择预构建真实控件；仍无法支撑的部分列为 gap 并回到设计澄清。
+- H1 `visual-review`：浏览器可复验的 HTML/CSS/少量 JS 或设计工具导出；不得要求接收者安装 `package.json`、lockfile、Node 或组件 CLI。
+- H2 `flow-review`：新高保真优先使用 `vue-shadcn-prebuilt`（`react-shadcn-prebuilt` 仅历史只读），轻量路线使用 `html-css-js`，主流程与关键异常状态可操作；场景可重复触发并重置。制作阶段允许必要工具，接收者无需安装 Node 或组件库，也不依赖网络。复杂控件只模拟当前决策需要的行为；简化会改变关键结论时，按 shadcn 集成说明补齐组件行为；仍无法支撑的部分列为 gap 并回到设计澄清。
 - 原型代码默认 throwaway；可复用的是项目 Token、组件语义映射、状态、测试场景和验收标准。任何源码进入生产仍需 实现合同编译器、Slice Contract 和 TDD。
 - 原型阶段不得调用 `yss-ui`，不得读取生产组件 API 来制造“真实组件原型”。需要核验真实 YSS/AntDV 组件的事项写入 `implementation_handoff`，由前端实现计划、已批准切片的实现和实现还原验证负责。
 
@@ -52,6 +52,17 @@ Design QA 合并 visual、layout、interaction、content、accessibility、cross
 
 ## 按需读取
 
+- 搜索选择或纯日期区间任务：读 [搜索与日期配方](references/search-date-patterns.md)；验证时读 [统一入口](references/prototype-verification.md)。
+- 新流程、陌生角色或复杂恢复仍有可用性疑问：读 [条件式用户研究](references/usability-research.md)，把待验证问题转为可观察任务。
+
+- 新企业高保真默认使用 [应用壳与多页工作区](references/enterprise-workspace.md)：登记真实导航页面，切换保留草稿，关闭按 dirty 状态确认，场景重置全量清空；既有批准页面仍遵守保持项。
+
+- 选择或接入高保真组件时，按 [任务→页面组合→组件配方](references/component-recipes.md) 读取适用条件、依赖、状态、键盘、焦点和窄屏规则；只用已登记组件，不自动覆盖 preset。
+
+- 新高保真页面默认选择根规范的紧凑变体；既有页面保持当前密度，详见 `yss-design-system/references/prototype-default-theme.md` 与 [Vue 组件集成](references/shadcn-vue-integration.md)。
+- 完整任务模式与低保真演练：按需读取 [业务模式](references/business-patterns.md)、[低保真演练](references/low-fidelity-exercise.md)；不替换已确认页面的保持项。
+- 内容规划、信息架构/交互或视觉候选比较：[concept-comparison.md](references/concept-comparison.md)；需要离线切换候选时读 [comparison-tool.md](references/comparison-tool.md)。
+
 - 档位、上游融合与迁移：[prototype-profile-routing.md](references/prototype-profile-routing.md)
 - 离线渲染适配与命令：[product-design-adapter.md](references/product-design-adapter.md)
 - 证据模板：`.template-spec/design/templates/prototype-evidence-template.yaml`
@@ -70,6 +81,14 @@ Design QA 合并 visual、layout、interaction、content、accessibility、cross
 
 确认 UI、交互、状态和权限体验均无改动的跨仓既有工程，读取 [既有 UI 分支](references/existing-ui-entry.md)，使用 existing-ui-baseline v1 和当前真实用户确认。任何 UI 改动回到上面的原型流程；输入核验不授予实现权限。
 
-## AntD 组件补充
+## 高保真组件路线
+
+新页面优先 [shadcn-vue + Vue 3](references/shadcn-vue-integration.md)，真实 Select、菜单、Sheet 等承担产品交互；不能只给原生控件套主题就称组件化。按任务借鉴 Blocks 的组合，保持项目 Token 与已评审行为。React 作者依赖与生成入口已移除；[历史包](references/shadcn-integration.md)只读保留，原生 HTML 用于轻量修改或明确例外；不混用两套组件 API。生产 Vue/YSS 合同不变。
+
+## 业务草案校准
+
+按 `.template-spec/process/business-tickets.md` 执行 Spec 业务草案、Design 校准与业务正式化。业务票放在 `business-tickets/`，集合引用进入 Spec / map / checkpoint；业务票不授予实现资格。实现票仍在 `issues/`，受工程准备、当前 Slice 合同批准和完整就绪检查约束。 Design 按页面、状态及失败恢复路径校准现有业务 Ticket，保持稳定 ID。等义细化核验既有授权延续；范围、规则或验收变化返回战略决定。原型完成后回交业务正式化，不直接请求实现仓库。
+
+## 浏览器与草稿生命周期
 
-消费 [组件集成说明](references/antd-integration.md) 与 [组件索引](references/antd-component-catalog.json)：默认原生 HTML，复杂交互确实影响评审结论时记录理由并选 `react-antd-prebuilt`。`--pattern workbench` 提供查询列表、详情、编辑和失败恢复 starter；真实 AntD 在独立作者目录按固定 lock 预构建，交付包仍离线运行、接收者无需 Node。两条路线统一根 DESIGN.md、六轴 QA、场景重置及当前用户确认，不恢复 Provider 技能、不证明生产 YSS 组件兼容。
+本地自动化浏览器使用 [临时会话模块](scripts/browser-session.mjs)，用法及中断边界见 [资源生命周期](references/resource-lifecycle.md)。配置目录放系统临时目录，正式截图和详细报告仍写原证据路径；摘要默认标准输出，仅在明确指定路径时保存。未正式化草稿使用临时工作区；已被批准、验证或交接引用的文件按正式资产保留。

package/template/.pi/skills/yss-prototype-stage/assets/comparison/comparison.css

@@ -0,0 +1,12 @@
+:root { font: var(--brand-font-size)/var(--brand-line-height) var(--brand-font-family); color: var(--brand-color-text); background: var(--brand-color-bg-layout); }
+* { box-sizing: border-box; } body { margin: 0; }
+header { padding: var(--brand-size-sm) var(--brand-size); background: var(--brand-color-bg-container); border-bottom: 1px solid var(--brand-color-border); }
+h1 { font-size: var(--brand-font-size-lg); margin: 0; } p { margin: var(--brand-size-xs) 0; overflow-wrap: anywhere; }
+nav { display: flex; align-items: center; flex-wrap: wrap; gap: var(--brand-size-sm); }
+label { display: flex; align-items: center; gap: var(--brand-size-xs); min-width: 0; }
+button, select { font: inherit; color: inherit; background: var(--brand-color-bg-container); min-height: var(--yss-control-height); border: 1px solid var(--brand-color-border); border-radius: var(--brand-border-radius); max-width: 100%; }
+button { cursor: pointer; } a { color: var(--yss-color-primary-control); }
+:focus-visible { outline: 2px solid var(--yss-color-primary-control); outline-offset: 2px; }
+#preview { width: 100%; } iframe { display: block; width: 100%; height: 100vh; border: 0; background: var(--brand-color-bg-container); }
+#error { color: var(--brand-color-text); border-left: var(--brand-size-xxs) solid var(--brand-color-error); padding: var(--brand-size-xs); }
+[hidden] { display: none !important; }

package/template/.pi/skills/yss-prototype-stage/assets/comparison/comparison.js

@@ -0,0 +1,52 @@
+(() => {
+  const data = window.prototypeComparison;
+  const $ = id => document.getElementById(id);
+  let timer, frame, requestId, expected;
+  document.title = $('title').textContent = data.title;
+  for (const variant of data.variants) $('variant').add(new Option(variant.label, variant.id));
+  for (const item of data.cases) $('case').add(new Option(item.label, item.id));
+  function fail(message) {
+    clearTimeout(timer); $('error').textContent = message; $('error').hidden = false;
+    $('status').textContent = ''; $('preview').replaceChildren(); frame = null;
+    $('direct').removeAttribute('href');
+  }
+  function render() {
+    clearTimeout(timer); $('error').hidden = true;
+    const hash = new URLSearchParams(location.hash.slice(1));
+    const variantId = hash.has('variant') ? hash.get('variant') : data.variants[0].id;
+    const caseId = hash.has('case') ? hash.get('case') : data.cases[0].id;
+    const variant = data.variants.find(v => v.id === variantId);
+    const scenario = data.cases.find(c => c.id === caseId);
+    if (hash.getAll('variant').length>1 || hash.getAll('case').length>1 || !variant || !scenario || [...hash.keys()].some(k => !['variant', 'case'].includes(k))) { fail('比较链接无效：候选或场景不存在。请选择有效候选和场景。'); return; }
+    $('variant').value = variant.id; $('case').value = scenario.id;
+    const fragment = new URLSearchParams({ variant: variant.id, case: scenario.id }).toString();
+    $('link').href = '#' + fragment;
+    const url = variant.entry + '#scenario=' + encodeURIComponent(scenario.scenario);
+    $('direct').href = url;
+    // Replacing the frame discards all previous in-memory form and workflow state.
+    frame = document.createElement('iframe');
+    frame.title = `${variant.label} · ${scenario.label}`;
+    // Ordinary local frames preserve file:// CSS/JS loading. This review UI is not a code sandbox.
+    requestId=crypto.randomUUID(); expected=scenario;
+    frame.onload=()=>frame?.contentWindow.postMessage({type:"yss-scenario-request",requestId},"*");
+    frame.src = url;
+    frame.onerror = () => fail('候选入口加载失败，请运行比较包 validate。');
+    $('preview').replaceChildren(frame);
+    $('status').textContent = '正在加载共同场景…';
+    timer = setTimeout(() => fail('候选未能加载，请检查入口或资源，并运行比较包 validate。'), 8000);
+  }
+  window.addEventListener('message', event => {
+    if (!frame || event.source !== frame.contentWindow || event.data?.type !== 'yss-scenario-result' || event.data.requestId !== requestId) return;
+    const result=event.data;
+    if(result.status==='error'){fail(`候选初始化失败：${result.error}`);return;}
+    if(result.status==='pending')return;
+    if(result.status!=='ready'||result.scenarioId!==expected.scenario||result.dataDigest!==expected.dataDigest){fail('候选初始化场景或数据不一致。');return;}
+    clearTimeout(timer); $('status').textContent = '场景已初始化；实际业务行为仍须评审。';
+  });
+  function select() {
+    const next = new URLSearchParams({ variant: $('variant').value, case: $('case').value }).toString();
+    if (location.hash.slice(1) === next) render(); else location.hash = next;
+  }
+  $('variant').addEventListener('change', select); $('case').addEventListener('change', select);
+  $('reset').addEventListener('click', render); window.addEventListener('hashchange', render); render();
+})();

package/template/.pi/skills/yss-prototype-stage/assets/comparison/index.html

@@ -0,0 +1,6 @@
+<!doctype html>
+<html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>方案比较</title><link rel="stylesheet" href="sources/tokens.css"><link rel="stylesheet" href="comparison.css"></head>
+<body><header><h1 id="title">方案比较</h1><p>评审辅助 · 选择仅切换候选，不表示批准</p>
+<nav aria-label="方案比较"><label>候选 <select id="variant"></select></label><label>场景 <select id="case"></select></label><button id="reset" type="button">重置当前场景</button><a id="direct" target="_blank" rel="noopener">原尺寸单独打开</a><a id="link">当前比较链接</a></nav>
+<p id="status" role="status"></p><p id="error" role="alert" hidden></p></header><main id="preview" aria-label="候选原尺寸预览"></main>
+<script src="comparison-data.js"></script><script src="comparison.js"></script></body></html>

package/template/.pi/skills/yss-prototype-stage/assets/comparison/review-ready.js

@@ -0,0 +1,2 @@
+// Readiness is not proof of correct scenario behavior. The browser test checks that separately.
+window.addEventListener('load', () => window.parent.postMessage({ type: 'yss-comparison-ready' }, '*'));

package/template/.pi/skills/yss-prototype-stage/assets/low-fidelity-exercise/app.js

@@ -0,0 +1,17 @@
+(() => {
+ const $=id=>document.getElementById(id),mode=document.body.dataset.mode;
+ let scene,rows,selected=new Set(),failed=false;
+ $('title').textContent=({single:'逐项处理',batch:'批量处理',queue:'引导队列'})[mode];
+ function button(label,action){const b=document.createElement('button');b.textContent=label;b.onclick=action;return b;}
+ function act(ids){if(!ids.length)return;if(scene.id==='failure'&&!failed){failed=true;$('status').textContent='处理失败，选择与资料已保留，请重试。';return;}rows=rows.filter(r=>!ids.includes(r.id));for(const id of ids)selected.delete(id);$('status').textContent=`已处理 ${ids.length} 项（本地模拟）。`;render();}
+ function render(){const box=$('content');box.replaceChildren();if(!rows.length){const p=document.createElement('p');p.textContent='全部资料已处理。';box.append(p);return;}
+  if(mode==='batch'){box.append(button('选择全部',()=>{selected=new Set(rows.map(r=>r.id));render();}),button('通过所选',()=>act([...selected])));}
+  for(const row of (mode==='queue'?rows.slice(0,1):rows)){const article=document.createElement('article'),h=document.createElement('h2'),p=document.createElement('p');h.textContent=`${row.id} · ${row.name}`;p.textContent=`负责人：${row.owner}；状态：${row.status}`;article.append(h,p);
+   if(mode==='batch'){const label=document.createElement('label'),input=document.createElement('input');input.type='checkbox';input.checked=selected.has(row.id);input.onchange=()=>{if(input.checked)selected.add(row.id);else selected.delete(row.id);};label.append(input,`选择 ${row.id}`);article.append(label);}else article.append(button(mode==='queue'?'通过并继续':`通过 ${row.id}`,()=>act([row.id])));
+   box.append(article);
+  }
+  if(mode==='queue'){const p=document.createElement('p');p.textContent=`剩余 ${rows.length} 项，按编号依次核对。`;box.append(p);}
+ }
+ function reset(){try{scene=window.prototypeRuntime.initialize();rows=scene.data.rows;selected=new Set();failed=false;$('status').textContent='待核对资料。';render();window.prototypeRuntime.ready(scene.ticket);}catch(e){window.prototypeRuntime.showError(e);}}
+ $('reset').onclick=reset;addEventListener('hashchange',reset);reset();
+})();

package/template/.pi/skills/yss-prototype-stage/assets/low-fidelity-exercise/index.html

@@ -0,0 +1 @@
+<!doctype html><html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>低保真审批演练</title><link rel="stylesheet" href="tokens.css"><link rel="stylesheet" href="styles.css"><script src="scenarios.js"></script><script src="scenario-runtime.js"></script><script defer src="app.js"></script></head><body data-mode="__MODE__"><main><h1 id="title"></h1><p>教学 fixture：核对并处理同一组资料；业务允许单项、批量及队列处理。</p><p id="status" role="status"></p><section id="content"></section><button id="reset">重置场景</button></main></body></html>

package/template/.pi/skills/yss-prototype-stage/assets/low-fidelity-exercise/styles.css

@@ -0,0 +1 @@
+:root{font-family:var(--brand-font-family);color:var(--brand-color-text);background:var(--brand-color-bg-layout)}main{max-width:960px;margin:auto;padding:var(--brand-size-lg)}article{background:var(--brand-color-bg-container);border:1px solid var(--brand-color-border);padding:var(--brand-size);margin-block:var(--brand-size)}button{min-height:var(--yss-control-height);border:1px solid var(--brand-color-border);border-radius:var(--brand-border-radius);background:var(--brand-color-bg-container);color:var(--brand-color-text);padding-inline:var(--brand-size);margin:var(--brand-size-xs)}button:focus-visible,input:focus-visible{outline:2px solid var(--yss-color-primary-control);outline-offset:2px}label{display:block;margin-block:var(--brand-size-sm)}@media(max-width:576px){main{padding:var(--brand-size-sm)}}

package/template/.pi/skills/yss-prototype-stage/assets/native-workbench/app.js

@@ -1,20 +1,26 @@
 (() => {
  const $ = id => document.getElementById(id);
- const seed = [{id:'M-001',name:'季度经营分析资料',owner:'张明',status:'已更新'},{id:'M-002',name:'跨部门业务协作与异常处理说明（长名称示例）',owner:'李华',status:'待核对'},{id:'M-003',name:'归档清单',owner:'王宁',status:'已更新'}];
- let rows, scenario, current, retried=false, trigger;
+
+ let rows, serverRows, scenario, current, retried=false, trigger;
  function render(){
   const visible=(scenario==='empty'||scenario==='loading')?[]:rows.filter(r=>(r.id+r.name).includes($('keyword').value.trim()));
   $('count').textContent=`共 ${visible.length} 条`;
   $('list-status').textContent=scenario==='loading'?'正在加载（固定评审状态）':visible.length?'':'暂无符合条件的资料';
   $('rows').replaceChildren();
-  for(const row of visible){const tr=document.createElement('tr');for(const key of ['id','name','owner','status']){const td=document.createElement('td');td.textContent=row[key];tr.append(td);}const td=document.createElement('td');for(const type of ['查看','编辑']){const b=document.createElement('button');b.textContent=type;b.disabled=type==='编辑'&&scenario==='no-permission';b.setAttribute('aria-label',`${type} ${row.id}`);b.onclick=()=>open(row,type,b);td.append(b);}tr.append(td);$('rows').append(tr);}
+  for(const row of visible){const tr=document.createElement('tr');for(const key of ['id','name','owner','status']){const td=document.createElement('td');td.textContent=row[key];td.dataset.label=({id:'编号',name:'资料名称',owner:'负责人',status:'状态'})[key];tr.append(td);}const td=document.createElement('td');for(const type of ['查看','编辑']){const b=document.createElement('button');b.textContent=type;b.disabled=type==='编辑'&&scenario==='no-permission';b.setAttribute('aria-label',`${type} ${row.id}`);b.onclick=()=>open(row,type,b);td.append(b);}tr.append(td);$('rows').append(tr);}
  }
  function close(id){$(id).close();const next=document.querySelector(`[aria-label="${trigger}"]`);if(next&&!next.disabled)next.focus();}
- function open(row,type,b){current=row;trigger=b.getAttribute('aria-label');retried=false;$('retry').hidden=true;$('reload').hidden=true;$('edit-status').textContent='';if(type==='查看'){ $('detail-content').replaceChildren();for(const [key,label] of [['id','编号'],['name','名称'],['owner','负责人'],['status','状态']]){const dt=document.createElement('dt'),dd=document.createElement('dd');dt.textContent=label;dd.textContent=row[key];$('detail-content').append(dt,dd);}$('detail').showModal();$('detail-close').focus();}else{$('name').value=row.name;$('owner').value=row.owner;$('edit').showModal();$('name').focus();}}
- function reset(){for(const id of ['detail','edit'])if($(id).open)$(id).close();scenario=new URLSearchParams(location.hash.slice(1)).get('scenario')||'primary';if(![...$('scenario').options].some(x=>x.value===scenario))scenario='primary';$('scenario').value=scenario;rows=seed.map(x=>({...x}));$('keyword').value='';$('feedback').textContent=scenario==='no-permission'?'当前资料仅可查看。':'';document.body.dataset.state=scenario;render();}
+ function open(row,type,b){current=row;trigger=b.getAttribute('aria-label');retried=false;$('retry').hidden=true;$('reload').hidden=true;$('edit-status').textContent='';if(type==='查看'){ $('detail-content').replaceChildren();for(const [key,label] of [['id','编号'],['name','名称'],['owner','负责人'],['status','状态'],['version','版本']]){const dt=document.createElement('dt'),dd=document.createElement('dd');dt.textContent=label;dd.textContent=row[key];$('detail-content').append(dt,dd);}$('detail').showModal();$('detail-close').focus();}else{$('name').value=row.name;$('owner').value=row.owner;$('version').textContent=row.version;$('edit').showModal();$('name').focus();}}
+ function reset(){
+  for(const el of document.querySelectorAll('dialog[open]'))el.close();
+  let initial;try{initial=window.prototypeRuntime.initialize();}catch(e){window.prototypeRuntime.showError(e);return;}
+  scenario=initial.id;rows=initial.data.rows;serverRows=initial.data.server_rows;current=null;retried=false;
+  $('scenario').value=scenario;$('keyword').value='';$('feedback').textContent=scenario==='no-permission'?'当前资料仅可查看。':'';document.body.dataset.state=scenario;render();window.prototypeRuntime.ready(initial.ticket);
+ }
+
  $('query').onsubmit=e=>{e.preventDefault();render();};$('clear').onclick=()=>{$('keyword').value='';render();};
  $('editor').onsubmit=e=>{e.preventDefault();if(scenario==='no-permission')return;if(scenario==='failure'&&!retried){$('edit-status').textContent='保存失败，输入已保留，请重试。';$('retry').hidden=false;return;}if(scenario==='conflict'&&!retried){$('edit-status').textContent='资料已被更新。输入已保留，重新加载前可复制内容。';$('reload').hidden=false;return;}current.name=$('name').value;current.owner=$('owner').value;current.status='已更新';render();close('edit');$('feedback').textContent='保存成功（本地模拟）。';document.body.dataset.state='success';};
- $('retry').onclick=()=>{retried=true;$('editor').requestSubmit();};$('reload').onclick=()=>{retried=true;$('name').value=current.name;$('owner').value='最新负责人';$('reload').hidden=true;$('edit-status').textContent='已重新加载，可继续编辑。';$('name').focus();};
+ $('retry').onclick=()=>{retried=true;$('editor').requestSubmit();};$('reload').onclick=()=>{if(!confirm('放弃本地修改并重新加载？'))return;retried=true;const latest=serverRows.find(r=>r.id===current.id);Object.assign(current,latest);$('name').value=latest.name;$('owner').value=latest.owner;$('version').textContent=latest.version;$('reload').hidden=true;$('edit-status').textContent='已重新加载，可继续编辑。';$('name').focus();};
  $('cancel').onclick=()=>close('edit');$('detail-close').onclick=()=>close('detail');for(const id of ['edit','detail'])$(id).addEventListener('cancel',e=>{e.preventDefault();close(id);});
  $('scenario').onchange=()=>{location.hash=`scenario=${$('scenario').value}`;reset();};$('reset').onclick=reset;window.addEventListener('hashchange',reset);reset();
 })();

package/template/.pi/skills/yss-prototype-stage/assets/native-workbench/index.html

@@ -7,5 +7,5 @@
 <details class="review-controls"><summary>评审场景</summary><label for="scenario">场景</label><select id="scenario"><option value="primary">正常</option><option value="empty">空数据</option><option value="loading">加载中</option><option value="failure">保存失败</option><option value="no-permission">无编辑权限</option><option value="conflict">并发冲突</option></select> <button id="reset" type="button">重置场景</button><p>供评审使用；所有数据和保存结果均为本地模拟。</p></details>
 </main>
 <dialog id="detail" aria-labelledby="detail-title"><h2 id="detail-title">资料详情</h2><dl id="detail-content"></dl><button id="detail-close" type="button">关闭详情</button></dialog>
-<dialog id="edit" aria-labelledby="edit-title"><form id="editor"><h2 id="edit-title">编辑资料</h2><label for="name">资料名称</label><input id="name" required maxlength="80"><label for="owner">负责人</label><input id="owner" required maxlength="40"><p id="edit-status" role="status"></p><div class="actions"><button id="save" type="submit">保存</button><button id="retry" type="button" hidden>重试</button><button id="reload" type="button" hidden>重新加载</button><button id="cancel" type="button">取消</button></div></form></dialog>
+<dialog id="edit" aria-labelledby="edit-title"><form id="editor"><h2 id="edit-title">编辑资料</h2><label for="name">资料名称</label><input id="name" required maxlength="80"><label for="owner">负责人</label><input id="owner" required maxlength="40"><p>版本：<span id="version"></span></p><p id="edit-status" role="status"></p><div class="actions"><button id="save" type="submit">保存</button><button id="retry" type="button" hidden>重试</button><button id="reload" type="button" hidden>重新加载</button><button id="cancel" type="button">取消</button></div></form></dialog>
 </body></html>

package/template/.pi/skills/yss-prototype-stage/assets/native-workbench/scenarios.json

@@ -0,0 +1,297 @@
+{
+  "schema_version": 1,
+  "scenarios": [
+    {
+      "id": "primary",
+      "label": "正常",
+      "state_ref": "maintenance-fixture/native-workbench/primary",
+      "initial_data": {
+        "rows": [
+          {
+            "id": "M-001",
+            "name": "季度经营分析资料",
+            "owner": "张明",
+            "status": "已更新",
+            "version": 1
+          },
+          {
+            "id": "M-002",
+            "name": "跨部门业务协作与异常处理说明（长名称示例）",
+            "owner": "李华",
+            "status": "待核对",
+            "version": 1
+          },
+          {
+            "id": "M-003",
+            "name": "归档清单",
+            "owner": "王宁",
+            "status": "已更新",
+            "version": 1
+          }
+        ],
+        "server_rows": [
+          {
+            "id": "M-001",
+            "name": "服务端最新资料名称",
+            "owner": "最新负责人",
+            "status": "已更新",
+            "version": 2
+          },
+          {
+            "id": "M-002",
+            "name": "服务端最新资料名称",
+            "owner": "最新负责人",
+            "status": "待核对",
+            "version": 2
+          },
+          {
+            "id": "M-003",
+            "name": "服务端最新资料名称",
+            "owner": "最新负责人",
+            "status": "已更新",
+            "version": 2
+          }
+        ],
+        "content": "待编辑内容",
+        "server_content": "重新加载的最新内容",
+        "outcome": "success"
+      }
+    },
+    {
+      "id": "empty",
+      "label": "空数据",
+      "state_ref": "maintenance-fixture/native-workbench/empty",
+      "initial_data": {
+        "rows": [],
+        "server_rows": [
+          {
+            "id": "M-001",
+            "name": "服务端最新资料名称",
+            "owner": "最新负责人",
+            "status": "已更新",
+            "version": 2
+          },
+          {
+            "id": "M-002",
+            "name": "服务端最新资料名称",
+            "owner": "最新负责人",
+            "status": "待核对",
+            "version": 2
+          },
+          {
+            "id": "M-003",
+            "name": "服务端最新资料名称",
+            "owner": "最新负责人",
+            "status": "已更新",
+            "version": 2
+          }
+        ],
+        "content": "待编辑内容",
+        "server_content": "重新加载的最新内容",
+        "outcome": "empty"
+      }
+    },
+    {
+      "id": "loading",
+      "label": "加载中",
+      "state_ref": "maintenance-fixture/native-workbench/loading",
+      "initial_data": {
+        "rows": [],
+        "server_rows": [
+          {
+            "id": "M-001",
+            "name": "服务端最新资料名称",
+            "owner": "最新负责人",
+            "status": "已更新",
+            "version": 2
+          },
+          {
+            "id": "M-002",
+            "name": "服务端最新资料名称",
+            "owner": "最新负责人",
+            "status": "待核对",
+            "version": 2
+          },
+          {
+            "id": "M-003",
+            "name": "服务端最新资料名称",
+            "owner": "最新负责人",
+            "status": "已更新",
+            "version": 2
+          }
+        ],
+        "content": "待编辑内容",
+        "server_content": "重新加载的最新内容",
+        "outcome": "loading"
+      }
+    },
+    {
+      "id": "failure",
+      "label": "保存失败",
+      "state_ref": "maintenance-fixture/native-workbench/failure",
+      "initial_data": {
+        "rows": [
+          {
+            "id": "M-001",
+            "name": "季度经营分析资料",
+            "owner": "张明",
+            "status": "已更新",
+            "version": 1
+          },
+          {
+            "id": "M-002",
+            "name": "跨部门业务协作与异常处理说明（长名称示例）",
+            "owner": "李华",
+            "status": "待核对",
+            "version": 1
+          },
+          {
+            "id": "M-003",
+            "name": "归档清单",
+            "owner": "王宁",
+            "status": "已更新",
+            "version": 1
+          }
+        ],
+        "server_rows": [
+          {
+            "id": "M-001",
+            "name": "服务端最新资料名称",
+            "owner": "最新负责人",
+            "status": "已更新",
+            "version": 2
+          },
+          {
+            "id": "M-002",
+            "name": "服务端最新资料名称",
+            "owner": "最新负责人",
+            "status": "待核对",
+            "version": 2
+          },
+          {
+            "id": "M-003",
+            "name": "服务端最新资料名称",
+            "owner": "最新负责人",
+            "status": "已更新",
+            "version": 2
+          }
+        ],
+        "content": "待编辑内容",
+        "server_content": "重新加载的最新内容",
+        "outcome": "failure"
+      }
+    },
+    {
+      "id": "no-permission",
+      "label": "无编辑权限",
+      "state_ref": "maintenance-fixture/native-workbench/no-permission",
+      "initial_data": {
+        "rows": [
+          {
+            "id": "M-001",
+            "name": "季度经营分析资料",
+            "owner": "张明",
+            "status": "已更新",
+            "version": 1
+          },
+          {
+            "id": "M-002",
+            "name": "跨部门业务协作与异常处理说明（长名称示例）",
+            "owner": "李华",
+            "status": "待核对",
+            "version": 1
+          },
+          {
+            "id": "M-003",
+            "name": "归档清单",
+            "owner": "王宁",
+            "status": "已更新",
+            "version": 1
+          }
+        ],
+        "server_rows": [
+          {
+            "id": "M-001",
+            "name": "服务端最新资料名称",
+            "owner": "最新负责人",
+            "status": "已更新",
+            "version": 2
+          },
+          {
+            "id": "M-002",
+            "name": "服务端最新资料名称",
+            "owner": "最新负责人",
+            "status": "待核对",
+            "version": 2
+          },
+          {
+            "id": "M-003",
+            "name": "服务端最新资料名称",
+            "owner": "最新负责人",
+            "status": "已更新",
+            "version": 2
+          }
+        ],
+        "content": "待编辑内容",
+        "server_content": "重新加载的最新内容",
+        "outcome": "no-permission"
+      }
+    },
+    {
+      "id": "conflict",
+      "label": "并发冲突",
+      "state_ref": "maintenance-fixture/native-workbench/conflict",
+      "initial_data": {
+        "rows": [
+          {
+            "id": "M-001",
+            "name": "季度经营分析资料",
+            "owner": "张明",
+            "status": "已更新",
+            "version": 1
+          },
+          {
+            "id": "M-002",
+            "name": "跨部门业务协作与异常处理说明（长名称示例）",
+            "owner": "李华",
+            "status": "待核对",
+            "version": 1
+          },
+          {
+            "id": "M-003",
+            "name": "归档清单",
+            "owner": "王宁",
+            "status": "已更新",
+            "version": 1
+          }
+        ],
+        "server_rows": [
+          {
+            "id": "M-001",
+            "name": "服务端最新资料名称",
+            "owner": "最新负责人",
+            "status": "已更新",
+            "version": 2
+          },
+          {
+            "id": "M-002",
+            "name": "服务端最新资料名称",
+            "owner": "最新负责人",
+            "status": "待核对",
+            "version": 2
+          },
+          {
+            "id": "M-003",
+            "name": "服务端最新资料名称",
+            "owner": "最新负责人",
+            "status": "已更新",
+            "version": 2
+          }
+        ],
+        "content": "待编辑内容",
+        "server_content": "重新加载的最新内容",
+        "outcome": "conflict"
+      }
+    }
+  ]
+}

package/template/.pi/skills/yss-prototype-stage/assets/native-workbench/styles.css

@@ -26,3 +26,5 @@ header span,small { color:var(--brand-color-text-secondary); font-weight:normal;
 dialog { width:min(600px,calc(100vw - 32px)); max-height:85vh; overflow:auto; padding:24px; border:0; border-radius:var(--brand-border-radius-lg); background:var(--brand-color-bg-container); color:var(--brand-color-text); }
 dialog::backdrop { background:rgba(0,0,0,.45); } dt { color:var(--brand-color-text-secondary); } dd { margin:8px 0 20px;overflow-wrap:anywhere; }
 @media(max-width:576px){header{padding:12px;gap:16px}.heading{align-items:start;gap:8px}.actions input{flex-basis:100%}h1{font-size:22px}}
+
+@media(max-width:576px){.table-scroll table,.table-scroll tbody,.table-scroll tr,.table-scroll td{display:block;min-width:0;width:auto}.table-scroll thead{display:none}.table-scroll tr{padding:var(--brand-size-sm);border-bottom:1px solid var(--brand-color-border)}.table-scroll td{border:0;overflow-wrap:anywhere}.table-scroll td[data-label]::before{content:attr(data-label) "：";color:var(--brand-color-text-secondary)}}