create-yss-spec 2.1.10 → 2.1.11

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

package/template/.qoder/skills/yss-dictionary/SKILL.md

@@ -1,49 +0,0 @@
----
-name: yss-dictionary
-description: Use when 用于 YSS 字典组件接入、字典缓存、字典管理接口、字典 Feign 客户端和 EnableDicManage 排障。当用户提到字典、Dic、DicCache、YssDicFeign、EnableDicManage、字典导入模板或字典不刷新时调用。
----
-
-# yss-dictionary
-
-Use this skill for YSS 字典组件. Keep implementation grounded in the local project and resolvable YSS backend component source.
-
-中文说明：本技能用于 YSS 字典组件。执行时优先读取源码索引，避免凭记忆猜类名、配置项或接入方式。
-
-## Source Index First
-
-- Backend source location is environment-specific; resolve it with `yss-source-index/references/source-location.md`.
-- Generated index: `references/source-index.md`
-- Component path hints: `yss-microservice-components/yss-component-dictionary-parent`
-
-Read `references/source-index.md` as a path-hint index whenever the task depends on exact modules, annotations, auto configuration, properties, controllers, clients, repositories, DTOs, handlers, or troubleshooting.
-
-## Workflow
-
-1. Identify whether the task is dictionary management, query/cache usage, Feign client integration, import/export template, or cache refresh troubleshooting.
-2. Read `references/source-index.md`, then inspect the matching module: dictionary, client, feign, or starter.
-3. For management endpoints, start with `DicController`, `DicQueryController`, `DicService`, and repositories.
-4. For consumers, prefer `YssDicFeign`, `DicCacheHolder`, and `DicCacheAutoConfiguration` instead of duplicating dictionary queries.
-5. For service-side enablement, check `EnableDicManage`, `EnableDicManageImportSelector`, and `DefaultDicConfiguration`.
-6. For import/export tasks, inspect `DicExcelTemplate` and `DicExcelImportTemplate`.
-
-## Capability Split
-
-- `yss-component-dictionary`: controllers, services, gateways, repositories, entities.
-- `yss-component-dictionary-client`: command/query DTOs and VO contracts.
-- `yss-component-dictionary-feign`: Feign client, cache holder, cache scheduler, service-name properties.
-- `yss-component-dictionary-starter`: `EnableDicManage` and default configuration.
-
-## Checklist
-
-- Required dependency or starter module is present.
-- Management service has `EnableDicManage` where required.
-- Consumer service points to the correct dictionary service name.
-- Cache refresh/scheduler behavior is checked when values are stale.
-- DTO/VO contracts from client module are reused.
-- Import/export template changes preserve existing Excel field mapping.
-
-## Do Not
-
-- Do not invent class names or configuration keys without checking the source index.
-- Do not replace component extension points with business-local framework code.
-- Do not broaden the task into unrelated YSS components unless the user asks.

package/template/.qoder/skills/yss-dictionary/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "yss-dictionary"
-  short_description: "YSS component skill for yss-dictionary"
-  default_prompt: "Use yss-dictionary for this YSS backend component task."

package/template/.qoder/skills/yss-dictionary/references/source-index.md

@@ -1,80 +0,0 @@
-# yss-dictionary Source Index
-
-Generated: 2026-08-17T12:03:37.436Z
-Source commit: `38b556a5081e6c66c0c538cbc1ef839b19996ed3`
-Source worktree: `dirty`
-Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
-
-This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
-
-Paths below are source path hints captured at refresh time. If they do not exist in the current workspace, locate sources using `YSS_SOURCE_ROOT`, CodeGraph, package/class names, Maven artifact names, or repository search before assuming the source is unavailable.
-
-## Component Path Hints
-
-- `yss-microservice-components/yss-component-dictionary-parent` (existed when indexed)
-
-## Documentation Files
-
-- No component documentation files found.
-
-## Maven Modules
-
-- `yss-microservice-components/yss-component-dictionary-parent`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-client`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-feign`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-starter`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary`
-
-## Key Java Entry Points
-
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-client/src/main/java/com/yss/cloud/dic/dto/cmd/DicAddCmd.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-client/src/main/java/com/yss/cloud/dic/dto/cmd/DicBasicAddCmd.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-client/src/main/java/com/yss/cloud/dic/dto/cmd/DicClassAddCmd.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-client/src/main/java/com/yss/cloud/dic/dto/cmd/DicClassEditCmd.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-client/src/main/java/com/yss/cloud/dic/dto/cmd/DicEditCmd.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-client/src/main/java/com/yss/cloud/dic/dto/cmd/DicExportCmd.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-client/src/main/java/com/yss/cloud/dic/dto/cmd/DicSystemAddCmd.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-client/src/main/java/com/yss/cloud/dic/dto/cmd/DicSystemEditCmd.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-client/src/main/java/com/yss/cloud/dic/dto/query/ClassInfoQuery.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-client/src/main/java/com/yss/cloud/dic/dto/query/DicBasicQuery.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-client/src/main/java/com/yss/cloud/dic/dto/query/DicClassQuery.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-client/src/main/java/com/yss/cloud/dic/vo/DicBasicVO.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-client/src/main/java/com/yss/cloud/dic/vo/DicClassInfoVO.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-client/src/main/java/com/yss/cloud/dic/vo/DicClassVO.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-client/src/main/java/com/yss/cloud/dic/vo/DicDetailVO.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-client/src/main/java/com/yss/cloud/dic/vo/DicSystemVO.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-feign/src/main/java/com/yss/cloud/dic/DicAppServiceNameProperties.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-feign/src/main/java/com/yss/cloud/dic/DicCacheAutoConfiguration.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-feign/src/main/java/com/yss/cloud/dic/DicCacheHolder.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-feign/src/main/java/com/yss/cloud/dic/feign/YssDicFeign.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-feign/src/main/java/com/yss/cloud/dic/scheduler/DicCacheScheduler.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-starter/src/main/java/com/yss/cloud/dic/EnableDicManage.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-starter/src/main/java/com/yss/cloud/dic/EnableDicManageImportSelector.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-starter/src/main/java/com/yss/cloud/dic/config/DefaultDicConfiguration.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/config/DicExcelImportTemplate.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/config/DicExcelTemplate.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/config/MybatisDicConfiguration.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/controller/DicController.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/controller/DicQueryController.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/convertor/Audit2AddMapping.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/convertor/Audit2EditMapping.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/convertor/DicBasicConvertor.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/convertor/DicClassConvertor.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/entity/AuditableEntity.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/entity/DicBasicEntity.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/entity/DicClassEntity.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/entity/DicSystemEntity.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/gateway/DicQueryGateway.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/gateway/impl/DicQueryGatewayImpl.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/repository/DicBasicRepository.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/repository/DicClassRepository.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/repository/DicSystemRepository.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/scheduler/DicCacheScheduler.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/service/DicService.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/service/impl/DicServiceImpl.java`
-
-## Recommended Next Reads
-
-- Start with the documentation files above when learning component usage.
-- Search the key Java entry points for annotations, auto configuration, properties, aspects, interceptors, handlers, and result objects before changing application code.
-- Prefer existing component extension points over rewriting framework logic in business modules.

package/template/.qoder/skills/yss-jdbc/SKILL.md

@@ -1,73 +0,0 @@
----
-name: yss-jdbc
-description: Use when 用于 YSS JDBC 组件的使用与排障。当用户提到 Hutool Db、多数据源 JDBC、动态数据源连接、批量写入、JdbcSqlUtil 或 DefaultHutoolDbHolder 时调用。
----
-
-# yss-jdbc
-
-用于处理 `yss-component-jdbc` 的动态连接、多数据源、Hutool Db 封装和批量操作问题。
-
-中文说明：本技能必须以本地源码为准，不再依赖旧的 `assets/*.java` 快照。
-
-## 何时使用
-
-- 用户要用 Hutool Db 访问已配置或动态拼装的数据源。
-- 用户在做多数据源同步、搬迁、批量写入。
-- 用户提到 `DefaultHutoolDbHolder`、`JdbcSqlUtil`、`DsParam`。
-- 用户排查 JDBC 工具类、自动配置、连接参数、批量 SQL 或动态数据源问题。
-
-## Source Index First
-
-Backend source location is environment-specific; resolve it with `yss-source-index/references/source-location.md`.
-
-Before changing code or giving exact class/config advice, read:
-
-`references/source-index.md`
-
-Use the index to locate current implementations such as:
-
-- `DefaultHutoolConfiguration`
-- `DefaultHutoolDbHolder`
-- `JdbcSqlUtil`
-- `DsParam`
-- JDBC-related auto configuration, properties, factory, holder, util, and tests
-
-中文说明：如果源码索引与本技能文字不一致，以源码索引和真实源码为准。
-
-## 工作方式
-
-1. 先读 `references/source-index.md`，确认当前组件入口和真实类名。
-2. 确认数据源是“Spring 已配置”还是“运行时动态输入”。
-3. 已配置数据源优先查 `DefaultHutoolDbHolder` 的当前 API。
-4. 动态外部连接优先查 `JdbcSqlUtil` + `DsParam` 的当前 API。
-5. 批量场景优先复用组件提供的批处理能力，不要手写低质量循环 SQL。
-6. 若源码存在测试或示例，优先按测试里的调用方式设计方案。
-
-## 选择规则
-
-- 已注册数据源：`DefaultHutoolDbHolder`
-- 临时连接外部库：`JdbcSqlUtil.getDb(...)`
-- 批量插入或批量 Map 数据：`JdbcSqlUtil` 的批处理能力
-- Spring Boot 接入问题：先看 auto-configuration 和 properties 类
-- 连接参数问题：先看 `DsParam` 字段、校验逻辑和工具方法签名
-
-## 检查清单
-
-- 数据源名称是否与配置一致。
-- 动态连接参数是否完整。
-- 批量操作是否需要事务包裹。
-- 是否错误地把 JDBC 工具层当成完整 ORM 使用。
-- 是否把账号、密码、URL 等敏感连接信息硬编码到业务代码。
-- 是否在 Repository/MyBatis 已覆盖的场景绕过统一持久层规范。
-
-## 修改约束
-
-- 不要在已有 Repository 体系里滥用 JDBC 工具类替代正常持久层。
-- 不要把账号密码直接写入代码常量。
-- 动态连接场景下优先校验连接参数，再执行写操作。
-- 不要凭记忆补类名、方法名或配置项；先从 source-index 跳到真实源码。
-
-## 按需读取
-
-- 源码索引：`references/source-index.md`
-- 组件路径线索：`yss-microservice-components/yss-component-jdbc`

package/template/.qoder/skills/yss-jdbc/agents/openai.yaml

@@ -1,5 +0,0 @@
-version: 1
-interface:
-  display_name: "YSS JDBC"
-  short_description: "动态数据源、JDBC 访问、批量写入与排障处理规范"
-  default_prompt: "Use $yss-jdbc to configure or debug Hutool Db, dynamic data sources, and JDBC batch access."

package/template/.qoder/skills/yss-jdbc/assets/DefaultHutoolConfiguration.java

@@ -1,9 +0,0 @@
-package com.yss.cloud.jdbc.db;
-
-import org.springframework.context.annotation.ComponentScan;
-import org.springframework.context.annotation.Configuration;
-
-@Configuration
-@ComponentScan("com.yss.cloud.jdbc.db")
-public class DefaultHutoolConfiguration {
-}

package/template/.qoder/skills/yss-jdbc/assets/DefaultHutoolDbHolder.java

@@ -1,33 +0,0 @@
-package com.yss.cloud.jdbc.db;
-
-import cn.hutool.db.Db;
-import cn.hutool.db.Session;
-import com.yss.cloud.mybatis.MultiDataSourceHolder;
-import lombok.RequiredArgsConstructor;
-import org.springframework.stereotype.Component;
-
-import javax.annotation.PostConstruct;
-import javax.sql.DataSource;
-import java.util.Map;
-
-@Component
-@RequiredArgsConstructor
-public class DefaultHutoolDbHolder {
-    public final MultiDataSourceHolder multiDataSourceHolder;
-    public static Map<String,DataSource> dataSourceMapTemp;
-
-    @PostConstruct
-    public void init(){
-        dataSourceMapTemp = multiDataSourceHolder.getMultiDataSource();
-    }
-
-    public static DataSource getAppDs(String dsName){
-        return dataSourceMapTemp.get(dsName);
-    }
-    public static Db getDb(String dsName) {
-        return Db.use(getAppDs(dsName));
-    }
-    public static Session getSession(String dsName) {
-        return Session.create(getAppDs(dsName));
-    }
-}

package/template/.qoder/skills/yss-jdbc/assets/DsParam.java

@@ -1,19 +0,0 @@
-package com.yss.cloud.jdbc.db;
-
-import lombok.AllArgsConstructor;
-import lombok.Data;
-import lombok.NoArgsConstructor;
-import lombok.ToString;
-
-@Data
-@AllArgsConstructor
-@NoArgsConstructor
-@ToString
-public class DsParam {
-    private String driverClass;
-    private String jdbc;
-    private String userName;
-    private String password;
-
-
-}

package/template/.qoder/skills/yss-jdbc/assets/JdbcSqlUtil.java

@@ -1,92 +0,0 @@
-package com.yss.cloud.jdbc.db;
-
-import cn.hutool.db.Db;
-import cn.hutool.db.Entity;
-import cn.hutool.db.Session;
-import cn.hutool.db.ds.simple.SimpleDataSource;
-
-import javax.sql.DataSource;
-import java.sql.SQLException;
-import java.util.*;
-import java.util.function.BiConsumer;
-import java.util.stream.Collectors;
-
-/**
- * @author zhudaoming
- */
-public class JdbcSqlUtil {
-
-    public static Db getDb(DsParam dsParam) {
-        return Db.use(
-                new SimpleDataSource(
-                        dsParam.getJdbc(),
-                        dsParam.getUserName(),
-                        dsParam.getPassword(),
-                        dsParam.getDriverClass()));
-    }
-
-    public static Db getDb(DataSource dataSource) {
-        return Db.use(dataSource);
-    }
-    public static Session getDbSession(DataSource dataSource) {
-        return Session.create(dataSource);
-    }
-
-    public static Session getDbSession(DsParam dsParam) {
-        return Session.create(new SimpleDataSource(
-                dsParam.getJdbc(),
-                dsParam.getUserName(),
-                dsParam.getPassword(),
-                dsParam.getDriverClass()));
-    }
-
-    public static List<Object[]> createBatchDataParam(Object[]... paramArray){
-        return new ArrayList<>(Arrays.asList(paramArray));
-    }
-    public static Object[] createQueryDataParam(Object... param){
-        return param;
-    }
-
-    public static void batchAddTableData(String toTable, List<Entity> entities, BiConsumer<String,List<Object[]>> taskCallback) throws SQLException {
-        if (!entities.isEmpty()){
-           String paramRex = entities.stream().findFirst().get().getFieldNames().stream().map(e->"?").collect(Collectors.joining(","));
-            String fields =entities.stream().findFirst().get().getFieldNames().stream().collect(Collectors.joining(","));
-            List<Object[]> allData = entities.stream().map(e -> e.values().toArray()).collect(Collectors.toList());
-            String batchSql = "insert into " +
-                    toTable +
-                    "(" +
-                    fields +
-                    ")" +
-                    "values" +
-                    "(" +
-                    paramRex +
-                    ")";
-            taskCallback.accept(batchSql,allData);
-        }
-    }
-
-    public static void batchAddMapData(String toTable, List<Map<String,String>> mapData, BiConsumer<String,List<Object[]>> taskCallback) throws SQLException {
-        if (!mapData.isEmpty()){
-            String paramRex;
-            String fields;
-            Optional<Map<String, String>> mapOptional = mapData.stream().findFirst();
-            Map<String, String> dataMap = mapOptional.get();
-            Set<Map.Entry<String, String>> entries = dataMap.entrySet();
-            paramRex = entries.stream().map(e -> "?").collect(Collectors.joining(","));
-            fields = entries.stream().map(Map.Entry::getKey).collect(Collectors.joining(","));
-
-            List<Object[]> allData = mapData.stream().map(m -> m.values().toArray()).collect(Collectors.toList());
-            String batchSql = "insert into " +
-                    toTable +
-                    "(" +
-                    fields +
-                    ")" +
-                    "values" +
-                    "(" +
-                    paramRex +
-                    ")";
-            taskCallback.accept(batchSql,allData);
-        }
-
-    }
-}

package/template/.qoder/skills/yss-jdbc/references/README.md

@@ -1,55 +0,0 @@
-# 参考资料
-
-本文档详细介绍了 `yss-component-jdbc` 组件的核心类和配置类。该组件基于 Hutool-db 进行了封装，提供了便捷的 JDBC 操作能力。
-
-## 核心类 (Core Classes)
-
-### 1. DefaultHutoolDbHolder.java
-
-**位置**: `../assets/DefaultHutoolDbHolder.java`
-
-基于 Hutool Db 的数据源持有者。
-
-**功能**:
-
-- **初始化**: 通过 `MultiDataSourceHolder` 获取系统配置的所有数据源。
-- **获取 Db/Session**: 提供了静态方法 `getDb(dsName)` 和 `getSession(dsName)`，允许根据数据源名称快速获取 Hutool 的 `Db` 或 `Session` 对象。
-
-### 2. JdbcSqlUtil.java
-
-**位置**: `../assets/JdbcSqlUtil.java`
-
-JDBC 操作工具类，提供了更底层的数据库操作封装。
-
-**核心功能**:
-
-- **动态连接**: 支持通过 `DsParam` (包含 url, user, password, driver) 动态创建连接，不依赖 Spring 容器管理的数据源。
-- **批量插入**:
-  - `batchAddTableData`: 将 `List<Entity>` 批量插入指定表。
-  - `batchAddMapData`: 将 `List<Map<String, String>>` 批量插入指定表。
-- **参数构建**: 提供了辅助方法构建批量参数。
-
-### 3. DsParam.java
-
-**位置**: `../assets/DsParam.java`
-
-数据源参数实体类。
-
-**属性**:
-
-- `driverClass`: 驱动类名
-- `jdbc`: JDBC URL
-- `userName`: 用户名
-- `password`: 密码
-
-### 4. DefaultHutoolConfiguration.java
-
-**位置**: `../assets/DefaultHutoolConfiguration.java`
-
-Spring 配置类，负责扫描并注册组件。
-
-## 使用场景
-
-1. **多数据源操作**: 当系统配置了多数据源时，可以使用 `DefaultHutoolDbHolder` 方便地切换数据源进行 CRUD。
-2. **临时/动态连接**: 当需要连接未在配置文件中定义的数据源（如用户输入的连接信息）时，使用 `JdbcSqlUtil` 配合 `DsParam`。
-3. **批量数据处理**: 处理大量数据导入导出时，`JdbcSqlUtil` 提供了高效的批量插入方法。

package/template/.qoder/skills/yss-jdbc/references/source-index.md

@@ -1,33 +0,0 @@
-# yss-jdbc Source Index
-
-Generated: 2026-08-17T12:03:37.436Z
-Source commit: `38b556a5081e6c66c0c538cbc1ef839b19996ed3`
-Source worktree: `dirty`
-Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
-
-This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
-
-Paths below are source path hints captured at refresh time. If they do not exist in the current workspace, locate sources using `YSS_SOURCE_ROOT`, CodeGraph, package/class names, Maven artifact names, or repository search before assuming the source is unavailable.
-
-## Component Path Hints
-
-- `yss-microservice-components/yss-component-jdbc` (existed when indexed)
-
-## Documentation Files
-
-- No component documentation files found.
-
-## Maven Modules
-
-- `yss-microservice-components/yss-component-jdbc`
-
-## Key Java Entry Points
-
-- `yss-microservice-components/yss-component-jdbc/src/main/java/com/yss/cloud/jdbc/db/DefaultHutoolConfiguration.java`
-- `yss-microservice-components/yss-component-jdbc/src/main/java/com/yss/cloud/jdbc/db/JdbcSqlUtil.java`
-
-## Recommended Next Reads
-
-- Start with the documentation files above when learning component usage.
-- Search the key Java entry points for annotations, auto configuration, properties, aspects, interceptors, handlers, and result objects before changing application code.
-- Prefer existing component extension points over rewriting framework logic in business modules.