create-yss-spec 1.1.2 → 1.1.3

package/template/.codex/skills/product-design/skills/user-context/scripts/user_context_preflight.py

@@ -0,0 +1,204 @@
+#!/usr/bin/env python3
+"""Read local Product Design context and print compact JSON."""
+
+from __future__ import annotations
+
+import argparse
+import hashlib
+import json
+import os
+import re
+import sys
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any
+
+PLUGIN_STATE_DIR = Path("state/plugins/product-design")
+DEFAULT_MAX_CONTEXT_BYTES = 2_000_000
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(
+        description="Read Product Design user-context.md and return saved context as JSON."
+    )
+    parser.add_argument(
+        "--codex-home",
+        type=Path,
+        default=None,
+        help="Codex home directory. Defaults to $CODEX_HOME or ~/.codex.",
+    )
+    parser.add_argument(
+        "--state-dir",
+        type=Path,
+        default=None,
+        help="Override the Product Design state directory.",
+    )
+    parser.add_argument(
+        "--max-context-bytes",
+        type=int,
+        default=DEFAULT_MAX_CONTEXT_BYTES,
+        help="Maximum user-context.md size to read.",
+    )
+    return parser.parse_args()
+
+
+def resolve_state_dir(codex_home: Path | None, state_dir: Path | None) -> Path:
+    if state_dir is not None:
+        return state_dir.expanduser().resolve()
+    home = codex_home or Path(os.environ.get("CODEX_HOME", "~/.codex"))
+    return (home.expanduser() / PLUGIN_STATE_DIR).resolve()
+
+
+def file_mtime(path: Path) -> str | None:
+    try:
+        return datetime.fromtimestamp(path.stat().st_mtime, tz=timezone.utc).isoformat()
+    except OSError:
+        return None
+
+
+def sha256_text(text: str) -> str:
+    return hashlib.sha256(text.encode("utf-8")).hexdigest()
+
+
+def parse_resource_name(line: str) -> dict[str, str]:
+    link_match = re.match(r"^\[(.+?)\]\((.+?)\)\s*$", line)
+    if link_match:
+        return {"name": link_match.group(1).strip(), "url": link_match.group(2).strip()}
+    url_match = re.match(r"^(https?://\S+)\s*$", line)
+    if url_match:
+        return {"name": url_match.group(1).strip(), "url": url_match.group(1).strip()}
+    return {"name": line.strip()}
+
+
+def summarize_user_context(markdown: str) -> dict[str, Any]:
+    entries: list[dict[str, Any]] = []
+    unresolved_categories: list[str] = []
+    category: str | None = None
+    in_saved_context = False
+    current_entry: dict[str, Any] | None = None
+
+    def flush_entry() -> None:
+        nonlocal current_entry
+        if current_entry:
+            entries.append(current_entry)
+            current_entry = None
+
+    for raw_line in markdown.splitlines():
+        line = raw_line.strip()
+        if not line or line.startswith(("<!--", "-->")):
+            continue
+
+        category_match = re.match(r"^# ([^#].*?)\s*$", line)
+        if category_match:
+            flush_entry()
+            category = category_match.group(1).strip()
+            in_saved_context = False
+            continue
+
+        if line == "## Saved Links And Context":
+            flush_entry()
+            in_saved_context = True
+            continue
+
+        if not category or not in_saved_context:
+            continue
+
+        if line.casefold() == "status: not provided" or line.casefold() == "status: not provided.":
+            flush_entry()
+            unresolved_categories.append(category)
+            continue
+
+        if not line.startswith("- "):
+            flush_entry()
+            current_entry = {"category": category, **parse_resource_name(line)}
+            continue
+
+        if not current_entry:
+            continue
+
+        bullet = line[2:].strip()
+        for prefix, key in (
+            ("Date Added:", "date_added"),
+            ("File:", "file"),
+            ("Useful Context:", "useful_context"),
+            ("Future Use:", "future_use"),
+        ):
+            if bullet.startswith(prefix):
+                current_entry[key] = bullet[len(prefix) :].strip().rstrip(".")
+                break
+        else:
+            current_entry.setdefault("notes", []).append(bullet)
+
+    flush_entry()
+    return {"entries": entries, "unresolved_categories": unresolved_categories}
+
+
+def missing_payload(state_dir: Path, context_path: Path) -> dict[str, Any]:
+    return {
+        "plugin": "product-design",
+        "state_dir": str(state_dir),
+        "user_context": {
+            "path": str(context_path),
+            "exists": False,
+            "status": "missing",
+            "entries": [],
+            "unresolved_categories": [],
+        },
+    }
+
+
+def main() -> int:
+    args = parse_args()
+    state_dir = resolve_state_dir(args.codex_home, args.state_dir)
+    context_path = state_dir / "user-context.md"
+
+    if not context_path.exists():
+        print(json.dumps(missing_payload(state_dir, context_path), indent=2))
+        return 0
+
+    size = context_path.stat().st_size
+    if size > args.max_context_bytes:
+        print(
+            json.dumps(
+                {
+                    "plugin": "product-design",
+                    "state_dir": str(state_dir),
+                    "user_context": {
+                        "path": str(context_path),
+                        "exists": True,
+                        "status": "too_large",
+                        "size_bytes": size,
+                        "max_context_bytes": args.max_context_bytes,
+                        "entries": [],
+                        "unresolved_categories": [],
+                    },
+                },
+                indent=2,
+            )
+        )
+        return 0
+
+    markdown = context_path.read_text(encoding="utf-8")
+    summary = summarize_user_context(markdown)
+    print(
+        json.dumps(
+            {
+                "plugin": "product-design",
+                "state_dir": str(state_dir),
+                "user_context": {
+                    "path": str(context_path),
+                    "exists": True,
+                    "status": "present",
+                    "sha256": sha256_text(markdown),
+                    "modified_at": file_mtime(context_path),
+                    **summary,
+                },
+            },
+            indent=2,
+        )
+    )
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/template/.codex/skills/product-design/templates/prototype/AGENTS.md

@@ -0,0 +1,7 @@
+# Prototype Instructions
+
+Run the local server yourself and open the preview in the in-app browser. Do not give the user server-start instructions when you can run it.
+
+Before making substantial visual changes, use the Product Design plugin's `get-context` skill when the visual source is unclear or no longer matches the current goal. When the user gives durable prototype-specific design feedback, preferences, or decisions, record them in `AGENTS.md`.
+
+When implementing from a selected generated mock, treat that image as the source of truth for layout, component anatomy, density, spacing, color, typography, visible content, and hierarchy.

package/template/.codex/skills/product-design/templates/prototype/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Prototype</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.jsx"></script>
+  </body>
+</html>

package/template/.codex/skills/product-design/templates/prototype/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "design-prototype",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite --host 127.0.0.1",
+    "build": "vite build",
+    "preview": "vite preview --host 127.0.0.1"
+  },
+  "dependencies": {
+    "@vitejs/plugin-react": "5.0.4",
+    "vite": "6.4.2",
+    "react": "19.2.0",
+    "react-dom": "19.2.0"
+  },
+  "devDependencies": {}
+}

package/template/.codex/skills/product-design/templates/prototype/src/App.jsx

@@ -0,0 +1,5 @@
+export function App() {
+  return (
+    <main></main>
+  );
+}

package/template/.codex/skills/product-design/templates/prototype/src/main.jsx

@@ -0,0 +1,10 @@
+import React from "react";
+import { createRoot } from "react-dom/client";
+import { App } from "./App.jsx";
+import "./styles.css";
+
+createRoot(document.getElementById("root")).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>,
+);

package/template/.codex/skills/product-design/templates/prototype/src/styles.css

@@ -0,0 +1,13 @@
+:root {
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  min-width: 320px;
+  min-height: 100vh;
+  -webkit-font-smoothing: antialiased;
+}

package/template/.codex/skills/product-design/templates/prototype/vite.config.mjs

@@ -0,0 +1,14 @@
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+
+export default defineConfig({
+  optimizeDeps: {
+    include: ["react", "react-dom/client"],
+  },
+  server: {
+    warmup: {
+      clientFiles: ["./src/main.jsx"],
+    },
+  },
+  plugins: [react()],
+});

package/template/.codex/skills/yss-product-lifecycle/SKILL.md

@@ -91,7 +91,7 @@ Use `excalidraw-diagram-generator` when diagrams will make boundaries, flows, da
    - persistence, metadata, versioning, lineage, query, or index -> system / data architecture, engineering contract, and Design Review downstream gates.
 4. Check whether required upstream artifacts exist.
    - Before PRD calibration, product design, API impact analysis, OpenAPI Draft, requirement freeze, or formal vertical slicing, verify PRD baseline and product overview design / functional architecture exist. If the task does not enter the PRD lifecycle, record the not-applicable reason in the impact assessment.
-   - For UI work, before PRD calibration, API impact analysis, OpenAPI Draft, or requirement freeze, verify low-fidelity `prototype-review` is approved and `docs/design/prototypes/<feature>/index.html` exists as an Ant Design v6 high-fidelity HTML prototype.
+   - For UI work, before PRD calibration, API impact analysis, OpenAPI Draft, or requirement freeze, verify low-fidelity `prototype-review` is approved, `docs/design/prototypes/<feature>/index.html` exists as an Ant Design v6 high-fidelity HTML prototype, AntD v6 CLI validation evidence is recorded, and user confirmation is recorded after the prototype is produced. This prototype is a required lifecycle artifact and may be generated automatically by the system / Agent after low-fidelity prototype review; it does not have to be manually supplied by the user.
    - Before formal vertical slicing, verify PRD, product overview design / functional architecture, OpenAPI Freeze or no-API-impact record, architecture review as needed, and a clear issue destination.
    - For medium/high-risk API, permission, state-machine, data-model, cross-client, new-module, or safety-sensitive changes, verify an OpenSpec-style Spec Delta exists or record why it is not needed.
    - Before frontend/backend implementation, verify vertical slice scope, implementation repo/location, whether the impacted frontend/backend runtime projects already exist and are reusable, YSS skill routing, Build Architecture Checklist, test command, and review strategy.
@@ -143,9 +143,9 @@ Default routing:
 |---|---|
 | Start a new business product/module | intake -> opportunity and Discovery -> `competitive-intelligence` when market / competitor facts are needed -> `grill-with-docs` -> `to-prd` -> product overview design / functional architecture -> product design and requirement freeze when UI exists |
 | Analyze competitors, substitute workflows, pricing, positioning, or market facts | `competitive-intelligence`; then feed stable findings into `grill-with-docs` and `to-prd` |
-| Design UI flow after PRD baseline | Verify product overview design / functional architecture first, then use `product-design-prototype`; add `wireframe-prototype` only when a low-fidelity page or flow sketch is needed |
+| Design UI flow after PRD baseline | Verify product overview design / functional architecture first, then use `product-design:index` as the primary Product Design router; follow its focused routing such as `$get-context`, `$ideate`, `$prototype`, `$image-to-code`, or `$url-to-code` |
 | Review low-fidelity prototype before high-fidelity design | `prototype-review` |
-| Build high-fidelity interactive HTML prototype | `high-fidelity-html-prototype` with Ant Design v6 after low-fidelity prototype review is approved |
+| Build high-fidelity interactive HTML prototype | Use `product-design:index` as the primary entrypoint and route to the appropriate Product Design focused workflow for prototype/code output; query AntD v6 design/component/demo/token/semantic facts with `antd` CLI before output; the required stage output must be Ant Design v6 HTML at `docs/design/prototypes/<feature>/index.html`, may be system / Agent generated, must record AntD CLI validation evidence, and must be confirmed by the user before downstream gates |
 | Review contract draft / OpenAPI Draft inside architecture/design review | `yss-openapi-draft-review` |
 | Record behavior deltas for medium/high-risk changes | OpenSpec-style Spec Delta at `docs/specs/<feature>-spec-delta.md` using `docs/templates/spec-delta-template.md` |
 | Clarify architecture artifact timing or gaps | this skill plus `docs/process/lifecycle-artifact-map.md` and `references/artifact-checklist.md` |

package/template/AGENTS.md

@@ -68,9 +68,9 @@ yss-product-lifecycle
 -> grill-with-docs
 -> to-prd
 -> product overview design / functional architecture
--> product-design-prototype
+-> product-design:index
 -> prototype-review
--> high-fidelity-html-prototype
+-> Product Design focused skill 产出高保真 HTML 原型并经用户确认
 -> OpenAPI Draft
 -> OpenSpec-style Spec Delta (中高风险行为变化时)
 -> OpenAPI Freeze
@@ -132,7 +132,7 @@ Matt skills 与 YSS skills 产物正文默认使用中文，包括澄清记录
 - PRD 基线阶段必须同步明确功能架构：功能域、模块边界、优先级、MVP / 非目标范围和模块依赖；不清晰时不得进入 PRD 校准。
 - 只要进入 PRD 初稿 / 需求基线流程，产品总体设计 / 功能架构就是必要产物，默认路径为 `docs/design/<feature>-product-overview-design.md`，且必须包含低保真原型 / 页面草图。不得直接从 PRD 初稿进入页面 / 原型 / 交互设计、OpenAPI Draft、PRD 校准、需求冻结或实现；不进入 PRD 生命周期的小文案、低风险 Bug 或局部配置变更，必须在影响面评估中说明不适用原因。
 - 涉及页面设计、原型评审、UI 实现、组件选型、主题 token、颜色排版间距或 Ant Design / YSS UI 风格一致性的任务，必须先用 `yss-design-system` 作为设计系统基线；详细规范引用 `docs/design/design-system.md`。
-- 有用户界面的功能在 PRD 初稿和产品总体设计 / 功能架构后必须先引用 `yss-design-system`，再用 `product-design-prototype` 产出页面、原型、交互状态、PRD 回填项和 OpenAPI 反推清单；低保真 `prototype-review` 通过后，必须新增 `high-fidelity-html-prototype` 产物，默认路径为 `docs/design/prototypes/<feature>/index.html`，且必须使用 Ant Design v6，之后才能进入 PRD 校准 / 需求冻结和 UI 驱动的 OpenAPI Draft。
+- 有用户界面的功能在 PRD 初稿和产品总体设计 / 功能架构后必须先引用 `yss-design-system`，再以 `product-design:index` 作为产品原型产出主入口，按 Product Design plugin 路由到 `$get-context`、`$ideate`、`$prototype`、`$image-to-code`、`$url-to-code` 等 focused skill，产出页面、原型、交互状态、PRD 回填项和 OpenAPI 反推清单；低保真 `prototype-review` 通过后，必须产出高保真 HTML 原型，默认路径为 `docs/design/prototypes/<feature>/index.html`，且必须使用 Ant Design v6。原型产出前必须使用 `antd` CLI 查询设计语言、组件 API、demo、token 和 semantic 信息；原型完成后必须记录 AntD v6 校验证据。该高保真 HTML 原型是流程必需产物，可由系统 / Agent 在低保真评审通过后自动产出，不要求用户手工提供；产出后必须获得用户确认并记录确认结果，未产出或未确认前不得进入 PRD 校准 / 需求冻结和 UI 驱动的 OpenAPI Draft。
 - 任何 API 契约变更必须先在 `docs/api/specs/*.yaml` 形成 Draft；OpenAPI 不得只基于 PRD 反推，必须结合产品总体设计 / 功能架构；有 UI 的功能还必须结合页面/原型/交互说明、状态矩阵、`prototype-review` 结论和 Ant Design v6 高保真 HTML 原型，经工程基线（如适用）、系统 / 数据架构和设计审查后 Freeze，再实现前后端和测试。
 - API、权限、状态机、数据模型、跨端、新模块或高风险行为变化，应在 Design Review / OpenAPI Freeze 前补充 OpenSpec-style Spec Delta，落点为 `docs/specs/<feature>-spec-delta.md`；小文案、局部样式、配置微调和低风险 Bug 默认不需要。Spec Delta 只记录行为差异、验收场景和测试映射，不恢复 OpenSpec CLI、额外变更目录或状态机。
 - OpenAPI Freeze 后进入 `to-issues`，将冻结范围拆成端到端垂直切片 Issue；不得要求额外状态机或变更目录作为交付前置。

package/template/docs/adr/adr-product-design-prototype-entrypoint.md

@@ -0,0 +1,54 @@
+# ADR-001: 使用 product-design:index 作为产品原型主入口
+
+## 状态
+
+已接受
+
+## 日期
+
+2026-07-06
+
+## 背景
+
+YSS Harness 需要把有 UI 功能的产品原型产出收敛到一个稳定入口，同时保留需求质询、设计系统、Ant Design v6 事实校验、原型评审和用户确认门禁。原有 `product-design-prototype`、`wireframe-prototype`、`high-fidelity-html-prototype` 容易被理解为并列主入口，导致 Agent 在不同阶段选择不同原型工具，难以保证高保真 HTML 原型、AntD v6 校验证据和用户确认记录一致落地。
+
+## 决策
+
+产品原型产出统一以 `product-design:index` 为主入口。该 skill 只负责路由，实际按 Product Design plugin 规则进入 `$get-context`、`$ideate`、`$prototype`、`$image-to-code`、`$url-to-code`、`$design-qa` 或 `$share` 等 focused skill。
+
+`grill-with-docs` 保留为前置需求质询和领域边界澄清工具，不承担 HTML 原型产出。`antd` skill / `antd` CLI 作为 Ant Design v6 组件、demo、token、semantic 和 design.md 的事实来源。YSS 生命周期继续负责 `prototype-review`、用户确认、PRD 回填和 OpenAPI Draft 门禁。
+
+## 考虑的替代方案
+
+| 方案 | 优点 | 缺点 | 结论 |
+|------|------|------|------|
+| 继续使用多个原型技能并列入口 | 对旧流程改动少 | Agent 路由不稳定，难以统一 AntD v6 高保真 HTML 原型和确认记录 | 放弃 |
+| 只保留 `high-fidelity-html-prototype` | 产物目标直接 | 缺少 Product Design plugin 的上下文、视觉探索、URL / 图片 / 代码来源路由能力 | 放弃 |
+| 以 `product-design:index` 为主入口，旧技能保留兼容 | 路由统一，可复用 focused skills，迁移风险低 | 需要在文档中明确 legacy 边界 | 采纳 |
+
+## 后果
+
+### 正面影响
+
+- 有 UI 的产品原型产出入口统一。
+- 高保真 HTML 原型、AntD CLI 校验证据和用户确认记录成为固定门禁。
+- Figma / Axure / Excalidraw / 截图 / URL 可作为输入来源，而不是主交付格式。
+
+### 负面影响
+
+- 需要维护完整 `.codex/skills/product-design/` 插件目录，不能只复制 `index/SKILL.md`。
+- 旧原型技能在过渡期仍会存在，需要通过流程文档限制使用语境。
+
+### 风险
+
+- 如果 Agent 未读取 Product Design focused skill，可能误把 `product-design:index` 当作直接产出技能。
+- 如果跳过 `antd` CLI 查询，原型可能偏离 Ant Design v6 组件 API 或 token。
+- 如果缺少用户确认记录，下游 PRD 校准和 OpenAPI Draft 会失去体验冻结依据。
+
+## 相关
+
+- `AGENTS.md`
+- `docs/process/product-prototype-workflow.md`
+- `docs/process/lifecycle-artifact-map.md`
+- `docs/design/README.md`
+- `docs/design/templates/prototype-confirmation-template.md`

package/template/docs/api/templates/openapi-draft-review-checklist.md

@@ -16,7 +16,9 @@
 | 原型 / 线框图 |  |  |
 | 状态矩阵 | `docs/design/<feature>-state-matrix.md` |  |
 | 原型评审结论 | `docs/design/<feature>-prototype-review.md` |  |
-| 高保真 HTML 原型 | `docs/design/prototypes/<feature>/index.html` | 有 UI 时必需；必须使用 Ant Design v6 |
+| 高保真 HTML 原型 | `docs/design/prototypes/<feature>/index.html` | 有 UI 时必需；必须使用 Ant Design v6，并通过 `product-design:index` 路由产出或记录例外原因 |
+| AntD CLI 校验证据 | `docs/design/<feature>-prototype-confirmation.md` 或评审记录 | 有 UI 时必需；记录 design.md / info / demo / token / semantic 查询 |
+| 用户确认记录 | `docs/design/<feature>-prototype-confirmation.md` | 有 UI 时必需；未确认前不得进入 OpenAPI Draft 评审 |
 | YSS 工程基线 | `.codex/skills/yss-ddd-scaffold-generator/references/yss-backend-scaffold-parent/SKILL.md` |  |
 
 ## P0 追踪矩阵
@@ -33,7 +35,7 @@
 | OpenAPI 语法 | YAML、`$ref`、path 参数、lint 通过 |  |  |
 | P0 覆盖 | 每个 P0 需求有 endpoint/schema/error/test 或明确非目标 |  |  |
 | 产品总体设计完整 | Draft 已依据 PRD 和产品总体设计 / 功能架构；缺产品总体设计时返回上游补齐 |  |  |
-| 交互输入完整 | 有 UI 时，Draft 已同时依据交互说明、原型/线框、状态矩阵、prototype-review 和 Ant Design v6 高保真 HTML 原型；无 UI 时需说明页面 / 交互资产不适用原因 |  |  |
+| 交互输入完整 | 有 UI 时，Draft 已同时依据交互说明、原型/线框、状态矩阵、prototype-review、Ant Design v6 高保真 HTML 原型、AntD CLI 校验证据和用户确认记录；无 UI 时需说明页面 / 交互资产不适用原因 |  |  |
 | DDD 契约边界 | Endpoint/schema 归属的限界上下文清楚；术语与 `CONTEXT.md` 和功能架构一致；契约不直接暴露内部聚合、Repository 或持久化表结构 |  |  |
 | 页面动作覆盖 | 每个按钮 / 抽屉 / 弹窗动作有 endpoint/non-goal、`actionKey`、权限和错误码 |  |  |
 | 对象生命周期 | manage/maintain/configure/create/update/archive/retry/cancel/publish/export/create-draft 语义闭环 |  |  |

package/template/docs/design/README.md

@@ -7,6 +7,8 @@
 - `docs/design/design.md`：从本地 `Product-Design-System` 引入并整理的 Ant Design 企业级设计系统说明，后续页面设计、交互说明、原型评审和前端实现默认引用该文件。
 - `docs/design/tokens/`：随仓库保存的主题、亮色 / 暗色 / 紧凑 token 和 CSS 变量快照，后续实现不得依赖本机 Downloads 目录。
 
+产品原型产出默认以 `product-design:index` 为主入口。该 skill 只负责路由，实际按 Product Design plugin 规则进入 `$get-context`、`$ideate`、`$prototype`、`$image-to-code`、`$url-to-code`、`$share` 或 `$design-qa` 等 focused skill；YSS 生命周期仍负责校验低保真评审、高保真 HTML 原型、AntD CLI 校验证据、用户确认和 PRD / OpenAPI 回填。
+
 进入 PRD 初稿 / 需求基线流程后，必须先沉淀产品总体设计 / 功能架构，再进入页面 / 原型 / 交互设计、PRD 校准、API 影响分析 / 契约草案或实现。产品总体设计文档必须包含低保真原型 / 页面草图，用于验证页面结构、关键操作和主流程。无 UI 的功能也需要产品总体设计 / 功能架构来说明功能域、业务对象、模块边界、API / 数据影响和不适用的页面状态；只有不进入 PRD 生命周期的小改动可在影响面评估中记录不适用原因。
 
 进入 API 影响分析 / 契约草案前，有用户界面的功能还必须沉淀：
@@ -18,7 +20,7 @@
 - 表单、表格、弹窗、抽屉、步骤流等交互说明。
 - loading、empty、error、readonly、disabled、no-permission、conflict 等状态矩阵。
 - 页面字段、筛选条件、操作按钮和权限规则。
-- 低保真原型评审通过后的 Ant Design v6 高保真可交互 HTML 原型，默认路径为 `docs/design/prototypes/<feature>/index.html`。
+- 低保真原型评审通过后的 Ant Design v6 高保真可交互 HTML 原型，默认路径为 `docs/design/prototypes/<feature>/index.html`；该产物可由系统 / Agent 自动生成，不要求用户手工提供，产出前必须使用 `antd` CLI 查询设计语言、组件 API、demo、token 和 semantic 信息，产出后必须记录 AntD v6 校验证据并获得用户确认。
 
 这些资产用于反推 API 影响、契约草案、OpenAPI 请求 / 响应字段、错误结构、分页筛选、权限状态和前端验收标准。
 
@@ -28,14 +30,16 @@
 - `docs/design/templates/interaction-spec-template.md`：页面、流程、交互、PRD 回填项和 OpenAPI 反推清单。
 - `docs/design/templates/state-matrix-template.md`：loading、empty、error、readonly、no-permission、conflict 等状态。
 - `docs/design/templates/prototype-review-checklist.md`：进入 PRD 校准 / API 影响分析 / 契约草案前的原型评审门禁。
+- `docs/design/templates/prototype-confirmation-template.md`：高保真 HTML 原型产出后的用户确认记录。
 
 推荐技能：
 
 - `yss-design-system`：项目设计系统与 Ant Design 企业级 UI 风格基线；页面设计、原型评审、UI 实现和主题 token 落地时默认先引用。
-- `product-design-prototype`：基于 PRD 初稿和产品总体设计 / 功能架构，产出页面 / 原型 / 交互设计资产。
-- `wireframe-prototype`：低保真线框、Excalidraw、Figma、Penpot、tldraw、Axure 等原型链接沉淀。
+- `product-design:index`：产品原型产出的主路由；根据输入是否有 URL、截图、Figma、代码目标或视觉方向，进入 `$get-context`、`$ideate`、`$prototype`、`$image-to-code`、`$url-to-code`、`$share` 或 `$design-qa` 等 focused skill。
+- Product Design focused skills：基于 PRD 初稿和产品总体设计 / 功能架构，产出低保真 / 高保真页面、原型、交互设计资产和可分享原型；高保真 HTML 原型默认由该路由链路产出。
+- `antd`：Ant Design v6 组件、demo、token、semantic 和 design.md 查询工具；生成或修改高保真 HTML 原型前后必须留下 CLI 校验证据。
 - `prototype-review`：原型阶段评审门禁；未通过则不要进入 PRD 校准 / API 影响分析 / 契约草案。
-- `high-fidelity-html-prototype`：低保真原型评审通过后，基于官方 `@ant-design/cli` / Ant Design For Agents 指引生成 Ant Design v6 高保真可交互 HTML 原型；未产出前不要进入 PRD 校准 / API 影响分析 / 契约草案。
+- 兼容入口：`product-design-prototype`、`wireframe-prototype`、`high-fidelity-html-prototype` 仅作为历史兼容或产物门禁名称保留；新的产品原型产出默认使用 `product-design:index`。
 - `excalidraw-diagram-generator`：根据已形成的 Discovery、PRD、OpenAPI Draft、Architecture 或 系统 / 数据架构设计 生成 `.excalidraw` 图；用于说明和审查，不替代文本规格。
 
 推荐目录：

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

@@ -10,8 +10,10 @@
 | 产品总体设计 / 功能架构 | `docs/design/<feature>-product-overview-design.md` | 必需；缺失时先返回产品总体设计阶段 |
 | 领域术语 | `CONTEXT.md` | 核心名词、状态和业务规则 |
 | Discovery | `docs/discovery/<feature>-discovery.md` | 可选 |
+| Product Design 路由 | `product-design:index -> <focused skill>` | 必需；记录 `$get-context`、`$ideate`、`$prototype`、`$image-to-code` 或 `$url-to-code` |
 | 原型 / 线框图 | `<链接或导出图片路径>` | Excalidraw / Figma / Penpot / tldraw / Axure / Markdown |
-| 高保真 HTML 原型 | `docs/design/prototypes/<feature>/index.html` | 低保真原型评审通过后补齐；必须使用 Ant Design v6 |
+| 高保真 HTML 原型 | `docs/design/prototypes/<feature>/index.html` | 低保真原型评审通过后补齐；必须使用 Ant Design v6；可由系统 / Agent 自动产出；产出后必须获得用户确认 |
+| AntD CLI 校验证据 | `<命令输出或记录路径>` | `antd design.md/info/demo/token/semantic --version 6.0.0 --format json` |
 | 现有 API 草案 | `docs/api/specs/<feature>.yaml` | 可选；通常应先完成产品设计和 PRD 校准 |
 
 ## 2. 页面地图
@@ -104,6 +106,7 @@
 - 每个表格列、筛选条件、表单字段、抽屉、弹窗和按钮都有数据来源或契约反推说明。
 - 设计可以拆成独立可演示的垂直切片。
 - 低保真原型评审通过后，高保真 HTML 原型使用 Ant Design v6 覆盖主流程、关键状态和响应式断点。
+- 原型产出前已使用 `antd` CLI 查询设计语言、组件 API、demo、token 和 semantic 信息；原型产出后已记录 AntD v6 校验证据。
 
 ## 9. 决策与未决问题
 

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

@@ -0,0 +1,57 @@
+# <功能名称> 高保真原型确认记录
+
+> 适用时机：Ant Design v6 高保真 HTML 原型产出后、PRD 校准 / 需求冻结 / UI 驱动 OpenAPI Draft 前。未确认前不得进入下游门禁。
+
+## 1. 原型信息
+
+| 项目 | 内容 |
+|---|---|
+| 功能名称 |  |
+| PRD | `docs/requirements/<feature>-prd.md` |
+| 产品总体设计 / 功能架构 | `docs/design/<feature>-product-overview-design.md` |
+| 交互说明 | `docs/design/<feature>-interaction-spec.md` |
+| 状态矩阵 | `docs/design/<feature>-state-matrix.md` |
+| 原型评审 | `docs/design/<feature>-prototype-review.md` |
+| 高保真 HTML 原型 | `docs/design/prototypes/<feature>/index.html` |
+| Product Design 路由 | `product-design:index -> <focused skill>` |
+| 产出方式 | 系统 / Agent 自动产出 / 人工补充 |
+| Ant Design 版本 | v6 |
+
+## 2. AntD CLI 校验证据
+
+| 校验项 | 命令 / 记录路径 | 结论 |
+|---|---|---|
+| 设计语言 | `antd design.md --version 6.0.0 --format json` |  |
+| 组件 API | `antd info <Component> --version 6.0.0 --format json` |  |
+| 组件 demo | `antd demo <Component> <demo> --version 6.0.0 --format json` |  |
+| 组件 token | `antd token <Component> --version 6.0.0 --format json` |  |
+| semantic | `antd semantic <Component> --version 6.0.0 --format json` |  |
+| lint / 替代校验 | `antd lint <prototype path> --format json` |  |
+
+## 3. 用户确认
+
+| 项目 | 内容 |
+|---|---|
+| 确认人 |  |
+| 确认时间 |  |
+| 确认方式 | 口头 / 评论 / Issue / 会议纪要 / 其他 |
+| 确认结论 | 通过 / 需调整 / 暂缓 |
+| 是否允许进入 PRD 校准 | 是 / 否 |
+| 是否允许进入 API 影响分析 / OpenAPI Draft | 是 / 否 |
+
+## 4. 调整项
+
+| 序号 | 调整内容 | 优先级 | 负责人 | 状态 |
+|---|---|---|---|---|
+| 1 |  | P0 / P1 / P2 |  |  |
+
+## 5. 结论
+
+```text
+确认结论：
+允许进入下一阶段：是 / 否
+阻断原因：
+- 
+补充说明：
+- 
+```

package/template/docs/design/templates/prototype-review-checklist.md

@@ -1,6 +1,6 @@
 # <功能名称> 原型评审清单
 
-> 适用时机：配合 `prototype-review` 使用。评审采用 fail-closed：有阻断项时必须回到产品设计阶段；低保真评审通过后必须进入 `high-fidelity-html-prototype`，不能直接进入 PRD 校准或 API 影响分析 / 契约草案。
+> 适用时机：配合 `prototype-review` 使用。评审采用 fail-closed：有阻断项时必须回到产品设计阶段；产品原型产出以 `product-design:index` 路由到 Product Design focused skill 为主；低保真评审通过后必须产出高保真 HTML 原型，可由系统 / Agent 自动产出；产出后必须获得用户确认，确认前不能直接进入 PRD 校准或 API 影响分析 / 契约草案。
 
 ## 评审输入
 
@@ -10,6 +10,8 @@
 | 交互说明 | `docs/design/<feature>-interaction-spec.md` |  |
 | 原型 / 线框图 | `<链接或导出图片路径>` |  |
 | 状态矩阵 | `docs/design/<feature>-state-matrix.md` |  |
+| Product Design 路由记录 | `product-design:index -> <focused skill>` |  |
+| AntD CLI 校验证据 | `<命令输出或记录路径>` |  |
 | 现有 API 草案 | `docs/api/specs/<feature>.yaml` | 可选 |
 
 ## 门禁清单
@@ -24,6 +26,8 @@
 | 权限行为能区分隐藏、禁用和调用后拒绝 |  |  |
 | 校验错误能区分模型级和字段级展示位置 |  |  |
 | 能从界面需求反推出 API 影响和契约草案 |  |  |
+| AntD v6 设计语言、组件 API、demo、token 和 semantic 已用 `antd` CLI 查询并记录 |  |  |
+| 高保真 HTML 原型未使用旧原型技能作为主入口，已通过 `product-design:index` 路由产出或记录例外原因 |  |  |
 | 前端验收、组件状态和数据依赖已明确 |  |  |
 | 安全红线已标记人工审查 |  |  |
 
@@ -59,5 +63,5 @@
 非阻断建议：
 - 
 下一步：
-- high-fidelity-html-prototype / 回到 product-design-prototype
+- product-design:index 路由高保真 HTML 原型产出 / 回到 Product Design focused skill 补齐原型 / 进入用户确认
 ```

package/template/docs/design/templates/state-matrix-template.md

@@ -1,6 +1,6 @@
 # <功能名称> 状态矩阵模板
 
-> 适用时机：配合 `product-design-prototype` 使用，在 PRD 校准和 API 影响分析 / 契约草案之前补齐页面状态。
+> 适用时机：配合 `product-design:index` 路由后的 Product Design focused skill 使用，在 PRD 校准和 API 影响分析 / 契约草案之前补齐页面状态。
 
 | 页面 / 组件 | 状态 | 触发条件 | 界面行为 | API / 数据要求 | 验收点 |
 |---|---|---|---|---|---|

package/template/docs/process/harness-executive-blueprint.md

@@ -46,7 +46,8 @@ AI 不能只作为一次性辅助工具使用。Harness 工程的目标，是把
 PRD
 → 产品总体设计 / 功能架构
 → 页面 / 原型 / 交互设计与 prototype-review（有 UI 时）
-→ Ant Design v6 高保真 HTML 原型（有 UI 时）
+→ product-design:index 路由 Product Design focused skill 产出 Ant Design v6 高保真 HTML 原型（有 UI 时）
+→ antd CLI 校验证据与用户确认记录（有 UI 时）
 → API 影响分析 / 契约草案
 → review-only OpenAPI Draft（如需要）
 → Issue Change

package/template/docs/process/harness-process-tailoring.md

@@ -18,7 +18,7 @@
 |---|---|---|
 | 只有模糊想法、业务机会或竞品输入 | 2. 机会与 Discovery | Discovery、`grill-with-docs`、PRD、产品总体设计 / 功能架构 |
 | 已有清晰 PRD，但用户、痛点、MVP 或非目标不稳 | 3. 业务 / PRD / 功能架构 | PRD Review、产品总体设计 / 功能架构、必要的页面 / 原型 / 交互设计 |
-| 有 UI 变更但缺页面流、状态矩阵、原型评审或高保真 HTML 原型 | 4. 产品设计与需求冻结 | 交互说明、状态矩阵、Prototype Review、Ant Design v6 高保真 HTML 原型、PRD 回填 |
+| 有 UI 变更但缺页面流、状态矩阵、原型评审、高保真 HTML 原型、AntD CLI 校验证据或用户确认记录 | 4. 产品设计与需求冻结 | 交互说明、状态矩阵、Prototype Review、Ant Design v6 高保真 HTML 原型（可在低保真评审通过后由系统 / Agent 自动产出）、AntD CLI 校验证据、用户确认记录、PRD 回填 |
 | API 路径、schema、错误结构、分页或权限发生变化 | 5. 系统 / 数据架构与工程契约设计审查 | API 影响记录、契约草案 / OpenAPI Draft Review、必要时 Spec Delta、系统 / 数据架构反审、Freeze、`to-issues` |
 | 服务边界、集成、部署、性能、可靠性或运维变化 | 5. 系统 / 数据架构与工程契约设计审查 | 系统架构、Design Review、必要时 Spec Delta、Build Architecture Checklist |
 | 持久化、元数据、版本、血缘、搜索、索引或迁移变化 | 5. 系统 / 数据架构与工程契约设计审查 | 数据架构、必要时 Spec Delta、人审点、Repository / MyBatis 前置审查 |

package/template/docs/process/harness-work-unit-map.md

@@ -14,7 +14,7 @@
 |---|---|---|---|---|---|---|
 | 0. 机会 / 问题收集 | 1. 入口分诊；2. 机会与 Discovery | 0. 入口分诊；1. 机会探索 | 分诊结论、Discovery 收敛、MVP 边界 | `yss-product-lifecycle`、`competitive-intelligence`、Discovery 模板 | 小改动可跳过；新产品 / 新模块必需 | 半自动生成分诊清单、竞品情报简报和 Discovery 模板 |
 | 1. 需求澄清 | 3. 业务 / PRD / 功能架构 | 3. 需求澄清 | 澄清记录、用户 / 痛点 / 验收标准 | `grill-with-docs`、`to-prd` | 小文案 / 单点 bug 可轻量化 | 半自动生成澄清问题和缺口清单 |
-| 2. PRD -> 产品总体设计 -> 原型校准 | 3. 业务 / PRD / 功能架构；4. 产品设计与需求冻结 | 4. 需求基线 / 功能架构；5. 页面 / 原型 / 交互设计；6. 原型评审；7. PRD 校准 / 需求冻结 | PRD、产品总体设计 / 功能架构、低保真原型、页面清单、状态矩阵、原型评审、Ant Design v6 高保真 HTML 原型、需求冻结 | `yss-design-system`、`product-design-prototype`、`prototype-review`、`high-fidelity-html-prototype` | 无 UI 可省略后续交互原型；进入 PRD 初稿 / 需求基线流程时不得省略产品总体设计及其低保真原型；有 UI 时低保真评审通过后不得省略高保真 HTML 原型；中等变更只补受影响页面 | 半自动检查 PRD 字段、产品总体设计、低保真原型、状态矩阵、原型评审和高保真 HTML 原型 |
+| 2. PRD -> 产品总体设计 -> 原型校准 | 3. 业务 / PRD / 功能架构；4. 产品设计与需求冻结 | 4. 需求基线 / 功能架构；5. 页面 / 原型 / 交互设计；6. 原型评审；7. PRD 校准 / 需求冻结 | PRD、产品总体设计 / 功能架构、低保真原型、页面清单、状态矩阵、原型评审、Ant Design v6 高保真 HTML 原型、AntD CLI 校验证据、用户确认记录、需求冻结 | `yss-design-system`、`product-design:index`、Product Design focused skills（`$get-context` / `$ideate` / `$prototype` / `$image-to-code` / `$url-to-code`）、`antd`、`prototype-review` | 无 UI 可省略后续交互原型；进入 PRD 初稿 / 需求基线流程时不得省略产品总体设计及其低保真原型；有 UI 时产品原型产出以 `product-design:index` 路由为主，低保真评审通过后不得省略高保真 HTML 原型，可由系统 / Agent 自动产出，产出前后必须使用 `antd` CLI 校验并在产出后获得用户确认；中等变更只补受影响页面 | 半自动检查 PRD 字段、产品总体设计、低保真原型、状态矩阵、原型评审、高保真 HTML 原型、AntD CLI 校验证据和用户确认记录 |
 | 3. SDD 研发规范基线 | 5. 系统 / 数据架构与工程契约设计审查；6. 契约冻结与 Issue | 8. API 影响分析 / 契约草案；9. 工程基线；13. 契约冻结；14. Issue formalization | API 影响记录、契约草案 / OpenAPI Draft / Freeze、Spec Delta、工程基线、垂直切片 Issue、实施路由、验证证据 | `to-issues`、`yss-router` | 无 API / 无工程边界变化时记录无影响结论；低风险小改动跳过 Spec Delta | 自动检查 OpenAPI Freeze / no API impact / Spec Delta / vertical slice Issue / implementation routing |
 | 4. DDD 领域建模 | 3. 业务 / PRD / 功能架构；5. 系统 / 数据架构与工程契约设计审查 | 2. 业务架构；10. 系统总体架构；11. 数据架构 | CONTEXT 术语、业务能力、领域边界、聚合 / 状态规则 | `domain-modeling`、`yss-domain-modeling`、`yss-domain` | 小改动只校验是否影响既有术语或边界 | 半自动检查术语回填和领域边界审查项 |
 | 5. 架构设计 | 5. 系统 / 数据架构与工程契约设计审查 | 8. API 影响分析 / 契约草案；9. 工程基线；10. 系统总体架构；11. 数据架构；12. 设计审查 | API 影响记录、工程基线、系统概要设计、数据架构、ADR 候选、架构评审 | `codebase-design`、`improve-codebase-architecture`、YSS 架构模板 | 不触碰 API、工程边界、服务边界、数据、NFR、部署时可轻量记录无影响 | 半自动生成 Architecture Review checklist |