create-yss-spec 2.2.8 → 2.2.10

package/template/.hermes/skills/yss-ddd-scaffold-generator/assets/templates/pom/parent-pom.xml.template

@@ -3,22 +3,33 @@
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <parent>
-        <groupId>com.yss.datamiddle</groupId>
-        <artifactId>yss-datamiddle-parent</artifactId>
-        <version>2.0.0-SNAPSHOT</version>
+        <groupId>{{parent_group_id}}</groupId>
+        <artifactId>{{parent_artifact_id}}</artifactId>
+        <version>{{parent_version}}</version>
         <relativePath />
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
+    <groupId>{{group_id}}</groupId>
     <artifactId>{{project_name}}-parent</artifactId>
-    <version>1.0.0-SNAPSHOT</version>
+    <version>{{project_version}}</version>
     <packaging>pom</packaging>
 
     <name>{{project_name}}-parent</name>
     <description>{{project_description}}</description>
 
     <properties>
-        <yss-components.version>2.0.0-SNAPSHOT</yss-components.version>
+        <yss-components.version>{{yss_components_version}}</yss-components.version>
+        <maven.compiler.source>1.8</maven.compiler.source>
+        <maven.compiler.target>1.8</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <mapstruct.version>1.5.5.Final</mapstruct.version>
+        <lombok.version>1.18.30</lombok.version>
+        <lombok-mapstruct-binding.version>0.2.0</lombok-mapstruct-binding.version>
+        <swagger-annotations-v3.version>2.2.22</swagger-annotations-v3.version>
+        <archunit.version>1.2.1</archunit.version>
+        <maven-compiler-plugin.version>3.11.0</maven-compiler-plugin.version>
+        <maven-enforcer-plugin.version>3.5.0</maven-enforcer-plugin.version>
     </properties>
 
     <modules>
@@ -53,24 +64,29 @@
                 <artifactId>yss-component-spring-cache</artifactId>
                 <version>${yss-components.version}</version>
             </dependency>
+            <dependency>
+                <groupId>com.tngtech.archunit</groupId>
+                <artifactId>archunit-junit5</artifactId>
+                <version>${archunit.version}</version>
+            </dependency>
 
             <dependency>
-                <groupId>com.yss.datamiddle</groupId>
+                <groupId>{{group_id}}</groupId>
                 <artifactId>{{project_name}}-domain</artifactId>
                 <version>${project.version}</version>
             </dependency>
             <dependency>
-                <groupId>com.yss.datamiddle</groupId>
+                <groupId>{{group_id}}</groupId>
                 <artifactId>{{project_name}}-application</artifactId>
                 <version>${project.version}</version>
             </dependency>
             <dependency>
-                <groupId>com.yss.datamiddle</groupId>
+                <groupId>{{group_id}}</groupId>
                 <artifactId>{{project_name}}-infrastructure</artifactId>
                 <version>${project.version}</version>
             </dependency>
             <dependency>
-                <groupId>com.yss.datamiddle</groupId>
+                <groupId>{{group_id}}</groupId>
                 <artifactId>{{project_name}}-web</artifactId>
                 <version>${project.version}</version>
             </dependency> {{db_dependency}} </dependencies>
@@ -78,6 +94,50 @@
 
     <build>
         <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>${maven-compiler-plugin.version}</version>
+                <configuration>
+                    <parameters>true</parameters>
+                    <annotationProcessorPaths>
+                        <path>
+                            <groupId>org.mapstruct</groupId>
+                            <artifactId>mapstruct-processor</artifactId>
+                            <version>${mapstruct.version}</version>
+                        </path>
+                        <path>
+                            <groupId>org.projectlombok</groupId>
+                            <artifactId>lombok</artifactId>
+                            <version>${lombok.version}</version>
+                        </path>
+                        <path>
+                            <groupId>org.projectlombok</groupId>
+                            <artifactId>lombok-mapstruct-binding</artifactId>
+                            <version>${lombok-mapstruct-binding.version}</version>
+                        </path>
+                    </annotationProcessorPaths>
+                </configuration>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-enforcer-plugin</artifactId>
+                <version>${maven-enforcer-plugin.version}</version>
+                <executions>
+                    <execution>
+                        <id>enforce-target-ddd-baseline</id>
+                        <goals><goal>enforce</goal></goals>
+                        <configuration>
+                            <rules>
+                                <requireJavaVersion><version>[1.8,1.9)</version></requireJavaVersion>
+                                <requireMavenVersion><version>[3.6.3,)</version></requireMavenVersion>
+                                <reactorModuleConvergence/>
+                                <dependencyConvergence/>
+                            </rules>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-source-plugin</artifactId>
@@ -92,4 +152,4 @@
             </plugin>
         </plugins>
     </build>
-</project>
+</project>

package/template/.hermes/skills/yss-ddd-scaffold-generator/assets/templates/pom/web-pom.xml.template

@@ -5,22 +5,18 @@
     <modelVersion>4.0.0</modelVersion>
 
     <parent>
-        <groupId>com.yss.datamiddle</groupId>
+        <groupId>{{group_id}}</groupId>
         <artifactId>{{project_name}}-adapter</artifactId>
-        <version>1.0.0-SNAPSHOT</version>
+        <version>{{project_version}}</version>
     </parent>
 
     <artifactId>{{project_name}}-web</artifactId>
 
     <dependencies>
         <dependency>
-            <groupId>com.yss.datamiddle</groupId>
+            <groupId>{{group_id}}</groupId>
             <artifactId>{{project_name}}-application</artifactId>
         </dependency>
-        <dependency>
-            <groupId>com.yss.datamiddle</groupId>
-            <artifactId>{{project_name}}-domain</artifactId>
-        </dependency>
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-web</artifactId>
@@ -35,10 +31,28 @@
             <scope>provided</scope>
         </dependency>
         <dependency>
-            <groupId>io.swagger</groupId>
+            <groupId>com.yss.cloud</groupId>
+            <artifactId>yss-component-dto</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.yss.cloud</groupId>
+            <artifactId>yss-component-exception</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.mapstruct</groupId>
+            <artifactId>mapstruct</artifactId>
+            <version>${mapstruct.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>io.swagger.core.v3</groupId>
             <artifactId>swagger-annotations</artifactId>
-            <version>1.6.16</version>
+            <version>${swagger-annotations-v3.version}</version>
             <scope>compile</scope>
         </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
     </dependencies>
-</project>
+</project>

package/template/.hermes/skills/yss-ddd-scaffold-generator/assets/wrapper/.mvn/maven.config

@@ -1,3 +1,2 @@
--DaltSnapshotDeploymentRepository=yss-dm-snapshot::default::http://192.168.167.26:8081/repository/dm-snapshot/
--DaltReleaseDeploymentRepository=yss-dm-releases::default::http://192.168.167.26:8081/repository/dm-release/
--P aliyun-only
+-s .mvn/settings.xml
+-P yss-internal

package/template/.hermes/skills/yss-ddd-scaffold-generator/assets/wrapper/.mvn/settings.xml

@@ -1,128 +1,41 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
+          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 https://maven.apache.org/xsd/settings-1.0.0.xsd">
     <servers>
         <server>
-            <id>dm26-mirror</id>
+            <id>yss-internal</id>
             <username>${env.MAVEN_REPO_USERNAME}</username>
             <password>${env.MAVEN_REPO_PASSWORD}</password>
         </server>
-        <server>
-            <id>dm26</id>
-            <username>${env.MAVEN_REPO_USERNAME}</username>
-            <password>${env.MAVEN_REPO_PASSWORD}</password>
-        </server>
-
-        <!-- 假设 yss-dm-* 和 dm-* 与 dm26 是同一服务器实例，可以尝试合并权限 -->
-        <server>
-            <id>yss-dm-releases</id>
-            <username>${env.MAVEN_REPO_USERNAME}</username>
-            <password>${env.MAVEN_REPO_PASSWORD}</password>
-        </server>
-        <server>
-            <id>yss-dm-snapshot</id>
-            <username>${env.MAVEN_REPO_USERNAME}</username>
-            <password>${env.MAVEN_REPO_PASSWORD}</password>
-        </server>
-
     </servers>
-
-    <!-- 解决镜像冲突：调整顺序，并使用更精确的 mirrorOf 语法 -->
     <mirrors>
-<!--        <mirror>-->
-<!--            <id>dm26-mirror</id>-->
-<!--            <name>Internal Repository Manager</name>-->
-<!--            <url>http://192.168.167.26:8081/repository/dm/</url>-->
-<!--            <mirrorOf>external:*</mirrorOf>-->
-<!--        </mirror>-->
-
+        <mirror>
+            <id>yss-internal</id>
+            <name>YSS controlled repository manager</name>
+            <url>${env.YSS_MAVEN_REPOSITORY_URL}</url>
+            <mirrorOf>*</mirrorOf>
+        </mirror>
     </mirrors>
-
     <profiles>
         <profile>
-            <id>internal-only</id>
-            <activation>
-                <property>
-                    <name>env</name>
-                    <value>internal</value>
-                </property>
-            </activation>
-            <!-- 配置部署仓库 -->
-            <properties>
-                <altReleaseDeploymentRepository>
-                    dm-releases::default::http://192.168.167.26:8081/repository/dm-releases/
-                </altReleaseDeploymentRepository>
-                <altSnapshotDeploymentRepository>
-                    dm-snapshots::default::http://192.168.167.26:8081/repository/dm-snapshots/
-                </altSnapshotDeploymentRepository>
-            </properties>
-
-            <!-- 通常，配置了镜像后，此处无需再声明repository。
-                 除非你需要从这个特定的仓库下载一些在镜像中未包含的构件 -->
+            <id>yss-internal</id>
             <repositories>
-                <!-- 你的内部仓库。由于镜像配置，对它的请求也会被代理 -->
                 <repository>
-                    <id>dm26</id>
-                    <name>Internal Repository</name>
-                    <url>http://192.168.167.26:8081/repository/dm/</url>
-                    <releases>
-                        <enabled>true</enabled>
-                        <updatePolicy>daily</updatePolicy> <!-- 平衡网络请求和更新频率 -->
-                    </releases>
-                    <snapshots>
-                        <enabled>true</enabled>
-                        <updatePolicy>always</updatePolicy> <!-- SNAPSHOT需要实时更新 -->
-                    </snapshots>
+                    <id>yss-internal</id>
+                    <url>${env.YSS_MAVEN_REPOSITORY_URL}</url>
+                    <releases><enabled>true</enabled></releases>
+                    <snapshots><enabled>true</enabled></snapshots>
                 </repository>
             </repositories>
-
             <pluginRepositories>
                 <pluginRepository>
-                    <id>dm26</id>
-                    <name>Internal Plugin Repository</name>
-                    <url>http://192.168.167.26:8081/repository/dm/</url>
-                    <releases>
-                        <enabled>true</enabled>
-                        <updatePolicy>daily</updatePolicy>
-                    </releases>
-                    <snapshots>
-                        <enabled>true</enabled>
-                        <updatePolicy>always</updatePolicy>
-                    </snapshots>
+                    <id>yss-internal</id>
+                    <url>${env.YSS_MAVEN_REPOSITORY_URL}</url>
+                    <releases><enabled>true</enabled></releases>
+                    <snapshots><enabled>true</enabled></snapshots>
                 </pluginRepository>
             </pluginRepositories>
         </profile>
-        <!-- 使用阿里云的配置 -->
-        <profile>
-            <id>aliyun-only</id>
-            <activation>
-                <property>
-                    <name>env</name>
-                    <value>aliyun</value>
-                </property>
-            </activation>
-            <repositories>
-                <!-- 阿里云仓库配置 -->
-                <repository>
-                    <id>aliyunmaven</id>
-                    <name>Aliyun Public Repository</name>
-                    <url>https://maven.aliyun.com/repository/public</url>
-                    <releases>
-                        <enabled>true</enabled>
-                        <updatePolicy>daily</updatePolicy> <!-- 平衡网络请求和更新频率 -->
-                    </releases>
-                    <snapshots>
-                        <enabled>false</enabled>
-                    </snapshots>
-                </repository>
-
-            </repositories>
-        </profile>
-
     </profiles>
-
-    <activeProfiles>
-        <activeProfile>aliyun-only</activeProfile>
-    </activeProfiles>
-</settings>
+</settings>

package/template/.hermes/skills/yss-ddd-scaffold-generator/assets/wrapper/.mvn/wrapper/maven-wrapper.properties

@@ -14,5 +14,7 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-distributionUrl=https://maven-warpper.oss-cn-beijing.aliyuncs.com/apache-maven-3.6.3bin.zip
-wrapperUrl=https://maven-warpper.oss-cn-beijing.aliyuncs.com/maven-wrapper-3.1.1.jar
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.6.3/apache-maven-3.6.3-bin.zip
+distributionSha256Sum=444522b0af3a85e966f25c50adfcd00a1a6fc5fce79f503bff096e02b9977c2e
+wrapperUrl=https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar
+wrapperSha256Sum=0f37e00f4a503f19cfb1b8100b1f251f241cd1981524761bb9454037cb97589d

package/template/.hermes/skills/yss-ddd-scaffold-generator/references/ARCHITECTURE.md

@@ -1,194 +1,116 @@
-# DDD 分层架构参考文档
+# YSS DDD Target Profile
 
-## 1. 架构概述
+本文定义 `architecture=target-domain-model` 的唯一目标结构。历史 `core/client/repository`、DTO 型 Gateway、client-in-domain 以及其他旧架构全部为 `unsupported`，不存在 legacy Profile 或回退分支。
 
-本脚手架采用 DDD（领域驱动设计）分层架构，将系统划分为四个核心层次：
+## 1. 模块职责
 
-```
-┌─────────────────────────────────────────────────────────────┐
-│                         Adapter 层                           │
-│                    (外部接口适配)                             │
-├─────────────────────────────────────────────────────────────┤
-│                       Application 层                         │
-│                    (业务用例编排)                             │
-├─────────────────────────────────────────────────────────────┤
-│                         Domain 层                            │
-│                    (核心业务逻辑)                             │
-├─────────────────────────────────────────────────────────────┤
-│                     Infrastructure 层                        │
-│                      (技术实现)                              │
-└─────────────────────────────────────────────────────────────┘
-```
-
-## 2. 各层职责
-
-### 2.1 Domain 层（领域层）
+### Domain
 
-**职责**:
+- 聚合根、Entity、Value Object、领域行为、不变量、Domain Event。
+- 聚合持久化使用 Domain Gateway/Port，只交换 Domain Model、领域值和领域标识。
+- 不依赖 Application、Infrastructure、Repository、Web、YSS DTO/Exception、Jackson、Swagger 或 Validation。
+- Domain error 使用稳定领域错误标识和参数，不决定 HTTP status 或公开消息。
 
-- 定义核心业务模型和规则
-- 定义数据传输对象（DTO）
-- 定义网关接口（Gateway）
-- 不包含任何技术实现细节
+推荐包：
 
-**包结构**:
-
-```
-com.yss.datamiddle.{module}
-├── client/dto/
-│   ├── cmd/        # 命令对象（写操作）
-│   ├── query/      # 查询对象（读操作）
-│   └── vo/         # 值对象（返回结果）
-└── domain/
-    ├── gateway/    # 网关接口
-    ├── model/      # 领域模型
-    └── service/    # 领域服务
+```text
+{base_package}.domain.{segment}
+├── model
+├── gateway
+├── service
+└── event
 ```
 
-**关键规范**:
-
-- Command 继承 `CommandDTO`，使用 JSR-303 校验
-- Query 继承 `PageQuery` 或 `QueryDTO`
-- VO 实现 `Serializable` 接口
-- Gateway 定义标准 CRUD 方法
+### Application
 
-### 2.2 Application 层（应用层）
+- 定义并编排 Use Case、事务边界、Application Command/Query/Result。
+- 写用例调用 Domain Model/Domain Gateway。
+- 分页、列表和读模型通过 Application Query Port，不把 `PageQuery`、`PageResult` 或 Web VO 放入 Domain。
+- 不依赖 Infrastructure 或 Web。
 
-**职责**:
-
-- 业务用例编排
-- 协调领域对象完成业务能力
-- 处理事务边界
-- 对象转换（DTO ↔ Domain）
-
-**包结构**:
+推荐包：
 
-```
-com.yss.datamiddle.{module}.core
-├── service/
-│   ├── impl/       # 服务实现
-│   └── convertor/  # MapStruct 转换器
-├── component/      # 业务组件
-└── job/            # 任务执行逻辑
+```text
+{base_package}.application
+├── command
+├── query
+├── result
+├── port
+└── service
 ```
 
-**关键规范**:
+### Infrastructure
 
-- Service 使用 `@RequiredArgsConstructor` 注入依赖
-- 写操作添加 `@Transactional` 注解
-- 使用 MapStruct 进行对象转换
+- 实现 Domain Gateway 和 Application Query Port。
+- MyBatis-Plus Repository、PO、SQL、数据源配置和 `PO <-> Domain Model` MapStruct 转换位于本层。
+- 首个受支持 Profile 是 `persistence=mybatis-plus`；其他持久化方案必须先通过独立 fixture。
+- 事务边界由 Application 持有，不在 GatewayImpl 重复制造边界。
 
-### 2.3 Infrastructure 层（基础设施层）
+### Adapter/Web
 
-**职责**:
+- HTTP Request/Response、校验、Controller、WebConvertor 和异常到 HTTP/YSS Result 的映射。
+- Request 字段来自冻结 OpenAPI/批准 allowlist，不从数据库 metadata 全量推导。
+- WebConvertor 使用 `@Mapper(componentModel = "spring")` 和构造器注入。
+- DTO 物理位置固定为 Web；独立 client module 为 `unsupported`。如未来确需发布复用制品，必须另行设计并批准新的 Target Profile。
+- Web 不直接依赖 Infrastructure，不把 Domain Model 作为 Controller seam。
 
-- 实现 Domain 层定义的 Gateway 接口
-- 数据持久化（Repository）
-- 外部服务集成
-- 配置管理
+### Bootstrap
 
-**包结构**:
+- 组合 Web 和 Infrastructure，提供机械 Spring Boot 入口与环境配置。
+- 默认配置使用 INFO；DEBUG 和 MyBatis stdout SQL 仅存在于 `application-local.yml`。
 
-```
-com.yss.datamiddle.{module}.repository
-├── entity/         # PO 对象
-├── gateway/impl/   # Gateway 实现
-├── convertor/      # 转换器
-└── {Domain}Repository.java
-```
+## 2. 依赖方向
 
-**关键规范**:
+```text
+Web -> Application -> Domain
+Infrastructure -> Application + Domain
+Bootstrap -> Web + Infrastructure
+```
 
-- PO 继承 `AuditableEntity`
-- Repository 继承 `BasePlusRepository`
-- 使用 `Wrappers.lambdaQuery()` 构建查询
+禁止：
 
-### 2.4 Adapter 层（适配器层）
+- Domain → Application/Infrastructure/Web
+- Application → Infrastructure/Web
+- Web → Infrastructure
+- Domain Gateway 接收 HTTP DTO、返回 Web VO/PageResult
+- Repository 把 PO 直接返回给 Application/Web
 
-**职责**:
+上述规则由生成工程的 `ArchitectureRulesTest` 执行，不只依赖文档约定。
 
-- 处理外部请求（HTTP、MQ、RPC）
-- 参数校验
-- 响应格式化
-- 异常处理
+## 3. 调用链
 
-**包结构**:
+写模型：
 
-```
-com.yss.datamiddle.{module}.rest
-└── {Domain}Controller.java
+```text
+HTTP Request -> WebConvertor -> Application Command -> Use Case
+  -> Domain Model/Domain Gateway -> GatewayImpl -> Repository/MyBatis -> PO
 ```
 
-**关键规范**:
-
-- Controller 使用 `@RestController`
-- 参数使用 `@Valid` 校验
-- 响应使用 `SingleResult`、`PageResult`、`MultiResult` 包装
-
-## 3. 依赖关系
+读模型：
 
+```text
+HTTP Page Request -> WebConvertor -> Application Query -> Query Port
+  -> Infrastructure Query Adapter -> Application Result -> Web Response
 ```
-Bootstrap -> Application -> Domain
-Infrastructure <-> Adapter (依赖倒置)
-```
-
-**依赖原则**:
 
-- Domain 层不依赖任何其他层
-- Application 层依赖 Domain 层
-- Infrastructure 层依赖 Domain 层（实现 Gateway）
-- Adapter 层依赖 Application 层
-- Bootstrap 层依赖所有层
+异常：
 
-## 4. 调用链路
-
-```
-Controller -> Service -> Gateway -> Repository -> Database
-     ↓         ↓         ↓          ↓
-   DTO/VO <- DTO/VO <- Domain <- PO
+```text
+Domain Error -> Application propagation/translation -> Web Exception Translator
+  -> HTTP status + stable error code + sanitized public message
 ```
 
-## 5. 命名规范
-
-| 类型       | 后缀        | 说明                   | 示例            |
-| ---------- | ----------- | ---------------------- | --------------- |
-| 持久化对象 | PO          | Persistent Object      | UserPO          |
-| 值对象     | VO          | Value Object           | UserVO          |
-| 命令对象   | Cmd         | Command                | UserAddCmd      |
-| 查询对象   | Query       | Query                  | UserPageQuery   |
-| 网关接口   | Gateway     | Gateway                | UserGateway     |
-| 服务接口   | Service     | Service                | UserService     |
-| 服务实现   | ServiceImpl | Service Implementation | UserServiceImpl |
-| 控制器     | Controller  | Controller             | UserController  |
-| 仓储接口   | Repository  | Repository             | UserRepository  |
-
-## 6. 最佳实践
-
-### 6.1 CQRS 模式
-
-- 简单查询可以直接调用 Gateway
-- 复杂业务逻辑通过 Service 编排
-
-### 6.2 事务管理
-
-- 事务边界在 Application 层
-- 使用 `@Transactional(rollbackFor = Exception.class)`
-
-### 6.3 异常处理
-
-- 业务异常抛出 `BizException`
-- 系统异常由全局异常处理器捕获
+## 4. 生成与演进
 
-### 6.4 日志规范
+- Scaffold 只生成机械模块、POM、Wrapper、配置、架构规则和 Manifest，不生成生产业务 CRUD。
+- 初始生成器为 `initialize-only`，非空目标失败。
+- Manifest v2 记录模板/合同/downstream skill digest 与 generator-owned 文件 hash。
+- 当前不支持模板升级，不得重跑初始生成器覆盖业务工程。未来如需支持同一 Target Profile 内的模板版本升级，必须另行设计、批准并验证。
 
-- 使用 SLF4J + Logback
-- 关键业务节点记录日志
-- 日志级别：DEBUG、INFO、WARN、ERROR
+## 5. 完成等级
 
-## 7. 参考资料
+- `generated`：文件已原子生成，尚未完成 Wrapper 验证。
+- `empty-scaffold-verified`：根目录 `./mvnw validate/test/package` 全部通过。
+- `first-slice-verified`：golden first slice 的 Domain、Application、Repository/MyBatis、DTO/Web、Exception、Wire 与架构负例全部通过。
 
-- [YSS 后端开发规范](./yss-backend-scaffold-parent/SKILL.md)
-- [Domain 层开发指南](./yss-backend-scaffold-domain/SKILL.md) → `yss-domain`
-- [Application 层开发指南](./yss-backend-scaffold-application/SKILL.md) → `yss-application`
-- [Infrastructure 层开发指南](./yss-backend-scaffold-infrastructure/SKILL.md) → `yss-repository`
-- [Web Adapter 开发指南](./yss-backend-scaffold-web/SKILL.md) → `yss-web-controller`
+只有最后一级可以声明已满足下游 YSS skills 的首切片就绪条件。