create-yss-spec 2.1.10 → 2.1.11

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

package/template/.trae/skills/yss-log/SKILL.md

@@ -1,48 +0,0 @@
----
-name: yss-log
-description: Use when YSS `CatchAndLog`, `CatchLogAspect`, log starter auto-configuration, request-parameter logging, latency logging, or centralized log collection is involved.
----
-
-# yss-log
-
-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-log-starter`
-
-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 DEBUG request/latency logging, exception logging, auto-configuration, or centralized collection. These are different capabilities.
-2. Read `references/source-index.md`, then read `README.md` and inspect `CatchAndLog`, `CatchLogAspect`, and `CatchLogAutoConfiguration`.
-3. `CatchAndLog` currently logs DEBUG request arguments and successful elapsed time. It does **not** catch target exceptions or guarantee a `finally` latency record; do not describe it as exception logging.
-4. For platform logging architecture, follow the README guidance around Logstash/Filebeat/ELK-style collection.
-5. Keep application logging, audit logging, and distributed tracing separate; load `yss-audit-log` for business audit events.
-
-## Capability Split
-
-- Code-level logging helper: `CatchAndLog` annotation and `CatchLogAspect`.
-- Auto-configuration: `CatchLogAutoConfiguration`.
-- Platform log collection: README guidance for Logstash/Filebeat/central storage/visualization.
-
-## Checklist
-
-- Required dependency or starter module is present.
-- Logs include enough context but avoid secrets and oversized payloads.
-- Request arguments are redacted/allowlisted and bounded before JSON serialization; never log tokens, passwords, private keys, or raw file/stream bodies.
-- Exceptions are not swallowed unless the annotation/aspect contract explicitly says so.
-- Logback/Log4j2 output format is compatible with collection pipeline.
-- Business audit requirements are not implemented with ordinary technical logs.
-
-## 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 infer behavior from the unused `pointcutAll()`; verify the pointcut actually bound to the advice.
-- Do not broaden the task into unrelated YSS components unless the user asks.

package/template/.trae/skills/yss-log/agents/openai.yaml

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

package/template/.trae/skills/yss-log/references/source-index.md

@@ -1,34 +0,0 @@
-# yss-log 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-log-starter` (existed when indexed)
-
-## Documentation Files
-
-- `yss-microservice-components/yss-component-log-starter/README.md`
-
-## Maven Modules
-
-- `yss-microservice-components/yss-component-log-starter`
-
-## Key Java Entry Points
-
-- `yss-microservice-components/yss-component-log-starter/src/main/java/com/yss/cloud/log/CatchAndLog.java`
-- `yss-microservice-components/yss-component-log-starter/src/main/java/com/yss/cloud/log/CatchLogAspect.java`
-- `yss-microservice-components/yss-component-log-starter/src/main/java/com/yss/cloud/log/CatchLogAutoConfiguration.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/.trae/skills/yss-taskflow/SKILL.md

@@ -1,58 +0,0 @@
----
-name: yss-taskflow
-description: Use when 用于 YSS 任务流组件、流程定义、任务定义、任务实例、TaskFactory、taskflow core/domain/bootstrap、任务状态和任务编排排障。
----
-
-# yss-taskflow
-
-Use this skill for YSS Taskflow 组件. Keep implementation grounded in the local project and resolvable YSS backend component source.
-
-中文说明：本技能用于 YSS Taskflow 组件。执行时优先读取源码索引，避免凭记忆猜类名、配置项或接入方式。
-
-## 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-taskflow`
-
-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 definition management, instance execution, task implementation, datasource/variable adapter, web API, state transition, or troubleshooting.
-2. Read `references/source-index.md`, then inspect the narrow module that matches the task.
-3. For task implementation, start from task API classes: `AbstractTask`, `AbstractAsynchLogicTask`, `TaskExecutionContext`, `TaskType`.
-4. For task dispatch, inspect `TaskFactory`, submitters, executors, thread pools, and `TaskflowExecutor`.
-5. For state/repair logic, inspect `TaskExecutionStatus` and event handlers before changing persistence or retry behavior.
-6. For web integration, inspect `TaskflowDefinitionController`, `TaskflowExecuteController`, `TaskflowInstanceController`, and `TaskInstanceController`.
-7. Keep taskflow changes scoped; this component spans adapter, core, domain, and bootstrap modules.
-
-## Capability Split
-
-- Task types: `SHELL`, `SQL`, `SQLPLUS`, `SUB_PROCESS`, `DEPENDENT`, `CONDITIONS`, `SWITCH`.
-- Task creation: `TaskFactory.createTask(TaskExecutionContext)` maps `TaskType` to concrete task implementations.
-- Execution core: `TaskflowExecutor`, `TaskflowBootstrap`, submitters, executors, async/sync thread pools.
-- State model: `TaskExecutionStatus` includes submitted, running, pause, stop, failure, success, fault tolerance, kill, delay, forced success, dispatch.
-- Persistence/domain: process/task repositories and entities in `yss-component-taskflow-core` and `domain`.
-- Adapters: datasource, variable, task shell/sql/sqlplus/api, and web controllers.
-
-## State Notes
-
-- Use `TaskExecutionStatus.isFinished()` and related helpers instead of duplicating status-code checks.
-- `shouldFailover()` treats submitted, dispatch, running, and delay as failover candidates.
-- Unsupported task type errors come from `TaskFactory`; check the task type string before debugging executors.
-
-## Checklist
-
-- Required dependency or starter module is present.
-- Task type, sync/async behavior, timeout strategy, and dependency relation are explicit.
-- Task context contains the parameters required by the concrete task implementation.
-- State transitions use existing status helpers and event handlers.
-- Logs use taskflow log collector/appender where applicable.
-- Web API changes preserve DTO/query/page conventions already in the component.
-
-## 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/.trae/skills/yss-taskflow/agents/openai.yaml

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