npm - create-yss-spec - Versions diffs - 3.0.0 → 3.1.0 - Mend

create-yss-spec 3.0.0 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2463) hide show

package/template/docs/design/preview.html CHANGED Viewed

@@ -3,18 +3,176 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>YSS Design System Preview</title>
-  <style>
-    :root { --primary:#3371ff; --primary-active:#245bdb; --text:rgba(0,0,0,.88); --secondary:rgba(0,0,0,.65); --layout:#f0f2f5; --surface:#fff; --subtle:#fafafa; --border:#d9d9d9; --selected:#e6f4ff; --success:#52c41a; --warning:#faad14; --error:#f5222d; font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif; }
-    * { box-sizing:border-box } body { margin:0; color:var(--text); background:var(--layout); font-size:14px; } .shell { max-width:1440px; margin:auto; padding:16px; } .toolbar { display:flex; gap:8px; flex-wrap:wrap; align-items:center; margin-bottom:12px; } h1,h2 { margin:0 0 12px; } h1 { font-size:24px; } h2 { font-size:18px; } .card { background:var(--surface); border:1px solid var(--border); border-radius:8px; padding:16px; margin-bottom:12px; } button,input,select { height:32px; border-radius:6px; border:1px solid var(--border); padding:0 12px; font:inherit; background:var(--surface); } button.primary { border-color:var(--primary); background:var(--primary); color:#000; font-weight:600; } button.primary:hover,button.primary:focus-visible { background:var(--primary-active); color:#fff; } button:disabled { background:#f0f0f0; color:rgba(0,0,0,.45); } input:focus-visible,select:focus-visible,button:focus-visible { outline:2px solid var(--primary); outline-offset:2px; } table { width:100%; border-collapse:collapse; } th,td { padding:8px 12px; border-bottom:1px solid var(--border); text-align:left; } th { background:var(--subtle); font-weight:600; } tr.selected { background:var(--selected); } .grid { display:grid; grid-template-columns:repeat(3,minmax(0,1fr)); gap:12px; } .status { padding:8px 12px; border-radius:4px; margin:8px 0; } .success { background:var(--success); color:#000; } .warning { background:var(--warning); color:#000; } .error { background:var(--error); color:#000; } .muted { color:var(--secondary); } @media (max-width:768px) { .shell { padding:12px; } .grid { grid-template-columns:1fr; } .toolbar > * { flex:1 1 140px; } table { min-width:620px; } .table-wrap { overflow-x:auto; } }
-  </style>
+  <meta name="theme-color" content="#f0f2f5">
+  <title>YSS Design System · Compact Preview</title>
+  <link rel="stylesheet" href="./preview.css">
 </head>
 <body>
-  <main class="shell">
-    <div class="toolbar"><h1>YSS 设计系统预览</h1><span class="muted">默认 / 紧凑密度</span><button class="primary" onclick="this.textContent='已保存'; this.disabled=true">保存</button><button disabled>禁用</button></div>
-    <section class="card"><h2>筛选与表单</h2><div class="toolbar"><input aria-label="关键词" placeholder="关键词"><select aria-label="状态"><option>全部状态</option><option>已启用</option></select><button class="primary">查询</button><button>重置</button></div><div class="status warning" role="status">请补充必填筛选条件。</div></section>
-    <section class="card"><h2>数据表格</h2><div class="table-wrap"><table><thead><tr><th>名称</th><th>状态</th><th>更新时间</th><th>操作</th></tr></thead><tbody><tr class="selected"><td>示例任务</td><td><span class="status success">成功</span></td><td>2026-09-02 09:30</td><td><button>查看</button></td></tr><tr><td>加载中的任务</td><td>加载中…</td><td>—</td><td><button disabled>编辑</button></td></tr><tr><td>失败任务</td><td><span class="status error">失败：权限不足</span></td><td>—</td><td><button>重试</button></td></tr></tbody></table></div></section>
-    <div class="grid"><section class="card"><h2>空状态</h2><p class="muted">暂无数据，请调整筛选条件。</p><button class="primary">创建记录</button></section><section class="card"><h2>弹层触发</h2><button onclick="alert('Modal / Drawer 应提供可见反馈和焦点管理')">打开 Modal</button></section><section class="card"><h2>无障碍</h2><p class="muted">使用 Tab 检查焦点顺序；缩放到 200% 检查布局。</p></section></div>
+  <main class="app-shell">
+    <header class="page-heading">
+      <div class="page-title-group">
+        <div class="eyebrow">YSS DESIGN SYSTEM</div>
+        <div class="title-line">
+          <h1>组件与状态预览</h1>
+          <span class="density-chip">紧凑模式 · 28px</span>
+        </div>
+        <p class="page-description">Ant Design v6 语义 Token · YSS 项目主题覆盖</p>
+      </div>
+      <div class="heading-actions">
+        <nav class="mode-switch" aria-label="主题预览">
+          <a href="./preview.html" aria-current="page">明亮</a>
+          <a href="./preview-dark.html">暗色</a>
+        </nav>
+        <button class="button button-primary" type="button" data-primary-action>保存规范</button>
+        <button class="button" type="button" disabled title="当前没有待提交的变更">提交</button>
+      </div>
+    </header>
+    <section class="panel" aria-labelledby="filter-title">
+      <div class="panel-heading">
+        <div>
+          <div class="panel-title-row">
+            <h2 id="filter-title">任务筛选</h2>
+            <span class="panel-description">保持单行扫描，空间不足时按字段组换行</span>
+          </div>
+        </div>
+        <span class="count-chip" data-count>3 条记录</span>
+      </div>
+      <div class="panel-body">
+        <form class="toolbar" data-filter-form>
+          <div class="field field-keyword">
+            <label for="keyword">任务名称</label>
+            <input id="keyword" class="control" type="search" placeholder="输入名称或编号" data-keyword>
+          </div>
+          <div class="field field-status">
+            <label for="status">运行状态</label>
+            <select id="status" class="control" data-status>
+              <option value="all">全部状态</option>
+              <option value="success">已完成</option>
+              <option value="processing">处理中</option>
+              <option value="error">失败</option>
+            </select>
+          </div>
+          <div class="toolbar-actions">
+            <button class="button button-text" type="button" data-reset>重置</button>
+            <button class="button button-primary" type="submit">查询</button>
+          </div>
+        </form>
+        <div class="notice notice-info filter-feedback" role="status">
+          <span>紧凑模式保留 14px 正文，以 28px 控件、8px 控件间距和 12px 区域节奏提升扫描效率。</span>
+        </div>
+      </div>
+    </section>
+    <section class="panel" aria-labelledby="table-title">
+      <div class="panel-heading">
+        <div class="panel-title-row">
+          <h2 id="table-title">任务列表</h2>
+          <span class="panel-description">状态使用浅色语义面，不使用高饱和整块填充</span>
+        </div>
+        <div class="table-actions">
+          <button class="button" type="button">导出</button>
+          <button class="button button-primary" type="button" data-dialog-trigger>新建任务</button>
+        </div>
+      </div>
+      <div class="table-wrap">
+        <table>
+          <colgroup>
+            <col style="width:34%">
+            <col style="width:16%">
+            <col style="width:16%">
+            <col style="width:20%">
+            <col style="width:14%">
+          </colgroup>
+          <thead>
+            <tr>
+              <th scope="col">名称</th>
+              <th scope="col">状态</th>
+              <th scope="col">责任人</th>
+              <th scope="col">更新时间</th>
+              <th scope="col">操作</th>
+            </tr>
+          </thead>
+          <tbody>
+            <tr data-record data-status="success" data-search="示例任务 yss-1024" aria-selected="true">
+              <td><span class="cell-main">示例任务</span><span class="cell-sub">YSS-1024 · 设计系统核验</span></td>
+              <td><span class="status-label status-success" data-row-status>已完成</span></td>
+              <td>陈墨</td>
+              <td>2026-09-02 09:30</td>
+              <td><button class="link-action" type="button">查看</button></td>
+            </tr>
+            <tr data-record data-status="processing" data-search="加载中的任务 yss-1025">
+              <td><span class="cell-main">加载中的任务</span><span class="cell-sub">YSS-1025 · Token 同步</span></td>
+              <td><span class="status-label status-processing" data-row-status>处理中</span></td>
+              <td>林晓</td>
+              <td>刚刚</td>
+              <td><button class="link-action" type="button" disabled>编辑</button></td>
+            </tr>
+            <tr data-record data-status="error" data-search="失败任务 yss-1026">
+              <td><span class="cell-main">失败任务</span><span class="cell-sub">YSS-1026 · 权限快照</span></td>
+              <td><span class="status-label status-error" data-row-status>权限不足</span></td>
+              <td>周屿</td>
+              <td>2026-09-02 08:46</td>
+              <td><button class="link-action" type="button" data-retry>重试</button></td>
+            </tr>
+            <tr data-empty-row hidden>
+              <td colspan="5"><span class="muted">没有符合当前筛选条件的任务。</span></td>
+            </tr>
+          </tbody>
+        </table>
+      </div>
+    </section>
+    <div class="support-grid">
+      <section class="panel" aria-labelledby="feedback-title">
+        <div class="panel-heading">
+          <h2 id="feedback-title">语义反馈</h2>
+          <span class="panel-description">颜色、边框与文本共同传达状态</span>
+        </div>
+        <div class="panel-body">
+          <div class="notice notice-success"><span>配置已同步，可进入下一步核验。</span></div>
+          <div class="notice notice-warning"><span>有 2 项变更等待维护者确认。</span></div>
+          <div class="notice notice-error" role="alert"><span>权限快照失败，请检查访问范围后重试。</span></div>
+        </div>
+      </section>
+      <section class="panel" aria-labelledby="empty-title">
+        <div class="panel-heading">
+          <h2 id="empty-title">空状态与无障碍</h2>
+          <span class="panel-description">下一步明确、焦点可见</span>
+        </div>
+        <div class="panel-body">
+          <div class="empty-state">
+            <div>
+              <p class="empty-title">暂无草稿</p>
+              <p class="muted">创建后即可验证 Modal、键盘焦点与操作反馈。</p>
+            </div>
+            <button class="button" type="button" data-dialog-trigger>创建草稿</button>
+          </div>
+          <ul class="check-list" aria-label="无障碍检查项">
+            <li>Tab 顺序符合视觉阅读顺序</li>
+            <li>200% 缩放时只有表格容器横向滚动</li>
+          </ul>
+        </div>
+      </section>
+    </div>
   </main>
+  <dialog class="dialog" data-dialog aria-labelledby="dialog-title">
+    <div class="dialog-header">
+      <h2 id="dialog-title">创建任务草稿</h2>
+      <button class="dialog-close" type="button" aria-label="关闭弹窗" data-dialog-close>关闭</button>
+    </div>
+    <div class="dialog-body">
+      <p>草稿只保存当前页面配置，不会触发正式发布或外部副作用。</p>
+    </div>
+    <div class="dialog-footer">
+      <button class="button" type="button" data-dialog-close>取消</button>
+      <button class="button button-primary" type="button" data-dialog-close>确认创建</button>
+    </div>
+  </dialog>
+  <div class="visually-hidden" aria-live="polite" data-live></div>
+  <script src="./preview.js"></script>
 </body>
 </html>

package/template/docs/design/preview.js ADDED Viewed

@@ -0,0 +1,71 @@
+const root = document.documentElement;
+const filterForm = document.querySelector("[data-filter-form]");
+const keywordInput = document.querySelector("[data-keyword]");
+const statusSelect = document.querySelector("[data-status]");
+const resetButton = document.querySelector("[data-reset]");
+const primaryButton = document.querySelector("[data-primary-action]");
+const count = document.querySelector("[data-count]");
+const emptyRow = document.querySelector("[data-empty-row]");
+const dialog = document.querySelector("[data-dialog]");
+const dialogTriggers = document.querySelectorAll("[data-dialog-trigger]");
+const dialogCloseButtons = document.querySelectorAll("[data-dialog-close]");
+const liveRegion = document.querySelector("[data-live]");
+const dataRows = [...document.querySelectorAll("tbody tr[data-record]")];
+function announce(message) {
+  liveRegion.textContent = message;
+}
+function applyFilters() {
+  const keyword = keywordInput.value.trim().toLowerCase();
+  const status = statusSelect.value;
+  let visible = 0;
+  dataRows.forEach((row) => {
+    const matchesKeyword = !keyword || row.dataset.search.includes(keyword);
+    const matchesStatus = status === "all" || row.dataset.status === status;
+    const matches = matchesKeyword && matchesStatus;
+    row.hidden = !matches;
+    if (matches) visible += 1;
+  });
+  count.textContent = `${visible} 条记录`;
+  emptyRow.hidden = visible !== 0;
+  announce(`筛选完成，共 ${visible} 条记录`);
+}
+filterForm.addEventListener("submit", (event) => {
+  event.preventDefault();
+  applyFilters();
+});
+resetButton.addEventListener("click", () => {
+  keywordInput.value = "";
+  statusSelect.value = "all";
+  applyFilters();
+  keywordInput.focus();
+  announce("筛选条件已重置");
+});
+primaryButton.addEventListener("click", () => {
+  const completedLabel = root.classList.contains("dark") ? "已发布" : "已保存";
+  primaryButton.textContent = completedLabel;
+  primaryButton.disabled = true;
+  announce(`${completedLabel}，操作已完成`);
+});
+dialogTriggers.forEach((button) => button.addEventListener("click", () => dialog.showModal()));
+dialogCloseButtons.forEach((button) => button.addEventListener("click", () => dialog.close()));
+document.querySelectorAll("[data-retry]").forEach((button) => {
+  button.addEventListener("click", () => {
+    const row = button.closest("tr");
+    const status = row.querySelector("[data-row-status]");
+    row.dataset.status = "processing";
+    status.className = "status-label status-processing";
+    status.textContent = "处理中";
+    button.textContent = "查看";
+    button.removeAttribute("data-retry");
+    announce("失败任务已重新提交，当前正在处理中");
+  });
+});

package/template/docs/design/schemas/visual-baseline.schema.json ADDED Viewed

@@ -0,0 +1,66 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.dev/schemas/visual-baseline-v1.json",
+  "title": "YSS Visual Baseline Contract",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "baseline_id", "feature", "version", "status", "bundle", "source", "capture_environment", "cases"],
+  "properties": {
+    "schema_version": {"const": 1},
+    "baseline_id": {"type": "string", "pattern": "^visual-baseline\\.[a-z0-9][a-z0-9-]*$"},
+    "feature": {"type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$"},
+    "version": {"type": "string", "pattern": "^v[1-9][0-9]*$"},
+    "status": {"enum": ["draft", "ready-for-human", "approved", "stale", "blocked"]},
+    "bundle": {
+      "type": "object", "additionalProperties": false,
+      "required": ["format", "root_ref", "digest", "size_bytes", "max_image_bytes", "max_bundle_bytes"],
+      "properties": {
+        "format": {"const": "portable-directory"}, "root_ref": {"type": "string", "minLength": 1},
+        "digest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"}, "size_bytes": {"type": "integer", "minimum": 0, "maximum": 104857600},
+        "max_image_bytes": {"const": 5242880}, "max_bundle_bytes": {"const": 104857600}
+      }
+    },
+    "source": {"$ref": "#/$defs/source"},
+    "capture_environment": {"$ref": "#/$defs/environment"},
+    "cases": {"type": "array", "minItems": 2, "items": {"$ref": "#/$defs/case"}}
+  },
+  "$defs": {
+    "digest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"},
+    "source": {
+      "type": "object", "additionalProperties": false,
+      "required": ["prototype_ref", "prototype_digest", "interaction_spec_ref", "interaction_spec_digest", "state_matrix_ref", "state_matrix_digest"],
+      "properties": {
+        "prototype_ref": {"type": "string", "pattern": "^sources/[^/]+$"}, "prototype_digest": {"$ref": "#/$defs/digest"},
+        "interaction_spec_ref": {"type": "string", "pattern": "^sources/[^/]+$"}, "interaction_spec_digest": {"$ref": "#/$defs/digest"},
+        "state_matrix_ref": {"type": "string", "pattern": "^sources/[^/]+$"}, "state_matrix_digest": {"$ref": "#/$defs/digest"}
+      }
+    },
+    "environment": {
+      "type": "object", "additionalProperties": false,
+      "required": ["browser", "browser_version", "operating_system", "fonts_digest", "device_scale_factor", "color_space", "locale", "timezone", "animations_disabled", "cursor_hidden", "capture_script_ref", "capture_script_digest", "capture_result_ref", "capture_result_digest"],
+      "properties": {
+        "browser": {"const": "chromium"}, "browser_version": {"type": "string", "minLength": 1}, "operating_system": {"type": "string", "minLength": 1},
+        "fonts_digest": {"$ref": "#/$defs/digest"}, "device_scale_factor": {"const": 1}, "color_space": {"const": "srgb"},
+        "locale": {"type": "string", "minLength": 1}, "timezone": {"type": "string", "minLength": 1},
+        "animations_disabled": {"const": true}, "cursor_hidden": {"const": true},
+        "capture_script_ref": {"type": "string", "pattern": "^capture/[^/]+$"}, "capture_script_digest": {"$ref": "#/$defs/digest"},
+        "capture_result_ref": {"type": "string", "pattern": "^capture/[^/]+$"}, "capture_result_digest": {"$ref": "#/$defs/digest"}
+      }
+    },
+    "case": {
+      "type": "object", "additionalProperties": false,
+      "required": ["case_id", "route", "page", "state", "viewport", "theme", "locale", "data_scenario", "image_ref", "image_digest", "image_size_bytes", "mask_ref", "mask_digest", "mask_size_bytes", "semantic_refs", "allowed_differences", "result"],
+      "properties": {
+        "case_id": {"type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$"}, "route": {"type": "string", "minLength": 1}, "page": {"type": "string", "minLength": 1}, "state": {"type": "string", "minLength": 1},
+        "viewport": {"type": "object", "additionalProperties": false, "required": ["name", "width", "height", "scroll_mode", "scroll_position"], "properties": {"name": {"type": "string", "minLength": 1}, "width": {"type": "integer", "minimum": 1}, "height": {"type": "integer", "minimum": 1}, "scroll_mode": {"enum": ["viewport", "segment"]}, "scroll_position": {"type": "integer", "minimum": 0}}},
+        "theme": {"type": "string", "minLength": 1}, "locale": {"type": "string", "minLength": 1}, "data_scenario": {"type": "string", "minLength": 1},
+        "image_ref": {"type": "string", "pattern": "^images/[^/]+\\.png$"}, "image_digest": {"$ref": "#/$defs/digest"}, "image_size_bytes": {"type": "integer", "minimum": 1, "maximum": 5242880},
+        "mask_ref": {"anyOf": [{"const": "not-applicable"}, {"type": "string", "pattern": "^masks/[^/]+\\.png$"}]},
+        "mask_digest": {"anyOf": [{"const": "not-applicable"}, {"$ref": "#/$defs/digest"}]},
+        "mask_size_bytes": {"type": "integer", "minimum": 0, "maximum": 5242880},
+        "semantic_refs": {"type": "array", "minItems": 1, "items": {"type": "string", "pattern": "^sources/[^/]+$"}},
+        "allowed_differences": {"type": "array", "items": {"type": "string", "minLength": 1}}, "result": {"const": "passed"}
+      }
+    }
+  }
+}

package/template/docs/design/templates/interaction-spec-template.md CHANGED Viewed

@@ -12,8 +12,8 @@
 | Discovery | `docs/.scratch/<feature>/discovery/<feature>-discovery.md` | 可选 |
 | 原型阶段合同 / Product Design 路由 | `yss-prototype-stage -> product-design:index -> <focused skill>` | 必需；记录 `$get-context`、`$ideate`、`$prototype`、`$image-to-code` 或 `$url-to-code` |
 | 原型 / 线框图 | `<链接或导出图片路径>` | Excalidraw / Figma / Penpot / tldraw / Axure / Markdown |
-| 高保真 HTML 原型 | `docs/.scratch/<feature>/design/prototypes/index.html` | 低保真原型评审通过后补齐；主题/视觉标准必须为 Ant Design v6，标准 React 组件锁定 antd@6，生产映射为 YSS UI + Ant Design Vue 4.x；产出后必须获得用户确认 |
-| 原型验证清单 | `docs/.scratch/<feature>/verification/prototype-evidence.yaml` | 记录实际 CLI / AntD 版本、CLI JSON 输出、浏览器验证和阻塞项 |
+| 原型交付物 | `docs/.scratch/<feature>/design/prototypes/index.html` 或稳定 URL | 低保真评审后按 H1/H2 档位补齐；H2 AntD 条件取事实；真实组件待验事项交接到前端实现计划，产出后必须获得用户确认 |
+| 原型验证清单 | `docs/.scratch/<feature>/verification/prototype-evidence.yaml` | 记录 schema v4 档位、浏览器、统一 Design QA、Visual Baseline case、条件组件证据和阻塞项 |
 | 现有 API 草案 | `docs/.scratch/<feature>/api/<feature>.yaml` | 可选；通常应先完成产品设计和 Spec 校准 |
 ## 2. 页面地图
@@ -105,8 +105,8 @@
 - loading、empty、error、no-permission、readonly、conflict、dirty-form 状态已展示，或明确不适用。
 - 每个表格列、筛选条件、表单字段、抽屉、弹窗和按钮都有数据来源或契约反推说明。
 - 设计可以拆成独立可演示的垂直切片。
-- 低保真原型评审通过后，高保真 HTML 原型使用 Ant Design v6 主题/视觉标准覆盖主流程、关键状态和响应式断点，并记录到生产 YSS UI/Ant Design Vue 4.x 的语义映射。
-- 原型产出前已使用 `antd` CLI 查询设计语言、组件 API、demo、token 和 semantic 信息；原型产出后已在 `prototype-evidence.yaml` 记录实际版本、CLI 与浏览器验证证据。
+- 低保真评审通过后，记录档位触发与待确认决定；H1 覆盖视觉和少量交互，H2 覆盖主流程/关键异常。
+- H2 只有实际使用 React AntD 且 fact pack 不新鲜时才执行增量 CLI 查询；H1 不创建 AntD 证据。任何原型档位都不得调用 `yss-ui` 或声明已验证真实生产组件。
 ## 9. 决策与未决问题

package/template/docs/design/templates/product-overview-design-template.md CHANGED Viewed

@@ -46,19 +46,19 @@ owner: ai
 |--------|-------------|----------|--------|------|--------|
 |  |  |  | P0 / P1 / P2 |  |  |
-## 6. Strategic DDD Check（轻量）
+## 6. 业务边界与协作检查（轻量）
 > 本节嵌入产品总体设计 / 功能架构，不新增独立阶段。只有当上下文数量多、协作关系复杂或边界争议无法在本节说明时，才升级为 `docs/.scratch/<feature>/architecture/<feature>-strategic-design.md`。
-| 限界上下文 | 核心职责 | 统一语言 / 关键术语 | 上游 / 下游 / 协作关系 | 对应功能域 / 页面 / API | 非目标 |
+| 业务责任区 | 核心职责 | 统一业务词汇 / 关键术语 | 规则提供方 / 使用方 / 协作关系 | 对应功能域 / 页面 / API | 非目标 |
 |------------|----------|---------------------|-------------------------|--------------------------|--------|
 |  |  |  |  |  |  |
-战略设计就绪检查：
+业务边界与协作就绪检查：
-- [ ] 统一语言已与 `CONTEXT.md` 对齐，新增术语已列出回填项。
+- [ ] 统一业务词汇已与 `CONTEXT.md` 对齐，新增术语已列出回填项。
 - [ ] 核心域、支撑域、通用域或“不适用”的判断已明确。
-- [ ] 每个 P0 能力都能归属到一个限界上下文或明确为跨上下文协作。
+- [ ] 每个 P0 能力都能归属到一个业务责任区或明确为跨责任区协作。
 - [ ] 上下文协作关系已说明，不把内部模型直接泄露为跨上下文契约。
 - [ ] 本节足以支撑 Spec 校准和 API 影响分析 / 契约草案；否则列为阻断项。
@@ -113,7 +113,7 @@ owner: ai
 - [ ] 用户主流程和异常路径已覆盖 MVP。
 - [ ] 业务对象、状态和关系不会与 `CONTEXT.md` 术语冲突。
 - [ ] 功能域、模块边界和优先级清楚。
-- [ ] Strategic DDD Check 已完成，或明确说明本次变更不影响领域边界。
+- [ ] 业务边界与协作检查已完成，或明确说明本次变更不影响业务责任边界。
 - [ ] 页面、API、数据、权限和审计影响已显式标注。
 - [ ] 低保真原型 / 页面草图已覆盖 P0 页面、主流程和关键异常路径，并能支撑后续交互设计。
 - [ ] Spec 回填项已列出，并分清阻断项和非阻断项。

package/template/docs/design/templates/prototype-confirmation-template.md CHANGED Viewed

@@ -1,6 +1,6 @@
-# <功能名称> 高保真原型确认记录
+# <功能名称> 原型交付物确认记录
-> 适用时机：Ant Design v6 主题/视觉标准高保真 HTML 原型产出后、Spec 校准 / 需求冻结 / UI 驱动 OpenAPI Draft 前。生产 API 仍为 YSS UI + Ant Design Vue 4.x；未确认前不得进入下游门禁。
+> 适用时机：H1/H2 原型交付物验证后、Spec 校准 / 需求冻结 / UI 驱动 OpenAPI Draft 前。用户只确认设计决定、可操作范围与模拟/gap；未确认前不得进入下游门禁。
 ## 1. 原型信息
@@ -12,24 +12,22 @@
 | 交互说明 | `docs/.scratch/<feature>/design/<feature>-interaction-spec.md` |
 | 状态矩阵 | `docs/.scratch/<feature>/design/<feature>-state-matrix.md` |
 | 原型评审 | `docs/.scratch/<feature>/design/<feature>-prototype-review.md` |
-| 高保真 HTML 原型 | `docs/.scratch/<feature>/design/prototypes/index.html` |
+| 原型档位与交付物 | `<H1/H2>`；`docs/.scratch/<feature>/design/prototypes/index.html` 或稳定 URL |
 | 机器可读验证清单 | `docs/.scratch/<feature>/verification/prototype-evidence.yaml` |
-| Product Design 路由 | `product-design:index -> <focused skill>` |
+| 原型路由 | `yss-prototype-stage -> H1/H2 -> <adapter>` |
 | 产出方式 | 系统 / Agent 自动产出 / 人工补充 |
-| Ant Design 目标版本 | `<实际项目选择的 v6 版本>` |
-## 2. AntD CLI 校验证据
+## 2. 用户需要确认的范围
-| 校验项 | 命令 / 记录路径 | 结论 |
+| 项目 | 内容 |
 |---|---|---|
-| 设计语言 | `antd design.md --format json` |  |
-| 组件 API | `antd info <Component> --version <target_antd_version> --format json` |  |
-| 组件 demo | `antd demo <Component> <demo> --version <target_antd_version> --format json` |  |
-| 组件 token | `antd token <Component> --version <target_antd_version> --format json` |  |
-| semantic | `antd semantic <Component> --version <target_antd_version> --format json` |  |
-| lint / 替代校验 | `antd lint <prototype path> --format json` |  |
-CLI 实际版本、目标 AntD 版本、完整 JSON 输出与浏览器验证结论以 `prototype-evidence.yaml` 为准；不得用本文中的示例版本替代实际记录。
+| 本原型确认的决定 |  |
+| 可操作范围 |  |
+| 模拟数据 / 模拟行为 |  |
+| 未关闭 gap |  |
+| 接受的差异或非目标 |  |
+技术栈、CLI、lockfile、digest 和扫描结果由 `prototype-evidence.yaml` 自动或工程验证记录，不要求用户确认。
 ## 3. 用户确认