create-yss-spec 3.0.1 → 3.1.3

package/template/.agents/skills/yss-design-system/references/design-system.md

@@ -1,11 +1,12 @@
 # YSS 设计系统执行规范
 
-本文件是 `docs/design/design.md` 的 skill 侧执行清单。项目文档面向团队阅读并作为唯一规范来源，本文件面向 Agent 执行、设计评审和前端实现，不单独承载新的 token 决策。
+本文件是 YSS 设计系统的 skill 侧执行清单，面向 Agent 执行、设计评审和前端实现，不单独承载新的 Token 决策或具体值。
 
 权威资料：
 
-- 团队规范：`docs/design/design.md`
-- Token 快照：`docs/design/tokens/*`
+- 规范源：根 `DESIGN.md`（项目视觉 Token 与组件视觉变体）
+- 治理说明：`docs/design/design.md`（生命周期、组件路线、状态与验收）
+- 派生快照：`docs/design/tokens/*`（实现映射，不得反向覆盖规范源）
 - Skill 入口：`.agents/skills/yss-design-system/SKILL.md`
 
 ## 设计定位
@@ -37,24 +38,14 @@
 
 ### 颜色
 
-| Token | 值 | 用途 |
+| 角色 | 规范源 | 运行时映射 |
 | --- | --- | --- |
-| `colorPrimary` | `#3371ff` | 主操作、链接、焦点、选中态 |
-| `colorPrimaryHover` | `#4096ff` | 主色 hover |
-| `colorPrimaryActive` | `#0958d9` | 主色 active |
-| `colorSuccess` | `#52c41a` | 成功状态 |
-| `colorWarning` | `#faad14` | 警告状态 |
-| `colorError` | `#f5222d` | 错误状态 |
-| `colorInfo` | `#3371ff` | 信息提示 |
-| `colorBgLayout` | `#f0f2f5` | 页面背景 |
-| `colorBgContainer` | `#ffffff` | 内容容器 |
-| `colorBgElevated` | `#ffffff` | 浮层容器 |
-| `colorText` | `rgba(0, 0, 0, 0.88)` | 主文本 |
-| `colorTextSecondary` | `rgba(0, 0, 0, 0.65)` | 次级文本 |
-| `colorTextTertiary` | `#8c8c8c` | 弱说明 |
-| `colorTextQuaternary` | `#bfbfbf` | placeholder / disabled |
-| `colorBorder` | `#d9d9d9` | 主边框 |
-| `colorBorderSecondary` | `#f0f0f0` | 次级分割线 |
+| 品牌 seed | `colors.primary` | `colorPrimary` / `--brand-color-primary` |
+| 高对比主控件 | `components.button-primary*` | `--yss-color-primary-control*` 或组件 Token |
+| 页面 / 容器 / 浮层 | `colors.canvas-layout` / `surface` / `surface-elevated` | 对应 `colorBg*` / `--brand-color-bg-*` |
+| 主次文本 | `colors.text*` | 对应 `colorText*` / `--brand-color-text*` |
+| 功能状态 | `colors.success*` / `warning*` / `error*` / `info-bg` | 对应状态 semantic Token |
+| 边框 | `colors.border-secondary` | 对应边框 semantic Token |
 
 颜色规则：
 
@@ -64,62 +55,47 @@
 - 不硬编码白色、灰色、状态色；优先引用 token、CSS variables 或 Ant Design theme。
 - semantic token 优先于色值：页面先声明背景、容器、浮层、文本、边框、状态等角色，再映射到具体 token。
 - 运行时短名 `--primary-color`、`--text-color`、`--bg-color` 必须指向 `--brand-*`，不要再维护第二套色值。
-- `blue` 等预设色板可以仍含官方 `#1677ff`；色板预设 ≠ 品牌主色。
+- 上游预设色板与项目品牌 seed 是不同角色；色板预设 ≠ 品牌主色。
 - accessibility contrast 不足时，通过 `ConfigProvider` 的 seed token 或组件 token 调整；不要为单个页面制造不可复用的深浅色例外。
 - Codex `$design-qa` 的 token / 字体对照读 `references/design-qa-theme.md`。
 
 ### 排版
 
-| 层级 | 字号 | 字重 | 用途 |
-| --- | --- | --- | --- |
-| Heading 1 | 38 | 600 | 大标题，慎用 |
-| Heading 2 | 32 | 600 | 页面级标题 |
-| Heading 3 | 26 | 600 | 重要分区 |
-| Heading 4 | 22 | 600 | 分区标题 |
-| Heading 5 | 18 | 600 | 卡片 / 面板标题 |
-| Body | 14 | 400 | 默认正文、控件、表格 |
-| Small | 12 | 400 | 辅助信息、Tag |
+| 角色 | 规范源 | 用途 |
+| --- | --- | --- |
+| 正文 | `typography.body` | 默认正文、控件、表格 |
+| 强调正文 | `typography.body-strong` | 表头与必要强调 |
+| 大 / 中标题 | `typography.heading-lg` / `heading-md` | 页面与分区层级 |
+| 辅助文本 | `typography.caption` | 说明、Tag 与次级信息 |
+| 按钮 | `typography.button` | 控件文字 |
 
 排版规则：
 
-- UI 默认正文 14px。
-- UI 字重优先 400 / 600。
+- 正文、标题、辅助文本和按钮的字号、字重、行高均从 `DESIGN.md` 对应角色读取。
 - 字体栈使用系统字体，不强制 `Inter`。
 - 不用 700+ 粗体表达选中或激活状态。
 - 选中状态优先使用颜色、边框、下划线、背景表达。
 
 ### 间距、尺寸、圆角
 
-| 类型 | 基线 |
+| 类型 | 规范源 |
 | --- | --- |
-| 间距网格 | 4px |
-| 默认控件高度 | 32px |
-| 小控件高度 | 24px |
-| 大控件高度 | 40px |
-| 默认字号 | 14px |
-| 字体栈 | 系统栈，不强制 `Inter` |
-| 小控件圆角 | 4px |
-| 默认控件圆角 | 6px |
-| 大容器 / 浮层圆角 | 8px |
-| 顶栏高度 | 64px |
-| 深色侧栏 | `#001529` |
+| 间距 | `spacing.*` 与组件变体的 `padding` |
+| 控件高度 | `components.button-*` / `input-*` 的 `height`；算法 seed 见治理说明 |
+| 控件 / 容器圆角 | `rounded.*` 与组件变体的 `rounded` |
+| 页面 / Card 内边距 | `components.page-shell` / `card-compact` |
 
 执行规则：
 
-- 间距使用 4 / 8 / 12 / 16 / 20 / 24 / 32 / 48。
+- 间距只使用 `spacing.*`，不要补写未登记的中间值。
+- 默认工作界面叠加一次 compact algorithm；seed 与计算结果从规范源和派生快照读取，不得二次 compact。
 - 表单、筛选区、工具栏、表格、详情页使用密集但有节奏的布局。
 - 控件圆角不得明显大于容器圆角。
 - 不使用任意 magic number；确需新增尺寸时，先说明为什么 token 不够。
 
 ### 动效
 
-| Token | 值 | 用途 |
-| --- | --- | --- |
-| `motionDurationFast` | `0.1s` | hover、focus、press |
-| `motionDurationMid` | `0.2s` | 折叠、淡入淡出、控件内部状态 |
-| `motionDurationSlow` | `0.3s` | Modal、Drawer、页面级浮层 |
-
-动效只服务于状态反馈、层级变化和空间关系。不自造 easing。
+动效只服务于状态反馈、层级变化和空间关系。使用目标 Provider 的 semantic motion Token，不在页面或本执行清单中自造 duration/easing；项目需要稳定覆盖时先登记到根 `DESIGN.md`。
 
 ## 组件规则
 
@@ -127,7 +103,7 @@
 | --- | --- |
 | Button Primary | 每个决策区域只保留一个主按钮 |
 | Button Default | 次级动作默认使用默认按钮或描边按钮 |
-| Input / Select | 默认高度 32px，focus 可见 |
+| Input / Select | 使用 `components.input-*` 高度和圆角，focus 可见；不得以算法 seed 冒充 compact 结果 |
 | Card | 只用于真实内容容器，不做卡片套卡片 |
 | Modal | 用于阻断式决策和关键表单 |
 | Drawer | 用于详情、编辑、辅助流程，不打断主列表上下文 |
@@ -206,15 +182,22 @@
 React + Ant Design：
 
 - 使用 `ConfigProvider` 注入主题。
-- 默认主题使用 `theme.defaultAlgorithm`；暗色与紧凑模式通过 theme algorithm 切换，不手工反转色值或逐组件压缩。
+- 默认工作界面使用 `theme.compactAlgorithm`；暗色紧凑模式组合 `theme.darkAlgorithm` 与 `theme.compactAlgorithm`，不手工反转色值或逐组件压缩。
+- seed 与 compact 计算值以 `DESIGN.md` / `tokens.compact.json` 为准；不要重复 compact。
 - 优先通过 token、component token、CSS variables、theme algorithm 实现样式。
 - 静态反馈 API 使用 `App`、hook API 或 context holder，避免主题上下文丢失。
 - 暗色模式使用 `darkAlgorithm` 或 `variables.dark.css`。
 - 紧凑模式使用 `compactAlgorithm` 或 `tokens.compact.json`。
 
+实验 Vue + Antdv Next：
+
+- H2 默认先使用 `yss-antdv-next-design` 校验精确版本 fact pack、组件集合与项目 baseline digest。
+- 共享本规范的 semantic token、紧凑密度和验收语义；props、events、slots 与主题 API 只从 Antdv Next fact pack 读取。
+- `yss-antd-design` 只保留为显式 React/AntD 兼容路线；默认 Provider 与兼容 Provider 都不替换生产 `yss-ui` 路线。
+
 YSS UI / Vue：
 
-- 业务页面优先走 `yss-ui` 和 `yss-ui-business-page-generation`；生命周期编排和旧触发词兼容使用 `yss-page-module-development`。
+- 业务页面实现与生命周期编排统一走 `yss-ui` 和 `yss-ui-business-page-generation`。
 - 新业务表单使用 `YFormily` schema；`YssFormily` 仅用于历史兼容。
 - 表格使用 `YTable`，列定义使用项目约定字段。
 - 高度自适应使用 `useTableHeight` / `useTreeHeight`。
@@ -237,7 +220,7 @@ YSS UI / Vue：
 
 - 是否消费 token，而不是硬编码颜色和尺寸。
 - 是否以 semantic token 表达颜色、圆角、阴影和状态层级。
-- 是否保持默认 14px 正文、32px 控件、4px 间距网格。
+- 是否使用当前 `DESIGN.md` 与 `tokens.compact.json` 的排版、控件和间距值，且没有重复 compact。
 - 是否保留 hover、focus、active、disabled、loading、empty、error 状态。
 - 是否只保留一个 single primary action，并让每个关键操作提供 interaction feedback。
 - 是否在目标字号和背景下复核 accessibility contrast。

package/template/.agents/skills/yss-domain/SKILL.md

@@ -7,7 +7,7 @@ description: 用于构建或重构 YSS 领域层代码。当用户要求设计
 
 这是一个领域实现 skill。核心目标是消费已批准的战术模型，将领域行为落实为代码；战术模型的设计与批准由 `yss-tactical-design` 和 `yss-product-lifecycle` 负责。
 
-本 skill 在新脚手架链路只支持 `target-domain-model`。`core/client/repository`、贫血对象和 VO 型 Gateway 对该链路均为 `unsupported`，不提供旧架构分支。
+本 skill 在新脚手架链路只支持 `domain-driven` / `target-domain-model`。`layered-mvc-service` 与 `mvc-data-analysis-v1` 是独立 MVC Profile，不是失败的 DDD 工程；它们不加载本 skill，也不生成 Domain Gateway。既有旧架构不在本链路内迁移。
 
 ## 何时使用
 

package/template/.agents/skills/yss-dto/SKILL.md

@@ -11,6 +11,7 @@ description: Use when YSS `Result`, `SingleResult`, `MultiResult`, `PageResult`,
 
 ## 所有权边界
 
+- 先消费 `architecture_identity`：DDD 的 HTTP DTO 在 Web；通用 MVC 私有 DTO 在 server、已批准公开 DTO 在 client；数据分析 MVC 公开 DTO 在 client。service/core 自有内部 Command/Query/Result，不依赖 client DTO；server 用 MapStruct 转换。共用 wire profile 不意味着共用模块路径。
 - `Result` / `SingleResult` / `MultiResult` / `PageResult`、`CommandDTO` / `QueryDTO` / `PageQuery` 的 canonical package、工厂方法、字段语义、默认值、枚举和禁用字段由本 skill 及 `references/openapi-wire-profile.yaml` 唯一持有。
 - Web skill 只生成 endpoint-specific Page Request、Request/Response 与 Convertor，并通过批准合同中的 profile 引用和 digest 消费上述协议；不得生成 wrapper/page base，也不得维护分页字段或默认值副本。
 - OpenAPI skill 只把该 profile 组合进 endpoint schema；不得从 Java getter 或本地常量反向建立第二份 wire 协议。

package/template/.agents/skills/yss-exception/SKILL.md

@@ -25,6 +25,7 @@ Read `references/source-index.md` as a path-hint index whenever the task depends
 4. Check `YssGlobalExceptionProperties` when global exception output/logging behavior is configurable.
 5. Keep logging semantics aligned: business exceptions usually do not require error-stack logging; system/unknown exceptions usually do.
 6. In the `target-domain-model` profile, Domain owns stable error meaning and parameters but does not depend directly on YSS `BizException` or HTTP. Translate at the Web boundary after verifying the component handler precedence.
+7. MVC Profile 的稳定业务错误归 service/core；Repository 保留 cause；server 持有 HTTP 映射与脱敏。不要为了复用错误码引入 Domain 层或让 core 依赖 client。分层依据 `docs/agents/backend-architecture-profiles.md`。
 
 ## Current Source Behavior
 

package/template/.agents/skills/yss-frontend-scaffold-generator/SKILL.md

@@ -30,6 +30,8 @@ branch: template
 
 ## Workflow
 
+采用专职前端 profile 或显式 `frontend_delivery` 绑定时，先按 `docs/process/frontend-backend-delivery.md` 实际核验战略与后端联合交付。缺任一输入只能诊断和回交；输入通过后准备计划/合同，正式实现、生成和恢复仍须当前批准的 Slice Contract 冻结接收摘要。接口或部署版本漂移时重新接收，不复用旧成功输出。
+
 1. 确认当前任务已经通过 Harness 入口分诊，且实现位置已记录在 proposal、design、build entry review、实施计划或实现路由记录中。
 2. 确认目标是外部实现仓库；只有用户明确选择时才输出到 Harness 仓库的 `apps/frontend/<project>/`。`apps/frontend/` 只能作为项目容器，`app/frontend/`、`app/backend/` 及其子路径禁止作为输出位置。`git-submodule` 只能在已初始化且附加分支的子仓工作树生成；空 gitlink、detached HEAD、`--force` 覆盖挂载点不得当成普通目录。
 3. 只读检查模板分支是否可访问：`git ls-remote --heads <repo> template`。
@@ -63,7 +65,7 @@ packages/package.json
 - 不修改模板既有的代码生成配置，也不把客户端生成加入 CI。
 - 不得把 `apps/frontend/` 容器根登记为项目根；Harness 内每个前端项目必须有独立的 `apps/frontend/<project>/` 路径。
 - 不把模板示例页面当作业务功能交付。
-- 生成后仍需使用 `yss-page-module-development`、`yss-components`、`yss-api-integration` 等专项 skill 实现业务页面。
+- 生成后仍需使用 `yss-ui-business-page-generation`、`yss-components`、`yss-api-integration` 等专项 skill 实现业务页面。
 
 ## Output
 

package/template/.agents/skills/yss-implementation-contract-compiler/SKILL.md

@@ -26,10 +26,12 @@ description: Use when a YSS vertical slice is entering implementation, spans mul
 
 ## 硬规则
 
+采用专职前端 profile 或显式 `frontend_delivery` 绑定时，先按 `docs/process/frontend-backend-delivery.md` 实际核验战略与后端联合交付。缺任一输入只能诊断和回交；输入通过后准备计划/合同，正式实现、生成和恢复仍须当前批准的 Slice Contract 冻结接收摘要。接口或部署版本漂移时重新接收，不复用旧成功输出。
+
 - 编译器不得输出 `approved`、`ready-for-agent` 或 `completed`。
 - Registry、Slice Contract 或编译器合同 schema v1 一律拒绝并给出迁移到 v2 的提示；不自动升级，不提供旧技能名兼容。
 - `required_capabilities` 与 `required_skills` 必须同时冻结；Registry 或编译器摘要变化后合同立即 `stale`，重新编译后仍须交生命周期重新批准。
-- UI 影响缺少正式原型确认时，不得路由页面实现。
+- UI 影响缺少正式原型确认、批准且 digest 当前的 Visual Baseline manifest 或当前切片 `case_id` 时，不得路由页面实现。模型必须先读 manifest 与语义引用，再查看对应 PNG；禁止目录 glob 和图片独立猜义。
 - Repository/数据模型影响缺少数据架构时，不得路由持久化实现。
 - 领域影响缺少批准且版本当前的 tactical-design contract 时，不得路由 Domain 实现；无领域影响必须记录 `not-applicable`。
 - API 变化必须回到生命周期 Draft/Review/Freeze；半成品 backend 不得冒充稳定 source of truth。
@@ -37,7 +39,7 @@ description: Use when a YSS vertical slice is entering implementation, spans mul
 - Harness 内实现路径必须落在 `apps/backend/<project>/` 或 `apps/frontend/<project>/` 的具体项目目录；`apps/backend/`、`apps/frontend/` 只能作为容器，`app/backend/`、`app/frontend/` 及其子路径一律阻断。外部实现仓库使用其登记的真实项目根路径。`git-submodule` 使用 `implementation_path_policy: git-submodule-harness-apps`，空 gitlink、detached HEAD 或 `--force` 覆盖挂载点不得脚手架；`inspectWorkingTreeScope.writable` 必须为显式布尔值。
 - 当前用户、缓存、审计、Excel、分布式 ID、请求校验、错误映射、加解密或网关韧性命中时，必须按 `compiler-contract.yaml` 的 `impact_to_capabilities` 补齐入口 capability；不能只在 `boundaries.md` 中提及。仅复用已经验证的平台认证 / 授权能力不算 component impact，不自动增加权限专项 skill。
 - 业务行为使用 `behavior-tdd`；只有机械脚手架/生成物可用 `controlled-generation`，并记录例外和验证。
-- 原型确认后若 backend `scaffold_status=required`，先由本编译器按 `scaffold_contract_schema` 编译 `yss-ddd-scaffold-generator` 的 `controlled-generation` 工作单元合同 draft；合同必须带 `contract_id`、`contract_version`、compiler draft、生命周期批准、持久化引用、允许写路径、预期证据和验证命令。经生命周期编排器批准并持久化后才能运行生成器，再由受控工作单元实际执行固定的 `./mvnw validate`、`./mvnw test`、`./mvnw package` 并记录逐条结果，随后加载 `yss-backend-scaffold-parent` 并重新编译业务合同；脚手架不承载业务行为。
+- 原型确认后若 backend `scaffold_status=required`，必须先读取工程基线中的 `scaffold-architecture-decisions.yaml`。编译器按已达到 `lifecycle-approved` 且 digest 当前的选择，把 `domain-driven` 解析为 `backend.ddd-scaffold` / `yss-ddd-scaffold-generator`，把 `layered-mvc` 解析为 `backend.mvc-scaffold` / `yss-layered-mvc-scaffold-generator`；处于 `undecided`、`recommended`、`awaiting-user-decision` 或 `stale` 时返回 `blocked`，不得默认 DDD。随后按 `scaffold_contract_schema` v3 编译 `controlled-generation` 工作单元合同 draft；合同必须带选择引用与 digest、`generator_skill`、Profile、能力模块闭包、批准/持久化引用、允许写路径、预期证据和验证命令。经生命周期批准并持久化后才能运行对应生成器，再由受控工作单元实际执行固定的 `./mvnw validate`、`./mvnw test`、`./mvnw package` 并记录逐条结果，随后重新编译业务合同；脚手架不承载业务行为。
 - 脚手架合同在编译阶段只能是 `draft` / `ready-for-lifecycle-review` / `blocked`；只有生命周期编排器可以把已持久化脚手架合同标记为 `approved`。脚手架合同只覆盖业务代码前的工程骨架工作单元；生成、基线校验和合同重编译完成后，它不能替代脚手架后的 Slice Implementation Contract。
 - 脚手架输出消费批准的脚手架合同；脚手架后的所有生成后端代码都必须绑定当前批准且版本当前的 Slice Implementation Contract、主 YSS skill、依赖闭包、允许写路径、预期证据和 YSS Skill Execution Result。打印命令、`./mvnw validate` 单项通过或脚手架成功不能替代合同批准；生成范围从机械内容变成业务行为时触发完整重路由。
 - 专项结果中的越界路径、缺失证据、`drift`、`violation` 或 `new_impacts` 必须阻断或重路由。
@@ -53,3 +55,9 @@ description: Use when a YSS vertical slice is entering implementation, spans mul
 ## 输出
 
 输出合同草案、capability/Recipe 解析记录、技能依赖闭包、不适用理由、阻塞项、TDD 模式、工作单元、预期证据、验证命令、人工审查点、完整重路由触发器，以及建议的 `suggested_owner_role_id`（UI 影响 → `role.frontend-engineer`，后端影响 → `role.backend-engineer`，测试/审查 → `role.test-engineer`）。自然语言说明不能替代结构化合同字段。编译器不得自行批准合同、设置 `ready-for-agent` 或关闭会签门禁；owner 建议只供主控派活。
+
+## 战略交接快照包
+
+跨仓交接使用 `scripts/strategic-handoff export / verify / import`。正式导出前补齐源战略的稳定规则 ID、关键场景和当前批准绑定；源资产原字节冻结、包内路径通过清单解析。目标导入只产生快照和对账/承接草案，正式 reconciliation 通过后才能进入战术设计。流程与字段见 `docs/process/strategic-handoff-package.md`。
+
+战术合同必须绑定 `strategic_handoff` 导入收据、包摘要、正式目标对账及逐条承接 rows。来自导入包时禁止仅填 `upstream_current: true`。批准前执行 `scripts/verify-strategic-handoff-consumption --root <target> <tactical>`；存在受控延期时按切片执行 `--slice <slice-id>`，实际核验通过且合同批准后才可继续相关切片。最新源规则、关键场景或资产变化使依赖项 stale；未知依赖扩大阻断，业务冲突回交战略方。结果绑定当前包与战术摘要，不能复用旧输出宣布 ready-for-agent。

package/template/.agents/skills/yss-implementation-contract-compiler/references/boundaries.md

@@ -18,6 +18,9 @@
 
 | Capability | Primary skill | Task modes |
 | --- | --- | --- |
+| `layer.mvc-service` | `yss-application` | `guidance`, `integration`, `slice-implementation`, `troubleshooting`, `review-input` |
+| `layer.mvc-persistence` | `yss-repository` | `guidance`, `integration`, `slice-implementation`, `troubleshooting`, `review-input` |
+| `layer.mvc-web` | `yss-web-controller` | `guidance`, `integration`, `slice-implementation`, `troubleshooting`, `review-input` |
 | `governance.implementation-contract` | `yss-implementation-contract-compiler` | `contract-compilation`, `reroute`, `result-validation` |
 | `maintenance.skill-source-index` | `yss-skill-source-index-refresh` | `component-maintenance`, `source-index-refresh` |
 | `architecture.tactical-domain` | `yss-tactical-design` | `guidance`, `integration`, `slice-implementation`, `review-input` |
@@ -40,7 +43,8 @@
 | `component.security-algorithm` | `yss-security-algorithm` | `guidance`, `integration`, `slice-implementation`, `troubleshooting`, `component-maintenance`, `review-input` |
 | `component.gateway-resilience` | `yss-resilience4j` | `guidance`, `integration`, `slice-implementation`, `troubleshooting`, `component-maintenance`, `review-input` |
 | `scaffold.ddd` | `yss-ddd-scaffold-generator` | `integration`, `component-maintenance` |
-| `scaffold.mvc` | `yss-mvc-scaffold-generator` | `integration`, `component-maintenance` |
+| `scaffold.layered-mvc` | `yss-layered-mvc-scaffold-generator` | `integration`, `component-maintenance` |
+| `project-init.mvc-data-analysis` | `yss-mvc-data-analysis-project-initializer` | `component-maintenance` |
 | `migration.springboot3` | `yss-up-springboot3` | `guidance`, `integration`, `troubleshooting`, `component-maintenance`, `review-input` |
 
 ## Narrow Recipes
@@ -49,6 +53,12 @@
 
 | Recipe | Capabilities |
 | --- | --- |
+| `backend.ddd-domain-behavior` | `layer.domain`, `layer.application`, `quality.java-code-style` |
+| `backend.ddd-persistence-mybatis` | `layer.persistence`, `framework.mybatis`, `codegen.mapstruct`, `codegen.lombok`, `quality.java-code-style` |
+| `backend.ddd-http-api` | `layer.web-adapter`, `contract.dto-wire`, `contract.request-validation`, `contract.error-mapping`, `codegen.mapstruct`, `codegen.lombok`, `quality.java-code-style` |
+| `backend.mvc-service-behavior` | `layer.mvc-service`, `quality.java-code-style` |
+| `backend.mvc-persistence-mybatis` | `layer.mvc-persistence`, `framework.mybatis`, `codegen.mapstruct`, `codegen.lombok`, `quality.java-code-style` |
+| `backend.mvc-http-api` | `layer.mvc-web`, `contract.dto-wire`, `contract.request-validation`, `contract.error-mapping`, `codegen.mapstruct`, `codegen.lombok`, `quality.java-code-style` |
 | `backend.domain-behavior` | `layer.domain`, `layer.application`, `quality.java-code-style` |
 | `backend.persistence-mybatis` | `layer.persistence`, `framework.mybatis`, `codegen.mapstruct`, `codegen.lombok`, `quality.java-code-style` |
 | `backend.http-api` | `layer.web-adapter`, `contract.dto-wire`, `contract.request-validation`, `contract.error-mapping`, `codegen.mapstruct`, `codegen.lombok`, `quality.java-code-style` |
@@ -60,7 +70,7 @@
 | `backend.security-algorithm` | `component.security-algorithm`, `contract.error-mapping` |
 | `backend.distributed-id` | `component.distributed-id` |
 | `backend.ddd-scaffold` | `scaffold.ddd`, `quality.java-code-style` |
-| `backend.mvc-scaffold` | `scaffold.mvc`, `quality.java-code-style` |
+| `backend.mvc-scaffold` | `scaffold.layered-mvc`, `quality.java-code-style` |
 | `backend.springboot3-migration` | `migration.springboot3`, `quality.java-code-style` |
 
 ## Impact Entry Mapping
@@ -84,7 +94,7 @@
 | `encryption-or-signing` | `component.security-algorithm` |
 | `gateway-resilience` | `component.gateway-resilience` |
 | `ddd-scaffold` | `scaffold.ddd` |
-| `mvc-scaffold` | `scaffold.mvc` |
+| `mvc-scaffold` | `scaffold.layered-mvc` |
 | `springboot3-migration` | `migration.springboot3` |
 
 ## Typed Skill Dependencies
@@ -93,9 +103,11 @@
 | --- | --- | --- | --- |
 | `yss-prototype-stage` | `prototype-review` | `review-only` | — |
 | `yss-prototype-stage` | `yss-design-system` | `coordination-only` | — |
-| `yss-prototype-stage` | `yss-antd-design` | `context-conditional` | `h2-react-antd` |
+| `yss-prototype-stage` | `yss-antdv-next-design` | `context-conditional` | `h2-vue-antdv-next-default` |
+| `yss-prototype-stage` | `yss-antd-design` | `context-conditional` | `h2-react-antd-explicit-compatibility` |
 | `yss-ddd-scaffold-generator` | `yss-backend-scaffold-parent` | `context-required` | — |
 | `yss-ddd-scaffold-generator` | `alibaba-java-code-style` | `context-required` | — |
+| `yss-layered-mvc-scaffold-generator` | `alibaba-java-code-style` | `context-required` | — |
 | `yss-domain` | `alibaba-java-code-style` | `context-required` | — |
 | `yss-domain` | `domain-modeling` | `coordination-only` | — |
 | `yss-domain` | `yss-tactical-design` | `context-conditional` | `tactical-domain` |
@@ -127,8 +139,4 @@
 | `yss-ui-business-page-generation` | `yss-hook` | `context-conditional` | `hooks` |
 | `yss-ui-business-page-generation` | `yss-formily` | `context-conditional` | `form` |
 | `yss-ui-business-page-generation` | `yss-api-integration` | `context-conditional` | `api` |
-| `yss-page-module-development` | `yss-components` | `context-conditional` | `components` |
-| `yss-page-module-development` | `yss-hook` | `context-conditional` | `hooks` |
-| `yss-page-module-development` | `yss-formily` | `context-conditional` | `form` |
-| `yss-page-module-development` | `yss-api-integration` | `context-conditional` | `api` |
 | `yss-api-integration` | `yss-openapi-governance` | `context-conditional` | `regeneration` |

package/template/.agents/skills/yss-implementation-contract-compiler/references/compiler-contract.yaml

@@ -1,4 +1,11 @@
 schema_version: 2
+backend_architecture:
+  registry_source: docs/agents/yss-skill-registry.yaml
+  identity_schema: docs/process/schemas/backend-architecture-identity.schema.json
+  required_evidence: [engineering_baseline, repository_registration, manifest]
+  required_identity_surfaces: [resolution, work_unit, execution_result]
+  family_recipe_selection: explicit-ddd-or-mvc-no-legacy-alias
+  readiness: supported-profile-and-current-identical-evidence
 compiled_by: yss-implementation-contract-compiler
 approved_by: yss-product-lifecycle
 capability_source: docs/agents/yss-skill-registry.yaml
@@ -54,6 +61,12 @@ readiness:
   data_impact: [data_architecture]
   backend_impact: [engineering_baseline, backend_repository, maven_wrapper]
   cross_repo: [repository_registry, delivery_order, integration_verification, rollback_order]
+  frontend_delivery:
+    when: specialized-frontend-profile-or-explicit-frontend-delivery-binding
+    source: docs/process/frontend-backend-delivery.md
+    verifier: scripts/verify-frontend-delivery
+    output_binding: frontend.delivery
+    inputs_verified_is_implementation_approval: false
 
 compiler_input_required:
   - slice_id
@@ -70,11 +83,11 @@ exclusive_flags:
 
 slice_contract_required:
   root: [schema_version, contract_id, contract_version, slice_id, status, lifecycle_refs, readiness, resolution, common, frontend, backend, contract, cross_repo, work_units]
-  lifecycle_refs: [spec, ticket, requirement_freeze, low_fidelity_review, prototype_review, prototype_profile_decision, prototype_deliverable, prototype_deliverable_verification, prototype_confirmation, openapi_freeze_or_no_impact, architecture_review, data_architecture, tactical_design, engineering_baseline, build_architecture_checklist, implementation_repository, frontend_repository, backend_repository, maven_wrapper]
+  lifecycle_refs: [spec, ticket, requirement_freeze, low_fidelity_review, prototype_review, prototype_profile_decision, prototype_deliverable, prototype_deliverable_verification, visual_baseline, prototype_confirmation, openapi_freeze_or_no_impact, architecture_review, data_architecture, tactical_design, engineering_baseline, build_architecture_checklist, implementation_repository, frontend_repository, backend_repository, maven_wrapper]
   readiness: [blockers, stale_inputs, not_applicable]
   resolution: [required_capabilities, required_skills, recipe_ids, conditions, reason_chains, registry_digest, compiler_contract_digest, compiled_at, freshness]
   common: [impacted_areas, implementation_path_policy, project_roots, required_capabilities, required_skills, optional_skills, unavailable_skills, allowed_write_paths, forbidden_patterns, expected_evidence_files, verification_commands, human_review_points, full_reroute_triggers, quality_baseline_ref, context_plan, doubt_driven_review]
-  frontend: [status, required_skills, approved_prototype_ref, state_matrix_ref, allowed_write_paths, component_test_seams, e2e_paths]
+  frontend: [status, required_skills, approved_prototype_ref, state_matrix_ref, visual_baseline_ref, visual_baseline_case_ids, allowed_write_paths, component_test_seams, e2e_paths]
   backend: [status, affected_layers, component_impacts, required_skills, application_boundary, transaction_boundary, persistence_strategy, allowed_write_paths, forbidden_patterns, expected_evidence_files, seam_deferred, verification_commands, tactical_ddd]
   contract: [api_impact, freeze_ref, no_api_impact_ref, generated_clients, contract_tests, regeneration_commands]
   cross_repo: [repositories, delivery_order, integration_verification, rollback_order]
@@ -91,6 +104,7 @@ lifecycle_ref_by_readiness:
   prototype_profile_decision: prototype_profile_decision
   prototype_deliverable: prototype_deliverable
   prototype_deliverable_verification: prototype_deliverable_verification
+  visual_baseline: visual_baseline
   prototype_confirmation: prototype_confirmation
   openapi_freeze: openapi_freeze_or_no_impact
   no_api_impact_record: openapi_freeze_or_no_impact
@@ -124,14 +138,23 @@ context_plan:
   missing_context_action: [blocked, reroute]
 
 scaffold_contract_schema:
-  schema_version: 2
+  schema_version: 3
   identity: service-engineering-baseline
   compiled_by: yss-implementation-contract-compiler
   approved_by: yss-product-lifecycle
   status_by_owner:
     compiler: [draft, ready-for-lifecycle-review, blocked]
     lifecycle: [approved, stale, blocked]
-  required: [contract_id, contract_version, scaffold_request_id, status, compiler_draft_ref, lifecycle_approval_ref, persisted_ref, current_version, implementation_repository, backend_repository, scaffold_status, project_name, target_output_dir, base_package, maven_coordinates, profiles, allowed_write_paths, expected_evidence_files, verification_commands, approval, work_unit, generation_policy]
+  required: [contract_id, contract_version, scaffold_request_id, status, compiler_draft_ref, lifecycle_approval_ref, persisted_ref, current_version, implementation_repository, backend_repository, scaffold_status, project_name, target_output_dir, base_package, architecture_family, generator_skill, decision_ref, decision_id, decision_digest, maven_coordinates, profiles, module_profile, allowed_write_paths, expected_evidence_files, verification_commands, approval, work_unit, generation_policy]
+  architecture_decision:
+    source: scaffold-architecture-decisions.yaml
+    required_status: lifecycle-approved
+    allowed_architectures: [domain-driven, layered-mvc]
+    blocked_statuses: [undecided, recommended, awaiting-user-decision, stale]
+    reference: [decision_ref, decision_id, decision_digest]
+    no_silent_default: true
+    user_confirmation_required: true
+    change_action: stale-and-recompile
   approval:
     required: [approval_ref, approver, persisted_ref, current_version]
   generation_policy:
@@ -145,29 +168,52 @@ scaffold_contract_schema:
     parent_required: [group_id, artifact_id, version]
     yss_components_version: 2.0.0-SNAPSHOT
   profiles:
-    required: [architecture, persistence, database, platform, validation_namespace, dto_placement, repository]
-    supported_initial:
-      architecture: target-domain-model
-      persistence: mybatis-plus
-      database: mysql
-      platform: spring-boot-2.7-jdk8
-      validation_namespace: javax
-      dto_placement: web
-      repository: yss-internal
-    unsupported: [old-architecture-profile, client-in-domain, mybatis, spring-boot-3, jakarta, separate-client-module]
+    discriminant: architecture_family
+    domain-driven:
+      generator_skill: yss-ddd-scaffold-generator
+      required: [architecture, persistence, verification_database, production_database, platform, validation_namespace, dto_placement, repository]
+      supported_initial: { architecture: target-domain-model, persistence: mybatis-plus, verification_database: h2, production_database: not-bound, platform: spring-boot-2.7-jdk8, validation_namespace: javax, dto_placement: web, repository: yss-internal }
+      resolved_modules: [domain, application, infrastructure, adapter, bootstrap]
+    layered-mvc:
+      generator_skill: yss-layered-mvc-scaffold-generator
+      required: [architecture, persistence, verification_database, production_database, platform, validation_namespace, repository]
+      supported_initial:
+        architecture: layered-mvc
+        persistence: mybatis-plus
+        verification_database: h2
+        production_database: not-bound
+        platform: spring-boot-2.7-jdk8
+        validation_namespace: javax
+        repository: yss-internal
+      module_resolution:
+        version: 1
+        core: [server, service, repository]
+        capabilities:
+          external-integration: [adapter]
+          published-client: [client]
+          feign-client: [client, feign-client]
+    unsupported: [old-architecture-profile, mybatis, spring-boot-3, jakarta, arbitrary-module-combination]
+  module_profile:
+    required: [requested_capabilities, resolved_modules, resolution_version]
+    resolution_version: 1
+    freeze_both_request_and_resolution: true
+    digest_change_status: stale
   unsupported_inputs:
     schema_v1: reject-no-auto-upgrade
+    schema_v2_new_generation: reject-no-auto-upgrade
     slice_id: forbidden-as-scaffold-identity
     existing_project: reject-no-scaffold-migration
   lifecycle_boundary:
     compiler_emits: [draft, ready-for-lifecycle-review, blocked]
     lifecycle_approves: [approved]
     generator_consumes: [approved]
-    after_generation: [yss-backend-scaffold-parent, yss-implementation-contract-compiler]
+    after_generation:
+      domain-driven: [yss-backend-scaffold-parent, yss-implementation-contract-compiler]
+      layered-mvc: [yss-implementation-contract-compiler]
   work_unit:
     required: [id, behavior, primary_skill, supporting_skills, tdd_mode, allowed_write_paths, expected_evidence, verification_commands, controlled_generation]
   generation_boundary:
-    allowed_for: [project_scaffold, pom, mechanical_config, wrapper, bootstrap_entrypoint, manifest_v2, architecture_rules, test_infrastructure]
+    allowed_for: [project_scaffold, pom, mechanical_config, wrapper, bootstrap_entrypoint, manifest_v3, architecture_rules, test_infrastructure]
     forbidden_when: [business_behavior, business_fields, business_state, permission, transaction, complex_query, error_mapping, business_example_crud]
     initialization: initialize-only
     regeneration: unsupported
@@ -182,8 +228,8 @@ scaffold_contract_schema:
 
 applicable_subcontract_nonempty:
   frontend:
-    scalar: [approved_prototype_ref, state_matrix_ref]
-    array: [required_skills, allowed_write_paths, component_test_seams, e2e_paths]
+    scalar: [approved_prototype_ref, state_matrix_ref, visual_baseline_ref]
+    array: [required_skills, visual_baseline_case_ids, allowed_write_paths, component_test_seams, e2e_paths]
   backend:
     scalar: [application_boundary, transaction_boundary, persistence_strategy]
     array: [affected_layers, required_skills, allowed_write_paths, forbidden_patterns, expected_evidence_files, verification_commands]
@@ -217,7 +263,7 @@ impact_to_capabilities:
   encryption-or-signing: [component.security-algorithm]
   gateway-resilience: [component.gateway-resilience]
   ddd-scaffold: [scaffold.ddd]
-  mvc-scaffold: [scaffold.mvc]
+  mvc-scaffold: [scaffold.layered-mvc]
   springboot3-migration: [migration.springboot3]
 
 tdd_modes:
@@ -229,9 +275,13 @@ tdd_modes:
 
 full_reroute_triggers:
   - scaffold-baseline-drift
+  - scaffold-architecture-decision-changed
+  - scaffold-profile-changed
+  - scaffold-module-resolution-changed
   - api-schema-impact
   - database-schema-impact
   - state-machine-impact
+  - visual-baseline-version-or-digest-changed
   - data-model-impact
   - new-write-path
   - new-repository
@@ -312,3 +362,12 @@ seam_deferred_required: [risk, owner, follow_up_ticket, verification_plan, targe
 deviation_required: [rule, reason, approval_ref]
 not_applicable_required: [item, reason]
 unavailable_skill_required: [skill, provider, fallback, resolution]
+
+strategic_handoff_consumption:
+  when: upstream-source-is-imported-strategic-handoff
+  required: [import_receipt_ref, bundle_digest, context_reconciliation_ref, rows]
+  verification: scripts/verify-strategic-handoff-consumption --root <target> --slice <slice-id> <approved-tactical-contract>
+  require_actual_exit_code: 0
+  stale_policy: latest-imported-source-digest-and-dependent-slices
+  unknown_dependency: block-all
+  compiler_must_not_approve: true

package/template/.agents/skills/yss-implementation-contract-compiler/references/slice-implementation-contract.md

@@ -1,7 +1,11 @@
 # Slice Implementation Contract
 
+后端合同还必须绑定 `architecture_identity`（schema 见 `docs/process/schemas/backend-architecture-identity.schema.json`），并与工程基线、登记和 Manifest 一致。将同一身份复制到 `resolution`、backend 工作单元和执行结果；Profile 的成熟度/Recipe 来源是技能注册表，draft 不得 ready-for-agent。旧 backend.domain-behavior/persistence-mybatis/http-api Recipe 只读退役，重新编译时显式选择 backend.ddd-* 或 backend.mvc-*。
+
 `yss-implementation-contract-compiler` 生成草案；`yss-product-lifecycle` 核验、批准并持久化。合同缺少必填字段时状态为 `blocked`。schema v1 已停止支持，必须重新编译为 v2，不提供自动升级。
 
+采用专职前端 profile 时，`frontend.delivery` 绑定 `{acceptance_ref, digest}`，来自 `scripts/verify-frontend-delivery` 的当前结果；也可由 `resolution.frontend_delivery` 承载，两处并存时必须一致。正式执行从持久化合同读取并重验输入。细则见 `docs/process/frontend-backend-delivery.md`。
+
 ```yaml
 slice_contract:
   schema_version: 2
@@ -83,6 +87,8 @@ slice_contract:
     required_skills: []
     approved_prototype_ref:
     state_matrix_ref:
+    visual_baseline_ref:
+    visual_baseline_case_ids: []
     generated_api_client_ref:
     allowed_write_paths: []
     component_test_seams: []
@@ -194,4 +200,4 @@ work_unit:
 
 `work_units` 中的前端、后端和测试任务是切片级子任务，不是新的生命周期阶段。每个子任务必须引用独立任务包；任务包只能消费同一份已批准且版本当前的 Slice Contract。`workflow_status` 追踪执行过程，不能替代生命周期状态；`contract_id`、`contract_version` 或 resolution digest 不一致时必须阻断并回到实现合同编译器。
 
-一个切片可以组合多个窄 Recipe，但只计算一次闭包。Recipe 只能引用 capability；合同同时冻结 `required_capabilities`、`required_skills`、完整原因链和 Registry/Compiler digest。任一 digest 改变时，当前合同标记 `stale`，重新编译后仍须由 `yss-product-lifecycle` 再批准。
+一个切片可以组合多个窄 Recipe，但只计算一次闭包。Recipe 只能引用 capability；合同同时冻结 `required_capabilities`、`required_skills`、完整原因链和 Registry/Compiler digest。任一 digest 或 Visual Baseline 版本 / digest 改变时，当前合同标记 `stale`，重新编译后仍须由 `yss-product-lifecycle` 再批准。UI 切片只消费 `visual_baseline_case_ids` 指定的图片，并先读取 manifest 与语义引用，禁止按目录 glob 猜测图片含义。

package/template/.agents/skills/yss-implementation-contract-compiler/references/yss-skill-execution-result.md

@@ -2,6 +2,8 @@
 
 核心 YSS skill 必须消费已批准合同版本，并返回：
 
+后端结果顶层带与当前 resolution 完全一致的 `architecture_identity`；每条验证记录还须有整数 `exit_code`。身份缺失、Profile 未 supported、验证非零或没有执行时间均不得 accepted。
+
 ```yaml
 execution_result:
   schema_version: 2

package/template/.agents/skills/yss-implementation-contract-compiler/tests/backend-profiles.test.mjs

@@ -0,0 +1,45 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { compileDefaultImplementationContract } from "../../../../scripts/lib/implementation-contract-compiler.mjs";
+import { validateArchitectureIdentity } from "../../../../scripts/lib/backend-architecture.mjs";
+import { loadSkillRegistry } from "../../../../scripts/lib/skill-registry.mjs";
+
+const registry = loadSkillRegistry();
+function input(name) {
+  const profile = registry.architecture_profiles[name];
+  const identity = { architecture_family: profile.architecture_family, architecture_profile: name,
+    generator_skill: profile.generator_skill, requested_capabilities: [], resolved_modules: profile.core_modules,
+    verification_database: "h2", production_database: "not-bound", contract_digest: "a".repeat(64) };
+  return { architecture_identity: identity, architecture_evidence: {
+    engineering_baseline: identity, repository_registration: identity, manifest: identity
+  }};
+}
+
+for (const name of Object.keys(registry.architecture_profiles)) {
+  test(`${name} selects architecture recipe and explicit Skill Profile`, () => {
+    const data = input(name);
+    const mvc = data.architecture_identity.architecture_family === "layered-mvc";
+    const result = compileDefaultImplementationContract({ ...data,
+      recipeIds: [mvc ? "backend.mvc-service-behavior" : "backend.ddd-domain-behavior", mvc ? "backend.mvc-http-api" : "backend.ddd-http-api"] });
+    assert.equal(result.required_skills.includes("yss-domain"), !mvc);
+    assert.equal(result.skill_profiles["yss-application"], name);
+    assert.equal(result.skill_profiles["yss-web-controller"], name);
+    assert.ok(result.readiness_blockers.includes("backend-profile-not-supported"));
+  });
+}
+
+test("rejects missing identity, deprecated recipe, wrong family and stale evidence", () => {
+  assert.throws(() => compileDefaultImplementationContract({ recipeIds: ["backend.mvc-http-api"] }), /architecture_identity/);
+  assert.throws(() => compileDefaultImplementationContract({ recipeIds: ["backend.http-api"] }), /deprecated/);
+  assert.throws(() => compileDefaultImplementationContract({ ...input("layered-mvc-service"), recipeIds: ["backend.ddd-http-api"] }), /架构族/);
+  const stale = input("layered-mvc-service");
+  stale.architecture_evidence.manifest = { ...stale.architecture_identity, contract_digest: "b".repeat(64) };
+  assert.throws(() => compileDefaultImplementationContract({ ...stale, recipeIds: ["backend.mvc-http-api"] }), /stale/);
+});
+
+test("rejects unsupported capability closure and production driver defaults", () => {
+  const identity = input("mvc-data-analysis-v1").architecture_identity;
+  assert.throws(() => validateArchitectureIdentity({ ...identity, resolved_modules: ["server"] }), /模块闭包/);
+  assert.throws(() => validateArchitectureIdentity({ ...identity, production_database: "oracle" }), /H2/);
+  assert.throws(() => compileDefaultImplementationContract({ ...input("layered-mvc-service"), requiredCapabilities: ["layer.domain"] }), /不匹配/);
+});