create-yss-spec 2.1.10 → 2.1.13

package/template/.claude/skills/product-design-prototype/SKILL.md

@@ -1,91 +0,0 @@
----
-name: product-design-prototype
-description: Use when a Spec baseline or user story has UI impact and needs page maps, user flows, wireframes, interaction states, or API implications before Spec calibration, OpenAPI Draft, or implementation.
----
-
-# Product Design Prototype
-
-## 兼容入口
-
-本 skill 仅服务旧名称或既有链接；它不是新的原型主入口。进入后先加载 `yss-prototype-stage`，并在 Codex 使用 `product-design:index` 产出设计资产。生命周期门禁仍由 `yss-product-lifecycle` 裁决。
-
-其余内容只描述可复用的交互说明检查项，不能替代统一合同中的 AntD CLI、浏览器验证或用户确认。
-
-## Required Inputs
-
-- Spec baseline or confirmed user stories.
-- `CONTEXT.md` terms when domain language matters.
-- Existing `docs/.scratch/<feature>/design/` assets or prototype links; keep the project-wide `docs/design/design.md` system baseline separate.
-- Known component/page constraints, such as YSS UI, Formily, tables, trees, drawers, modals, permissions, or generated API clients.
-
-If no Spec baseline exists, route back to `yss-product-lifecycle` / `grill-with-docs` / `to-spec`. If the change has no UI impact, record the no-UI decision and continue to Spec calibration, OpenAPI, or engineering baseline.
-
-## Core Flow
-
-1. Inspect current assets: `docs/.scratch/<feature>/spec.md`, `docs/.scratch/<feature>/design/`, `docs/.scratch/<feature>/api/`, `docs/.scratch/<feature>/architecture/`, and active Spec Delta changes.
-2. Create or update `docs/.scratch/<feature>/design/<feature>-interaction-spec.md` using `docs/design/templates/interaction-spec-template.md`.
-3. Capture page map, primary user flow, exception flow, and low-fidelity prototype or wireframe link.
-4. Fill the state matrix using `docs/design/templates/state-matrix-template.md`.
-5. Write the OpenAPI implication list: fields, filters, actions, errors, permissions, pagination, optimistic/concurrency states, and audit/version data.
-6. For every primary page action, add an action-to-contract row: page/component, action label, `actionKey`, endpoint or explicit non-goal, request fields, response shape, permission behavior, state transition, idempotency/concurrency rule, and error codes.
-7. For every P0 requirement containing verbs such as manage, maintain, configure, create, update, archive, retry, cancel, publish, export, or create draft, confirm the interaction spec either names the API implication or records that the capability is intentionally out of scope.
-8. Hand off to `prototype-review`. After approval, return to `yss-prototype-stage` for `product-design:index` 高保真产出、AntD CLI 与浏览器验证；未形成确认记录前不得冻结/校准 Spec 或进入 OpenAPI Draft。
-9. 交互原型应标注 semantic token 角色、single primary action、interaction feedback 和不可逆操作确认；若页面使用 Ant Design，主题密度或暗色策略必须使用 theme algorithm，并在关键文本上复核 accessibility contrast。
-
-## Tool Routing
-
-| Need | Add skill/tool |
-|---|---|
-| Low-fidelity page or flow sketch | `product-design:index` |
-| Figma work or existing Figma file | `figma` / `figma-use` |
-| YSS implementation constraints | `yss-router`, then `yss-ui`, `yss-formily`, `yss-page-module-development` as needed |
-
-## Output Contract
-
-Return:
-
-```markdown
-### 当前阶段
-Product design / prototype / interaction design
-
-### 输入资产
-- <docs/.scratch/<feature>/spec.md / docs/.scratch/<feature>/discovery/ / CONTEXT / existing design paths>
-
-### 设计产物
-- <docs/.scratch/<feature>/design/... or prototype link>
-
-### 页面与流程
-- <page map and main/exception flows>
-
-### 状态矩阵
-- <loading/empty/error/no-permission/readonly/conflict/dirty states>
-
-### OpenAPI 反推清单
-- <request/response fields, filters, actions, errors, permissions>
-
-### 页面动作到契约映射
-- <page/component action -> actionKey -> endpoint/non-goal -> permission -> state transition -> error codes>
-
-### Ant Design v6 体验检查
-- <semantic token / theme algorithm / single primary action / interaction feedback / accessibility contrast>
-
-### 是否可进入 Spec 校准 / OpenAPI Draft
-- <yes/no; include whether Spec calibration is needed first>
-
-### 下一步
-- <prototype-review / high-fidelity-html-prototype / routing back to Spec/design>
-```
-
-## Data Modeling Example
-
-For a data middle platform modeling MVP, cover at least:
-
-- Model list: search, status filter, create action, empty and no-permission states.
-- Model detail: draft vs published version, fields tab, validation panel, publish action.
-- Field editor drawer: field name, type, nullable, primary key, default value, business meaning, validation errors.
-- Publish confirmation modal: validation summary, irreversible version-freeze warning, audit actor/time.
-- Version history: published version list, diff entry, rollback or deprecate decision if in scope.
-- Readonly published version: create-draft action or explicit non-goal.
-- Validation panel: rule source, blocker/warning configuration source, validation run result.
-
-The API implication list should include list filters, YSS page result shape, field-level validation errors, publish result, version metadata, rule configuration source, draftVersion behavior, and permission-driven disabled actions.

package/template/.claude/skills/product-design-prototype/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "Product Design Prototype"
-  short_description: "UI flow and state design before API draft"
-  default_prompt: "Use $product-design-prototype to turn a Spec baseline into interaction design assets before Spec calibration."

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