create-yss-spec 2.1.9 → 2.1.11

package/template/.pi/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/.pi/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/.pi/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/.pi/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."

package/template/.pi/skills/yss-backend-scaffold-web/SKILL.md

@@ -1,175 +0,0 @@
----
-name: "yss-backend-scaffold-web"
-description: "YSS 管理服务的 Web Adapter 开发框架和技术指南。在实现 REST API 控制器、请求处理和响应格式化时需要用到。"
----
-
-# Web Adapter Layer Development Guide
-
-本技能为开发 YSS 服务的**Web 适配器层**（REST API）提供指导和框架。
-Web 适配器负责通过 HTTP 公开业务功能、处理输入验证和格式化响应。
-
-## 1. 核心职责 (Core Responsibilities)
-
-- **Request Handling**: Map HTTP requests (GET, POST, PUT, DELETE) to Java methods.
-- **Input Validation**: Validate request bodies and parameters using JSR-303/380 annotations (`@Valid`, `@NotNull`, etc.).
-- **Response Formatting**: Wrap business results into standard `Result` objects (`SingleResult`, `PageResult`, `MultiResult`).
-- **Orchestration Delegation**: Delegate business logic to the **Application Service**. Simple queries can be delegated directly to the **Domain Gateway** (CQRS pattern).
-
-## 2. 代码结构 (Code Structure)
-
-Web Adapters are typically located in the `bootstrap` module or a dedicated `web` module.
-
-```
-com.yss.{module}.rest
-├── {Domain}Controller.java      # Main REST Controller
-└── {Domain}ReportController.java # Optional: For reporting/stats APIs
-```
-
-## 3. 开发规范 (Development Guidelines)
-
-### 3.1 Controller 定义
-
-- **注解**: 使用 `@RestController`。
-- **路径**: `@RequestMapping("/api/{module}/{domain}")` (e.g., `/api/quality/rule`).
-- **依赖注入**: 使用 Lombok `@RequiredArgsConstructor` 进行构造器注入。
-- **命名**: `{Domain}Controller` (e.g., `QualityRuleController`).
-
-### 3.2 依赖注入原则
-
-- **写操作/复杂逻辑**: 必须注入 **Application Service** (`XxxService`)。
-- **读操作 (Query)**: 允许直接注入 **Domain Gateway** (`XxxGateway`) 以减少样板代码 (CQRS)。
-
-### 3.3 参数与响应
-
-- **Command (写)**: 使用 `@PostMapping`/`@PutMapping` + `@RequestBody` + `{Domain}Cmd` 对象。
-- **Query (读)**: 使用 `@PostMapping` (for complex search) + `@RequestBody` + `{Domain}Page/Query` 对象。
-- **Wrapper**:
-  - `SingleResult<T>`: 单个对象或基本类型。
-  - `MultiResult<T>`: 列表。
-  - `PageResult<T>`: 分页数据。
-- **Validation**: 必须在参数前添加 `@Valid` 注解。
-
-### 3.4 异常处理
-
-- **不要**在 Controller 中捕获通用异常 (`Exception`)。
-- 让全局异常处理器 (`GlobalExceptionHandler`) 统一处理运行时异常。
-- 仅在需要特定 HTTP 状态码转换时捕获特定异常。
-
-## 4. 代码示例 (Code Examples)
-
-### 4.1 标准 CRUD Controller
-
-```java
-package com.yss.{module}.rest;
-
-import com.yss.cloud.dto.result.MultiResult;
-import com.yss.cloud.dto.result.PageResult;
-import com.yss.cloud.dto.result.SingleResult;
-import com.yss.{module}.client.dto.cmd.{Domain}AddCmd;
-import com.yss.{module}.client.dto.cmd.{Domain}UpdateCmd;
-import com.yss.{module}.client.dto.cmd.{Domain}StatusCmd;
-import com.yss.{module}.client.dto.query.{Domain}Page;
-import com.yss.{module}.client.vo.{Domain}VO;
-import com.yss.{module}.core.service.{Domain}Service;
-// Optional: Import Gateway for direct queries
-// import com.yss.{module}.domain.gateway.{Domain}Gateway;
-import lombok.RequiredArgsConstructor;
-import org.springframework.web.bind.annotation.*;
-
-import javax.validation.Valid;
-
-/**
- * {Domain} 管理控制器
- *
- * @author {User}
- */
-@RestController
-@RequestMapping("/api/{module}/{domain-path}")
-@RequiredArgsConstructor
-public class {Domain}Controller {
-
-    private final {Domain}Service {domainVar}Service;
-    // private final {Domain}Gateway {domainVar}Gateway; // For CQRS if needed
-
-    /**
-     * 分页查询 {Domain}
-     *
-     * @param query 查询条件
-     * @return 分页结果
-     */
-    @PostMapping("/page")
-    public PageResult<{Domain}VO> page(@Valid @RequestBody {Domain}Page query) {
-        return {domainVar}Service.page(query);
-    }
-
-    /**
-     * 根据ID查询详情
-     *
-     * @param id 主键ID
-     * @return 详情对象
-     */
-    @GetMapping("/detail/{id}")
-    public SingleResult<{Domain}VO> detail(@PathVariable String id) {
-        return SingleResult.of({domainVar}Service.detail(id));
-    }
-
-    /**
-     * 新增 {Domain}
-     *
-     * @param cmd 新增命令
-     * @return 新增结果 (通常是ID或完整对象)
-     */
-    @PostMapping
-    public SingleResult<Long> add(@Valid @RequestBody {Domain}AddCmd cmd) {
-        return SingleResult.of({domainVar}Service.add(cmd));
-    }
-
-    /**
-     * 更新 {Domain}
-     *
-     * @param cmd 更新命令
-     * @return 更新结果
-     */
-    @PutMapping
-    public SingleResult<Boolean> update(@Valid @RequestBody {Domain}UpdateCmd cmd) {
-        {domainVar}Service.update(cmd);
-        return SingleResult.of(true);
-    }
-
-    /**
-     * 状态变更 (启用/禁用)
-     *
-     * @param cmd 状态命令
-     * @return 变更后的状态
-     */
-    @PostMapping("/enabled")
-    public SingleResult<Integer> switchStatus(@Valid @RequestBody {Domain}StatusCmd cmd) {
-        {domainVar}Service.switchStatus(cmd);
-        return SingleResult.of(cmd.getStatus());
-    }
-}
-```
-
-### 4.2 复杂业务操作示例
-
-```java
-    /**
-     * 执行业务操作 (e.g. 立即运行检查)
-     *
-     * @param cmd 执行命令
-     * @return 执行结果ID
-     */
-    @PostMapping("/execute")
-    public SingleResult<String> execute(@Valid @RequestBody {Domain}ExecuteCmd cmd) {
-        // 调用 Service 处理复杂业务逻辑
-        return SingleResult.of(
-                {domainVar}Service.execute(cmd)
-        );
-    }
-```
-
-## 5. 阶段 7 合同
-
-- 只消费冻结 OpenAPI/no-impact record 和批准合同；Controller 不得穿透 Application/Domain 边界。
-- Controller/DTO/Convertor 骨架可受控生成；权限、校验、错误映射和接口行为使用 `behavior-tdd`。
-- 返回统一 `YSS Skill Execution Result`，包含代码、契约/API 测试、实际验证和新增 API/权限影响。

package/template/.pi/skills/yss-backend-scaffold-web/agents/openai.yaml

@@ -1,5 +0,0 @@
-version: 1
-interface:
-  display_name: "YSS Scaffold Web"
-  short_description: "YSS 后端脚手架 Web 层、DTO 与控制器规范"
-  default_prompt: "Use $yss-backend-scaffold-web to implement the web adapter layer for a YSS backend scaffold module."