create-yss-spec 2.2.8 → 2.2.10

package/template/.cursor/skills/yss-product-lifecycle/references/orchestration.md

@@ -86,6 +86,12 @@ tracker 选择和冲突按 `docs/agents/issue-tracker.md` 裁决：已持久化
 
 暂停输出：门禁、指定会签 `role_id`、`runtime_id`、会签文件路径、证据、推荐答案、一个问题、恢复动作。
 
+## Context Plan 与质量基线
+
+实现合同先消费 `common.context_plan`：必需上下文只包含 `CONTEXT.md`、已批准 Spec、当前合同和适用 ADR / 工程基线；专项 references、实现仓库文件和历史证据按影响面按需加载。达到最小充分证据后停止扩展，缺失权威上下文只能 `blocked` 或 `reroute`。
+
+质量标准由 `engineering-baseline` 以 `baseline_id` / `baseline_version` 定义一次，Slice Contract、YSS Skill Execution Result、`code-review` 和发布检查只引用它，并将约束结果写入 `constraint_results`。命中 API / 数据迁移、跨仓契约、发布回滚、实际安全行为或生命周期 / 生成语义时，必须在现有决策或审查记录中完成 Doubt-Driven 主张、反证、证据、残余风险和 Reviewer 引用；普通低风险变更不触发该流程。
+
 ## Wayfinder 完成判定
 
 “无 frontier”不等于完成。只有以下条件同时成立，才能 `wayfinder → handoff → to-spec`：

package/template/.cursor/skills/yss-repository/SKILL.md

@@ -22,30 +22,32 @@ description: Use when generating or refactoring YSS persistence models, BaseRepo
 ## 工作方式
 
 1. 先确认输入来源：领域模型、metadata、数据库表、DDL。
-2. 探测持久化 profile：新 DDD 默认 `PO <-> Domain Model`；legacy YSS 常见 `Entity + BaseRepository + GatewayImpl`。沿用现有工程命名，不混用两套模型。
+2. 确认持久化 Profile 为 `mybatis-plus` 与 `PO <-> Domain Model`；`Entity + BaseRepository + DTO/VO GatewayImpl` 等旧架构对新脚手架为 `unsupported`。
 3. 如果 metadata 不完整，先补齐 metadata、数据库表结构或 DDL 输入。
 4. 涉及 POJO 字段、getter/setter、constructor、builder 或日志时，必须加载并遵守 `lombok`。
-5. 涉及持久化模型与 Domain/VO/CMD 转换时，必须加载并遵守 `mapstruct`。
+5. 涉及持久化模型与 Domain/Application Result 转换时，必须加载并遵守 `mapstruct`；Infrastructure 不生成 Web VO/CMD 转换。
 6. 生成代码时严格保持 Domain 与 Infrastructure 分层边界。
 7. 默认先生成基础 CRUD 骨架，把复杂查询留给手工实现。
 
 ## 产物范围
 
 - `domain/{segment}/gateway/*Gateway.java`
-- `repository/entity/*PO.java`（legacy profile 沿用 `*Entity.java`）
+- `repository/entity/*PO.java`
 - `repository/*Repository.java`
 - `repository/convertor/*Convertor.java`
 - `repository/gateway/impl/*GatewayImpl.java`
+- `query/adapter/*QueryAdapter.java`（实现 Application Query Port）
 
 ## 约束
 
 - Domain 不依赖 Infrastructure。
 - Gateway 定义在 Domain，实现放在 Infrastructure。
+- Domain Gateway 只交换 Domain Model、领域值和标识；分页、列表和读模型走 Application Query Port，禁止返回 Web VO 或把 `PageQuery` 带入 Domain。
 - PO / Domain Model 等 POJO 样板代码优先使用 Lombok；不要成片手写 getter/setter、constructor、builder 或 logger。
-- Convertor 必须优先使用 MapStruct；禁止 `BeanUtils.copyProperties`、反射式通用拷贝和重复手写字段赋值，除非实现合同记录受控例外、测试和 review 证据。
+- Convertor 必须优先使用 `@Mapper(componentModel = "spring")` 和构造器注入；禁止静态 `INSTANCE`、`BeanUtils.copyProperties`、反射式通用拷贝和重复手写字段赋值，除非实现合同记录受控例外、测试和 review 证据。
 - MapStruct 与 Lombok 同时使用时，必须确认注解处理器顺序和 `lombok-mapstruct-binding` 配置；构建命令使用项目根目录 `./mvnw ...`。
 - 逻辑删除、审计字段、主键策略要显式处理，不要隐式略过。
-- 事务放在批准的 Application 用例边界；legacy GatewayImpl 已有事务时先记录并测试迁移影响，不重复嵌套制造假边界。
+- 事务放在批准的 Application 用例边界；检测到旧 GatewayImpl 事务布局时返回 `unsupported`，不在 scaffold 链路内迁移。
 
 ## 质量门禁
 

package/template/.cursor/skills/yss-repository/references/infrastructure-layer-guide.md

@@ -1,192 +1,107 @@
-本 Skill 提供了 YSS **Infrastructure (基础设施层)** 的通用开发规范。Infrastructure 层负责实现 Domain 层定义的网关接口，处理数据持久化、外部服务调用和配置管理。
+# YSS Infrastructure Target Profile 指南
 
-## 1. 核心职责 (Core Responsibilities)
+本指南只定义 `target-domain-model + mybatis-plus`。历史 `Entity + DTO/VO Gateway` 为 `unsupported`，不存在旧架构 Profile。
 
-- **实现网关接口 (Gateway Implementation)**: 实现 Domain 层定义的 `Gateway` 接口。
-- **数据持久化 (Persistence)**: 定义 `Repository` 接口和 `PO` (Persistent Object) 实体，操作数据库。
-- **对象转换 (Conversion)**: 使用 MapStruct 实现 PO 与 Domain Model/DTO 之间的转换。
-- **外部适配 (External Adapters)**: 集成外部服务 (如文件存储、消息队列)。
+## 1. 职责
 
-## 2. 代码结构 (Code Structure)
+- 实现 Domain Gateway，负责 Aggregate 持久化。
+- 实现 Application Query Port，负责分页、列表和读模型。
+- 定义 PO、MyBatis-Plus Repository/Mapper、XML 和数据源适配。
+- 通过 Spring MapStruct Bean 完成 `PO <-> Domain Model`、`PO -> Application Result`。
 
-```
-com.yss.{module}.repository
-├── entity                  # 持久化对象 (PO)
-├── gateway.impl            # Domain Gateway 接口实现
-├── convertor               # MapStruct 转换器
-├── util                    # 工具类
-└── {Domain}Repository.java # MyBatis Plus Repository 接口
-```
-
-## 3. 开发规范 (Development Guidelines)
-
-### 3.1 持久化对象 (PO)
-
-- **命名**: `DomainName` + `PO` (e.g., `QualityTemplatePO`)。
-- **继承**: 推荐继承 `AuditableEntity` 以自动处理审计字段 (`created_by`, `created_date` 等)，但非强制要求。
-- **注解**:
-  - `@TableName("t_table_name")`: 指定数据库表名。
-  - `@TableId(value = "id", type = IdType.ASSIGN_ID)`: 指定主键策略 (雪花算法)。
-  - `@TableField("column_name")`: 指定字段映射。
-  - 按 `lombok` skill 选择最小注解；PO 默认使用 `@Getter` / `@Setter`，不得无条件使用 `@Data`。继承基类时再审查 `equals/hashCode/toString` 风险。
-
-### 3.2 Repository 接口
-
-- **继承**: `com.yss.cloud.mybatis.support.BasePlusRepository<PO>`。
-- **位置**: 直接位于 `com.yss.{module}.repository` 包下。
-- **Mapper XML**: 对应的 XML 文件位于 `src/main/resources/mappers`。
-
-### 3.3 Gateway 实现
-
-- **位置**: `com.yss.{module}.repository.gateway.impl`。
-- **注解**: `@Repository` 或 `@Service`。
-- **依赖注入**: 使用 `@RequiredArgsConstructor` (Lombok) 或 `@Autowired` 注入 Repository。
-- **查询逻辑**: 使用 `Wrappers.lambdaQuery()` 构建类型安全的查询条件。
-- **分页处理**: 使用 `PageUtil.page(query)` 构建分页对象，返回 `PageResult.of(...)`。
+Infrastructure 不拥有业务事务边界，不向 Application/Web 暴露 PO，也不直接生成 HTTP VO。
 
-### 3.4 对象转换 (Convertor)
+## 2. 包结构
 
-- **工具**: MapStruct。
-- **位置**: `com.yss.{module}.repository.convertor`。
-- **命名**: `DomainName` + `Convertor` (e.g., `QualityTemplateConvertor`)。
-- **规范**: 定义 `INSTANCE` 常量，使用 `Mappers.getMapper(...)` 获取实例。
+```text
+{base_package}.infrastructure
+├── persistence
+│   ├── po
+│   ├── repository
+│   ├── convertor
+│   └── gateway
+└── query
+    ├── adapter
+    └── convertor
+```
 
-## 4. 详细案例 (Detailed Examples)
+新脚手架固定使用 `{base_package}.infrastructure`。已有 `{base_package}.repository` 工程不由 scaffold 改写；需要现代化时单独立项。
 
-### 4.1 Persistent Object (PO)
+## 3. Domain Gateway 实现
 
 ```java
-package com.yss.quality.repository.entity;
-
-import com.baomidou.mybatisplus.annotation.IdType;
-import com.baomidou.mybatisplus.annotation.TableField;
-import com.baomidou.mybatisplus.annotation.TableId;
-import com.baomidou.mybatisplus.annotation.TableName;
-import lombok.Getter;
-import lombok.Setter;
-import lombok.EqualsAndHashCode;
-
-@Getter
-@Setter
-@EqualsAndHashCode(callSuper = true)
-@TableName("t_quality_template")
-public class QualityTemplatePO extends AuditableEntity {
-
-    @TableId(value = "id", type = IdType.ASSIGN_ID)
-    private Long id;
-
-    @TableField("template_name")
-    private String templateName;
+@Repository
+@RequiredArgsConstructor
+public class QualityTemplateGatewayImpl implements QualityTemplateGateway {
+    private final QualityTemplateRepository repository;
+    private final QualityTemplatePersistenceConvertor convertor;
 
-    @TableField("template_code")
-    private String templateCode;
+    @Override
+    public Optional<QualityTemplate> findById(QualityTemplateId id) {
+        return Optional.ofNullable(repository.selectById(id.value()))
+                .map(convertor::toDomain);
+    }
 
-    @TableField("status")
-    private Integer status;
+    @Override
+    public void save(QualityTemplate aggregate) {
+        repository.insertOrUpdate(convertor.toPO(aggregate));
+    }
 }
 ```
 
-### 4.2 Repository Interface
+GatewayImpl 不接收 Web Cmd/Query，不返回 VO/PageResult，不声明新的业务事务。
 
-```java
-package com.yss.quality.repository;
-
-import com.yss.cloud.mybatis.support.BasePlusRepository;
-import com.yss.quality.repository.entity.QualityTemplatePO;
-
-public interface QualityTemplateRepository extends BasePlusRepository<QualityTemplatePO> {
-}
-```
+## 4. Query Port 实现
 
-### 4.3 Gateway Implementation
+分页/列表属于 Application Query Port：
 
 ```java
-package com.yss.quality.repository.gateway.impl;
-
-import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
-import com.baomidou.mybatisplus.core.metadata.IPage;
-import com.baomidou.mybatisplus.core.toolkit.Wrappers;
-import com.yss.cloud.dto.result.PageResult;
-import com.yss.quality.client.dto.query.QualityTemplatePage;
-import com.yss.quality.client.vo.QualityTemplateVO;
-import com.yss.quality.domain.template.gateway.QualityTemplateGateway;
-import com.yss.quality.repository.QualityTemplateRepository;
-import com.yss.quality.repository.convertor.QualityTemplateConvertor;
-import com.yss.quality.repository.entity.QualityTemplatePO;
-import com.yss.quality.repository.util.PageUtil;
-import lombok.RequiredArgsConstructor;
-import org.springframework.stereotype.Repository;
-import org.springframework.util.StringUtils;
-
-import java.util.List;
-
 @Repository
 @RequiredArgsConstructor
-public class QualityTemplateGatewayImpl implements QualityTemplateGateway {
-
-    private final QualityTemplateRepository qualityTemplateRepository;
+public class QualityTemplateQueryAdapter implements QualityTemplateQueryPort {
+    private final QualityTemplateRepository repository;
+    private final QualityTemplateQueryConvertor convertor;
 
     @Override
-    public PageResult<QualityTemplateVO> pageQualityTemplate(QualityTemplatePage query) {
-        LambdaQueryWrapper<QualityTemplatePO> wrapper = Wrappers.lambdaQuery(QualityTemplatePO.class);
-
-        // 构建查询条件
-        if (StringUtils.hasText(query.getTemplateName())) {
-            wrapper.like(QualityTemplatePO::getTemplateName, query.getTemplateName());
-        }
-        if (query.getStatus() != null) {
-            wrapper.eq(QualityTemplatePO::getStatus, query.getStatus());
-        }
-
-        wrapper.orderByDesc(QualityTemplatePO::getCreatedDate);
-
-        // 执行分页查询
-        IPage<QualityTemplatePO> result = qualityTemplateRepository.selectPage(PageUtil.page(query), wrapper);
-
-        // 转换结果
-        List<QualityTemplateVO> records = QualityTemplateConvertor.INSTANCE.toQualityTemplateVOList(result.getRecords());
-
-        return PageResult.of(
-                records,
-                result.getTotal(),
-                result.getSize(),
-                result.getCurrent()
-        );
+    public PageResult<QualityTemplateResult> page(QualityTemplatePageQuery query) {
+        // orderBy/groupBy 必须先映射到批准列白名单，再构造 MyBatis 条件。
+        return convertor.toResultPage(repository.selectPage(...));
     }
 }
 ```
 
-### 4.4 Convertor (MapStruct)
-
-```java
-package com.yss.quality.repository.convertor;
-
-import com.yss.quality.client.vo.QualityTemplateVO;
-import com.yss.quality.repository.entity.QualityTemplatePO;
-import org.mapstruct.Mapper;
-import org.mapstruct.factory.Mappers;
+`PageQuery` 可以在 Web/Application/Infrastructure 协作链使用，但不得进入 Domain。`orderBy` / `groupBy` 禁止直接拼接 SQL。
 
-import java.util.List;
+## 5. PO 与 Repository
 
-@Mapper
-public interface QualityTemplateConvertor {
-    QualityTemplateConvertor INSTANCE = Mappers.getMapper(QualityTemplateConvertor.class);
+- Target Profile 使用 `*PO`；旧式 `*Entity` 布局为 `unsupported`。
+- PO 默认使用最小 Lombok 注解，不无条件使用 `@Data`。
+- 当前实现继承项目既有 `BasePlusRepository<PO>`；普通 MyBatis 为 `unsupported`。
+- Mapper XML 位于项目既有扫描路径；扫描包和 XML 路径必须由集成测试证明。
 
-    QualityTemplateVO toQualityTemplateVO(QualityTemplatePO po);
+## 6. MapStruct
 
-    List<QualityTemplateVO> toQualityTemplateVOList(List<QualityTemplatePO> pos);
+```java
+@Mapper(componentModel = "spring")
+public interface QualityTemplatePersistenceConvertor {
+    QualityTemplate toDomain(QualityTemplatePO source);
+    QualityTemplatePO toPO(QualityTemplate source);
 }
 ```
 
-## 5. 注意事项 (Notes)
+- 禁止 `INSTANCE = Mappers.getMapper(...)`。
+- Convertor 使用构造器注入。
+- 父 POM 必须配置 `mapstruct-processor`、Lombok 和 `lombok-mapstruct-binding`。
+- 验证必须编译生成实现，不能只检查接口文本。
+
+## 7. 验证
 
-1.  **AuditableEntity**: 推荐业务 PO 继承此基类，以便自动维护审计信息。
-2.  **Lombok 使用**: 使用 `@RequiredArgsConstructor` 进行构造器注入是推荐的最佳实践。
-3.  **Wrapper 使用**: 优先使用 `Wrappers.lambdaQuery()` 而不是字符串列名，以提高重构安全性。
-4.  **分页工具**: 使用 `PageUtil` 统一处理分页参数，避免手动计算 offset。
+- Domain Gateway：保存后可通过 Gateway seam 重新加载等价 Aggregate。
+- Query Port：分页、total、排序白名单和空结果。
+- Mapper/Repository：实际 MyBatis-Plus/H2 或批准数据库 fixture。
+- Architecture：Infrastructure 可以依赖 Application/Domain；反向依赖必须失败。
+- 使用项目根 `./mvnw test/package` 留证。
 
-## 6. 阶段 7 合同
+## 8. 旧架构边界
 
-- 前置条件是批准的数据架构、Repository 策略和 Slice Contract。
-- PO/Repository/Convertor 骨架可受控生成；复杂查询、分页语义、数据源、事务、迁移和并发使用 `behavior-tdd`。
-- 返回统一 `YSS Skill Execution Result`，证据包含实际文件、集成测试、MapStruct/Lombok 配置和 `./mvnw ...` 结果。
+检测到 Repository 直接接收 client Query、返回 VO、Convertor 做 `PO -> VO` 或使用旧式 Entity 布局时，返回 `unsupported`，不得由新 scaffold 自动改写。旧项目继续按原工程维护；现代化改造必须单独立项。

package/template/.cursor/skills/yss-router/references/router-contract.yaml

@@ -5,7 +5,6 @@ skill_aliases:
   api-integration: yss-api-integration
   microapp-commit: yss-microapp-commit
   page-module-development: yss-page-module-development
-  yss-ui-business-page-generation: yss-page-module-development
   use-table-height: yss-use-table-height
   use-tree-height: yss-use-tree-height
 implementation_path_policy:
@@ -68,7 +67,7 @@ slice_contract_required:
   root: [schema_version, contract_id, contract_version, slice_id, status, lifecycle_refs, readiness, common, frontend, backend, contract, cross_repo, work_units]
   lifecycle_refs: [spec, ticket, requirement_freeze, low_fidelity_review, prototype_review, high_fidelity_html, prototype_verification, antd_cli_evidence, browser_verification_evidence, 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]
-  common: [impacted_areas, implementation_path_policy, project_roots, required_skills, optional_skills, unavailable_skills, allowed_write_paths, forbidden_patterns, expected_evidence_files, verification_commands, human_review_points, full_reroute_triggers]
+  common: [impacted_areas, implementation_path_policy, project_roots, 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]
   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]
@@ -100,20 +99,49 @@ work_unit_required: [id, behavior, primary_skill, supporting_skills, tdd_mode, a
 work_unit_nonempty_arrays: [allowed_write_paths, expected_evidence, verification_commands]
 slice_contract_nonempty: [contract_id, contract_version, slice_id, status]
 slice_contract_array_fields:
-  common: [impacted_areas, implementation_path_policy, project_roots, required_skills, allowed_write_paths, forbidden_patterns, expected_evidence_files, verification_commands, full_reroute_triggers]
+  common: [impacted_areas, implementation_path_policy, project_roots, required_skills, allowed_write_paths, forbidden_patterns, expected_evidence_files, verification_commands, full_reroute_triggers, quality_baseline_ref, context_plan, doubt_driven_review]
+
+context_plan:
+  required: [required_context_refs, on_demand_context_refs, context_stop_rule, missing_context_action]
+  context_stop_rule: minimal-sufficient-evidence
+  missing_context_action: [blocked, reroute]
 
 scaffold_contract_schema:
-  schema_version: 1
+  schema_version: 2
+  identity: service-engineering-baseline
   compiled_by: yss-router
   approved_by: yss-product-lifecycle
   status_by_owner:
     router: [draft, ready-for-lifecycle-review, blocked]
     lifecycle: [approved, stale, blocked]
-  required: [contract_id, contract_version, slice_id, status, router_draft_ref, lifecycle_approval_ref, persisted_ref, current_version, implementation_repository, backend_repository, scaffold_status, target_git_url_or_output_dir, allowed_write_paths, expected_evidence_files, verification_commands, approval, work_unit, overwrite_policy]
+  required: [contract_id, contract_version, scaffold_request_id, status, router_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]
   approval:
     required: [approval_ref, approver, persisted_ref, current_version]
-  overwrite_policy:
-    required: [force_allowed, overwrite_scope, rollback_ref]
+  generation_policy:
+    required: [mode, existing_target, old_project_migration, template_upgrade]
+    mode: initialize-only
+    existing_target: unsupported
+    old_project_migration: unsupported
+    template_upgrade: unsupported
+  maven_coordinates:
+    required: [group_id, project_version, parent, yss_components_version]
+    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]
+  unsupported_inputs:
+    schema_v1: reject-no-auto-upgrade
+    slice_id: forbidden-as-scaffold-identity
+    existing_project: reject-no-scaffold-migration
   lifecycle_boundary:
     router_emits: [draft, ready-for-lifecycle-review, blocked]
     lifecycle_approves: [approved]
@@ -122,12 +150,18 @@ scaffold_contract_schema:
   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]
+    allowed_for: [project_scaffold, pom, mechanical_config, wrapper, bootstrap_entrypoint, manifest_v2, 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
+    template_upgrade: unsupported
+    old_project_migration: unsupported-separate-architecture-modernization-initiative
   verification:
     commands: ["./mvnw validate", "./mvnw test", "./mvnw package"]
     requires_execution: true
-    evidence: [command, exit_code, duration_ms, stdout_ref, stderr_ref, executed_at]
+    completion_levels: [generated, empty-scaffold-verified, first-slice-verified]
+    downstream_readiness_claim_requires: first-slice-verified
+    evidence: [preflight, command, exit_code, failure_category, duration_ms, stdout_ref, stderr_ref, executed_at]
 
 applicable_subcontract_nonempty:
   frontend:
@@ -178,6 +212,11 @@ dependency_closure:
     always: [yss-exception]
   yss-exception:
     always: [yss-dto]
+  yss-ui-business-page-generation:
+    when_components: [yss-components]
+    when_hooks: [yss-hook]
+    when_form: [yss-formily]
+    when_api: [yss-api-integration]
   yss-page-module-development:
     when_components: [yss-components]
     when_hooks: [yss-hook]
@@ -241,6 +280,7 @@ full_reroute_triggers:
   - test-seam-changed
   - verification-command-changed
   - delivery-order-changed
+  - doubt-review-triggered
 
 reroute_destinations:
   scaffold-baseline-drift: stage7-scaffold-revalidation
@@ -258,9 +298,30 @@ reroute_destinations:
   test-seam-changed: spec-ticket-test-seam-review
   verification-command-changed: stage7-contract-recompile
   delivery-order-changed: cross-repo-release-review
+  doubt-review-triggered: high-risk-decision-review
+
+doubt_driven_review:
+  applies_when:
+    - api-schema-impact
+    - database-schema-impact
+    - cross-repo-contract
+    - release-or-rollback
+    - authentication-authorization-tenant-or-sensitive-data-behavior
+    - lifecycle-or-generation-semantics
+  required: [claim, counterclaim, evidence_refs, residual_risks, reviewer_ref]
+  status_values: [not-applicable, required, completed, blocked]
+  blocking_when: [missing-counterclaim, insufficient-evidence, unresolved-residual-risk]
+  evidence_owner: decision-or-review-record
+  no_new_lifecycle_stage: true
+
+quality_baseline:
+  source: lifecycle_refs.engineering_baseline
+  required_for: [project-instance]
+  reused_by: [slice-contract, yss-skill-execution-result, code-review, release]
+  redefinition: forbidden
 
 execution_result_allowed_statuses: [implemented, seam-deferred, drift, violation, not-applicable]
-execution_blockers: [path-outside-contract, missing-evidence, verification-not-executed, verification-command-mismatch, seam-deferred-without-owner, constraint-failed, unapproved-deviation, drift, violation, new-impacts]
+execution_blockers: [path-outside-contract, missing-evidence, verification-not-executed, verification-command-mismatch, seam-deferred-without-owner, constraint-failed, doubt-review-missing, unapproved-deviation, drift, violation, new-impacts]
 
 contract_versioning:
   full_reroute_current_status: stale

package/template/.cursor/skills/yss-router/references/slice-implementation-contract.md

@@ -54,6 +54,20 @@ slice_contract:
     verification_commands: []
     human_review_points: []
     full_reroute_triggers: []
+    quality_baseline_ref:
+    context_plan:
+      required_context_refs: []
+      on_demand_context_refs: []
+      context_stop_rule: minimal-sufficient-evidence
+      missing_context_action: blocked # or reroute
+    doubt_driven_review:
+      status: not-applicable # or required / completed / blocked
+      trigger_impacts: []
+      claim:
+      counterclaim:
+      evidence_refs: []
+      residual_risks: []
+      reviewer_ref:
   frontend:
     status: not-applicable
     required_skills: []

package/template/.cursor/skills/yss-router/references/yss-skill-execution-result.md

@@ -13,6 +13,8 @@ execution_result:
     contract_ref:
     contract_id:
     contract_version:
+    quality_baseline_ref:
+    context_plan_ref:
   changed_files:
     - path:
       contract_area: common | frontend | backend | contract | cross_repo
@@ -28,6 +30,9 @@ execution_result:
     - constraint:
       status: passed | failed | not-applicable
       evidence_ref:
+  doubt_driven_review:
+    status: not-applicable | completed | blocked
+    record_ref:
   seam_deferred:
     - risk:
       owner:

package/template/.cursor/skills/yss-ui/SKILL.md

@@ -46,14 +46,15 @@ pnpm why vue @yss-ui/components @yss-ui/hooks ant-design-vue vxe-table
 
 - `YTable` 替代 AntDV `Table`，列使用 `field/type` 和字段同名插槽。
 - `YTree` 替代 AntDV `Tree`。
-- `YssFormily` 是新代码 canonical name；`YFormily` 仅作为已确认导出的 deprecated alias。
+- `YFormily` 是新代码 canonical name；`YssFormily` 仅作为已确认导出的历史兼容 alias。
 - `YSplitPane`、`YButton`、`YCard` 等已有封装优先使用 YSS。
 
 ## 4. 最小专项 skill 路由
 
 | 任务 | 必须路由 |
 |---|---|
-| 完整页面模块 | `yss-page-module-development` |
+| 新建或改造完整业务页面 | `yss-ui-business-page-generation` |
+| 生命周期页面编排与旧触发词兼容 | `yss-page-module-development` |
 | 页面布局、组件和交互 | `yss-components` |
 | 请求、分页、参数、树数据映射 | `yss-hook` |
 | Formily schema、联动、校验、详情态 | `yss-formily` |
@@ -78,7 +79,7 @@ views/PageName/
 - `index.vue` 只做页面编排和事件转发。
 - `components/` 承载区块展示和局部交互。
 - `hooks/` 承载请求、分页、参数单一来源、映射和错误兜底。
-- `schemas/` 承载 `YssFormily` schema。
+- `schemas/` 承载 `YFormily` schema。
 - 页面内禁止复制请求流程、分页状态和复杂字段转换。
 
 ## 6. 跨组件强制约束
@@ -129,7 +130,7 @@ verification: pnpm type-check
 1. 读取批准合同、项目版本和组件映射。
 2. 选择最小专项 skills。
 3. 搭页面目录和布局。
-4. 接 `YssFormily`、`YTable`、`YTree` 等 YSS 主体组件。
+4. 接 `YFormily`、`YTable`、`YTree` 等 YSS 主体组件。
 5. 下沉请求、分页和映射到 `yss-hook`。
 6. 接高度、主题、locale、浮层和无障碍约束。
 7. 联调冻结 API、Mock、路由和权限。
@@ -139,7 +140,7 @@ verification: pnpm type-check
 
 - [ ] 已记录 Vue、YSS UI、AntDV、VXE 实际版本。
 - [ ] 组件选型符合 `component-routing.md`，回退有证据。
-- [ ] 新代码使用 `YssFormily` 和真实存在的 `yss-hook`。
+- [ ] 新代码使用 `YFormily` 和真实存在的 `yss-hook`。
 - [ ] YTable/YTree/Formily/高度 Hook 遵循专项 skill。
 - [ ] 主题、locale、浮层容器和微应用隔离已检查。
 - [ ] loading/empty/error/no-access/selected 状态按影响面覆盖。

package/template/.cursor/skills/yss-ui/references/component-routing.md

@@ -9,7 +9,7 @@
 | 数据表格 | `YTable` | VXE Table + AntDV Pagination | specialized | 使用 `yss-components`、`field/type`、字段插槽 |
 | 编辑表格 | `YEditTable` | VXE Table | specialized | 对照 edit-table docs/demo |
 | 树 | `YTree` | AntDV Tree | specialized | 搜索、Tooltip、动作和高度路由 |
-| Schema 表单 | `YssFormily` | Formily + AntDV | specialized | `YssFormily` 为 canonical；加载 `yss-formily` |
+| Schema 表单 | `YFormily` | Formily + AntDV | specialized | `YFormily` 为 canonical；`YssFormily` 仅为历史兼容名；加载 `yss-formily` |
 | 分栏布局 | `YSplitPane` | YSS layout | required | 统一主从页面与容器高度 |
 | 文件导入 | `YFileImport` | Upload/业务适配 | required | 使用 YSS 上传结果和表单适配 |
 | 条件构建 | `YConditionBuilder` | YSS domain component | required | 使用对应 docs/demo |