create-yss-spec 1.0.0

package/template/.codex/skills/yss-ddd-scaffold-generator/references/yss-backend-scaffold-application/SKILL.md

@@ -0,0 +1,127 @@
+---
+name: yss-backend-scaffold-application
+description: YSS 管理服务应用层开发框架和技术指南。在实现应用服务、用例协调或 DTO 转换时需要用到。
+---
+
+# Application 层开发规范 (Application Layer Development Guide)
+
+本 Skill 提供了 YSS 数据质量管理服务 **Application (应用层)** 的开发规范。Application 层负责协调领域对象完成业务用例，是连接 Adapter 层和 Domain 层的桥梁。
+
+## 1. 核心职责 (Core Responsibilities)
+
+- **业务用例编排 (Use Case Orchestration)**: 协调 Domain Service 和 Gateway 完成复杂的业务流程。
+- **服务接口实现 (Service Implementation)**: 实现 Application Service 接口，对外提供业务能力。
+- **DTO 转换 (DTO Conversion)**: 负责将 Domain 对象转换为 Adapter 层所需的 DTO/VO。
+- **事务控制 (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 应用服务实现 (ServiceImpl)
+
+- **位置**: `com.yss.{module}.core.service.impl`。
+- **注解**: `@Service`，通常配合 `@RequiredArgsConstructor` 进行构造器注入。
+- **事务**: 在写操作方法上添加 `@Transactional` 注解。
+- **逻辑**: 主要负责调用 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 异常处理
+
+- **业务异常**: 抛出 `BizException` 或其子类。
+- **系统异常**: 抛出 `RuntimeException`，由全局异常处理器捕获。
+
+## 4. 详细案例 (Detailed Examples)
+
+### 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: {}", cmd.getTemplateName());
+        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.  **事务边界**: Application Service 方法通常是一个事务的边界。
+4.  **日志记录**: 在关键业务节点记录日志，便于问题排查。

package/template/.codex/skills/yss-ddd-scaffold-generator/references/yss-backend-scaffold-application/agents/openai.yaml

@@ -0,0 +1,5 @@
+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/.codex/skills/yss-ddd-scaffold-generator/references/yss-backend-scaffold-domain/SKILL.md

@@ -0,0 +1,269 @@
+---
+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 `@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 `@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**: `@Data`, `@Builder`, `@NoArgsConstructor`, `@AllArgsConstructor`
+
+## 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.Data;
+
+import javax.validation.constraints.NotBlank;
+import javax.validation.constraints.NotEmpty;
+import javax.validation.constraints.NotNull;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 数据质量规则模板新增命令对象
+ */
+@Data
+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.Data;
+
+import javax.validation.constraints.NotNull;
+
+/**
+ * 数据质量规则模板查询对象
+ */
+@Data
+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.Data;
+import java.io.Serializable;
+import java.util.Map;
+
+/**
+ * 数据质量规则模板值对象
+ */
+@Data
+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` 校验。

package/template/.codex/skills/yss-ddd-scaffold-generator/references/yss-backend-scaffold-domain/agents/openai.yaml

@@ -0,0 +1,5 @@
+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/.codex/skills/yss-ddd-scaffold-generator/references/yss-backend-scaffold-infrastructure/SKILL.md

@@ -0,0 +1,191 @@
+---
+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")`: 指定字段映射。
+  - `@Data`, `@EqualsAndHashCode(callSuper = true)`: Lombok 注解。
+
+### 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.Data;
+import lombok.EqualsAndHashCode;
+
+@Data
+@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。

package/template/.codex/skills/yss-ddd-scaffold-generator/references/yss-backend-scaffold-infrastructure/agents/openai.yaml

@@ -0,0 +1,5 @@
+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."