create-yss-spec 2.2.10 → 3.0.1

package/template/docs/design/templates/prototype-evidence-template.yaml

@@ -1,99 +1,123 @@
 # 复制到 docs/.scratch/<feature>/verification/prototype-evidence.yaml。
-# schema v1 只读兼容；关闭 gate.prototype-verified 前必须迁移到本 schema v2。
-schema_version: 2
+# 只保留所选档位的 profile_evidence 子块；schema v1/v2 仅允许只读迁移。
+schema_version: 3
 feature: <feature>
 prototype_ref: docs/.scratch/<feature>/design/prototypes/index.html
-prototype_stack:
-  framework: react
-  package_manager: pnpm
-  package_manifest_ref: docs/.scratch/<feature>/design/prototypes/package.json
-  lockfile_ref: docs/.scratch/<feature>/design/prototypes/pnpm-lock.yaml
-  source_entry_ref: docs/.scratch/<feature>/design/prototypes/src/App.jsx
-  build_entry_ref: docs/.scratch/<feature>/design/prototypes/dist/index.html
-  build_command: pnpm build
-  build_result: pending
-  actual_antd_version: <exact-6.x-version-from-lockfile>
+prototype_profile: H2
+profile_kind: flow-review
+profile_decision:
+  decision_to_inform: <本轮原型需要支持的决定>
+  risk_assumptions:
+    - <需要验证或接受的风险假设>
+  trigger_results:
+    - trigger: <multi-page-navigation-or-other-trigger>
+      matched: true
+      evidence_ref: <spec-state-matrix-or-review-ref>
+  calculated_profile: H2
+  override:
+    applied: false
+    direction: none
+    reason: not-applicable
+    evidence_ref: not-applicable
+upstream_refs:
+  spec_ref: docs/.scratch/<feature>/spec/<feature>-spec.md
+  interaction_spec_ref: docs/.scratch/<feature>/design/<feature>-interaction-spec.md
+  low_fidelity_ref: docs/.scratch/<feature>/design/<feature>-low-fidelity.md
+  state_matrix_ref: docs/.scratch/<feature>/design/<feature>-state-matrix.md
+  prototype_review_ref: docs/.scratch/<feature>/design/<feature>-prototype-review.md
+source_visual:
+  ideation_status: required
+  selected_ref: <selected-source-visual-ref>
+  reuse_reason: not-applicable
 design_baseline:
-  design_standard: ant-design-v6
   project_design_ref: docs/design/design.md
   project_token_refs:
     - docs/design/tokens/theme.json
     - docs/design/tokens/tokens.compact.json
-  upstream_design_md_source: https://ant.design/design.md
-  upstream_design_md_record_ref: <path-to-json-output-or-summary>
-  theme_adapter_ref: docs/.scratch/<feature>/design/prototypes/src/yss-theme.js
+  project_token_baseline_digest: <sha256>
   project_override_reviewed: false
-  theme_override:
-    color_primary: "#3371ff"
-    color_error: "#f5222d"
-    color_bg_layout: "#f0f2f5"
-    compact_control_height: 28
-    border_radius: 6
-    font_family: system-stack
-    recorded: false
-    note: 官方当前同样使用系统字体和 6px 默认控件圆角；真实项目差异主要是品牌/状态色、页面背景和默认紧凑密度，不得误写为 Inter/8px 差异。
-visual_semantic_mapping:
-  runtime_component_library: ant-design-vue-4.x
-  runtime_version_source: implementation-lockfile
-  components:
-    - semantic_role: <primary-action-or-other-role>
-      antd_v6_component: <React-AntD-component-used-by-prototype>
-      project_token_refs: [<token-name>]
-      yss_or_antdv_target: <YSS-or-AntDV-production-component>
-      state_mapping: [default, hover, active, disabled, loading]
-      react_only_api_not_copied: false
-      verification_ref: <same-state-screenshot-or-test-ref>
-antd:
-  fact_skill: yss-antd-design
-  cli_command: antd
-  cli_version: <actual-cli-version>
-  target_antd_version: <same-exact-6.x-version>
-  queries:
-    design_md: <path-to-json-output>
-    components:
-      - component: <Component>
-        info_ref: <path-to-json-output>
-        demo_ref: <path-to-json-output>
-        token_ref: <path-to-json-output>
-        semantic_ref: <path-to-json-output>
-  lint_applicable: true
-  lint_reason: react-source
-  lint_ref: <path-to-json-output>
-  lint_passed: false
-browser_verification:
-  executor: <browser-or-automation-name>
+browser_delivery:
+  delivery_kind: static-directory
+  entry_ref: docs/.scratch/<feature>/design/prototypes/index.html
   rendered_nonblank: false
-  prototype_digest: <sha256-or-version-ref>
+  prototype_digest: <sha256>
   viewports:
     - name: desktop
       size: 1440x900
       result: pending
-    - name: narrow-mobile
+      screenshot_ref: <path>
+    - name: narrow
       size: 390x844
       result: pending
-  main_flow_result: pending
-  failure_permission_or_conflict_result: pending
-  console_error_ref: <path-to-console-output-or-none>
+      screenshot_ref: <path>
+  console_result: pending
+  console_ref: <path-to-console-output-or-none>
 design_qa:
   report_ref: docs/.scratch/<feature>/verification/design-qa.md
   result: pending
-accessibility_verification:
-  contrast_results_ref: <path-to-default-hover-active-disabled-focus-results>
-  keyboard_navigation_result: pending
-  focus_visible_and_order_result: pending
-  semantic_label_dialog_result: pending
-  zoom_200_result: pending
-  reduced_motion_result: pending
-  target_size_result: pending
-  automated_scan:
-    tool: <tool-or-manual>
-    version: <actual-version-or-not-applicable>
-    result: pending
-    ref: <path-to-result-or-manual-check>
+  axes:
+    visual: pending
+    layout: pending
+    interaction: pending
+    content: pending
+    accessibility: pending
+    cross_platform: pending
+profile_evidence:
+  # H1 只保留 visual_review；不得包含 package/lockfile/AntD 字段。
+  # visual_review:
+  #   runtime_build_required: false
+  #   key_interactions_result: pending
+  #   keyboard_result: pending
+  #   focus_result: pending
+  #   contrast_result: pending
+  #   zoom_200: {applicable: false, result: not-applicable, evidence_ref: not-applicable}
+  #   reduced_motion: {applicable: false, result: not-applicable, evidence_ref: not-applicable}
+  flow_review:
+    implementation:
+      framework: react
+      runtime_build_required: true
+      package_manager: pnpm
+      package_manifest_ref: docs/.scratch/<feature>/design/prototypes/package.json
+      lockfile_ref: docs/.scratch/<feature>/design/prototypes/pnpm-lock.yaml
+      build_command: pnpm build
+      build_result: pending
+    main_flow_result: pending
+    exceptional_state_result: pending
+    exceptional_state_ref: <failure-permission-or-conflict-ref>
+    keyboard_result: pending
+    focus_result: pending
+    contrast_result: pending
+    zoom_200_result: pending
+    reduced_motion_result: pending
+    visual_regression:
+      applicable: true
+      result: pending
+      evidence_ref: <snapshot-result-ref>
+    prototype_library_facts:
+      applicable: true
+      component_basis: react-antd-6
+      source: fact-pack
+      actual_antd_version: <exact-6.x-version-from-lockfile>
+      manifest_ref: docs/design/facts/antd/<exact-version>/manifest.json
+      manifest_digest: <sha256>
+      components_covered: [<Component>]
+      project_token_baseline_digest: <same-as-design-baseline>
+      new_api_uncertainty: false
+implementation_handoff:
+  prototype_code_reusable: false
+  production_component_assumptions:
+    - <原型采用的语义预计可由目标 YSS/AntDV 组件表达>
+  verification_targets:
+    - behavior: <进入实现后需要基于真实组件验证的行为>
+      target_stage: frontend-implementation-plan
 review:
-  prototype_review_ref: docs/.scratch/<feature>/design/<feature>-prototype-review.md
   result: pending
+  review_ref: docs/.scratch/<feature>/design/<feature>-prototype-review.md
 user_confirmation:
-  confirmation_ref: docs/.scratch/<feature>/design/<feature>-prototype-confirmation.md
   result: pending
+  confirmation_ref: docs/.scratch/<feature>/design/<feature>-prototype-confirmation.md
+  confirmed_decision: <用户确认的设计决定>
+  operable_scope: [<可操作范围>]
+  simulations_or_gaps: [<模拟或缺口>]
+gaps: []
 blockers: []

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

@@ -1,6 +1,6 @@
 # <功能名称> 原型评审清单
 
-> 适用时机：配合 `prototype-review` 使用。评审采用 记录阻塞原因：有阻断项时必须回到产品设计阶段；产品原型产出以 `product-design:index` 路由到 Product Design focused skill 为主；低保真评审通过后必须产出高保真 HTML 原型，可由系统 / Agent 自动产出；产出后必须获得用户确认，确认前不能直接进入 Spec 校准或 API 影响分析 / 契约草案。
+> 适用时机：配合 `prototype-review` 使用。低保真与状态矩阵有阻断项时回产品设计；通过后先提取风险，再按确定性规则选择 H1/H2 原型交付物。产出后仍须用户确认，确认前不能进入 Spec 校准或 API 影响分析。
 
 ## 评审输入
 
@@ -11,7 +11,7 @@
 | 原型 / 线框图 | `<链接或导出图片路径>` |  |
 | 状态矩阵 | `docs/.scratch/<feature>/design/<feature>-state-matrix.md` |  |
 | 原型阶段合同 / Product Design 路由记录 | `yss-prototype-stage -> product-design:index -> <focused skill>` |  |
-| 原型验证清单 | `docs/.scratch/<feature>/verification/prototype-evidence.yaml` | 高保真完成后补齐 CLI 与浏览器验证 |
+| 原型验证清单 | `docs/.scratch/<feature>/verification/prototype-evidence.yaml` | 档位确定后补齐 schema v3 共同与档位证据 |
 | 现有 API 草案 | `docs/.scratch/<feature>/api/<feature>.yaml` | 可选 |
 
 ## 门禁清单
@@ -26,7 +26,8 @@
 | 权限行为能区分隐藏、禁用和调用后拒绝 |  |  |
 | 校验错误能区分模型级和字段级展示位置 |  |  |
 | 能从界面需求反推出 API 影响和契约草案 |  |  |
-| 高保真 HTML 原型已按 `yss-prototype-stage` 通过 `product-design:index` 路由产出，或记录等价 Agent 适配及例外原因 |  |  |
+| 已列出原型需要回答的决定、风险触发及 H1/H2 推荐档位；无充分证据时回退 H2 |  |  |
+| 状态矩阵中的每个状态均有事件、转换、guard、动作和退出路径 |  |  |
 | 前端验收、组件状态和数据依赖已明确 |  |  |
 | 风险 / 回滚约束和人工确认项已记录 |  |  |
 
@@ -63,5 +64,5 @@
 非阻断建议：
 - 
 下一步：
-- product-design:index 路由高保真 HTML 原型产出 / 回到 Product Design focused skill 补齐原型 / 进入用户确认
+- yss-prototype-stage 计算档位并进入对应适配器 / 回到产品设计补齐状态与风险 / 进入原型交付物构建
 ```

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

@@ -2,6 +2,8 @@
 
 > 适用时机：配合 `product-design:index` 路由后的 Product Design focused skill 使用，在 Spec 校准和 API 影响分析 / 契约草案之前补齐页面状态。
 
+状态矩阵同时承担轻量状态机合同：每个可进入状态都必须有触发事件、允许转换、guard、动作与退出路径。不要另建第二份 state-machine 资产。
+
 | 页面 / 组件 | 状态 | 触发条件 | 界面行为 | API / 数据要求 | 验收点 |
 |---|---|---|---|---|---|
 | 模型列表 | 加载中 | 首次进入或筛选条件变化 | 表格展示加载态；查询条件尽量保持可用 | 列表请求进行中 | 用户看到进度且布局不跳动 |
@@ -16,6 +18,15 @@
 | 发布弹窗 | 并发冲突 | 页面加载后草稿已被他人修改 | 展示刷新或重试决策 | 冲突错误码、最新版本或 token | 不会误覆盖他人修改 |
 | 发布弹窗 | 发布成功 | 发布接口成功 | 关闭弹窗，展示已发布状态和版本号 | 发布版本元数据 | 详情页反映冻结版本 |
 
+## 状态转换合同
+
+| 状态 | 事件 | Guard | 下一状态 | 进入 / 退出动作 | 恢复或退出路径 |
+|---|---|---|---|---|---|
+| 加载中 | 请求成功 | 响应有效 | 可操作 | 渲染数据、解除 busy | 进入主流程 |
+| 加载中 | 请求失败 | 错误可重试 | 错误 | 保留上下文、展示错误 | 重试或返回 |
+| 表单已修改 | 提交 | 校验通过且有权限 | 提交中 | 禁用重复提交 | 成功、失败或冲突 |
+| 并发冲突 | 刷新 | 用户确认放弃本地旧版本 | 可操作 | 拉取最新版本 | 重新编辑或退出 |
+
 ## 必须确认的状态决策
 
 | 决策项 | 选择的行为 | 负责人 |

package/template/docs/discovery/reports/agent-governance-options.md

@@ -3,7 +3,7 @@
 ## 结论摘要
 
 1. 逐技能结构 / 路由 / 行为 eval 不作为 YSS 模板首个升级方向。结构和路由已有确定性校验；行为 eval 成本高、易重复生命周期门禁，应降为后续按变更和风险触发的试验性能力。
-2. invocation metadata 进入 `yss-skill-registry.yaml`；Router 合同只定义字段 schema、解析和阻断规则，不复制每个 skill 的示例。trigger examples 进入注册表，但保持少量、结构化、只为消歧服务。
+2. invocation metadata 进入 `yss-skill-registry.yaml`；实现合同编译器 合同只定义字段 schema、解析和阻断规则，不复制每个 skill 的示例。trigger examples 进入注册表，但保持少量、结构化、只为消歧服务。
 3. freshness audit 作为生命周期完成条件的 core 能力，不新建一个常驻通用 skill；Doubt-Driven 作为高风险条件触发的 core 路由策略；Wayfinder 保持 maintainer-only / 兼容入口的可选模式，不进入默认 core 路由。
 
 ## Q1：eval 是否为首个升级方向
@@ -11,7 +11,7 @@
 ### 现状事实
 
 - 技能身份、层级、成熟度、别名、默认可发现性和来源投影已经由 [`yss-skill-registry.yaml`](../../agents/yss-skill-registry.yaml)、[`skill-registry.mjs`](../../../scripts/lib/skill-registry.mjs)、`sync-skills` 和 `skills-lock.json` 共同校验。
-- 生命周期路由和 Router 已经对未登记技能、依赖闭包、原型独立评审、代码审查唯一入口等关键路由做确定性检查。
+- 生命周期路由和 实现合同编译器 已经对未登记技能、依赖闭包、原型独立评审、代码审查唯一入口等关键路由做确定性检查。
 - 生命周期完成已经要求 fresh verification、证据可读、阻断信号清空和 stale / drift 重路由。
 
 ### 决策
@@ -21,7 +21,7 @@
 | 层次 | 初始策略 | 原因 |
 |---|---|---|
 | 结构 | 继续使用现有静态 / schema 校验 | 成本最低，收益已覆盖大部分缺陷 |
-| 路由 | 只对注册表、Router、生命周期变更做确定性增量校验 | 与现有门禁直接对齐，避免重复运行 |
+| 路由 | 只对注册表、实现合同编译器、生命周期变更做确定性增量校验 | 与现有门禁直接对齐，避免重复运行 |
 | 行为 | P2 试验；只覆盖变更中的 core / 高风险 skill | 避免全量运行导致 token 和维护成本失控 |
 
 行为 eval 的进入条件应是：skill 内容或路由发生变化、命中高风险影响、或出现真实 finding；退出条件是连续真实任务证明它能发现现有静态校验抓不到的问题，且没有形成第二套生命周期门禁。
@@ -31,7 +31,7 @@
 ### 决策
 
 - **注册表**是技能级调用元数据的唯一事实源：调用模式、触发条件、排除条件、主要输出、依赖和少量 trigger examples 均放在这里。
-- **Router 合同**定义 schema、解析顺序、依赖闭包和阻断规则；不复制每个技能的完整示例，避免注册表与 Router 漂移。
+- **实现合同编译器 合同**定义 schema、解析顺序、依赖闭包和阻断规则；不复制每个技能的完整示例，避免注册表与 实现合同编译器 漂移。
 - **生命周期编排合同**继续保留工作单元级 `workflow_reference.invocation_mode`（例如 `model-invoked` / `reference`）。它描述一次工作单元如何被执行，不与注册表的 `user` / `model` / `both` 技能级模式混用。
 
 ### trigger examples 约束
@@ -41,14 +41,14 @@
 - specialist 技能可继承 `impacts` 触发条件；只有存在歧义时才增加显式 examples。
 - examples 只影响发现和路由提示，不直接批准门禁、Ticket 状态或 `ready-for-agent`。
 
-当前已落地的低成本基础见 [`yss-skill-registry.yaml`](../../agents/yss-skill-registry.yaml) 的 `invocation_contract`，以及 [`router-contract.yaml`](../../.agents/skills/yss-router/references/router-contract.yaml) 的合同字段。
+当前已落地的低成本基础见 [`yss-skill-registry.yaml`](../../agents/yss-skill-registry.yaml) 的 `invocation_contract`，以及 [`compiler-contract.yaml`](../../.agents/skills/yss-implementation-contract-compiler/references/compiler-contract.yaml) 的合同字段。
 
 ## Q3：三项能力的路由层级
 
 | 能力 | 推荐层级 | 具体落点 | 不应做什么 |
 |---|---|---|---|
 | freshness audit | core 能力 | 生命周期完成条件、候选快照、fresh verification、stale / drift 检查 | 不再新增一个对所有任务常驻的通用审计 skill |
-| Doubt-Driven | core 条件路由 | Router / 工程基线 / 架构与契约审查中的高风险分支 | 不升级为所有低风险任务的默认步骤，不新建生命周期阶段 |
+| Doubt-Driven | core 条件路由 | 实现合同编译器 / 工程基线 / 架构与契约审查中的高风险分支 | 不升级为所有低风险任务的默认步骤，不新建生命周期阶段 |
 | Wayfinder | maintainer-only / 兼容入口的可选模式 | 超长、多 Agent、多会话或 frontier 不清晰时，完成后回 `handoff → to-spec` | 不改变阶段、门禁、Ticket 角色或 `ready-for-agent` |
 
 ### Doubt-Driven 的高风险触发器
@@ -63,8 +63,8 @@ freshness 是“完成结论可信度”的 core 约束，而不是新的工作
 
 - [YSS skill registry](../../agents/yss-skill-registry.yaml)
 - [Skill registry validator](../../../scripts/lib/skill-registry.mjs)
-- [YSS Router contract](../../.agents/skills/yss-router/references/router-contract.yaml)
-- [Slice Implementation Contract](../../.agents/skills/yss-router/references/slice-implementation-contract.md)
+- [YSS 实现合同编译器 contract](../../.agents/skills/yss-implementation-contract-compiler/references/compiler-contract.yaml)
+- [Slice Implementation Contract](../../.agents/skills/yss-implementation-contract-compiler/references/slice-implementation-contract.md)
 - [Lifecycle orchestration contract](../../.agents/skills/yss-product-lifecycle/references/orchestration-contract.yaml)
 - [Harness process tailoring](../../process/harness-process-tailoring.md)
 - [Addy Osmani agent-skills](https://github.com/addyosmani/agent-skills)

package/template/docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md

@@ -5,6 +5,7 @@ Matt Pocock Engineering Skills 提供轻量的澄清、实现、TDD、诊断和
 ## 进入与退出
 
 - Matt user-invoked 的 `grill-with-docs`、`to-spec`、`to-tickets` 和 `implement` 必须由用户显式启动，任何 skill 不得自动调用它们；YSS 生命周期只准备、校验和验收其结果。所有 Matt model-invoked skill 仍须遵守 `AGENTS.md` 的阶段、门禁和证据要求，并只能在生命周期允许的工作单元中调用。
-- `code-review` 保持唯一默认审查入口。YSS 适配把 Slice `required_skills`、`alibaba-java-code-style` 与命中的 `yss-ui` / `yss-domain` 等专项 skill 编译为 Standards 检查输入，并要求实现仓已有的 `pnpm` / `./mvnw` 机器检查；禁止再增加第二个通用审查 skill 或专用审查 Cloud 环境来代替这条接线。审查 finding 按编排合同分流：实现者修复后全轴复审，或合同 `stale` 后回 Router；审查者不得写实现。
+- `code-review` 保持唯一默认审查入口。YSS 适配把 Slice `required_skills`、`alibaba-java-code-style` 与命中的 `yss-ui` / `yss-domain` 等专项 skill 编译为 Standards 检查输入，并要求实现仓已有的 `pnpm` / `./mvnw` 机器检查；禁止再增加第二个通用审查 skill 或专用审查 Cloud 环境来代替这条接线。审查 finding 按编排合同分流：实现者修复后全轴复审，或合同 `stale` 后回 实现合同编译器；审查者不得写实现。
 - `template-source` 只执行模板维护流程，不生成具体产品 Spec、原型、OpenAPI 或垂直切片 Ticket。
+- Matt 的 `research` 已适配为 canonical `yss-research`，旧名只作为 deprecated alias。YSS 版本提供 `technical-evidence` / `strategy-evidence` profile、`quick` / `evidence-audited` 模式、证据合同和确定性校验，同时保留上游 revision 与原始 hash 以便追溯。
 - Agent 完成工作单元后返回可核验的 evidence refs、变更资产、验证命令、残余风险和下一路由。

package/template/docs/process/implementation-repo-integration.md

@@ -40,7 +40,7 @@ apps/
 - 后端：已登记项目根的 `./mvnw` 校验 / 测试；若工程已配置 Checkstyle、P3C 或 Spotless，审查时实际执行。
 - `git-submodule` 必须递归检出；空 gitlink 不得当作「没有工程」。
 - 模板源 `.cursor/environment.json` 只安装模板校验依赖（`jsonschema`、模板 `pnpm`），**不是**实现仓审查运行时。`project-instance` 与实现仓库的 Cloud / CI 环境自行包含 JDK、Maven Wrapper 和 `pnpm`。
-- 审查任务包只写证据路径；专项 skill 只读，不得写实现。审查 finding 按 `review_standards_route.finding_disposition` 分流：`violation` 交实现者修复后全轴复审；`drift` / `new_impacts` 回 Router，不在审查会话中改代码。
+- 审查任务包只写证据路径；专项 skill 只读，不得写实现。审查 finding 按 `review_standards_route.finding_disposition` 分流：`violation` 交实现者修复后全轴复审；`drift` / `new_impacts` 回 实现合同编译器，不在审查会话中改代码。
 
 ## 1.3 `repository_scope: git-submodule`
 

package/template/docs/process/lifecycle-artifact-map.md

@@ -31,7 +31,7 @@
 | `gate.stage-decision-package-approved` | 阶段决策包批准 | `stage.discovery` | Discovery 到 Spec 入口需要稳定的阶段决策合同。 | `gate.domain-strategy-approved` | `evidence.stage-decision-package`、`evidence.approval-record` |
 | `gate.spec-baseline-approved` | Spec 基线批准 | `stage.spec-architecture` | 新功能、行为变化或范围扩大进入 Spec 基线。 | 无 | `evidence.approval-record` |
 | `gate.prototype-reviewed` | 原型评审 | `stage.product-design` | 命中产品设计影响，且低保真页面、流程、状态或 API 反推需要独立评审。 | 无 | `evidence.prototype-review-result` |
-| `gate.prototype-verified` | 高保真原型验证 | `stage.product-design` | 需要高保真 HTML 原型进行视觉与交互校准。 | 无 | `evidence.antd-cli-validation`、`evidence.browser-prototype-verification` |
+| `gate.prototype-verified` | 原型交付物验证 | `stage.product-design` | 产品设计影响需要通过 H1/H2 原型交付物进行视觉或流程校准；真实组件验证留到前端实现阶段。 | 无 | `evidence.prototype-profile-decision`、`evidence.prototype-deliverable-verification` |
 | `gate.user-confirmation` | 用户确认 | `stage.product-design` | 产品设计影响尚未被人工确认。 | 无 | `evidence.prototype-confirmation` |
 | `gate.openapi-draft-reviewed` | OpenAPI Draft Review | `stage.system-data-engineering` | 有 API 影响且 Draft 已生成。 | 无 | `evidence.openapi-draft-review` |
 | `gate.design-reviewed` | 设计审查 | `stage.system-data-engineering` | API 或架构影响。 | 无 | `evidence.design-review-result` |
@@ -57,7 +57,7 @@
 | `artifact.interaction-spec` | 交互说明 | `stage.product-design` | 命中产品设计影响。 |
 | `artifact.low-fidelity-prototype` | 低保真原型 | `stage.product-design` | 命中产品设计影响。 |
 | `artifact.state-matrix` | 状态矩阵 | `stage.product-design` | 存在状态流转、异常或恢复。 |
-| `artifact.high-fidelity-html-prototype` | 高保真 HTML 原型 | `stage.product-design` | 需要视觉与交互校准。 |
+| `artifact.prototype-deliverable` | 原型交付物 | `stage.product-design` | 低保真评审后需要 H1 视觉或 H2 流程校准。 |
 | `artifact.prototype-review` | 原型评审记录 | `stage.product-design` | 命中 gate.prototype-reviewed。 |
 | `artifact.prototype-confirmation` | 原型确认记录 | `stage.product-design` | 命中 gate.user-confirmation。 |
 | `artifact.openapi-draft` | OpenAPI Draft | `stage.system-data-engineering` | 有 API 影响。 |
@@ -89,6 +89,8 @@
 | `evidence.prototype-review-result` | 原型评审结果 | 低保真页面、流程、状态与 API 反推的独立评审结论和阻断项。 |
 | `evidence.antd-cli-validation` | Ant Design CLI 校验证据 | 设计语言、组件、demo、token、semantic 与 lint 的实际 CLI/目标版本和可读输出引用。 |
 | `evidence.browser-prototype-verification` | 浏览器原型验证证据 | 高保真原型的非空渲染、主流程、异常状态、视口和控制台验证记录。 |
+| `evidence.prototype-profile-decision` | 原型档位选择证据 | 基于低保真评审后的风险触发、决定目标、H1/H2 计算结果以及人工升降级依据。 |
+| `evidence.prototype-deliverable-verification` | 原型交付物验证证据 | schema v3 共同证据与所选档位的浏览器、Design QA、无障碍、组件事实或真实组件合同验证结果。 |
 | `evidence.prototype-confirmation` | 原型用户确认记录 | 高保真原型、验证清单和进入下游阶段范围的人工确认结论。 |
 | `evidence.openapi-draft-review` | OpenAPI Draft 审查记录 | P0、错误、分页、幂等和契约测试审查记录。 |
 | `evidence.contract-approval` | Slice 合同批准记录 | 生命周期编排器批准且已持久化的当前版本合同引用。 |

package/template/docs/process/lifecycle-registry-baseline.json

@@ -1,7 +1,7 @@
 {
   "schema_version": 1,
   "registry_id": "yss.lifecycle",
-  "semantic_sha256": "15375e8d7da599e2117e19399cb5e14b9c53aa4e4ce7c94c4e9c135a499e55e6",
+  "semantic_sha256": "6fe3accf810dda1686080f1dd32f9393b22fa006acceb89ff17cb5668a8a67a6",
   "published_ids": [
     "artifact.architecture-review",
     "artifact.data-architecture",
@@ -19,6 +19,7 @@
     "artifact.openapi-freeze-record",
     "artifact.parent-ticket",
     "artifact.product-overview",
+    "artifact.prototype-deliverable",
     "artifact.prototype-confirmation",
     "artifact.prototype-review",
     "artifact.retrospective",
@@ -42,6 +43,8 @@
     "evidence.maintenance-intensity-checkpoint",
     "evidence.openapi-draft-review",
     "evidence.prototype-confirmation",
+    "evidence.prototype-deliverable-verification",
+    "evidence.prototype-profile-decision",
     "evidence.prototype-review-result",
     "evidence.repository-identity-check",
     "evidence.stage-decision-package",

package/template/docs/process/lifecycle-registry.yaml

@@ -8,7 +8,7 @@ id_policy:
   pattern: '^(stage|gate|artifact|work-unit|evidence)\.[a-z0-9][a-z0-9-]*$'
   published_ids_immutable: true
   baseline: docs/process/lifecycle-registry-baseline.json
-  deprecated_ids: [work-unit.fresh-verification, work-unit.independent-review]
+  deprecated_ids: [artifact.high-fidelity-html-prototype, work-unit.fresh-verification, work-unit.independent-review]
 
 stages:
   - id: stage.entry-triage
@@ -78,6 +78,12 @@ evidence:
   - id: evidence.browser-prototype-verification
     name: 浏览器原型验证证据
     description: 高保真原型的非空渲染、主流程、异常状态、视口和控制台验证记录。
+  - id: evidence.prototype-profile-decision
+    name: 原型档位选择证据
+    description: 基于低保真评审后的风险触发、决定目标、H1/H2 计算结果以及人工升降级依据。
+  - id: evidence.prototype-deliverable-verification
+    name: 原型交付物验证证据
+    description: schema v3 共同证据与所选档位的浏览器、Design QA、无障碍、组件事实或真实组件合同验证结果。
   - id: evidence.prototype-confirmation
     name: 原型用户确认记录
     description: 高保真原型、验证清单和进入下游阶段范围的人工确认结论。
@@ -128,10 +134,10 @@ gates:
     trigger: 命中产品设计影响，且低保真页面、流程、状态或 API 反推需要独立评审。
     evidence: [evidence.prototype-review-result]
   - id: gate.prototype-verified
-    name: 高保真原型验证
+    name: 原型交付物验证
     stage: stage.product-design
-    trigger: 需要高保真 HTML 原型进行视觉与交互校准。
-    evidence: [evidence.antd-cli-validation, evidence.browser-prototype-verification]
+    trigger: 产品设计影响需要通过 H1/H2 原型交付物进行视觉或流程校准；真实组件验证留到前端实现阶段。
+    evidence: [evidence.prototype-profile-decision, evidence.prototype-deliverable-verification]
   - id: gate.user-confirmation
     name: 用户确认
     stage: stage.product-design
@@ -225,10 +231,10 @@ artifacts:
     name: 状态矩阵
     stage: stage.product-design
     trigger: 存在状态流转、异常或恢复。
-  - id: artifact.high-fidelity-html-prototype
-    name: 高保真 HTML 原型
+  - id: artifact.prototype-deliverable
+    name: 原型交付物
     stage: stage.product-design
-    trigger: 需要视觉与交互校准。
+    trigger: 低保真评审后需要 H1 视觉或 H2 流程校准。
   - id: artifact.prototype-review
     name: 原型评审记录
     stage: stage.product-design
@@ -373,8 +379,8 @@ work_units:
     name: 原型设计与验证
     scope: project-instance
     input: Spec、产品设计影响和状态矩阵。
-    output: 交互说明、低/高保真原型、评审、AntD CLI 和浏览器证据。
-    completion: 原型评审、高保真验证和用户确认门禁均通过。
+    output: 交互说明、低保真、状态矩阵、H1/H2 原型交付物、统一 Design QA、档位验证证据与前端实现交接事项。
+    completion: 低保真评审、schema v3 原型交付物验证和用户确认门禁均通过；生产组件待验事项已交接到前端实现计划。
   - id: work-unit.technical-analysis
     name: 技术分析与契约冻结
     scope: project-instance

package/template/docs/process/template-engineering-overview.md

@@ -33,7 +33,7 @@ YSS 模板工程是一套可版本化的研发治理系统。它用仓库身份
 | 产品线 | 模板源 | 实例化 CLI | 生命周期边界 |
 |---|---|---|---|
 | 全产品生命周期 | `yss-spec-project-template` | `create-yss-spec` | 从 Discovery 到发布与复盘 |
-| DDD 战略设计交接 | `yss-strategic-design-harness` | `create-yss-harness-design` | 从机会、需求和战略设计到 Strategic Design Handoff |
+| DDD 战略设计交接 | `yss-harness-design-agent` | `create-yss-harness-design` | 从机会、需求和战略设计到 Strategic Design Handoff |
 | 开发落地 | `yss-harness-dev-agent` | `create-yss-harness-dev` | 从已批准 Spec 或战略设计交接包到 Tactical Design、Slice Contract、实现与验证 |
 
 每条产品线使用独立的 profile、metadata 和固定模板 commit。CLI 之间遇到其他产品线的 metadata 时必须 fail closed，不能自动接管。
@@ -48,7 +48,7 @@ YSS 模板工程是一套可版本化的研发治理系统。它用仓库身份
 
 ### 5.2 技能供应链
 
-`.agents/skills` 是跨 Agent 共享技能的权威内容。`.claude/skills`、`.codex/skills`、`.cursor/skills`、`.hermes/skills`、`.pi/skills`、`.qoder/skills` 和 `.trae/skills` 是生成投影。
+`.agents/skills` 是跨 Agent 共享技能的权威内容。`.claude/skills`、`.codex/skills`、`.cursor/skills`、`.pi/skills`、`.qoder/skills` 和 `.trae/skills` 是生成投影。
 
 `docs/agents/yss-skill-registry.yaml` 管理技能分层、成熟度、别名和运行时发现；`skills-lock.json` 管理来源、版本、hash 与投影完整性。修改共享技能后必须同步投影并更新 lock，不能分别编辑平台副本。
 

package/template/docs/process/template-verification-profiles.yaml

@@ -39,14 +39,20 @@ required_files:
   - CONTEXT.md
   - skills-lock.json
   - .agents/skills/.yss-skills-manifest.json
+  - .agents/skills/.strategic-design-skills-manifest.json
   - .mcp.json
   - .agents/mcp_config.json
   - .cursor/mcp.json
-  - .gemini/settings.json
-  - .kiro/settings/mcp.json
   - .vscode/mcp.json
   - docs/agents/yss-skill-registry.yaml
+  - .agents/skills/yss-implementation-contract-compiler/SKILL.md
+  - .agents/skills/yss-implementation-contract-compiler/references/compiler-contract.yaml
+  - .agents/skills/yss-implementation-contract-compiler/references/boundaries.md
+  - .agents/skills/yss-implementation-contract-compiler/references/slice-implementation-contract.md
+  - .agents/skills/yss-implementation-contract-compiler/tests/compiler-scenarios.test.mjs
+  - .agents/skills/yss-skill-source-index-refresh/SKILL.md
   - docs/agents/yss-ui-skills-integration.md
+  - docs/agents/strategic-design-skills-integration.md
   - docs/user-guide/yss-ui-mcp.md
   - docs/agents/digital-human-roles.yaml
   - docs/process/lifecycle-registry.yaml
@@ -72,6 +78,7 @@ required_files:
   - .agents/skills/yss-tactical-design/scripts/validate-tactical-design.mjs
   - .agents/skills/yss-tactical-design/tests/run-scenarios.mjs
   - .agents/skills/yss-prototype-stage/references/product-design-adapter.md
+  - .agents/skills/yss-prototype-stage/references/prototype-profile-routing.md
   - .agents/skills/yss-prototype-stage/scripts/prototype-contract.mjs
   - .agents/skills/yss-prototype-stage/tests/run-scenarios.mjs
   - docs/design/templates/prototype-evidence-template.yaml
@@ -91,6 +98,8 @@ required_files:
 syntax_files:
   - scripts/sync-skills
   - scripts/update-skill-lock
+  - scripts/verify-upstream-skill-source
+  - scripts/lib/skill-supply-chain.mjs
   - scripts/generate-lifecycle-artifacts
   - scripts/verify-lifecycle-registry
   - scripts/verify-lifecycle-checkpoint
@@ -106,7 +115,13 @@ syntax_files:
   - scripts/verify-maintenance-review-record
   - scripts/verify-maintenance-intensity-scenarios
   - scripts/verify-skill-registry
+  - scripts/lib/implementation-contract-compiler.mjs
+  - scripts/generate-yss-skill-boundaries
+  - scripts/audit-yss-backend-skills
+  - scripts/verify-retired-skill-ids
   - scripts/verify-skill-governance
+  - scripts/verify-upstream-skill-source
+  - scripts/lib/skill-supply-chain.mjs
   - scripts/verify-yss-dto-openapi-profile
   - scripts/verify-yss-dto-openapi-scenarios
   - scripts/verify-digital-human-roles
@@ -117,7 +132,7 @@ syntax_files:
   - scripts/verify-lifecycle-transition-scenarios
   - scripts/verify-matt-yss-integration-scenarios
   - scripts/verify-prototype-backend-scaffold-scenarios
-  - scripts/verify-yss-router-scenarios
+  - scripts/verify-yss-implementation-contract-compiler-scenarios
   - scripts/verify-yss-prototype-contract-scenarios
   - scripts/verify-openapi-yaml-first-scenarios
   - scripts/verify-openapi-json-handoff-scenarios
@@ -145,9 +160,11 @@ routing:
     groups: [hygiene]
   - patterns: [AGENTS.md, yss-project.yaml, "docs/process/template-engineering-overview.md"]
     groups: [governance-release]
-  - patterns: [skills-lock.json, ".agents/skills/**", ".claude/skills/**", ".codex/skills/**", ".cursor/skills/**", ".hermes/skills/**", ".pi/skills/**", ".qoder/skills/**", ".trae/skills/**", "docs/agents/yss-skill-registry.yaml", "docs/agents/skills-maintenance.md", "scripts/*skill*"]
+  - patterns: [skills-lock.json, ".agents/skills/**", ".claude/skills/**", ".codex/skills/**", ".cursor/skills/**", ".pi/skills/**", ".qoder/skills/**", ".trae/skills/**", "docs/agents/yss-skill-registry.yaml", "docs/agents/skills-maintenance.md", "scripts/*skill*"]
     groups: [skills]
-  - patterns: [.mcp.json, .agents/mcp_config.json, .cursor/mcp.json, .gemini/settings.json, .kiro/settings/mcp.json, .vscode/mcp.json, docs/user-guide/yss-ui-mcp.md, docs/agents/yss-ui-skills-integration.md]
+  - patterns: [.mcp.json, .agents/mcp_config.json, .cursor/mcp.json, .vscode/mcp.json, docs/user-guide/yss-ui-mcp.md, docs/agents/yss-ui-skills-integration.md]
+    groups: [skills]
+  - patterns: [.agents/skills/.strategic-design-skills-manifest.json, docs/agents/strategic-design-skills-integration.md, submodules/yss-harness-design-agent/**]
     groups: [skills]
   - patterns: ["docs/process/maintenance-*", "docs/process/harness-process-tailoring.md", "docs/process/schemas/maintenance-*", "scripts/*maintenance*", "scripts/lib/maintenance-*"]
     groups: [maintenance]
@@ -187,6 +204,7 @@ groups:
       - { run: "scripts/update-skill-lock --check" }
       - { run: "scripts/verify-skill-registry" }
       - { run: "scripts/verify-skill-governance" }
+      - { run: "scripts/verify-upstream-skill-source --source=iloveZzz/yss-harness-design-agent --source-root=submodules/yss-harness-design-agent", when: template-source }
   tactical-design:
     commands:
       - { run: "node --check .agents/skills/yss-tactical-design/scripts/validate-tactical-design.mjs" }
@@ -227,7 +245,10 @@ groups:
       - { run: "scripts/verify-scaffold-generator-scenarios" }
       - { run: "scripts/verify-prototype-backend-scaffold-scenarios" }
       - { run: "scripts/verify-matt-yss-integration-scenarios" }
-      - { run: "scripts/verify-yss-router-scenarios" }
+      - { run: "scripts/verify-yss-implementation-contract-compiler-scenarios" }
+      - { run: "scripts/generate-yss-skill-boundaries --check" }
+      - { run: "scripts/audit-yss-backend-skills --check" }
+      - { run: "scripts/verify-retired-skill-ids" }
       - { run: "scripts/verify-yss-ui-scenarios" }
       - { run: "scripts/verify-yss-prototype-contract-scenarios" }
       - { run: "node .agents/skills/yss-prototype-stage/scripts/prototype-contract.mjs validate-evidence docs/design/templates/prototype-evidence-template.yaml --allow-template" }

package/template/docs/templates/build-architecture-checklist-template.md

@@ -19,8 +19,8 @@ owner: ai
 | 系统 / 数据架构设计 |  |  |
 | 风险 / 回滚约束 | `AGENTS.md` |  |
 | Slice Implementation Contract |  | 填写 contract_id / contract_version / 生命周期批准状态 |
-| 后端脚手架策略 | `orchestration-contract.yaml` / `yss-ddd-scaffold-generator` |  | backend `scaffold_status=required` 时填写结构化合同身份、批准/持久化引用、生成器输入、预期文件、实际 `./mvnw` 结果和后置 Router 重编译 |
-| 工程项目路径策略 | `docs/process/implementation-repo-integration.md` / Router Contract |  | Harness 内必须是 `apps/backend/<project>/` 或 `apps/frontend/<project>/`；`apps/backend/`、`apps/frontend/` 仅为容器，`app/backend/`、`app/frontend/` 及其子路径阻断 |
+| 后端脚手架策略 | `orchestration-contract.yaml` / `yss-ddd-scaffold-generator` |  | backend `scaffold_status=required` 时填写结构化合同身份、批准/持久化引用、生成器输入、预期文件、实际 `./mvnw` 结果和后置 实现合同编译器 重编译 |
+| 工程项目路径策略 | `docs/process/implementation-repo-integration.md` / 实现合同编译器 Contract |  | Harness 内必须是 `apps/backend/<project>/` 或 `apps/frontend/<project>/`；`apps/backend/`、`apps/frontend/` 仅为容器，`app/backend/`、`app/frontend/` 及其子路径阻断 |
 | 垂直切片工作单元 |  |  |
 | YSS Skill Execution Result |  | 每个 skill / work_unit 的结果文件引用 |
 
@@ -30,9 +30,9 @@ owner: ai
 |---|---|---|---|---|---|
 | DDD 分层不得穿透：Domain 不依赖 Adapter、Infrastructure、Mapper、Controller 或 Web DTO | 系统架构 / YSS DDD 规范 / `AGENTS.md` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 若发现穿透依赖，标记 `violation` 并停止 build，回到架构修正 |
 | 后端切片必须回勾 `Backend Slice Implementation Contract`：required skills、允许写范围、禁止模式、证据文件、延期 seam 和验证命令完整 | implementation routing / 垂直切片 Ticket / `AGENTS.md` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺合同或合同不完整时暂停并记录替代方案 |
-| 统一合同版本：实现消费的 contract_id / contract_version 与生命周期批准并持久化的版本一致，Router 未自行批准合同或推进 `ready-for-agent` | Slice Implementation Contract / 生命周期证据 |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 版本不一致时将工作单元标记 `stale` 并暂停 build |
-| 合同子项闭环：Common、Frontend、Backend、Contract、Cross-repo 子合同按影响面填写，不适用项有原因 | Slice Implementation Contract |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺失适用子合同时回到 Router |
-| 原型确认后的后端脚手架顺序：工程基线 → Router 脚手架合同 draft / 生命周期批准 → `yss-ddd-scaffold-generator` → `yss-backend-scaffold-parent` → Router 重编译；脚手架不得生成业务行为 | `yss-product-lifecycle` / `yss-ddd-scaffold-generator` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 顺序缺失、生成器混入业务行为或缺 Execution Result 时阻断 |
+| 统一合同版本：实现消费的 contract_id / contract_version 与生命周期批准并持久化的版本一致，实现合同编译器 未自行批准合同或推进 `ready-for-agent` | Slice Implementation Contract / 生命周期证据 |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 版本不一致时将工作单元标记 `stale` 并暂停 build |
+| 合同子项闭环：Common、Frontend、Backend、Contract、Cross-repo 子合同按影响面填写，不适用项有原因 | Slice Implementation Contract |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺失适用子合同时回到 实现合同编译器 |
+| 原型确认后的后端脚手架顺序：工程基线 → 实现合同编译器 脚手架合同 draft / 生命周期批准 → `yss-ddd-scaffold-generator` → `yss-backend-scaffold-parent` → 实现合同编译器 重编译；脚手架不得生成业务行为 | `yss-product-lifecycle` / `yss-ddd-scaffold-generator` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 顺序缺失、生成器混入业务行为或缺 Execution Result 时阻断 |
 | 写路径与证据：Execution Result 的 changed_files 均位于 allowed_write_paths，expected_evidence_files 已实际生成 | Slice Implementation Contract / YSS Skill Execution Result |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 路径越界或证据缺失标记 `violation` 并阻断 build |
 | TDD 模式：每个工作单元唯一选择 `behavior-tdd` 或 `controlled-generation`；生成器未承载状态、权限、业务过滤、事务、错误映射或用户可见交互 | Slice Implementation Contract / 垂直切片 Ticket / Execution Result |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 模式不匹配时拆分工作单元并完整重路由 |
 | 所有后续生成代码：必须消费当前批准合同、主 YSS skill、依赖闭包、允许写路径、预期证据和 YSS Skill Execution Result；业务行为使用 `behavior-tdd` | `post_scaffold_generated_code_policy` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺任一条件或以时间压力豁免时阻断 build |
@@ -47,7 +47,7 @@ owner: ai
 | 文档语言：持久化生命周期文档、实施记录、审查报告、发布说明和 Git checkpoint 正文必须使用中文，英文 skill / 模板不得原样落地 | `AGENTS.md` / `yss-product-lifecycle` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 仅保留必要英文技术标识、命令和 metadata |
 | 高风险变更：按已批准的普通影响面结论记录验证证据、责任人和回滚约束 | `AGENTS.md` / Spec / 架构记录 |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺验证证据或责任人时不得发布或合并 |
 | 质量基线：`baseline_id` / `baseline_version` 只从 `engineering-baseline` 引用，Slice、Execution Result、审查和发布不得重复定义 | `engineering-baseline` / `orchestration-contract.yaml` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺少基线引用或出现重复标准时阻断并回到工程基线 |
-| Doubt-Driven：命中 API、数据、跨仓、发布回滚、实际安全行为或生命周期 / 生成语义时具备主张、反证、证据、残余风险和审查引用 | Router Contract / `orchestration-contract.yaml` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺反证、证据不足或残余风险未处理时阻断 |
+| Doubt-Driven：命中 API、数据、跨仓、发布回滚、实际安全行为或生命周期 / 生成语义时具备主张、反证、证据、残余风险和审查引用 | 实现合同编译器 Contract / `orchestration-contract.yaml` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺反证、证据不足或残余风险未处理时阻断 |
 |  |  |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  |  |
 
 状态说明：