create-yss-spec 2.1.3 → 2.1.5

package/template/docs/design/README.md

@@ -4,7 +4,7 @@
 
 设计系统基线：
 
-- `docs/design/design.md`：从本地 `Product-Design-System` 引入并整理的 Ant Design 企业级设计系统说明，后续页面设计、交互说明、原型评审和前端实现默认引用该文件。
+- `docs/design/design.md`：从本地 `Product-Design-System` 引入并整理的 Ant Design 企业级设计系统说明，后续页面设计、交互说明、原型评审和前端实现默认引用该文件；官方 `design.md` 是上游默认，项目 token 是项目覆盖，优先级以该文件为准。
 - `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 校验证据、用户确认和 Spec / OpenAPI 回填。
@@ -31,11 +31,13 @@
 - `docs/design/templates/state-matrix-template.md`：loading、empty、error、readonly、no-permission、conflict 等状态。
 - `docs/design/templates/prototype-review-checklist.md`：进入 Spec 校准 / API 影响分析 / 契约草案前的原型评审门禁。
 - `docs/design/templates/prototype-confirmation-template.md`：高保真 HTML 原型产出后的用户确认记录。
+- `docs/design/templates/prototype-evidence-template.yaml`：原型阶段的 AntD CLI、浏览器验证、评审和确认的机器可读证据清单。
 
 推荐技能：
 
 - `yss-design-system`：项目设计系统与 Ant Design 企业级 UI 风格基线；页面设计、原型评审、UI 实现和主题 token 落地时默认先引用。
-- `product-design:index`：产品原型产出的主路由；根据输入是否有 URL、截图、Figma、代码目标或视觉方向，进入 `$get-context`、`$ideate`、`$prototype`、`$image-to-code`、`$url-to-code`、`$share` 或 `$design-qa` 等 focused skill。
+- `yss-prototype-stage`：跨 Agent 的原型阶段合同，固定资产、证据、设计优先级与生命周期回流；Codex 的主路由为 `product-design:index`。
+- `product-design:index`：Codex 产品原型产出的主路由；根据输入是否有 URL、截图、Figma、代码目标或视觉方向，进入 `$get-context`、`$ideate`、`$prototype`、`$image-to-code`、`$url-to-code`、`$share` 或 `$design-qa` 等 focused skill。
 - Product Design focused skills：基于 Spec 初稿和产品总体设计 / 功能架构，产出低保真 / 高保真页面、原型、交互设计资产和可分享原型；高保真 HTML 原型默认由该路由链路产出。
 - `antd`：Ant Design v6 组件、demo、token、semantic 和 design.md 查询工具；生成或修改高保真 HTML 原型前后必须留下 CLI 校验证据。
 - `prototype-review`：原型阶段评审门禁；未通过则不要进入 Spec 校准 / API 影响分析 / 契约草案。

package/template/docs/design/design.md

@@ -19,6 +19,10 @@
 
 结论：这不是营销型视觉系统，而是面向中后台、数据密集、表单密集、流程密集产品的 Ant Design 风格企业级设计系统。项目内 UI 默认应以“清晰、确定、低装饰、可扫描、高一致性”为目标。
 
+## 原型设计依据的优先级
+
+原型使用 Ant Design 时，`https://ant.design/design.md` 与官方 `antd` CLI 提供的是**上游默认**和组件事实；项目的 `docs/design/design.md`、`docs/design/tokens/*` 是经过确认的**项目覆盖**。当前功能只能在这两层之下完成语义组件映射。若上游默认与项目 token 不同，以项目覆盖为准，并在 `prototype-evidence.yaml` 中记录差异；不得把上游默认直接写回项目实现。
+
 ## 设计原则
 
 本项目采用该设计系统时，优先遵循四个原则：

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

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

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

@@ -13,21 +13,24 @@
 | 状态矩阵 | `docs/.scratch/<feature>/design/<feature>-state-matrix.md` |
 | 原型评审 | `docs/.scratch/<feature>/design/<feature>-prototype-review.md` |
 | 高保真 HTML 原型 | `docs/.scratch/<feature>/design/prototypes/index.html` |
+| 机器可读验证清单 | `docs/.scratch/<feature>/verification/prototype-evidence.yaml` |
 | Product Design 路由 | `product-design:index -> <focused skill>` |
 | 产出方式 | 系统 / Agent 自动产出 / 人工补充 |
-| Ant Design 版本 | v6 |
+| 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` |  |
+| 设计语言 | `antd design.md --format json` |  |
+| 组件 API | `antd info <Component> --version <target_antd_version> --format json` |  |
+| 组件 demo | `antd demo <Component> <demo> --version <target_antd_version> --format json` |  |
+| 组件 token | `antd token <Component> --version <target_antd_version> --format json` |  |
+| semantic | `antd semantic <Component> --version <target_antd_version> --format json` |  |
 | lint / 替代校验 | `antd lint <prototype path> --format json` |  |
 
+CLI 实际版本、目标 AntD 版本、完整 JSON 输出与浏览器验证结论以 `prototype-evidence.yaml` 为准；不得用本文中的示例版本替代实际记录。
+
 ## 3. 用户确认
 
 | 项目 | 内容 |

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

@@ -0,0 +1,46 @@
+# 复制到 docs/.scratch/<feature>/verification/prototype-evidence.yaml。
+# 本文件是原型验证证据清单；命令输出、截图和审查记录可存为相邻文件并由路径引用。
+schema_version: 1
+feature: <feature>
+prototype_ref: docs/.scratch/<feature>/design/prototypes/index.html
+design_baseline:
+  project_design_ref: docs/design/design.md
+  project_token_refs: []
+  upstream_design_md_source: https://ant.design/design.md
+  upstream_design_md_record_ref: <path-to-json-output-or-summary>
+  project_override_reviewed: false
+antd:
+  cli_command: antd
+  cli_version: <actual-cli-version>
+  target_antd_version: <project-selected-v6-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_ref: <path-to-json-output>
+  lint_passed: false
+browser_verification:
+  executor: <browser-or-automation-name>
+  rendered_nonblank: false
+  prototype_digest: <sha256-or-version-ref>
+  viewports:
+    - name: desktop
+      size: <width>x<height>
+      result: pending
+    - name: narrow-mobile
+      size: <width>x<height>
+      result: pending
+  main_flow_result: pending
+  failure_permission_or_conflict_result: pending
+  console_error_ref: <path-to-console-output-or-none>
+review:
+  prototype_review_ref: docs/.scratch/<feature>/design/<feature>-prototype-review.md
+  result: pending
+user_confirmation:
+  confirmation_ref: docs/.scratch/<feature>/design/<feature>-prototype-confirmation.md
+  result: pending
+blockers: []

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

@@ -10,8 +10,8 @@
 | 交互说明 | `docs/.scratch/<feature>/design/<feature>-interaction-spec.md` |  |
 | 原型 / 线框图 | `<链接或导出图片路径>` |  |
 | 状态矩阵 | `docs/.scratch/<feature>/design/<feature>-state-matrix.md` |  |
-| Product Design 路由记录 | `product-design:index -> <focused skill>` |  |
-| AntD CLI 校验证据 | `<命令输出或记录路径>` |  |
+| 原型阶段合同 / Product Design 路由记录 | `yss-prototype-stage -> product-design:index -> <focused skill>` |  |
+| 原型验证清单 | `docs/.scratch/<feature>/verification/prototype-evidence.yaml` | 高保真完成后补齐 CLI 与浏览器验证 |
 | 现有 API 草案 | `docs/.scratch/<feature>/api/<feature>.yaml` | 可选 |
 
 ## 门禁清单
@@ -26,8 +26,7 @@
 | 权限行为能区分隐藏、禁用和调用后拒绝 |  |  |
 | 校验错误能区分模型级和字段级展示位置 |  |  |
 | 能从界面需求反推出 API 影响和契约草案 |  |  |
-| AntD v6 设计语言、组件 API、demo、token 和 semantic 已用 `antd` CLI 查询并记录 |  |  |
-| 高保真 HTML 原型未使用旧原型技能作为主入口，已通过 `product-design:index` 路由产出或记录例外原因 |  |  |
+| 高保真 HTML 原型已按 `yss-prototype-stage` 通过 `product-design:index` 路由产出，或记录等价 Agent 适配及例外原因 |  |  |
 | 前端验收、组件状态和数据依赖已明确 |  |  |
 | 风险 / 回滚约束和人工确认项已记录 |  |  |
 
@@ -58,6 +57,7 @@
 
 ```text
 结论：通过 / 阻断
+生命周期门禁：`gate.prototype-reviewed` 通过 / 不通过
 阻断项：
 - 
 非阻断建议：

package/template/docs/discovery/templates/discovery-template.md

@@ -61,7 +61,6 @@ owner: ai
 | 页面 / 交互 | 是 / 否 / 待定 |  | 产品设计 / Prototype Review |
 | OpenAPI / 契约 | 是 / 否 / 待定 |  | API 影响分析 / 契约草案 |
 | 数据模型 / 持久化 | 是 / 否 / 待定 |  | 数据架构 / Design Review |
-| 权限 / 审计 | 是 / 否 / 待定 |  | 系统架构 / 安全审查 |
 | 外部系统 / 集成 | 是 / 否 / 待定 |  | 系统架构 / ADR |
 | 发布 / 回滚 / 运维 | 是 / 否 / 待定 |  | 系统架构 / Release Review |
 | 高风险变更 / 人工确认项 | 是 / 否 / 待定 |  | 人工确认项 |

package/template/docs/implementation/create-yss-spec-repository-mode-contract.md

@@ -52,7 +52,7 @@ npx create-yss-spec@latest attach \
 {
   "metadataSchemaVersion": 2,
   "templateName": "create-yss-spec",
-  "cliVersion": "2.1.0",
+  "cliVersion": "2.1.4",
   "templateSource": "github:iloveZzz/yss-spec-project-template",
   "templateCommit": "<40-char-commit>",
   "managedFilesManifestVersion": "<manifest-hash>",
@@ -85,6 +85,6 @@ CLI 必须遵循 [Spec / Ticket 迁移指南](../user-guide/规格与任务迁
 1. 模板恢复 `docs/process/*`、正式处理 `.qoder` 投影并通过 fresh verification，形成确定 commit。
 2. CLI 绑定该 commit，完成 attach / sync 跨仓库测试和独立 review。
 3. 运行固定 commit 的 `npm test`、`npm pack --dry-run`，确认包内快照和实例门禁通过。
-4. 发布 CLI `2.1.0`，并回写版本、验证证据、备份恢复路径和回滚点。
+4. 发布 CLI `2.1.4`，并回写版本、验证证据、备份恢复路径和回滚点。
 
 模板引用仍为浮动 ref、任一共同验证失败、独立 review 未完成或打包失败时，只能声明“本仓库实现完成，跨仓库发布受阻”，不得声明整体可发布。本轮不执行 npm publish。

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

@@ -2,6 +2,8 @@
 
 本文件规定如何根据变更规模和风险选择最近可信阶段。裁剪只减少未触发的门禁，不得跳过已经命中的条件强制门禁。
 
+安全 / 权限不单独分诊。需求或冻结资产没有明确改变相关行为时不登记、不解释 `not-applicable`、不增加门禁；明确改变时只按实际 UI、API、Backend、Data、High-risk 影响复用普通流程。SQL / DDL / 迁移、上传 / 下载等技术载体继续由其数据或 API 影响决定路线，不自动升级为安全专项。
+
 ## 1. 判定顺序
 
 1. 先读取 `yss-project.yaml`，非法、缺失或不支持的身份直接进入迁移检查。

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

@@ -1,12 +1,16 @@
 # Harness 工作单元地图
 
-| 工作单元 | 输入 | 输出 | 完成条件 |
-|---|---|---|---|
-| 入口分诊 | 用户请求、仓库身份 | 影响面与最近可信阶段 | 身份和影响面可解释 |
-| 单一事实源更新 | 变更合同 | 权威文档或脚本 | 其他投影可由脚本生成 |
-| 技能投影同步 | `.agents/skills` | Agent root 投影、skills lock | `--check` 通过 |
-| 模板快照构建 | 固定模板 commit | CLI bundled snapshot | commit 与 tree hash 可追踪 |
-| attach / sync 集成 | 目标仓库、dry-run 计划 | 受管资产和 metadata | 验证通过或完整回滚 |
-| Fresh verification | 变更仓库 | 命令输出与证据 | 所有命中门禁通过 |
-| 独立审查 | 变更 diff、验证证据 | review 结论 | 无未处理阻断项 |
-| 发布与回滚 | 已审查 commit | release note、观察信号、回滚点 | 两仓库顺序和恢复动作明确 |
+<!-- lifecycle-registry:work-units:start -->
+> 此表由 `docs/process/lifecycle-registry.yaml` 生成；它只描述 `template-source` 的 Harness 工作单元。
+
+| 稳定 ID | 工作单元 | 输入 | 输出 | 完成条件 |
+|---|---|---|---|---|
+| `work-unit.entry-triage` | 入口分诊 | 用户请求、仓库身份。 | 影响面与最近可信阶段。 | 身份和影响面可解释。 |
+| `work-unit.ssot-update` | 单一事实源更新 | 变更合同。 | 权威文档或脚本。 | 其他投影可由脚本生成。 |
+| `work-unit.skill-projection-sync` | 技能投影同步 | .agents/skills。 | Agent root 投影、skills lock。 | --check 通过。 |
+| `work-unit.template-snapshot-build` | 模板快照构建 | 固定模板 commit。 | CLI bundled snapshot。 | commit 与 tree hash 可追踪。 |
+| `work-unit.attach-sync-integration` | attach / sync 集成 | 目标仓库、dry-run 计划。 | 受管资产和 metadata。 | 验证通过或完整回滚。 |
+| `work-unit.fresh-verification` | Fresh verification | 变更仓库。 | 命令输出与证据。 | 所有命中门禁通过。 |
+| `work-unit.independent-review` | 独立审查 | 变更 diff、验证证据。 | review 结论。 | 无未处理阻断项。 |
+| `work-unit.release-and-rollback` | 发布与回滚 | 已审查 commit。 | release note、观察信号、回滚点。 | 两仓库顺序和恢复动作明确。 |
+<!-- lifecycle-registry:work-units:end -->

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

@@ -1,48 +1,93 @@
 # YSS 生命周期产物与门禁地图
 
-本文是模板仓库与模板实例共享的生命周期事实源。它定义主阶段、条件门禁、必须持久化的产物和退出标准；具体项目只有在触发条件命中时才执行对应门禁。
+本文是模板仓库与模板实例共享的生命周期派生阅读视图。结构化事实源是 `docs/process/lifecycle-registry.yaml`；本文解释主阶段、条件门禁、必须持久化的产物和退出标准。具体项目只有在触发条件命中时才执行对应门禁。
 
-## 1. 八个主阶段
+<!-- lifecycle-registry:structure:start -->
+> 此结构区由 `docs/process/lifecycle-registry.yaml` 生成。当前为 `shadow` 模式：它校验结构和派生文档，不改变运行时状态 schema 或人工批准语义。
 
-| 阶段 | 目标 | 主要产物 | 退出标准 |
+## 1. 主阶段
+
+| 稳定 ID | 阶段 | 目标 | 退出标准 |
+|---|---|---|---|
+| `stage.entry-triage` | 入口分诊 | 确认仓库身份、问题范围和影响面。 | yss-project.yaml 合法，影响面和最近可信阶段可解释。 |
+| `stage.discovery` | Discovery | 澄清问题、用户、约束和机会。 | 问题边界、关键假设和待确认项已记录。 |
+| `stage.spec-architecture` | Spec / 功能架构 | 固化解决方案和功能边界。 | Spec 基线和功能边界可审查。 |
+| `stage.product-design` | 产品设计 | 在存在产品设计影响时校准页面流和状态。 | 命中的设计门禁通过；未命中项记录 not-applicable 及原因。 |
+| `stage.system-data-engineering` | 系统 / 数据架构与工程契约 | 固化系统、数据、工程基线和 API 契约。 | 受影响工程契约冻结或记录无 API 影响；required 脚手架证据齐全。 |
+| `stage.ticket-formalization` | Ticket 正式化 | 将冻结范围拆为可追踪的父 Ticket 和垂直切片。 | 工作单元窄、依赖清晰、验收和测试 seam 可执行。 |
+| `stage.vertical-slice-implementation` | 垂直切片实现 | 以批准合同驱动 TDD 实现和跨仓库协作。 | 允许写路径、禁止模式、证据和验证命令全部满足。 |
+| `stage.verification-release-retrospective` | 验证 / 发布 / 复盘 | 完成 fresh verification、发布和回顾。 | 所有命中门禁通过，人工审查点已完成，checkpoint 可追溯。 |
+
+## 2. 生命周期对象
+
+门禁是需要裁决的审查点；产物、工作单元和证据不是门禁的同义词。未命中条件的门禁记录 `not-applicable` 及原因，不生成空文档。
+
+### 2.1 条件门禁
+
+| 稳定 ID | 门禁 | 所属阶段 | 触发条件 | 必须留下的证据 |
+|---|---|---|---|---|
+| `gate.repository-identity-valid` | 仓库身份校验 | `stage.entry-triage` | 每次进入流程。 | `evidence.repository-identity-check` |
+| `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.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` |
+| `gate.openapi-frozen` | OpenAPI Freeze | `stage.system-data-engineering` | API 进入实现。 | `evidence.approval-record` |
+| `gate.engineering-baseline-accepted` | 工程基线 | `stage.system-data-engineering` | 后端、前端或高风险工程变化。 | `evidence.fresh-verification` |
+| `gate.architecture-reviewed` | 架构审查 | `stage.system-data-engineering` | 高风险或跨边界变化。 | `evidence.design-review-result` |
+| `gate.slice-contract-approved` | Slice Implementation Contract 批准 | `stage.ticket-formalization` | Agent 进入实现；脚手架完成后每个后续生成代码工作单元。 | `evidence.contract-approval` |
+| `gate.slice-ready-for-agent` | 垂直切片实现就绪 | `stage.ticket-formalization` | 垂直切片具备直接实现条件。 | `evidence.contract-approval`、`evidence.approval-record` |
+| `gate.release-ready` | 发布就绪 | `stage.verification-release-retrospective` | 合并、发布或阶段完成。 | `evidence.fresh-verification`、`evidence.checkpoint-and-rollback` |
+
+### 2.2 生命周期产物
+
+| 稳定 ID | 产物 | 所属阶段 | 触发条件 |
 |---|---|---|---|
-| 入口分诊 | 确认仓库身份、问题范围和影响面 | 入口分诊记录、仓库身份清单 | `yss-project.yaml` 合法，影响面和最近可信阶段可解释 |
-| Discovery | 澄清问题、用户、约束和机会 | Discovery 记录、问题陈述 | 问题边界、关键假设和待确认项已记录 |
-| Spec / 功能架构 | 固化解决方案和功能边界 | Spec、产品总体设计、功能架构 | Spec 基线和功能边界可审查 |
-| 产品设计 | 在存在产品设计影响时校准页面流和状态 | 低保真草图、状态矩阵、高保真 HTML 原型、用户确认 | 触发的设计门禁通过；未触发项记录 `not-applicable` 及原因 |
-| 系统 / 数据架构与工程契约 | 固化系统、数据、工程基线和 API 契约；原型确认后为新后端服务建立 YSS 工程骨架 | 架构审查、工程基线、后端脚手架生成结果、OpenAPI Draft / Freeze、ADR | 受影响的工程契约冻结或记录无 API 影响；backend `scaffold_status=required` 时脚手架、基线校验和 Router 重编译证据齐全 |
-| Ticket 正式化 | 将冻结范围拆为可追踪的父 Ticket 和垂直切片 | 功能父 Ticket、垂直切片 Ticket | 工作单元窄、依赖清晰、验收和测试 seam 可执行 |
-| 垂直切片实现 | 以批准合同驱动 TDD 实现和跨仓库协作 | Slice Implementation Contract、代码、测试、YSS Skill Execution Result | 允许写路径、禁止模式、证据和验证命令全部满足 |
-| 验证 / 发布 / 复盘 | 完成 fresh verification、发布和回顾 | 验证记录、发布记录、回滚点、复盘 | 所有命中的门禁通过，人工审查点已完成，checkpoint 可追溯 |
-
-## 2. 条件门禁与产物
-
-| 门禁 | 触发条件 | 必须留下的证据 |
+| `artifact.impact-assessment` | 影响面分析 | `stage.entry-triage` | 每次变更。 |
+| `artifact.discovery-record` | Discovery 记录 | `stage.discovery` | 新问题或边界不清。 |
+| `artifact.spec` | Spec | `stage.spec-architecture` | 新功能、行为变化或范围扩大。 |
+| `artifact.product-overview` | 产品总体设计 | `stage.spec-architecture` | 进入 Spec 基线。 |
+| `artifact.functional-architecture` | 功能架构 | `stage.spec-architecture` | 新模块或跨边界变化。 |
+| `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-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 影响。 |
+| `artifact.openapi-freeze-record` | OpenAPI Freeze 记录 | `stage.system-data-engineering` | API 进入实现。 |
+| `artifact.data-architecture` | 数据架构 | `stage.system-data-engineering` | 数据模型、存储或一致性变化。 |
+| `artifact.engineering-baseline` | 工程基线记录 | `stage.system-data-engineering` | 后端、前端或高风险工程变化。 |
+| `artifact.architecture-review` | 架构审查记录 | `stage.system-data-engineering` | 高风险或跨边界变化。 |
+| `artifact.spec-delta` | Spec Delta | `stage.spec-architecture` | 已有冻结 Spec 的高风险行为变化。 |
+| `artifact.parent-ticket` | 功能父 Ticket | `stage.ticket-formalization` | 每个进入追踪的功能。 |
+| `artifact.vertical-slice-ticket` | 垂直切片 Ticket | `stage.ticket-formalization` | 进入实现前。 |
+| `artifact.slice-implementation-contract` | Slice Implementation Contract | `stage.ticket-formalization` | Agent 进入实现。 |
+| `artifact.retrospective` | 复盘记录 | `stage.verification-release-retrospective` | 发布后或阶段性完成后满足复盘触发条件。 |
+
+### 2.3 执行证据
+
+| 稳定 ID | 证据 | 说明 |
 |---|---|---|
-| 影响面分析 | 每次变更 | 受影响仓库、资产和风险 |
-| 仓库身份校验 | 每次进入流程 | `yss-project.yaml` 校验结果 |
-| Discovery | 新问题或边界不清 | Discovery 记录 |
-| Spec | 新功能、行为变化或范围扩大 | Spec 基线 |
-| 产品总体设计 | 进入 Spec 基线 | 总体设计或功能架构 |
-| 功能架构 | 新模块或跨边界变化 | 功能架构图 / 说明 |
-| 低保真原型 | 命中产品设计影响 | 页面流草图 |
-| 状态矩阵 | 存在状态流转、异常或恢复 | 状态矩阵 |
-| 高保真 HTML 原型 | 需要视觉与交互校准 | 原型地址和审查结果 |
-| 用户确认 | 产品设计影响未被人工确认 | 确认记录 |
-| OpenAPI Draft | 有 API 影响 | OpenAPI 3.1 Draft |
-| 设计审查 | API 或架构影响 | 审查意见和处理结果 |
-| OpenAPI Freeze | API 进入实现 | Freeze 版本和消费者确认 |
-| 数据架构 | 数据模型、存储或一致性变化 | 数据架构记录 |
-| 工程基线 | 后端、前端或高风险工程变化 | 工程基线、项目根路径和验证命令；Harness 内项目必须符合 `apps/backend/<project>/` / `apps/frontend/<project>/`，新后端还需脚手架登记、Router 脚手架合同 draft / 生命周期批准记录、生成器输入 / 预期文件、`./mvnw` 结果和 YSS Skill Execution Result |
-| 架构审查 | 高风险或跨边界变化 | 架构审查记录 |
-| Spec Delta | 已有冻结 Spec 的高风险行为变化 | `ADDED / MODIFIED / REMOVED` 差异 |
-| 功能父 Ticket | 每个进入追踪的功能 | `parent-ticket.md` 或远程父 Ticket |
-| 垂直切片 Ticket | 进入实现前 | 可独立验证的切片 Ticket |
-| Slice Implementation Contract | Agent 进入实现；脚手架完成后每个后续生成代码工作单元 | 批准的 Slice Implementation Contract、当前版本、YSS skill 闭包和写路径 / 证据约束 |
-| YSS Skill Execution Result | YSS 专项 skill 完成工作单元 | YSS Skill Execution Result |
-| Fresh Verification / 发布 | 合并、发布或阶段完成 | fresh verification、release、rollback、checkpoint |
-
-所有门禁都是条件强制门禁。未命中触发条件时，必须明确记录 `not-applicable` 及原因；不生成空文档。完成结论必须同时包含批准的 Slice Implementation Contract 与 YSS Skill Execution Result（若进入实现阶段）。
+| `evidence.impact-assessment` | 影响面分析记录 | 受影响仓库、资产、风险与最近可信阶段。 |
+| `evidence.repository-identity-check` | 仓库身份校验结果 | yss-project.yaml 的合法性与 repository_mode 裁决。 |
+| `evidence.approval-record` | 人工批准记录 | 对需要人工批准的 Spec、设计、契约或发布裁决的可追溯记录。 |
+| `evidence.design-review-result` | 设计审查结果 | API、架构或产品设计审查意见及处理结果。 |
+| `evidence.prototype-review-result` | 原型评审结果 | 低保真页面、流程、状态与 API 反推的独立评审结论和阻断项。 |
+| `evidence.antd-cli-validation` | Ant Design CLI 校验证据 | 设计语言、组件、demo、token、semantic 与 lint 的实际 CLI/目标版本和可读输出引用。 |
+| `evidence.browser-prototype-verification` | 浏览器原型验证证据 | 高保真原型的非空渲染、主流程、异常状态、视口和控制台验证记录。 |
+| `evidence.prototype-confirmation` | 原型用户确认记录 | 高保真原型、验证清单和进入下游阶段范围的人工确认结论。 |
+| `evidence.openapi-draft-review` | OpenAPI Draft 审查记录 | P0、错误、分页、幂等和契约测试审查记录。 |
+| `evidence.contract-approval` | Slice 合同批准记录 | 生命周期编排器批准且已持久化的当前版本合同引用。 |
+| `evidence.yss-skill-execution-result` | YSS Skill Execution Result | 专项 skill 的合同版本、写入、验证、延期 seam 与偏离证据。 |
+| `evidence.fresh-verification` | Fresh Verification 记录 | 本轮实际执行的验证命令、结果和时间。 |
+| `evidence.checkpoint-and-rollback` | Checkpoint 与回滚点 | 可追溯的变更边界、发布记录和恢复动作。 |
+<!-- lifecycle-registry:structure:end -->
+
+完成结论必须同时包含批准的 Slice Implementation Contract 与 YSS Skill Execution Result（若进入实现阶段）。
+
+安全 / 权限不形成独立门禁。只有需求或冻结资产明确改变相关业务行为时，才把它写入普通产物，并按实际 UI、API、Backend、Data、High-risk 影响使用上表既有门禁。
 
 ## 3. 退出与 checkpoint
 

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

@@ -0,0 +1,70 @@
+{
+  "schema_version": 1,
+  "registry_id": "yss.lifecycle",
+  "semantic_sha256": "6261529654dba3e3738aa950e42d6af5b5db1b3be4ac6c2e4dc86a395c49ec6f",
+  "published_ids": [
+    "artifact.architecture-review",
+    "artifact.data-architecture",
+    "artifact.discovery-record",
+    "artifact.engineering-baseline",
+    "artifact.functional-architecture",
+    "artifact.high-fidelity-html-prototype",
+    "artifact.impact-assessment",
+    "artifact.interaction-spec",
+    "artifact.low-fidelity-prototype",
+    "artifact.openapi-draft",
+    "artifact.openapi-freeze-record",
+    "artifact.parent-ticket",
+    "artifact.product-overview",
+    "artifact.prototype-confirmation",
+    "artifact.prototype-review",
+    "artifact.retrospective",
+    "artifact.slice-implementation-contract",
+    "artifact.spec",
+    "artifact.spec-delta",
+    "artifact.state-matrix",
+    "artifact.vertical-slice-ticket",
+    "evidence.antd-cli-validation",
+    "evidence.approval-record",
+    "evidence.browser-prototype-verification",
+    "evidence.checkpoint-and-rollback",
+    "evidence.contract-approval",
+    "evidence.design-review-result",
+    "evidence.fresh-verification",
+    "evidence.impact-assessment",
+    "evidence.openapi-draft-review",
+    "evidence.prototype-confirmation",
+    "evidence.prototype-review-result",
+    "evidence.repository-identity-check",
+    "evidence.yss-skill-execution-result",
+    "gate.architecture-reviewed",
+    "gate.design-reviewed",
+    "gate.engineering-baseline-accepted",
+    "gate.openapi-draft-reviewed",
+    "gate.openapi-frozen",
+    "gate.prototype-reviewed",
+    "gate.prototype-verified",
+    "gate.release-ready",
+    "gate.repository-identity-valid",
+    "gate.slice-contract-approved",
+    "gate.slice-ready-for-agent",
+    "gate.spec-baseline-approved",
+    "gate.user-confirmation",
+    "stage.discovery",
+    "stage.entry-triage",
+    "stage.product-design",
+    "stage.spec-architecture",
+    "stage.system-data-engineering",
+    "stage.ticket-formalization",
+    "stage.verification-release-retrospective",
+    "stage.vertical-slice-implementation",
+    "work-unit.attach-sync-integration",
+    "work-unit.entry-triage",
+    "work-unit.fresh-verification",
+    "work-unit.independent-review",
+    "work-unit.release-and-rollback",
+    "work-unit.skill-projection-sync",
+    "work-unit.ssot-update",
+    "work-unit.template-snapshot-build"
+  ]
+}