create-yss-spec 2.1.10 → 2.1.11

package/template/.qoder/skills/yss-backend-scaffold-application/SKILL.md

@@ -1,139 +0,0 @@
----
-name: yss-backend-scaffold-application
-description: Use when implementing YSS application use cases, transaction boundaries, cross-aggregate orchestration, idempotency, or application-level DTO conversion.
----
-
-# Application 层开发规范 (Application Layer Development Guide)
-
-本 Skill 约束 Application 层的用例边界。它是目标 DDD 架构规则，不等同于现有 YSS 组件仓库中所有 `core/service` 的历史实现；先探测工程布局并记录兼容 profile。
-
-## 1. 核心职责 (Core Responsibilities)
-
-- **业务用例编排 (Use Case Orchestration)**: 协调 Domain Service 和 Gateway 完成复杂的业务流程。
-- **服务接口实现 (Service Implementation)**: 实现 Application Service 接口，对外提供业务能力。
-- **DTO 转换 (DTO Conversion)**: 只在合同指定时负责 Domain/Application model 与 client/web DTO/VO 的转换；不得把 Repository PO 带入 Application。
-- **事务控制 (Transaction Management)**: 在应用层进行 `@Transactional` 事务管理。
-
-## 2. 代码结构 (Code Structure)
-
-```
-com.yss.{module}.core
-├── service                 # 应用服务接口
-│   ├── impl                # 应用服务实现
-│   └── convertor           # MapStruct 转换器 (App 层专用)
-├── component               # 业务组件 (Exporter, Handler)
-└── job                     # 任务执行逻辑 (Runner, Func)
-```
-
-## 3. 开发规范 (Development Guidelines)
-
-### 3.1 应用服务实现 (AppServiceImpl)
-
-- **位置**: 新 DDD 工程优先 `application/.../service/impl`；legacy profile 才使用 `core/service/impl`。
-- **注解**: `@Service`，通常配合 `@RequiredArgsConstructor` 进行构造器注入。
-- **事务**: 只在已确认的用例边界添加 `@Transactional(rollbackFor = Exception.class)`；读用例明确 `readOnly` 与总数策略。
-- **逻辑**: 主要负责调用 Domain Service 或 Gateway，**不应包含核心领域逻辑**（应下沉到 Domain 层）。
-
-### 3.2 对象转换 (Convertor)
-
-- **工具**: MapStruct。
-- **位置**: `com.yss.{module}.core.service.convertor`。
-- **职责**: 将 `Domain Object` (VO/Entity) 转换为 `Application VO` 或 `Client VO`。
-- **规范**: 定义 `INSTANCE` 常量，使用 `Mappers.getMapper(...)` 获取实例。
-
-### 3.3 异常处理
-
-- **业务异常**: 使用 `ExceptionFactory.bizException(...)` 或项目已批准的 `BizException` 错误码。
-- **已知系统异常**: 使用 `ExceptionFactory.sysException(...)` 并保留 cause；未知异常交由全局处理器兜底，不在 Application 吞并或改写。
-
-## 4. Legacy 参考形状（不可复制）
-
-以下 `QualityTemplate*` 代码只是说明 legacy `core/service` 形状的占位示例，不是当前参考源码中已验证存在的通用模块，也不定义新模块的包名、接口或返回模型。新 DDD profile 必须由批准合同生成中性 Application 接口，不能复制这些名称或 DTO/VO Gateway 泄漏。
-
-### 4.1 Application Service Implementation
-
-```java
-package com.yss.quality.core.service.impl;
-
-import com.yss.cloud.dto.result.PageResult;
-import com.yss.quality.client.dto.cmd.QualityTemplateAddCmd;
-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.domain.template.service.QualityTemplateService;
-import lombok.RequiredArgsConstructor;
-import lombok.extern.slf4j.Slf4j;
-import org.springframework.stereotype.Service;
-import org.springframework.transaction.annotation.Transactional;
-
-import java.util.List;
-
-/**
- * 数据质量规则模板应用服务实现类
- */
-@Service
-@RequiredArgsConstructor
-@Slf4j
-public class QualityTemplateServiceImpl implements QualityTemplateService {
-
-    private final QualityTemplateGateway qualityTemplateGateway;
-
-    @Override
-    public PageResult<QualityTemplateVO> pageQualityTemplate(QualityTemplatePage query) {
-        // 直接调用 Domain Gateway
-        return qualityTemplateGateway.pageQualityTemplate(query);
-    }
-
-    @Override
-    @Transactional(rollbackFor = Exception.class)
-    public Long addQualityTemplate(QualityTemplateAddCmd cmd) {
-        // 可以在此进行简单的应用层校验或编排
-        log.info("Adding quality template");
-        return qualityTemplateGateway.addQualityTemplate(cmd);
-    }
-}
-```
-
-### 4.2 Convertor (MapStruct)
-
-```java
-package com.yss.quality.core.service.convertor;
-
-import com.yss.quality.client.vo.QualityTechTemplateVO;
-import com.yss.quality.client.vo.QualityTemplateVO;
-import com.yss.quality.params.base.PluginParams;
-import org.mapstruct.Mapper;
-import org.mapstruct.NullValueCheckStrategy;
-import org.mapstruct.NullValuePropertyMappingStrategy;
-import org.mapstruct.factory.Mappers;
-
-import java.util.List;
-
-@Mapper(
-    nullValuePropertyMappingStrategy = NullValuePropertyMappingStrategy.IGNORE,
-    nullValueCheckStrategy = NullValueCheckStrategy.ALWAYS
-)
-public interface QualityTechTemplateConvertor {
-    QualityTechTemplateConvertor INSTANCE = Mappers.getMapper(QualityTechTemplateConvertor.class);
-
-    // 将 Domain VO 和 PluginParams 组合转换为 TechTemplateVO
-    QualityTechTemplateVO useQualityTechTemplateVO(QualityTemplateVO qualityTemplateVO, List<PluginParams> pluginParams);
-}
-```
-
-## 5. 注意事项 (Notes)
-
-1.  **职责分离**: Application 层关注“做什么”（流程编排），Domain 层关注“怎么做”（业务规则）。
-2.  **依赖方向**: Application 层依赖 Domain 层，不应依赖 Adapter 层（Web/Job）。
-3.  **事务边界**: 一个用例一个边界；跨聚合写入、幂等键、事件发布时点必须写入合同并用 `behavior-tdd` 验证。
-4.  **上下文能力**: 当前用户、审计、普通技术日志、校验和异常是条件依赖，按 `yss-router` 影响闭包加载，不在 AppService 内手工解析 Header/JWT。
-
-## 6. 架构探测门禁
-
-先确认工程是新 DDD `application/domain/infrastructure/adapter`，还是 legacy `core/client/repository`。没有 `backend_repository`、Maven Wrapper 和已批准合同版本时输出 `blocked`；不得用示例包名推断真实接口。
-
-## 7. 阶段 7 合同
-
-- 明确当前 Use Case、Application 边界、事务边界、跨聚合协调和异常映射，只消费批准后的合同版本。
-- AppService 骨架可受控生成；用例编排、事务、幂等、权限和失败行为必须使用 `behavior-tdd`。
-- 返回统一 `YSS Skill Execution Result`，证据至少包含 Application 代码、测试、MapStruct/Lombok 条件和实际 `./mvnw ...` 结果。

package/template/.qoder/skills/yss-backend-scaffold-application/agents/openai.yaml

@@ -1,5 +0,0 @@
-version: 1
-interface:
-  display_name: "YSS Scaffold Application"
-  short_description: "YSS 后端脚手架应用层、用例编排与 DTO 规范"
-  default_prompt: "Use $yss-backend-scaffold-application to implement the application layer for a YSS backend scaffold module."

package/template/.qoder/skills/yss-backend-scaffold-domain/SKILL.md

@@ -1,281 +0,0 @@
----
-name: "yss-backend-scaffold-domain"
-description: "YSS 管理服务领域层的脚手架和最佳实践。在实现业务逻辑、定义数据网关或创建领域模型时调用。"
----
-
-# Domain 层开发规范 (Domain Layer Development Guide)
-
-本 Skill 提供了 YSS 数据质量管理服务 **Domain (领域层)** 的开发规范。Domain 层是系统的核心，包含业务逻辑、领域模型和接口定义。
-
-## 1. 核心职责 (Core Responsibilities)
-
-- **定义业务模型 (Model)**: 包含实体 (Entity)、值对象 (VO)、聚合根 (Aggregate Root)。
-- **定义服务接口 (Gateway/Service)**: 定义与 Infrastructure 层交互的接口 (Gateway) 以及领域内部服务 (Domain Service)。
-- **定义数据契约 (DTO)**: 定义 Command (增删改), Query (查询), VO (视图) 等数据传输对象。
-- **业务逻辑实现**: 核心业务规则的校验和处理。
-
-## 2. 代码结构 (Code Structure)
-
-```
-com.yss.{module}
-├── client                  # 对外暴露的数据契约 (DTOs)
-│   ├── dto
-│   │   ├── cmd             # Command: 写操作参数 (e.g., QualityRuleAddCmd)
-│   │   └── query           # Query: 读操作参数 (e.g., QualityRulePage)
-│   └── vo                  # Value Object: 返回结果 (e.g., QualityBusinessRuleVO)
-└── domain                  # 领域核心实现
-    └── {domain_name}       # 具体的领域模块 (e.g., user, metadata)
-        ├── gateway         # 网关接口定义 (e.g., UserGateway)
-        ├── model           # 领域实体/枚举 (e.g., User, UserType)
-        └── service         # 领域服务 (e.g., UserService)
-```
-
-## 3. 开发规范 (Development Guidelines)
-
-### 3.1 数据传输对象 (DTO)
-
-- **Command (Cmd)**: 用于数据修改 (Create/Update/Delete)。
-  - 继承 `com.yss.cloud.dto.CommandDTO`。
-  - 按 `lombok` skill 选择 `@Getter` / `@Setter` / 构造器等最小注解；不默认使用 `@Data`。
-  - 必须使用 JSR-303/380 注解进行参数校验 (`@NotBlank`, `@NotNull`, `@Size` 等)。
-  - **示例**: `QualityRuleAddCmd`
-
-- **Query**: 用于数据查询。
-  - 分页查询继承 `com.yss.cloud.dto.page.PageQuery`。
-  - 普通查询继承 `com.yss.cloud.dto.QueryDTO`。
-  - **示例**: `QualityRulePage`
-
-- **View Object (VO)**: 用于展示层返回数据。
-  - 纯 POJO 仍按 `lombok` skill 选择最小注解；涉及身份、关系、敏感字段或懒加载时不得默认使用 `@Data`。
-  - **示例**: `QualityBusinessRuleVO`
-
-### 3.2 网关接口 (Gateway)
-
-Gateway 定义了领域层对外的依赖接口，通常由 Infrastructure 层实现。
-
-- **命名**: `DomainName` + `Gateway` (e.g., `QualityTemplateGateway`)。
-- **方法定义规范**:
-  - **分页查询**: `PageResult<VO> pageXxx(Query query)`
-  - **列表查询**: `List<VO> listXxx(Query query)`
-  - **单条查询**: `VO getXxxById(Long id)` 或 `VO getXxxByCode(String code)`
-  - **新增**: `Long/ResultVO addXxx(Cmd cmd)` (返回 ID 或 结果对象)
-  - **更新**: `void/ResultVO updateXxx(Cmd cmd)`
-  - **删除**: `void deleteXxx(Cmd cmd)`
-
-### 3.3 领域服务 (Domain Service)
-
-当业务逻辑涉及多个聚合根或不适合放入单一实体时，使用 Domain Service。
-
-- **命名**: `DomainName` + `Service` (e.g., `QualityTemplateService`)。
-- **职责**: 编排领域逻辑，调用 Gateway。
-
-### 3.4 常用类与注解
-
-- **分页结果**: `com.yss.cloud.dto.result.PageResult<T>`
-- **校验注解**: `javax.validation.constraints.*` (`@NotNull`, `@NotBlank`)
-- **Lombok**: 按对象语义选择 `@Getter`, `@Setter`, `@Builder`, `@NoArgsConstructor`, `@AllArgsConstructor`，不默认使用聚合式 `@Data`。
-
-## 4. 详细案例 (Detailed Examples)
-
-### 4.1 Command (新增命令)
-
-```java
-package com.yss.quality.client.dto.cmd;
-
-import com.yss.cloud.dto.CommandDTO;
-import com.yss.quality.domain.QualityRuleTemplateType;
-import com.yss.quality.domain.QualityType;
-import com.yss.quality.domain.datasource.entity.DatabaseType;
-import com.yss.quality.domain.rule.entity.QualityRuleType;
-import lombok.Getter;
-import lombok.Setter;
-
-import javax.validation.constraints.NotBlank;
-import javax.validation.constraints.NotEmpty;
-import javax.validation.constraints.NotNull;
-import java.util.List;
-import java.util.Map;
-
-/**
- * 数据质量规则模板新增命令对象
- */
-@Getter
-@Setter
-public class QualityTemplateAddCmd extends CommandDTO {
-
-    @NotBlank(message = "模板名称不能为空")
-    private String templateName;
-
-    @NotBlank(message = "模板编码不能为空")
-    private String templateCode;
-
-    @NotEmpty(message = "数据库类型不能为空")
-    private List<DatabaseType> databaseType;
-
-    @NotNull(message = "模板类型不能为空")
-    private QualityRuleTemplateType templateType;
-
-    @NotNull(message = "模板规则类型不能为空")
-    private QualityType ruleType;
-
-    private String description;
-
-    @NotBlank(message = "异常SQL不能为空")
-    private String exceptionCountSql;
-
-    @NotNull
-    private String resultLabel;
-
-    private Boolean defaultFlag;
-
-    Map<String, Object> ruleTemplateParam;
-}
-```
-
-### 4.2 Query (分页查询)
-
-```java
-package com.yss.quality.client.dto.query;
-
-import com.yss.cloud.dto.page.PageQuery;
-import com.yss.quality.domain.QualityRuleTemplateType;
-import com.yss.quality.domain.QualityType;
-import lombok.Getter;
-import lombok.Setter;
-
-import javax.validation.constraints.NotNull;
-
-/**
- * 数据质量规则模板查询对象
- */
-@Getter
-@Setter
-public class QualityTemplatePage extends PageQuery {
-    /**
-     * 模板类型
-     */
-    private QualityRuleTemplateType templateType;
-
-    /**
-     * 规则类型
-     */
-    @NotNull
-    private QualityType ruleType;
-
-    /**
-     * 模板名称
-     */
-    private String templateName;
-
-    private Integer status;
-}
-```
-
-### 4.3 Gateway (网关接口)
-
-```java
-package com.yss.quality.domain.template.gateway;
-
-import com.yss.cloud.dto.result.PageResult;
-import com.yss.quality.client.dto.cmd.QualityTemplateAddCmd;
-import com.yss.quality.client.dto.cmd.QualityTemplateDeleteCmd;
-import com.yss.quality.client.dto.cmd.QualityTemplateUpdateCmd;
-import com.yss.quality.client.dto.query.QualityTemplatePage;
-import com.yss.quality.client.vo.QualityTemplateVO;
-
-/**
- * 数据质量规则模板网关接口
- */
-public interface QualityTemplateGateway {
-
-    /**
-     * 分页查询数据质量规则模板
-     */
-    PageResult<QualityTemplateVO> pageQualityTemplate(QualityTemplatePage query);
-
-    /**
-     * 根据ID查询数据质量规则模板
-     */
-    QualityTemplateVO getQualityTemplateById(Long id);
-
-    /**
-     * 新增数据质量规则模板
-     */
-    Long addQualityTemplate(QualityTemplateAddCmd cmd);
-
-    /**
-     * 更新数据质量规则模板
-     */
-    void updateQualityTemplate(QualityTemplateUpdateCmd cmd);
-
-    /**
-     * 删除数据质量规则模板
-     */
-    void deleteQualityTemplate(QualityTemplateDeleteCmd cmd);
-}
-```
-
-### 4.4 Domain Service (领域服务)
-
-```java
-package com.yss.quality.domain.template.service;
-
-import com.yss.cloud.dto.result.PageResult;
-import com.yss.quality.client.dto.cmd.QualityTemplateAddCmd;
-import com.yss.quality.client.dto.query.QualityTemplatePage;
-import com.yss.quality.client.vo.QualityTemplateVO;
-
-/**
- * 数据质量规则模板服务接口
- */
-public interface QualityTemplateService {
-
-    PageResult<QualityTemplateVO> pageQualityTemplate(QualityTemplatePage query);
-
-    QualityTemplateVO getQualityTemplateById(Long id);
-
-    Long addQualityTemplate(QualityTemplateAddCmd cmd);
-
-    // 更多业务方法...
-}
-```
-
-### 4.5 Value Object (视图对象)
-
-```java
-package com.yss.quality.client.vo;
-
-import lombok.Getter;
-import lombok.Setter;
-import java.io.Serializable;
-import java.util.Map;
-
-/**
- * 数据质量规则模板值对象
- */
-@Getter
-@Setter
-public class QualityTemplateVO implements Serializable {
-    private Long id;
-    private String templateName;
-    private String templateCode;
-    private String resultLabel;
-    private String databaseType;
-    private String qualityRuleType;
-    private String qualityType;
-    private Map<String,Object> ruleTemplateParam;
-    private Boolean defaultFlag;
-}
-```
-
-## 5. 注意事项 (Notes)
-
-1.  **依赖倒置**: Domain 层**不应依赖** Infrastructure 层或 Web 层。所有外部交互通过 Gateway 接口定义。
-2.  **贫血模型 vs 充血模型**: 虽然目前主要是贫血模型 (DTO/VO)，但鼓励将核心业务逻辑下沉到 Domain Model 中。
-3.  **参数校验**: 必须在 Cmd 对象中使用注解进行严格的参数校验，Gateway 实现层应进行 `@Valid` 校验。
-
-## 6. 阶段 7 合同
-
-- 领域规则、状态机和不变量必须使用 `behavior-tdd`；只允许 DTO/VO/接口等机械骨架使用受控生成。
-- 消费批准后的合同和 work unit，写入允许路径，并返回统一 `YSS Skill Execution Result`。
-- 发现新的状态机、权限、数据模型、API 或跨上下文影响时返回 `new_impacts` 并暂停。

package/template/.qoder/skills/yss-backend-scaffold-domain/agents/openai.yaml

@@ -1,5 +0,0 @@
-version: 1
-interface:
-  display_name: "YSS Scaffold Domain"
-  short_description: "YSS 后端脚手架领域层、聚合与规则建模实践落地规范"
-  default_prompt: "Use $yss-backend-scaffold-domain to implement the domain layer for a YSS backend scaffold module."

package/template/.qoder/skills/yss-backend-scaffold-infrastructure/SKILL.md

@@ -1,199 +0,0 @@
----
-name: "yss-backend-scaffold-infrastructure"
-description: "YSS 服务的基础设施层开发框架和技术指南。在实现数据访问层、数据库实体、外部服务适配器时需要用到。"
----
-
-# Infrastructure 层开发规范 (Infrastructure Layer Development Guide)
-
-本 Skill 提供了 YSS **Infrastructure (基础设施层)** 的通用开发规范。Infrastructure 层负责实现 Domain 层定义的网关接口，处理数据持久化、外部服务调用和配置管理。
-
-## 1. 核心职责 (Core Responsibilities)
-
-- **实现网关接口 (Gateway Implementation)**: 实现 Domain 层定义的 `Gateway` 接口。
-- **数据持久化 (Persistence)**: 定义 `Repository` 接口和 `PO` (Persistent Object) 实体，操作数据库。
-- **对象转换 (Conversion)**: 使用 MapStruct 实现 PO 与 Domain Model/DTO 之间的转换。
-- **外部适配 (External Adapters)**: 集成外部服务 (如文件存储、消息队列)。
-
-## 2. 代码结构 (Code Structure)
-
-```
-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(...)`。
-
-### 3.4 对象转换 (Convertor)
-
-- **工具**: MapStruct。
-- **位置**: `com.yss.{module}.repository.convertor`。
-- **命名**: `DomainName` + `Convertor` (e.g., `QualityTemplateConvertor`)。
-- **规范**: 定义 `INSTANCE` 常量，使用 `Mappers.getMapper(...)` 获取实例。
-
-## 4. 详细案例 (Detailed Examples)
-
-### 4.1 Persistent Object (PO)
-
-```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;
-
-    @TableField("template_code")
-    private String templateCode;
-
-    @TableField("status")
-    private Integer status;
-}
-```
-
-### 4.2 Repository Interface
-
-```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.3 Gateway Implementation
-
-```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;
-
-    @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()
-        );
-    }
-}
-```
-
-### 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;
-
-import java.util.List;
-
-@Mapper
-public interface QualityTemplateConvertor {
-    QualityTemplateConvertor INSTANCE = Mappers.getMapper(QualityTemplateConvertor.class);
-
-    QualityTemplateVO toQualityTemplateVO(QualityTemplatePO po);
-
-    List<QualityTemplateVO> toQualityTemplateVOList(List<QualityTemplatePO> pos);
-}
-```
-
-## 5. 注意事项 (Notes)
-
-1.  **AuditableEntity**: 推荐业务 PO 继承此基类，以便自动维护审计信息。
-2.  **Lombok 使用**: 使用 `@RequiredArgsConstructor` 进行构造器注入是推荐的最佳实践。
-3.  **Wrapper 使用**: 优先使用 `Wrappers.lambdaQuery()` 而不是字符串列名，以提高重构安全性。
-4.  **分页工具**: 使用 `PageUtil` 统一处理分页参数，避免手动计算 offset。
-
-## 6. 阶段 7 合同
-
-- 前置条件是批准的数据架构、Repository 策略和 Slice Contract。
-- PO/Repository/Convertor 骨架可受控生成；复杂查询、分页语义、数据源、事务、迁移和并发使用 `behavior-tdd`。
-- 返回统一 `YSS Skill Execution Result`，证据包含实际文件、集成测试、MapStruct/Lombok 配置和 `./mvnw ...` 结果。

package/template/.qoder/skills/yss-backend-scaffold-infrastructure/agents/openai.yaml

@@ -1,5 +0,0 @@
-version: 1
-interface:
-  display_name: "YSS Scaffold Infrastructure"
-  short_description: "YSS 后端脚手架基础设施层与持久化实现设计落地规范"
-  default_prompt: "Use $yss-backend-scaffold-infrastructure to implement the infrastructure layer for a YSS backend scaffold module."