create-yss-spec 3.5.3 → 3.5.4

package/template/.pi/skills/yss-prototype-stage/assets/vue-business-patterns/workspace.ts

@@ -0,0 +1,26 @@
+import { createApp, type Component } from 'vue'
+import Workspace from './Workspace.vue'
+import { validateWorkspace } from './workspace-model.js'
+
+export type WorkspaceDefinition = {
+  brand: string
+  modules: { id: string; label: string }[]
+  groups: { id: string; label: string; moduleId: string }[]
+  pages: { id: string; title: string; moduleId: string; groupId: string; component: Component; icon?: Component; sceneKey?: string; mapScene?: (scene: any) => any }[]
+  defaultPage: string
+  sceneMode?: 'pages' | 'direct'
+  appearance?: 'standard' | 'glass'
+}
+export function singlePageDefinition(page: Component, title: string, appearance: 'standard' | 'glass' = 'standard', id = 'main'): WorkspaceDefinition {
+  return { brand: 'YSS 资料中心', modules: [{ id: 'records', label: '资料管理' }], groups: [{ id: 'tasks', label: '业务任务', moduleId: 'records' }], pages: [{ id, title, moduleId: 'records', groupId: 'tasks', component: page }], defaultPage: id, sceneMode: 'direct', appearance }
+}
+export function mountWorkspace(definition: WorkspaceDefinition) {
+  validateWorkspace(definition)
+  document.documentElement.dataset.appearance = definition.appearance || 'standard'
+  const app = createApp(Workspace, { definition })
+  app.config.errorHandler = error => (window as any).prototypeRuntime.showError(error)
+  app.mount('#app')
+  return app
+}
+
+import './business-controls.css'

package/template/.pi/skills/yss-prototype-stage/references/business-patterns.md

@@ -0,0 +1,42 @@
+# 企业页面模式与维护场景
+
+仅在当前需求确有同类任务时按需读取并选择模式；已有页面的局部修改优先保持其结构。示例不创建业务规则、批准或生产组件承诺。
+
+五类模式及组件状态展示统一使用 [Vue 模式](shadcn-vue-integration.md)：`assets/vue-business-patterns/` 与 `export-vue-patterns.mjs`。框架中立的 `export-business-patterns.mjs` 命令同样导出 Vue，不再加载 React。
+
+## Vue 模式的运行与定制
+
+`assets/vue-business-patterns/` 中每个 `*.config.json` 是作者入口，包含 `schema_version: 1`、`title`、`entry`、`scenarios`。在独立作者目录准备固定依赖后执行：
+
+```bash
+node .agents/skills/yss-prototype-stage/scripts/export-business-patterns.mjs --project-root <项目根> --output <新的空目录> --toolchain <作者工具目录>
+```
+
+交付目录中打开 index.html，可逐页评审。定制时复制所选入口、实际导入的 页面 SFC、Frame.vue / mount.ts / patterns.css / refinement.css 与场景 JSON；替换为自己的交互说明和状态矩阵引用，用 build-shadcn-vue-prototype.mjs --config 构建。原型脚本不会自动迁移为生产代码。
+
+默认套用共享紧凑主题；查询筛选与动作同行、表单限制阅读宽度、审批采用紧凑行、窄屏列表展示摘要。布局选择不修改示例行为。已有页面仅在明确允许时采用这些布局，保持原密度可通过作者配置 `density: comfortable` 选择。
+
+## 教学状态及已声明规则
+
+所有资料均为虚构数据；行、版本和服务端快照来自对应场景 JSON。`state_ref` 指向本文只表示维护 fixture 的规则来源，真实业务必须替换。
+
+| 模式 | 场景 | 动作与可观察结果 |
+|---|---|---|
+| 查询详情 | primary / empty / loading / no-permission | 名称和状态共同过滤；编号排序；每页两条；跨页选择保留；只读时禁止选择但可查看详情。无筛选结果显示空态。 |
+| 分步表单 | primary / failure / no-permission | 名称和负责人必填；返回保留所有字段；首次模拟提交失败后再次提交成功；无权限不能提交。 |
+| 审批权限 | primary / empty / failure / no-permission | 本 fixture 允许单项与批量通过。李华负责的资料在当前 fixture 中因关联资料未补齐不可审批；失败场景首次操作的最后一个可处理项失败，其余成功项移出列表；失败项保留并可重试。 |
+| 冲突恢复 | primary / failure / conflict / no-permission | 修改后保存；冲突保留草稿；确认放弃后整体替换为 server_rows，包含名称、负责人和版本；取消确认不改输入；重载后可再次保存。 |
+| 高密度分析 | primary / empty / loading | 24 行代表资料；筛选同步改变统计和明细；概览可定位资料；明细保留横向表格及固定编号列。 |
+
+这些状态是可重复触发的固定评审输入，不模拟真实服务器或并发通信。未声明的场景不可退回正常页面。准备只读/加载/异常快照时核对当前模式是否支持该场景。
+
+## 评审方法
+
+从用户任务选择模式，再调整信息优先级、密度和反馈位置；不要先堆叠所有组件。先在 1440×900 检查主操作与内容分组，再在 390×844 实际完成相同关键任务。表格整体不溢出不代表行操作可发现；应定位可操作控件、确认可见及可聚焦。保持项必须与原页面同状态对照。
+
+每条关键路径至少记录入口、初始输入、操作、结果和来源中的 actionKey / 状态引用。失败、恢复与再次提交作为连续流程检查，不以按钮出现代替结果正确。该记录并入现有交互说明和六轴 QA。
+
+既有三组视觉正反例位于 yss-design-system/assets/enterprise-craft：查询层级对应查询详情模式，字段分组对应分步表单，阻断及恢复对应审批权限和冲突模式。正反例用于解释设计取舍；上述可运行模式用于任务演练。
+
+新增组件状态展示从导出入口的 `component-states/index.html` 进入；字段/详情/菜单/分页等配方见 [组件导航](component-recipes.md)。五类模式保持既有确定性场景和业务规则，不因组件选择新增状态来源。
+

package/template/.pi/skills/yss-prototype-stage/references/comparison-tool.md

@@ -0,0 +1,48 @@
+# 离线候选比较工具 v2
+
+比较包仅为 review-only 辅助快照，不取代正式原型、Prototype Evidence v4、Visual Baseline v1 或用户决定。2–3 个候选逐个原尺寸显示；条件探索仍使用三个。
+
+## 共同输入
+
+每个候选包含字节相同的 `scenarios.json`、由工具生成的 `scenarios.js`、`scenario-runtime.js` 及项目 `tokens.css`。场景 JSON 使用 schema_version=1，scenarios 中每项包含唯一 id、label、state_ref 与 initial_data 对象；至少有 primary。state_ref 引用已有状态说明；不新增另一套业务状态或批准字段。UI 与模拟服务端快照均来自 initial_data，不能在候选代码另写一套 seed。
+
+页面通过 `window.prototypeRuntime.initialize()` 读取 hash 并取得 `{id, data, ticket}`，data 是初始数据副本。完成数据重置与首次渲染后调用 `ready(ticket)`；异常调用 `fail(error)`。原生和 shadcn starter 已接入。未知、缺失或多余的 hash 参数报错；没有 hash 时才使用 primary。异步初始化也必须等渲染完成后确认，不能在 load 事件直接报成功。
+
+```json
+{
+  "schema_version": 2,
+  "comparison_id": "task-options",
+  "title": "资料处理方案",
+  "comparison_ref": "docs/.scratch/demo/design/interaction.md",
+  "scenario_ref": "docs/.scratch/demo/design/shared-scenarios.json",
+  "cases": [{"id": "normal", "label": "正常处理", "scenario": "primary"}],
+  "variants": [
+    {"id": "a", "label": "逐项处理", "root": "docs/.scratch/demo/design/candidates/a", "entry": "index.html", "cases": ["normal"]},
+    {"id": "b", "label": "批量处理", "root": "docs/.scratch/demo/design/candidates/b", "entry": "index.html", "cases": ["normal"]}
+  ]
+}
+```
+
+比较问题、差异轴、事前标准、保持项与选择代价写在 comparison_ref 中。scenario 引用 JSON 的既有场景 ID，case.id 只是比较入口，不重新定义 Visual Baseline case_id。
+
+```bash
+node .agents/skills/yss-prototype-stage/scripts/prototype-comparison.mjs prepare --project-root <项目根> --feature demo --input <比较输入.json>
+node .agents/skills/yss-prototype-stage/scripts/prototype-comparison.mjs validate --root <比较包> --project-root <项目根>
+node .agents/skills/yss-prototype-stage/scripts/prototype-comparison.mjs seal --root <未批准的v2比较包>
+```
+
+输出固定为 `docs/.scratch/<feature>/design/comparisons/<comparison-id>/`。prepare 检查 ID 存在、各候选共同数据及派生脚本一致、Token 和资源完整；非空目录拒绝覆盖，失败删除临时包。manifest v2 只保存来源、入口、场景与摘要，不保存批准。
+
+## 初始化与实际评审
+
+候选切换或重置会重建 frame，清除上一个候选的临时数据。外层在页面加载后发送本次初始化标识，候选返回该标识、场景 ID、输入摘要与 pending/ready/error。外层校验来源 frame、标识及预期输入，忽略迟到回复；启动错误、资源错误、初始化错误或 8 秒超时显示失败。收到 load 事件不代表初始化成功。
+
+该确认只证明应用报告了预期初始化，不证明业务逻辑正确。浏览器仍检查实际字段、列表和动作结果，尤其失败保留、取消恢复、确认重载与再次保存。临时内部操作不反向改变外层初始场景。
+
+`#variant=a&case=normal` 为稳定链接；未知候选/场景直接报错。iframe 不缩放，使用当前可用宽度。正式截图通过“原尺寸单独打开”进入候选，设置 1440×900 或 390×844，不把工具外框当成产品基线。工具不跨 frame 读取 DOM，不依赖网络、服务器或 localStorage。
+
+validate 不带 project-root 时仅验证便携快照；带项目根时再检查来源漂移。seal 不更新来源、不产生批准，变更来源需新建比较包。
+
+## 兼容
+
+v1 仅允许 `validate --allow-legacy` 只读检查，结果提示“未验证应用初始化”。默认校验、prepare 和 seal 不接受 v1，不批量改写历史资产。迁移时保留旧包，依据原始候选和当前状态来源生成新的 v2 比较；旧 AntD 资产仍遵守其只读边界。

package/template/.pi/skills/yss-prototype-stage/references/component-recipes.md

@@ -0,0 +1,41 @@
+# 任务、页面组合与当前组件
+
+先读当前交互说明和状态矩阵，再按任务选择组合。组件可用不代表业务规则已批准；此处只导航已固定源码，不自动搜索 registry、执行 latest 或覆盖 preset。新高保真优先 shadcn-vue + Vue 3；历史 React 包仅显式 legacy 只读校验。Blocks 仅提供任务组合参考，不自动复制上游页面、依赖或默认主题。
+
+## 任务导航
+
+| 用户任务 | 页面组合 | 当前组件 | 状态与验收重点 |
+|---|---|---|---|
+| 在多个业务页面间连续处理 | 模块 → 分组侧栏 → 页签 → 工作区 | Button、Tabs、DropdownMenu、Tooltip、Sheet、AlertDialog | 页面去重、dirty 关闭确认、切换保留草稿、场景重置清空、隐藏浮层清理；见 [企业工作区](enterprise-workspace.md) |
+| 查询后核对资料 | 筛选 → 结果与选择 → 分页 → 详情侧栏 | Field/Input/Select、Table/Checkbox/Badge、Pagination、DropdownMenu、Sheet | 查询/排序后的页码合法；显示筛选和选择范围；跨页选择按当前合同保留；空态可恢复；390px 摘要保留身份/名称/状态/操作，次要字段进详情 |
+| 分步录入并确认 | 字段分组 → 帮助/错误 → 下一步 → 结果 | Field、InputGroup、Textarea、Button、Alert | label/帮助/错误绑定同一字段；首错定位；返回保留全部输入；失败重试不重置草稿；窄屏单列 |
+| 单项/批量审批 | 待办列表 → 持续原因 → 主操作 → 剩余事项 | Checkbox、Badge、Alert、Button、Separator | 主操作直接可见；禁用原因无需 Tooltip 才能发现；部分失败保留失败项和重试入口 |
+| 冲突恢复 | 字段草稿 → 阻断说明 → 放弃确认 → 全量重载 | Field、Alert、Dialog、AlertDialog | 取消确认保留草稿；确认按状态矩阵完整替换快照；核对版本及再次保存，不能只核对提示文字 |
+| 高密度核对 | 指标主次 → 同源筛选 → 概览/明细 → 定位 | Card、Tabs、Table、Separator | 指标及明细来自同一筛选；横向滚动仅在表格内；滚动提示、关键列与可聚焦入口稳定；不默认引入图表 |
+| 等待、空结果与上下文 | 加载占位 → 空态下一步；当前位置 | Skeleton/Spinner、Empty、Breadcrumb | 加载有可读文本，不用无限动画冒充进度；路径最后一项标当前页，无目标不伪造链接 |
+
+## 组件选择与依赖
+
+固定集合及摘要以 `assets/shadcn-vue-authoring/registry-manifest.json` 为准，当前共 27 组。基础 11 个为 Button、Input、Dialog、Select、Table、Badge、Label、Checkbox、Textarea、Tabs、AlertDialog；补充 13 个为 Card、Separator、Breadcrumb、Field、InputGroup、Alert、Empty、Skeleton、Spinner、Sheet、DropdownMenu、Tooltip、Pagination；新增 Combobox、RangeCalendar、Popover。
+
+- Field 组合 Label/Separator；InputGroup 组合 Button/Input/Textarea；Pagination 使用 Button 变体。Table 只负责基础表格，筛选、排序、分页和选择逻辑消费本地场景与现有业务合同。
+- Vue 的 Sheet、DropdownMenu、Tooltip 使用固定 reka-ui；图标使用 @lucide/vue。构建器验证固定 revision、许可、包版本、锁及依赖闭包。主题只在本地映射层适配，源文件变更须另记差异。
+- 搜索单选与纯日期范围按 [专项配方](search-date-patterns.md) 使用；不使用未登记的多选、日期时间、图表、Sidebar 或 Sonner。确有新增需求时先明确决策及验证范围，不假装当前已支持。
+
+## 键盘、焦点及主题配方
+
+- Field：Vue `for`与唯一控件 ID 对应；说明和错误 ID 写入 `aria-describedby`；验证错误设置 `aria-invalid`，焦点转到第一处错误。服务端模拟失败用持续 Alert，保留全部步骤输入。
+- InputGroup：边框和焦点环由外层统一提供；内层不重复高度、边框和圆角。附加操作按钮有独立名称，不把点击说明等同于提交。
+- Sheet/Dialog：标题与说明完整；Escape、关闭和取消路径可用；关闭后回到原触发器。窄屏内容滚动时操作可访问，必要时全宽；不要把复杂多步骤强塞进小弹窗。
+- DropdownMenu：次要操作才收纳；Arrow/Enter/Escape 可操作，禁用项不可执行，关闭焦点返回；关键主操作始终可见。Tooltip 仅补充说明，不能承载唯一错误或权限原因。
+- Pagination：显示结果数、当前页和页数；首尾按钮禁用；筛选导致结果减少时回到合法页；选择范围明确，空结果不出现虚假资料。
+- 所有组件使用当前 DESIGN 角色，compact/comfortable 不修改正文角色。窄屏按当前普通控件变体；点击区域和相邻间距实测，不能以控件名或高度证明无障碍。
+- 场景切换/重置重新初始化局部状态，清除输入、错误、菜单、Sheet/Dialog 与选择。菜单打开时也要通过场景 hash 切换验证清理；初始化确认不代替行为测试。
+
+- Select：有限选项使用真实 SelectTrigger/SelectContent/SelectItem；核对 Arrow/Enter/Escape、选中反馈、焦点返回、弹层宽度及窄屏边界。Vue 使用 `v-model` / `update:modelValue` 与 `--reka-select-trigger-width`，不得复制 React 的事件或 Radix 变量。原生 select 只用于明确选定的轻量路线或独立评审工具，并在证据注明。
+
+## 可运行教学与证据
+
+原五类模式、新增两个变体与组件状态展示见 [Vue 集成](shadcn-vue-integration.md)，`export-vue-patterns.mjs` 或兼容命令 `export-business-patterns.mjs` 均构建 Vue。组件展示使用 `component-states-standard.config.json`，默认、禁用、错误、加载、选中、浮层均可复现。三个视觉正反例仍从设计系统的 `references/enterprise-craft.md` 导航。
+
+所有检查并入六轴 QA：记录场景、来源、步骤、实际结果和适用视口；行为缺陷、视觉观察与偏好建议分别报告。沿用 Prototype Evidence v4、Visual Baseline v1 与比较 v2，不新增批准字段或生命周期门禁。

package/template/.pi/skills/yss-prototype-stage/references/concept-comparison.md

@@ -0,0 +1,26 @@
+# 内容规划与方案比较
+
+用于存在信息架构、交互或视觉方向不确定性的任务。已有页面模式足够时说明依据即可，不为满足数量而探索。产物写入现有交互说明的对应章节，不另建需求、状态机或批准记录。
+
+## 先回答问题
+
+用一小段说明用户要完成什么、哪些必须保持、什么可以变化、哪个风险需要通过原型回答。先列内容与来源，再分配区域；标出主要/辅助信息、长中文/空值和动作结果。灰度草图也应让评审者找到主任务，不能靠颜色补救结构。
+
+信息架构/交互比较在独立低保真评审前完成。三个候选可沿步骤组织、逐项/批量粒度、人与系统分工、入口、承诺时点形成差异；每个候选写明假设、适用情况及代价。它们都必须满足已确认业务规则，不能通过删功能或隐藏异常制造优势。高保真阶段只比较尚未确定的视觉层级与布局，行为变化返回受影响的低保真评审。
+
+## 公平比较
+
+- 先引用 Spec 的硬约束，再列可权衡项；不编造点击数或完成时间门槛，不看完候选后改标准。
+- 保持同一任务、代表数据、状态、文案长度、保真度与制作深度。不得一个候选精修、另外两个充当陪衬。
+- 原尺寸逐个查看；交互比较使用相同场景并重置。比较工具的场景声明和数据摘要不证明页面实际消费正确，必须实际操作。
+- 记录可定位的观察、选择代价、落选理由、重新考虑条件。用户选择沿用现有决定记录；工具选项、Agent 推荐和截图不是批准。
+
+例如审批工作台可以探索逐项处理、批量处理后单独处理异常、引导队列，但只有 Spec 允许这些行为时才成立。若批量处理未获需求授权，不能作为“更高效”的候选。三个同布局不同颜色的页面不算三个交互方案。
+
+## 来源与采用边界
+
+方法参考 Owl [parallel-concepts](https://github.com/Owl-Listener/designer-skills/blob/9a6930cf84a822eb458624bd11c61aac5bbdf224/prototyping-testing/skills/parallel-concepts/SKILL.md)、[concept-selection](https://github.com/Owl-Listener/designer-skills/blob/9a6930cf84a822eb458624bd11c61aac5bbdf224/prototyping-testing/skills/concept-selection/SKILL.md)（MIT），以及 [wireframe 内容规划](https://github.com/yhassy/wireframe-skill/blob/948d4331343b18d913d5bc502da72ed0c5f19101/wireframe-designer.md)（MIT）。独立改写方法，未复制上游实现；不采用未经验证的经验阈值。原尺寸比较参考 [Emil prototype](https://github.com/emilkowalski/skills/blob/d16ebe60d09a5ba2afcb7054ede9d0a10c9f6128/skills/prototype/SKILL.md)（MIT），不采用自动转生产或删除旧原型。
+
+## 完整演练
+
+需要把标准转成可执行观察时，读取 [资料审批演练](low-fidelity-exercise.md)：同一任务脚本覆盖三个组织方式及失败恢复。将观察写回现有比较表，不把教学推荐当成用户选择。

package/template/.pi/skills/yss-prototype-stage/references/enterprise-workspace.md

@@ -0,0 +1,53 @@
+# 企业多页工作区配方
+
+新企业高保真默认使用本配方；已有批准页面先登记保持项。视觉尺寸只读取根 DESIGN.md 的 workspace 角色，业务规则仍消费交互说明与状态矩阵。
+
+## 任务与布局
+
+顶部承载真实模块入口，侧栏承载当前模块的分组页面，可关闭页面 Tag 承载已打开的工作上下文。只登记可操作页面，不复制参考系统的账号、业务数据和全部菜单。单页任务使用同一应用壳的单页入口；组件状态展示保留独立入口。
+
+取消应用外框的居中限宽，表单内部保留阅读宽度。压缩重复标题和描述；筛选、结果范围、选择和动作直接进入工作视线。详情在选择前不占位，宽屏选中后展开分栏，较窄视口用 Sheet。导航形态及尺寸按根规范，页面主滚动、详情滚动和表格横向滚动职责明确。窄屏保证主要任务和退出动作可达。
+
+应用壳由固定 Button、Badge（页面 Tag 容器）、DropdownMenu、Tooltip、Sheet、AlertDialog 组合；这不是新登记的上游 Sidebar，不安装额外库或改变 revision。明确选择玻璃时只用于导航和浮层，密集正文保持实底。
+
+## 作者接口
+
+`assets/vue-business-patterns/workspace.ts` 提供 `mountWorkspace(definition)`：
+
+- `brand`、`modules: [{id,label}]`、`groups: [{id,label,moduleId}]`。
+- `pages: [{id,title,moduleId,groupId,component,icon?,sceneKey?,mapScene?}]` 和 `defaultPage`。ID 为唯一 kebab-case；未知模块、分组、默认页及无页面模块拒绝初始化。
+- `sceneMode` 默认 `pages`，从共同场景的 `initial_data.pages[sceneKey || id]` 取原始场景；兼容单页使用 `direct`。`mapScene(scene)` 可显式选择已有来源，但必须返回 ID、状态来源和数据，不能静默回退 primary。
+- `appearance` 默认 `standard`；`glass` 为可选外观。密度仍由现有 CLI/config 规则选择。
+
+构建配置仍为 schema 1 的 title、entry、scenarios、可选 density；入口导入 mountWorkspace 和明确页面定义。原有 `mount(page,title,appearance)` 继续生成单页应用壳，默认页 ID 为 main。无配置 starter 仍为查询任务；多页演练使用 `workspace-standard.config.json`，玻璃使用 `workspace-glass.config.json`。
+
+页面通过 `useWorkspacePage()` 接入：`trackDirty(computed(...))` 报告真实未提交修改，成功提交或接受服务端快照后更新基线；`onLeave(cleanup)` 关闭 Select/Menu/Sheet/Dialog、撤销焦点请求及暂停临时任务。页面业务数据归页面实例所有，重开从当前场景全新复制；不把用户输入写回共同 fixture。
+
+## 导航、草稿和场景
+
+页面 Tag 使用 `nav` + 原生 Button 的导航语义及 `aria-current="page"`，不用 Tabs/tablist/tabpanel。激活按钮与关闭按钮并列，不嵌套按钮；默认页固定，其余可关闭。左右键及 Home/End 只移动焦点，Enter/空格激活，Delete 请求关闭；窄屏通过已打开页面菜单访问其他页面。溢出时只滚动 Tag 容器，不能带动正文。当前项使用主色浅底、描边和字重；页内视图 Tabs 保留主色文字与指示线，不叠加填充胶囊。
+
+收起导航保持图标居中、当前项标记和可访问名称，Tooltip 使用反相表面及同色箭头；选页、展开或改变断点时关闭旧提示。动效消费现有 Token，并响应减少动效。
+
+按页面 ID 去重打开。默认页固定；关闭当前页后选左侧相邻页，没有时回默认页。关闭有修改的页签须确认，取消完整保留；关闭其他页不得改变当前页的输入和滚动。
+
+切换页签保留组件缓存、筛选、分页、选择、草稿及滚动。隐藏页从活动 DOM 移除，临时浮层关闭，不允许隐藏 Dialog 抢焦点。冲突示例离开时关闭编辑弹窗但保留草稿，返回后通过“继续编辑草稿”恢复。缓存只在当前文档内存，不用 Cookie 或浏览器持久存储，刷新重新初始化。
+
+链接使用 `?page=<id>#scenario=<id>`。页面 query 只接受一个合法 page，场景 hash 沿用原有严格校验；未知、重复或缺失入口明确报错。前进/后退只切换页面时保留缓存，场景变化则销毁全部缓存。重置保留链接指向的当前页、回到该场景初始数据，其余非默认页关闭；评审工具的减少透明选项不属于业务草稿。
+
+初始化先校验全部页面的数据映射，再挂载当前页，首次 Vue 渲染后调用 ready(ticket)。错误不发送成功，迟到 ticket 不覆盖当前结果；初始化确认不证明业务行为正确。
+
+## 共同演练输入
+
+`compose-workspace-scenarios.mjs --write` 根据五类原始 JSON 生成 workspace.scenarios.json，`--check` 核验精确字节。每页记录原始场景 ID、state_ref、source_ref 和源文件摘要，原文件随构建 provenance 交付。
+
+- primary：全部页面的原有 primary。
+- exceptions：表单 failure、审批 failure、冲突 conflict；查询和分析使用 primary。
+- no-permission：四类已有权限场景的页面使用 no-permission；分析没有写动作，明确使用原有 primary。
+- empty：查询、审批、分析使用 empty；表单和冲突保持 primary。
+
+组合是教学任务集合，不声明页面之间共享业务存储或建立新联动。导出器同时输出五类单页、企业工作区和组件状态页。比较候选仍共用场景 JSON；比较 v2、Prototype Evidence v4、Visual Baseline v1 不增加批准字段。
+
+## 六轴 QA
+
+核对导航一致、页签键盘/关闭回退、草稿取消/确认、重新打开、非法入口、反复重置、浮层清理、详情退出和焦点返回；复验五类原有主流程与失败恢复。检查计算样式、窄屏任务、缩放、滚动、对比度及 console。构建和模型单测不能代替浏览器检查；受环境限制时逐项记未执行并保留原因，不宣布 implementation-ready。

package/template/.pi/skills/yss-prototype-stage/references/low-fidelity-exercise.md

@@ -0,0 +1,32 @@
+# 低保真完整演练：资料审批组织方式
+
+这是维护教学 fixture，不是产品需求或用户批准。本文明确允许单项、批量、按编号队列审批同一组三条虚构资料；三条资料均已具备审批条件。确认通过后仅从本地待处理集合移除；首次失败保留输入和选择，再次操作成功。
+
+## 输入与保持项
+
+用户任务是核对编号、名称、负责人、状态后处理三条资料。三候选共享 scenarios.json、文案、数据、失败状态、Token 和相同低保真深度；允许变化只有任务组织、选择粒度和上下文展示。不能删除字段或跳过失败处理来制造优势。
+
+## 事前标准与任务脚本
+
+硬约束：每条资料可定位、可核对；只处理明确选择的资料；失败保留上下文；重置恢复原始三条。权衡项：列表全局对照能力、重复选择成本、逐条核对负担。没有人为规定的完成秒数或点击达标门槛。
+
+1. 正常场景：找到 M-002 的负责人，再处理全部资料；记录实际操作与结果。
+2. 失败场景：执行处理，核对失败后行与选择未丢失，再重试；确认剩余资料集合。
+3. 每个候选完成后重置，再切换到下一候选，从同一初始数据开始。
+4. 在桌面和窄屏执行；填写现有交互说明的观察、代价及落选理由。
+
+| 候选 | 差异轴 | 适合条件 | 需要观察的代价 |
+|---|---|---|---|
+| 逐项处理 | 全列表中逐条提交 | 经常需要横向比较资料 | 重复动作，逐条定位 |
+| 批量处理 | 选择集合后统一提交 | 允许批量且资料同质 | 误选风险、选择集合理解 |
+| 引导队列 | 系统按顺序给出下一条 | 每项需要集中核对 | 看不到完整列表上下文 |
+
+## 教学选择示范
+
+在本 fixture 的“同质资料、允许批量、需要整体核对”假设下，示范推荐批量处理。代价是必须看清所选范围；逐项方案保留全局上下文但重复提交；队列适合逐项仔细核对但牺牲全局对照。若真实需求禁止批量或每项审核负担更高，应重新比较。此段是条件推演，不是用户选择、实测效率结论或批准记录。
+
+运行后将实际观察与本段假设对照，不用教学推荐替代证据。工具输出仅为 review-only，正式原型仍经过原有低保真评审、H1/H2、QA 和用户确认。
+
+```bash
+node .agents/skills/yss-prototype-stage/scripts/export-low-fidelity-exercise.mjs --project-root <项目根> --output <新的空目录>
+```

package/template/.pi/skills/yss-prototype-stage/references/product-design-adapter.md

@@ -1,10 +1,10 @@
 # YSS HTML 原型适配器
 
-H1/H2 表示验证深度，不表示低/高保真。统一消费 Prototype Evidence schema v4 与 Visual Baseline schema v1。默认 `html-css-js`，接收者可离线打开；生产组件验证仍归下游 `yss-ui`，原型阶段不得调用。
+H1/H2 表示验证深度，不表示低/高保真。统一消费 Prototype Evidence schema v4 与 Visual Baseline schema v1。高保真主要采用 `vue-shadcn-prebuilt`，简单局部修改可用 `html-css-js`，接收者可离线打开；生产组件验证仍归下游 `yss-ui`，原型阶段不得调用。
 
 ## 构建与交付
 
-在项目实例中，低保真和状态矩阵评审通过后运行；模板源仅在临时 fixture 测试生成器：
+在项目实例中，低保真和状态矩阵评审通过后，优先按 [shadcn 集成](shadcn-vue-integration.md) 构建高保真；以下为保留的原生轻量路线。模板源仅在临时 fixture 测试生成器：
 
 ```bash
 node .agents/skills/yss-prototype-stage/scripts/prototype-contract.mjs prepare-flow \
@@ -40,7 +40,7 @@ node .agents/skills/yss-prototype-stage/scripts/prototype-contract.mjs validate-
 
 ## 统一 QA 与离线复验
 
-六轴仍为 visual/layout/interaction/content/accessibility/cross-platform，写同一份 feature 级 `verification/design-qa.md`。原生语义优先；弹窗按适用行为验证初始焦点、Tab、Escape 和关闭后的焦点去向。ARIA 属性或自动扫描不替代键盘实操。
+六轴仍为 visual/layout/interaction/content/accessibility/cross-platform，写同一份 feature 级 `verification/design-qa.md`。原生语义优先；弹窗按适用行为验证初始焦点、Tab、Escape 和关闭后的焦点去向。ARIA 属性或自动扫描不替代键盘实操。按 `yss-design-system/references/search-date-theme.md` 增加 320 CSS px 重排、真实点击区域、焦点遮挡及按人群风险选择的读屏记录；与实际 200% 缩放分别留证。维护检查使用 [统一验证入口](prototype-verification.md)。
 
 复制资源包到脱离源仓的目录，以 `file://` 且无网络运行，检查所有采用的场景、资源加载、console、键盘、焦点、200% zoom/reduced motion。证据写 `delivery_contract=offline-html-v1`、`resource_manifest_ref`、`offline_verification_ref/result`。机器静态检查通过只代表结构可检查。
 
@@ -54,6 +54,12 @@ node .agents/skills/yss-prototype-stage/scripts/visual-baseline-contract.mjs sea
 
 从 manifest 的 `case_id` 读取语义与截图，不依赖 glob；视觉回归按风险采用，首次生成基线不声称已有回归通过。六轴 QA、独立评审、用户确认和生产实现隔离保持原合同。
 
-## 条件 AntD 路线
+## shadcn 主要路线
 
-已确认复杂交互需要真实组件时，按 [AntD 集成](antd-integration.md) 使用 `react-antd-prebuilt`；这是作者侧预构建，接收者仍无需 Node，所有资源离线随包。默认 `html-css-js` 保持原生实现。组件库知识仅作为本阶段设计事实，不取代根 DESIGN.md 或授权生产实现。
+按 [shadcn 集成](shadcn-vue-integration.md) 使用 `vue-shadcn-prebuilt`。组件源码固定 revision，作者侧预构建；H1/H2 均交付离线 HTML 资源包。原生路线用于轻量改动及已有模式。React AntD 不再生成，旧证据通过显式 legacy 选项只读核验。
+
+## 候选比较
+
+已有本地候选需要原尺寸切换时使用 [独立比较工具](comparison-tool.md)。比较包属于评审辅助，不属于已批准原型；其 manifest 不取代 Prototype Evidence v4 或 Visual Baseline v1。高保真页面层级与状态表达按 `yss-design-system/references/enterprise-craft.md` 检查，同批查看桌面/窄屏，统一修整后复验。关键 finding 未关闭时保持阻塞。
+
+React 作者依赖、组件源码和生成入口已退役，历史批准包仅显式 `--allow-legacy` 只读核验，不重新封存。见 [历史路线](shadcn-integration.md)。

package/template/.pi/skills/yss-prototype-stage/references/prototype-profile-routing.md

@@ -8,8 +8,8 @@
 
 | 档位 | 名称 | 命中条件 | 默认适配器 |
 |---|---|---|---|
-| H1 | `visual-review` | 仅需确认布局、密度、层级、文案或少量关键交互；不涉及多页面导航、复杂联动、权限、恢复、冲突或真实组件差异 | 语义 HTML + 项目 Token CSS + 最小 JavaScript；可使用设计工具导出，但必须有浏览器可复验入口 |
-| H2 | `flow-review` | 多页面/路由、复杂表单联动、权限体验、失败恢复、并发冲突或需要可操作主流程测试 | HTML/CSS/JavaScript 可操作流程；默认离线资源包，保持同等流程和异常验收 |
+| H1 | `visual-review` | 仅需确认布局、密度、层级、文案或少量关键交互；不涉及多页面导航、复杂联动、权限、恢复、冲突或真实组件差异 | shadcn-vue + 项目 Token 离线预构建；轻量页面可使用原生 HTML 或设计工具导出，必须有浏览器可复验入口 |
+| H2 | `flow-review` | 多页面/路由、复杂表单联动、权限体验、失败恢复、并发冲突或需要可操作主流程测试 | shadcn-vue 可操作流程；轻量页面可用原生 HTML，同等流程和异常验收，交付离线资源包 |
 
 真实 YSS/AntDV 组件行为、lockfile、props、slots、events 或 Storybook 状态不是第三种原型档位。它们属于前端实现计划、已批准切片的生产实现与实现还原验证。原型中发现的相关不确定性写入 `implementation_handoff`，不得为解决它调用 `yss-ui` 或把实现仓组件代码引入原型。
 
@@ -31,7 +31,7 @@
 
 ### H1
 
-- 浏览器不依赖 Node/runtime build；原型目录不得伪造 `package.json`、lockfile 或 AntD 查询段。
+- 浏览器不依赖 Node/runtime build；原型目录不得伪造 `package.json`、lockfile 或空组件查询段。
 - 至少验证一个或少量关键交互，以及基础键盘、焦点和对比度。
 - 200% zoom 与 reduced motion 只在影响面命中时要求；视觉回归和真实组件 story 不强制。
 
@@ -39,7 +39,7 @@
 
 - 主流程与关键 failure / no-permission / conflict 状态可操作。
 - 验证键盘、焦点、对比度、200% zoom、reduced motion；按风险决定视觉回归。
-- 默认 `component_basis=html-css-js`、`runtime_build_required=false`、`prototype_library_facts.applicable=false`，不创建 package、lockfile 或空事实包。
+- 高保真优先 `component_basis=vue-shadcn-prebuilt`，来源见 [shadcn 集成](shadcn-vue-integration.md)。原生轻量路线使用 `html-css-js` 且 `prototype_library_facts.applicable=false`；两者 `runtime_build_required=false`，交付目录不放 package 或 lockfile。
 - 场景使用现有 `case_id/data_scenario` 对应状态矩阵；固定初始输入与结果，提供切换、深链接和重置，验证失败后的输入保留、重试、权限边界及冲突恢复。
 - `offline-html-v1` 交付包记录所有本地资源及摘要；断开网络后通过 `file://` 从独立目录复验，保存 console、资源、交互和截图结果。静态扫描不能替代浏览器行为证明。
 
@@ -51,7 +51,9 @@
 
 ## 条件 ideation
 
-新视觉方向、信息架构不确定或存在多个合理布局时比较三个候选方案，由用户选择后构建。可用低保真、HTML 或按需 `product-design:ideate`；不把 ImageGen 当作所有原型的前置依赖。已批准模式或当前设计规范足以约束页面时，记录 `not-applicable`、来源与理由。
+信息架构或交互存在实质不确定性时，在独立低保真评审之前按 [方案比较方法](concept-comparison.md) 比较三个候选并取得用户选择。通过评审后，只有视觉方向仍未确定时比较高保真候选；保持已批准行为，行为变化返回受影响评审。候选保持同一任务、数据、保真度与制作深度，比较前明确硬约束与取舍标准；换色不算交互方案。记录选择代价、落选理由及重新考虑条件，沿用现有用户决定协议，不另立批准门禁。
+
+可用语义草图、HTML 或按需 `product-design:ideate`；离线比较用 [评审工具](comparison-tool.md)，不把 ImageGen 当作所有原型的前置依赖。已批准模式或当前设计规范足以约束页面时，记录 `not-applicable`、来源与理由；已解决的问题不重复探索。
 
 `source_visual.kind=design-system` 引用 `DESIGN.md`，走规范直出和 `design-contract` QA；`visual-reference` 引用独立视觉稿，走 `visual-comparison` QA。两者都要求统一六轴 QA 和用户确认；首版截图只在确认后成为后续回归基线。
 
@@ -77,4 +79,6 @@
 
 采纳的外部方法与适用边界见 [HTML 原型实践](html-prototype-practices.md)；不安装上游整包或引入第二套状态、QA、交接体系。
 
-真实组件确有评审价值时，H2 可条件使用 `react-antd-prebuilt`，仍交付离线 HTML 资源包；启用条件、版本与验证见 [AntD 集成](antd-integration.md)。
+React AntD 预构建也已退役；旧证据与资源仅显式 legacy 只读校验，不封存新版本。高保真主要路线与迁移说明见 [shadcn 集成](shadcn-vue-integration.md)。
+
+React 作者依赖、组件源码和生成入口已退役，历史批准包仅显式 `--allow-legacy` 只读核验，不重新封存。见 [历史路线](shadcn-integration.md)。

package/template/.pi/skills/yss-prototype-stage/references/prototype-verification.md

@@ -0,0 +1,25 @@
+# 原型验证入口
+
+维护验证统一由 `scripts/verify-prototype-design` 执行；分发实例可直接调用本 Skill 的同名 `.mjs`。`verify-yss-prototype-contract-scenarios` 和历史 `antd-reference.test.mjs` 转调相同 contract 实现。
+
+```sh
+node .agents/skills/yss-prototype-stage/scripts/verify-prototype-design.mjs \
+  --scope all --toolchain "$AUTHOR_TOOLS" \
+  --browser-tools "$PLAYWRIGHT_DIR" --output "$EXTERNAL_EMPTY_OUTPUT"
+```
+
+作者工具：复制当前 `assets/shadcn-vue-authoring/package.json`、`pnpm-lock.yaml` 到独立目录，`pnpm install --frozen-lockfile --ignore-scripts`。浏览器工具：固定 Playwright 安装目录（内含 index.mjs），事先物化其对应 Chromium 和 WebKit。入口记录实际版本，不自动安装或降级。兼容 `YSS_VUE_TOOLCHAIN` 和 `YSS_PLAYWRIGHT_MODULE`；显式参数优先。
+
+主 CLI 精简实例先用 `assets ensure stage.product-design --apply` 安装阶段，再用 `skills ensure prototype-review yss-design-system --apply` 补齐本专项所核验的三个 Skill；Design/Frontend 保留各自默认编排。维护夹具引用可分发的 `scripts/lib/testing/user-decision-fixture.mjs`；其中模拟批准仅用于测试，不是产品或人的真实决定。
+
+| 范围 | 检查 |
+|---|---|
+| contract | 精确依赖/锁、27 组原始组件、H1/H2 构建、场景/工作区、便携资源、比较工具、legacy 拒绝、验证入口反例 |
+| browser | 用当前来源构建并复制到独立目录，真实交互、工作区、布局/焦点、缩放、离线与原模式回归 |
+| all | 串行执行二者；任一失败不能得到通过 |
+
+所选范围缺工具、浏览器、输入或执行结果时非零退出。`report.json` 记录 passed/failed/not-executed/not-applicable 数量、源码前后摘要、包摘要、工具版本、命令/退出码及原始日志与截图报告路径。未命中项须给出理由；缺环境不能记作不适用。输出目录必须位于仓库外且为空，保留失败运行，不覆盖重跑。来源漂移后固定输入重新运行。
+
+W01–W14 / T01–T07 的可操作部分由 `tests/workspace-browser.mjs`、原模式、组件、缩放和比较浏览器检查组合覆盖。320 CSS px 重排与浏览器真实 200% 缩放分别记录；缩放用隔离测试 profile 的 `chrome.tabs.setZoom/getZoom`，不以 CSS zoom 或 DPR 模拟代替。WebKit 对本地文件使用 HTTP(S) 拦截阻断网络，报告该机制与 Chromium offline 的差别。
+
+运行证据经现有 `design_qa.report_ref`、场景/离线/视觉证据字段引用，不是第二套生命周期状态。首次截图仅为待审输入；维护者按当前 DESIGN/保持项观察后记录六轴结论，不与自身比较宣称视觉回归通过。自动化不能替代读屏、真实用户测试或用户视觉确认。

package/template/.pi/skills/yss-prototype-stage/references/resource-lifecycle.md

@@ -0,0 +1,20 @@
+# 原型浏览器与临时输入
+
+`browser-session.mjs` 提供独立 Node 命令用的 `withBrowserSession`。它创建系统临时配置目录，只终止 `session.spawn` 创建并持有的浏览器进程；成功、异常和 SIGINT / SIGTERM / SIGHUP 均清理。SIGKILL、系统断电无法执行清理，失败时报告遗留路径；不按进程名结束浏览器，不使用用户 profile。
+
+```js
+import { withBrowserSession } from './browser-session.mjs';
+await withBrowserSession(async session => {
+  const browser = session.spawn(chromePath, [
+    '--headless=new', `--user-data-dir=${session.profileDir}`,
+    '--remote-debugging-port=0', 'about:blank'
+  ], {stdio: 'ignore'});
+  // 使用本次浏览器采集；截图和详细结果写入既有正式证据目录。
+  // await verify(browser);
+  // console.log(JSON.stringify(summary));
+});
+```
+
+仅传入真正的浏览器可执行文件；不通过 shell 或会脱离控制的启动器。证据路径不得位于 `session.profileDir`。每条独立命令仅使用一个会话；不要在嵌入宿主服务中安装这些进程级信号处理器。关闭调试连接也应使用 finally。只读查看既有基线无需启动新浏览器。
+
+摘要默认随命令输出；命令可以提供显式 `--summary-file <路径>` 写入独立摘要，详细证据格式与引用不变。一次性工作项数组、待正式化证据也用系统临时工作区；纳入批准、验证或冻结引用后持久化并按正式资产保护。已有资产通过 `.template-spec/process/feature-assets.md` 的外部计划整理，不自动清理。

package/template/.pi/skills/yss-prototype-stage/references/search-date-patterns.md

@@ -0,0 +1,28 @@
+# 搜索选择与日期范围
+
+在选项较多、同名对象需要编号区分时选择 Combobox；少量固定选项继续使用 Select。日期条件包含起止日且只关心日历日时选择 RangeCalendar + Popover。先明确任务、数据和取消语义，再选择组件；本配方不覆盖远程搜索、多选、日期时间或时区转换。
+
+## 行为与教学入口
+
+`assets/vue-business-patterns/combined-query-standard.config.json` 演示组合查询；`owner-validity-standard.config.json` 演示负责人及有效期表单。`export-vue-patterns.mjs` 同时导出原五类模式、新变体、工作区及组件状态展示。全部是维护 fixture，不写入产品 Spec；参考日期固定为场景 JSON 的 `referenceDate`，不使用运行当天。
+
+| 决策 | 本轮教学合同 | 实现交接必须明确 |
+|---|---|---|
+| 搜索和值 | 搜索词只过滤本地名称/编号；正式值为稳定 ID；同名不同 ID 可区分 | 选项来源、ID 类型、权限和历史失效 ID；不能把名称当主键 |
+| 搜索状态 | 空结果、加载、失败重试、禁用和清空；失败保留词和值 | 哪些状态来自真实服务；恢复动作和错误码 |
+| 键盘 | 上下键、Enter、Escape；组合输入期间 Enter 不选中；取消不覆盖旧值 | 中文输入法、目标浏览器和辅助技术检查 |
+| 日期 | 纯 `YYYY-MM-DD`，起止均包含、同日合法、双空不限；单端、逆序、非法日期阻止应用并定位 | API 的日期格式、空值含义、区间端点；禁止隐式时间戳转换 |
+| 日期草稿 | 浮层独立草稿；应用才提交；取消/Escape 保留原值；清空先改临时值 | 保存、筛选和浮层应用的三个边界 |
+| 页面生命周期 | KeepAlive 保留已应用查询及表单草稿；关闭确认后重开初态；离页清理浮层 | 内存保留范围、刷新策略和逻辑焦点后继 |
+
+新增能力由固定 revision 的原始组件承担语义。本地 SearchSelect/DateRange 承担业务状态，主题在独立映射层；不修改 vendor 源文件。`@internationalized/date` 使用锁定的 3.12.4，禁止用 `new Date('YYYY-MM-DD')` 绕入时区语义。
+
+## 把设计疑问写成可观察任务
+
+“用户是否理解日期？”改成：“找出 2024-02-29 当天由 U-001 负责的资料，再取消一次日期修改；记录最终结果和条件。”观察是否选错同名 ID、是否应用单端日期、取消后能否辨认原条件。任务不给按钮名或点击顺序；成功标准可复核，模拟执行不填成真实用户观察。
+
+陌生角色、新主流程、复杂权限或恢复操作仍有未解问题时，进入 [条件式用户研究方法](usability-research.md)。业务范围仍由已有 Spec、交互说明和状态矩阵承载；研究材料不授予实现或批准资格。
+
+## 验证
+
+通过 [统一验证入口](prototype-verification.md) 运行来源/编译、原五类模式和新增浏览器场景。重点反例：文字假冒选择、非法 ID、重名误选、IME 误提交、未完成范围被应用、取消改值、失效触发器抢焦点。结果并入现有六轴 QA，不增加 schema 或批准字段。

package/template/.pi/skills/yss-prototype-stage/references/shadcn-integration.md

@@ -0,0 +1,5 @@
+# React shadcn 原型历史路线
+
+React 作者依赖、组件源码和构建入口已退役。新高保真使用 [shadcn-vue](shadcn-vue-integration.md)，轻量原型可用原生 HTML。生产 Vue/YSS 合同不变。
+
+已封存 `react-shadcn-prebuilt` 包和旧 React AntD 证据保留只读：仅通过 `prototype-contract.mjs validate-project --allow-legacy`（证据使用 `validate-evidence --allow-legacy`）核验原有内容与摘要。只读通过不代表当前门禁通过，不能使用 `seal-project` 重封存 React 包。继续修改时，从业务交互与场景输入构建新 Vue 包，重新进行当前 QA 和用户确认；不改旧批准资产。

package/template/.pi/skills/yss-prototype-stage/references/shadcn-vue-integration.md

@@ -0,0 +1,46 @@
+# shadcn-vue 作者路线
+
+新高保真优先 `vue-shadcn-prebuilt`：Vue 3 + shadcn-vue / Reka UI。H1/H2 仍表示验证深度，生产 Vue/YSS 技术栈和实现合同不变。React 作者路线已移除；[历史包](shadcn-integration.md)仅只读保留；原生 HTML 适合轻量修改与明确例外，不把原生 Select 的外观修饰称为组件接入。
+
+## 固定来源与适用边界
+
+`assets/shadcn-vue-authoring/registry-manifest.json` 登记官方仓库 `unovue/shadcn-vue`、固定 revision、27 组组件的原文件 URL / 摘要和 MIT 许可。Vue 组件由多个 `.vue` / `index.ts` 组成，不以文件个数或 CLI 版本冒充组件版本。工具链单独锁定 Vue、同版 compiler-sfc、Reka UI、图标及构建依赖；不运行 registry 自动探索或 latest 安装。
+
+优先按 [组件配方](component-recipes.md) 选择。官方 [Blocks](https://shadcn-vue.com/blocks) 提供页面组合参考；不整包引入 Sidebar、图表或额外业务规则。Table 是基础表格，当前示例的筛选、分页、选择来自本地已知行为，不宣称引入 TanStack Data Table。未登记组件先明确任务与验证范围。
+
+## 作者目录及构建
+
+在独立工具目录复制本 Skill 的 `assets/shadcn-vue-authoring/package.json` 与 `pnpm-lock.yaml`，用 `pnpm install --frozen-lockfile --ignore-scripts` 物化依赖；不要在共享 Skill 内安装。已物化工具可断网重复构建。配置 schema 保持 1：
+
+```json
+{"schema_version":1,"title":"资料查询","entry":"entry.ts","scenarios":"scenarios.json","density":"compact"}
+```
+
+```sh
+node .agents/skills/yss-prototype-stage/scripts/build-shadcn-vue-prototype.mjs \
+  --project-root "$PROJECT_ROOT" --feature records-vue --profile H2 \
+  --toolchain "$AUTHOR_TOOLS" --config "$AUTHOR_DIR/prototype.config.json"
+```
+
+入口可为 TS/JS，通过 `createApp` 挂载 `.vue` 页面；保留无 config 的查询 starter，以及 `--entry` 入口，两者互斥。CLI density 优先于 config；默认 compact，comfortable 可选。路径相对配置目录，不得越界或逃逸符号链接。支持本地 TS/JS、JSON、CSS、图片及 Vue SFC 的 script/script-setup、HTML template、普通/ scoped CSS；不执行外部块、自定义块、预处理器或 CSS module。依赖使用固定工具目录，组件别名为 `@/components/ui/<name>`；上游原始 registry 别名仅由构建器映射。
+
+Vue 在作者侧编译，接收者只拿到普通 HTML、IIFE、本地样式、场景与资源，无运行时模板编译、网络请求或安装要求。构建记录实际作者资源、使用的组件文件、固定依赖、锁、源码与主题摘要；临时目录验证后原子落盘，失败清理，非空目标拒绝覆盖。代码静态限制不是任意不可信代码沙箱；运行原型时仍须浏览器断网与交互验证。
+
+## 场景、组件与证据
+
+新企业原型使用 [企业工作区](enterprise-workspace.md) 应用壳，单页入口兼容，多页使用 `mountWorkspace(definition)`。构建 schema 和密度优先级不变。workspace-standard.config.json 和 workspace-glass.config.json 提供同输入演练，组合场景通过 `compose-workspace-scenarios.mjs --check` 绑定原始输入。
+
+用 `window.prototypeRuntime.initialize()` 获得当前场景的全新数据，根组件按 ticket 重建；Vue `nextTick` 后调用 `ready(ticket)`。Vue `app.config.errorHandler` 接入 `prototypeRuntime.showError`；错误调用 `fail` 并显示错误，未知 hash 不回退正常场景；每次切换清除草稿、菜单与 Teleport 浮层。初始化确认只证明声明的初始化完成，不代替行为断言。
+
+- Vue Select 用 `v-model`、`update:modelValue` 和 `--reka-select-trigger-width`；不复制 React 事件及 Radix CSS 变量。
+- Sheet/Dialog 关闭回到实际触发器，菜单转详情避免两个浮层抢焦点。
+- Field 显式关联 label、说明、错误和首错焦点；InputGroup 的边框与焦点环由外层统一。
+- 根 DESIGN 与本地 Token 角色决定主题；玻璃仅为已选示例外观，减少透明和减少动效均需计算样式验证。
+
+`export-vue-patterns.mjs --project-root "$PROJECT_ROOT" --output "$OUTPUT" --toolchain "$AUTHOR_TOOLS"` 输出原五类页面模式、搜索/日期两个变体、工作区和组件状态展示。完整配置、页面及共同场景在 `assets/vue-business-patterns/`；查询、只读、空态、加载、表单失败重试可复现。审批、冲突恢复、分析和组件状态展示同样使用 Vue 组件；不再需要 React 工具链。
+
+H2：`implementation.framework` / `component_basis` 为 `vue-shadcn-prebuilt`，`runtime_build_required=false`，`library_package=shadcn-vue`，来源 `source-snapshot`，填写固定 `registry_revision`、`build_provenance_ref`、组件覆盖、DESIGN / Token 摘要。H1 来源留在 adapter manifest。沿用 Prototype Evidence v4、Visual Baseline v1、比较 v2 和六轴 QA，不新增批准状态。
+
+使用 `prototype-contract.mjs validate-project` 校验新包；有 `--project-root` 时核验当前规范，无参数则验证便携快照。旧 React 包仅通过显式 `--allow-legacy` 只读校验，不能重新封存；迁移创建新目录，禁止改写旧批准资产。
+
+构建与实际浏览器验证统一走 [verify-prototype-design](prototype-verification.md)；缺工具或跳过不能报告通过。

package/template/.pi/skills/yss-prototype-stage/references/usability-research.md

@@ -0,0 +1,26 @@
+# 按问题选择用户研究
+
+新主流程、陌生业务角色、复杂权限或异常恢复仍有未解决的可用性问题时，准备小范围研究。已有证据足以回答当前问题时引用它及适用边界；不把每个原型变更都升级为研究门禁。项目已有强制批准仍按其合同执行。
+
+准备材料写入现有研究证据与 `design-qa.md`：问题、目标人群及纳入条件、无提示任务、固定场景、观察表、结果限制与待决事项。流程设计参考 [GOV.UK moderated usability testing](https://www.gov.uk/service-manual/user-research/using-moderated-usability-testing)。
+
+| 项目 | 可执行记录 |
+|---|---|
+| 问题 | 哪个具体决策缺证据？例如同名选项是否导致负责人选错 |
+| 参与者 | 实际承担任务的角色、经验、辅助技术/语言条件；排除与利益冲突理由 |
+| 任务 | 给目的与业务上下文，不给按钮名、路径或正确答案；记录完成标准与终止条件 |
+| 主持 | 统一说明本地模拟范围、同意方式及记录用途；中性追问，不提示操作 |
+| 观察 | 匿名参与者 ID、版本/包摘要、任务、成功/放弃、错误、恢复、求助及原话出处；时间仅在统一计时下比较 |
+| 结论 | 区分直接观察、解释和建议；样本/招募偏差、场景简化、未覆盖人群及未执行项 |
+
+教学任务：“找到闰日登记且由 U-002 负责的资料，修改日期后决定不采用修改。”预设数据来自组合查询 fixture；成功条件是负责人编号正确、结果正确、取消保持原范围。观察栏初始填“未执行”，不能填写模型想象的用户表现。
+
+## 后续真实效果试点交接（本轮不执行）
+
+| 任务 | 共同输入 | 观察指标 |
+|---|---|---|
+| 查询维护 | 同一 Spec/角色、同名 ID、空/失败/禁用选项、包含边界的固定日期和重置起点 | 正确率、误选、错误恢复、提示次数、完成时间 |
+| 复杂表单 | 同一字段/校验、权限、跨页草稿和失败重试场景 | 草稿丢失、输入与已选值混淆、错误定位、放弃率 |
+| 审批恢复 | 同一权限矩阵、部分失败和并发恢复来源 | 错误操作、重试范围、恢复结果与状态理解 |
+
+执行前另行确定参与者、模型/运行时与版本、预算、分组与顺序、停止条件和数据保管；不以工程测试数作为效果提升。Agent 试点沿用 `.template-source/scripts/skills-agent-eval.py`（分发环境没有该维护入口时由模板维护仓执行），固定共同输入与模型条件，保存真实轨迹和未完成记录。真实用户试点引用现有 `yss-research` 的 strategy-evidence 记录；不伪造研究结果、不从无样本的演示计算提升比例。

package/template/.pi/skills/yss-prototype-stage/scripts/browser-session.mjs

@@ -0,0 +1,57 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+
+// A standalone browser verification command owns these process groups only.
+// Evidence must be written outside profileDir. SIGKILL cannot run cleanup.
+export async function withBrowserSession(run) {
+  const profileDir = fs.mkdtempSync(path.join(os.tmpdir(), 'yss-browser-'));
+  fs.chmodSync(profileDir, 0o700);
+  const children = [];
+  let closing;
+  const alive = child => {
+    if (child.exitCode !== null || child.signalCode !== null) return false;
+    try { process.kill(child.pid, 0); return true; }
+    catch (error) { if (error.code === 'ESRCH') return false; throw error; }
+  };
+  const stop = (child, signal) => {
+    try { child.kill(signal); }
+    catch (error) { if (error.code !== 'ESRCH') throw error; }
+  };
+  const delay = ms => new Promise(resolve => setTimeout(resolve, ms));
+  const cleanup = () => closing ??= (async () => {
+    try {
+      for (const child of children) if (child.pid && alive(child)) stop(child, 'SIGTERM');
+      const deadline = Date.now() + 2000;
+      while (children.some(child => child.pid && alive(child)) && Date.now() < deadline) await delay(25);
+      for (const child of children) if (child.pid && alive(child)) stop(child, 'SIGKILL');
+      const killDeadline = Date.now() + 2000;
+      while (children.some(child => child.pid && alive(child)) && Date.now() < killDeadline) await delay(25);
+      if (children.some(child => child.pid && alive(child))) throw Error('owned browser process did not exit');
+      fs.rmSync(profileDir, {recursive: true});
+    } catch (error) {
+      process.stderr.write(`browser-session cleanup incomplete; retained ${profileDir}: ${error.message}\n`);
+      throw error;
+    }
+  })();
+  const handlers = new Map(['SIGINT', 'SIGTERM', 'SIGHUP'].map(signal => [signal, () => {
+    cleanup().then(() => process.exit({SIGINT:130,SIGTERM:143,SIGHUP:129}[signal]), () => process.exit(1));
+  }]));
+  for (const [signal, handler] of handlers) process.once(signal, handler);
+  try {
+    const result = await run({profileDir, spawn(executable, args, options = {}) {
+      if (closing) throw Error('browser-session is closing');
+      const child = spawn(executable, args, {...options, detached: process.platform !== 'win32', shell: false});
+      child.on('error', error => { child.sessionError = error; });
+      children.push(child);
+      return child;
+    }});
+    const failed = children.find(child => child.sessionError);
+    if (failed) throw failed.sessionError;
+    return result;
+  } finally {
+    try { await cleanup(); }
+    finally { for (const [signal, handler] of handlers) process.removeListener(signal, handler); }
+  }
+}