create-yss-spec 3.0.0 → 3.1.0

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

@@ -1,99 +1,136 @@
 # 复制到 docs/.scratch/<feature>/verification/prototype-evidence.yaml。
-# schema v1 只读兼容；关闭 gate.prototype-verified 前必须迁移到本 schema v2。
-schema_version: 2
+# 只保留所选档位的 profile_evidence 子块；schema v1/v2/v3 仅允许只读迁移。
+schema_version: 4
 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
+  canonical_design_ref: DESIGN.md
+  canonical_design_digest: <sha256>
   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>
+visual_baseline:
+  manifest_ref: docs/.scratch/<feature>/handoff/visual-baseline-v1/visual-baseline.yaml
+  baseline_id: visual-baseline.<feature>
+  version: v1
+  digest: <sha256>
+  status: approved
+  case_ids: [primary-desktop, primary-narrow]
+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
+      case_ids: [primary-desktop]
+    - 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>
+      case_ids: [primary-narrow]
+  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: vue
+      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: vue-antdv-next
+      source: fact-pack
+      library_package: antdv-next
+      library_version: 1.5.2
+      manifest_ref: docs/design/facts/antdv-next/1.5.2/manifest.json
+      manifest_digest: <sha256>
+      components_covered: [<Component>]
+      canonical_design_digest: <same-as-design-baseline>
+      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
+  user_decision_ref: <真实用户决定记录>
+  decision_subject_ref: <原型与基线确认快照>
   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 v4 共同与档位证据，并引用 Visual Baseline Bundle v1 |
 | 现有 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/design/templates/visual-baseline-template.yaml

@@ -0,0 +1,70 @@
+# 复制到 Visual Baseline Bundle 根目录的 visual-baseline.yaml；图片由浏览器/Design QA 捕获后执行 seal。
+schema_version: 1
+baseline_id: visual-baseline.<feature>
+feature: <feature>
+version: v1
+status: draft
+bundle:
+  format: portable-directory
+  root_ref: docs/.scratch/<feature>/handoff/visual-baseline-v1
+  digest: <sha256>
+  size_bytes: <bytes>
+  max_image_bytes: 5242880
+  max_bundle_bytes: 104857600
+source:
+  prototype_ref: sources/prototype.snapshot.html
+  prototype_digest: <sha256>
+  interaction_spec_ref: sources/interaction-spec.snapshot.md
+  interaction_spec_digest: <sha256>
+  state_matrix_ref: sources/state-matrix.snapshot.md
+  state_matrix_digest: <sha256>
+capture_environment:
+  browser: chromium
+  browser_version: <exact-version>
+  operating_system: <os-and-version>
+  fonts_digest: <sha256>
+  device_scale_factor: 1
+  color_space: srgb
+  locale: zh-CN
+  timezone: Asia/Shanghai
+  animations_disabled: true
+  cursor_hidden: true
+  capture_script_ref: capture/capture.mjs
+  capture_script_digest: <sha256>
+  capture_result_ref: capture/result.json
+  capture_result_digest: <sha256>
+cases:
+  - case_id: primary-desktop
+    route: /<route>
+    page: <PageName>
+    state: normal
+    viewport: {name: desktop, width: 1440, height: 900, scroll_mode: viewport, scroll_position: 0}
+    theme: compact-light
+    locale: zh-CN
+    data_scenario: primary
+    image_ref: images/primary-desktop.png
+    image_digest: <sha256>
+    image_size_bytes: <bytes>
+    mask_ref: not-applicable
+    mask_digest: not-applicable
+    mask_size_bytes: 0
+    semantic_refs: [sources/prototype.snapshot.html, sources/interaction-spec.snapshot.md, sources/state-matrix.snapshot.md]
+    allowed_differences: []
+    result: <passed>
+  - case_id: primary-narrow
+    route: /<route>
+    page: <PageName>
+    state: normal
+    viewport: {name: narrow, width: 390, height: 844, scroll_mode: viewport, scroll_position: 0}
+    theme: compact-light
+    locale: zh-CN
+    data_scenario: primary
+    image_ref: images/primary-narrow.png
+    image_digest: <sha256>
+    image_size_bytes: <bytes>
+    mask_ref: not-applicable
+    mask_digest: not-applicable
+    mask_size_bytes: 0
+    semantic_refs: [sources/prototype.snapshot.html, sources/interaction-spec.snapshot.md, sources/state-matrix.snapshot.md]
+    allowed_differences: []
+    result: <passed>

package/template/docs/design/tokens/.design-md-projection.json

@@ -1,13 +1,13 @@
 {
   "schema_version": 1,
   "source": "DESIGN.md",
-  "source_sha256": "976d74b4af85b5062f9c5a365591809ff240159f0f4445ce05e7a4dcb76d0185",
+  "source_sha256": "59a9f90f7dd62d5e1d4c398e7b8ab8fae595622d0d5fea7bc0d43fe63802f5d5",
   "files": {
-    "docs/design/tokens/theme.json": "94010a32320bfe7135f75d87357609162e0358061fe8577d820dcb62f43ac4e4",
+    "docs/design/tokens/theme.json": "aab648fa655c9d6f6d3932081a035543fd6481902c873dd218b50f9e550bedac",
     "docs/design/tokens/tokens.default.json": "bf89486a8730a68673473fa7d5afe40b158e833b10df7da75d505bc53f8f6167",
     "docs/design/tokens/tokens.dark.json": "79b93203f305d26f2f230a8af1f4b7e77c9bdb7997efa0746eed1508c928f85b",
     "docs/design/tokens/tokens.compact.json": "afa4ae457a3db81d4b8a4b103ed9d6baa897daa1bbc23c96ee7d9182d2b4b992",
-    "docs/design/tokens/variables.css": "d5bb7bdfe13d71214c44d1a0fdf9648cb5fa35cb6511fb2a35202f8a96fb39dd",
+    "docs/design/tokens/variables.css": "157dd6300e34be53f93196357c97125b77e00f980011db920d2964d46b12600d",
     "docs/design/tokens/variables.dark.css": "b8ebb18f304831ee5c86cf6e5563702b2cc0ce2f51b055036e437a385226cd99"
   }
 }

package/template/docs/design/tokens/theme.json

@@ -11,7 +11,7 @@
     "colorText": "rgba(0, 0, 0, 0.88)",
     "colorTextSecondary": "rgba(0, 0, 0, 0.65)",
     "colorBorder": "#d9d9d9",
-    "fontFamily": "-apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, \"Noto Sans\", sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\", \"Noto Color Emoji\"",
+    "fontFamily": "-apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, \"Noto Sans\", sans-serif",
     "fontFamilyCode": "\"SFMono-Regular\", Consolas, \"Liberation Mono\", Menlo, Courier, monospace",
     "fontSize": 14,
     "borderRadius": 6,
@@ -27,5 +27,5 @@
     "layoutSiderBackground": "#001529",
     "layoutBodyBackground": "#f0f2f5"
   },
-  "algorithm": "default"
+  "algorithm": "compact"
 }

package/template/docs/design/tokens/variables.css

@@ -1,4 +1,9 @@
 :root {
+  --yss-color-primary-control: #245bdb;
+  --yss-color-primary-control-hover: #2f68eb;
+  --yss-color-on-primary: #ffffff;
+  --yss-control-height-compact: 28px;
+  --yss-card-compact-padding: 16px;
   --brand-color-primary: #3371ff;
   --brand-color-primary-bg: #d6e4ff;
   --brand-color-primary-bg-hover: #adc6ff;

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,7 +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/harness-executive-blueprint.md

@@ -2,7 +2,7 @@
 
 Harness 以仓库身份、影响面、条件门禁和可读证据串联研发流程。执行编排器只推进第一个未阻塞工作单元，并在人工暂停、handoff、实现、合并和发布边界集中回写 checkpoint。
 
-## 核心不变量
+## 核心约束
 
 - `template-source` 只维护流程模板，不生成具体产品资产。
 - `project-instance` 必须从最近可信阶段进入，不以目录猜测门禁状态。

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

@@ -49,6 +49,7 @@
 ## 5. 上下文、反证与质量基线裁剪
 
 - Slice Contract 的 `common.context_plan` 是实现上下文的唯一轻量计划：先读 `CONTEXT.md`、已批准 Spec、当前合同和适用 ADR / 工程基线，再按影响面按需加载 references；达到最小充分证据后停止扩展。缺失权威上下文只能 `blocked` 或 `reroute`。
+- `project-instance` 的所有生命周期工作单元在批准或 `next_route` 前必须生成并校验 `context_reconciliation`；它绑定根目录唯一 `CONTEXT.md`、结构化术语引用以及全文/引用集双摘要，是横切证据而不是新增 gate。`template-source` 维护只验证模板、schema、场景和分发投影，结果记录带原因的 `not-applicable`。
 - 质量标准在 `engineering-baseline` 中定义一次，以 `baseline_id` / `baseline_version` 被 Slice Contract、YSS Skill Execution Result、`code-review` 和发布检查复用；切片不得重定义同一标准。约束结果统一写入 `constraint_results`。
 - 只有命中高风险影响时才要求 Doubt-Driven 在途反证：API / 数据迁移、跨仓契约、发布回滚、实际改变的安全行为、生命周期或生成语义。反证写入现有决策 / 架构 / 契约 / 发布审查记录，不新增生命周期阶段；缺少反证、证据不足或残余风险未处理即阻断。
 - Wayfinder 是超长工作的可选规划模式，不改变阶段、门禁或 Ticket 状态；地图收敛后按 `wayfinder → handoff → to-spec` 返回主链。

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

@@ -27,11 +27,11 @@
 | 稳定 ID | 门禁 | 所属阶段 | 触发条件 | 前置门禁 | 必须留下的证据 |
 |---|---|---|---|---|---|
 | `gate.repository-identity-valid` | 仓库身份校验 | `stage.entry-triage` | 每次进入流程。 | 无 | `evidence.repository-identity-check` |
-| `gate.domain-strategy-approved` | DDD 战略设计批准 | `stage.discovery` | 存在 DDD 战略设计影响或需要确定领域边界、统一语言和核心规则。 | 无 | `evidence.domain-strategy-review`、`evidence.approval-record` |
+| `gate.domain-strategy-approved` | 业务边界与规则确认 | `stage.discovery` | 需要确定业务板块、业务责任区、统一业务词汇、协作关系或关键规则。 | 无 | `evidence.domain-strategy-review`、`evidence.approval-record` |
 | `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` |
@@ -48,8 +48,8 @@
 | 稳定 ID | 产物 | 所属阶段 | 触发条件 |
 |---|---|---|---|
 | `artifact.impact-assessment` | 影响面分析 | `stage.entry-triage` | 每次变更。 |
-| `artifact.domain-strategy` | DDD 战略设计 | `stage.discovery` | 新产品/模块、跨上下文功能、统一语言冲突、服务边界或核心规则变化。 |
-| `artifact.stage-decision-package` | 阶段决策包 | `stage.discovery` | Discovery 到 Spec 入口需要结构化上游决策。 |
+| `artifact.domain-strategy` | 业务边界与规则设计 | `stage.discovery` | 新产品/模块、跨责任区协作、业务词汇冲突、责任边界或关键规则变化。 |
+| `artifact.stage-decision-package` | 方案决策包 | `stage.discovery` | Discovery 到 Spec 入口需要结构化上游决策。 |
 | `artifact.discovery-record` | Discovery 记录 | `stage.discovery` | 新问题或边界不清。 |
 | `artifact.spec` | Spec | `stage.spec-architecture` | 新功能、行为变化或范围扩大。 |
 | `artifact.product-overview` | 产品总体设计 | `stage.spec-architecture` | 进入 Spec 基线。 |
@@ -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 影响。 |
@@ -78,8 +78,9 @@
 
 | 稳定 ID | 证据 | 说明 |
 |---|---|---|
+| `evidence.context-reconciliation` | Context Reconciliation 证据 | 工作单元在批准或流转前对根目录唯一 CONTEXT.md 的稳定术语回写、作用域解析和双摘要核对结果；不新增门禁。 |
 | `evidence.impact-assessment` | 影响面分析记录 | 受影响仓库、资产、风险与最近可信阶段。 |
-| `evidence.domain-strategy-review` | DDD 战略设计评审证据 | 子域、限界上下文、统一语言、Context Map、场景和不变量的结构化评审结果。 |
+| `evidence.domain-strategy-review` | 业务边界与规则评审证据 | 业务板块、业务责任区、统一业务词汇、协作与交接关系、关键场景和不可违反规则的结构化评审结果。 |
 | `evidence.tactical-design-review` | DDD 战术设计评审证据 | 聚合、Entity、Value Object、不变量、状态机、一致性、Gateway 与 API 隔离的结构化评审结果。 |
 | `evidence.stage-decision-package` | 阶段决策包验证证据 | 阶段决策包的 Schema、引用、语义一致性、影响传播和下游消费验证结果。 |
 | `evidence.maintenance-intensity-checkpoint` | 模板维护强度 checkpoint | template-source 变更的 L1 / L2 / L3 分级、触发项、最低验证证据、review 模式和升级记录。 |
@@ -89,6 +90,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": "f745204885a0c335b7f87dc1e1f5fd162a556b84e4543d6e1f356da41f6c081a",
   "published_ids": [
     "artifact.architecture-review",
     "artifact.data-architecture",
@@ -20,6 +20,7 @@
     "artifact.parent-ticket",
     "artifact.product-overview",
     "artifact.prototype-confirmation",
+    "artifact.prototype-deliverable",
     "artifact.prototype-review",
     "artifact.retrospective",
     "artifact.slice-implementation-contract",
@@ -33,6 +34,7 @@
     "evidence.approval-record",
     "evidence.browser-prototype-verification",
     "evidence.checkpoint-and-rollback",
+    "evidence.context-reconciliation",
     "evidence.contract-approval",
     "evidence.design-review-result",
     "evidence.domain-strategy-review",
@@ -42,6 +44,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",
@@ -78,20 +82,21 @@
     "work-unit.domain-strategy-design",
     "work-unit.entry-triage",
     "work-unit.fresh-verification",
+    "work-unit.frontend-implementation-verification",
     "work-unit.independent-review",
     "work-unit.intensity-aware-review",
     "work-unit.intensity-aware-verification",
-    "work-unit.frontend-implementation-verification",
     "work-unit.prototype-design",
     "work-unit.release-and-retrospective",
     "work-unit.release-and-rollback",
+    "work-unit.service-project-initialization",
     "work-unit.skill-projection-sync",
     "work-unit.slice-implementation",
     "work-unit.spec-synthesis",
     "work-unit.ssot-update",
     "work-unit.stage-decision",
     "work-unit.technical-analysis",
-    "work-unit.ticket-decomposition",
-    "work-unit.template-snapshot-build"
+    "work-unit.template-snapshot-build",
+    "work-unit.ticket-decomposition"
   ]
 }