create-yss-spec 2.1.10 → 2.1.13

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

package/template/.agents/skills/yss-taskflow/references/source-index.md

@@ -1,158 +0,0 @@
-# yss-taskflow 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-taskflow` (existed when indexed)
-
-## Documentation Files
-
-- No component documentation files found.
-
-## Maven Modules
-
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-datasource`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-task`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-task/yss-component-taskflow-task-api`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-task/yss-component-taskflow-task-shell`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-task/yss-component-taskflow-task-sql`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-task/yss-component-taskflow-task-sqlplus`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-variable`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-web`
-- `yss-microservice-components/yss-component-taskflow`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-bootstrap`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain`
-
-## Key Java Entry Points
-
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-datasource/src/main/java/com.yss.cloud.taskflow.datasource/TaskflowDataSourceConfiguration.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-datasource/src/main/java/com.yss.cloud.taskflow.datasource/TaskflowDataSourceEntity.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-datasource/src/main/java/com.yss.cloud.taskflow.datasource/TaskflowDataSourceProperties.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-task/yss-component-taskflow-task-api/src/main/java/com/yss/cloud/taskflow/task/api/AbstractAsynchLogicTask.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-task/yss-component-taskflow-task-api/src/main/java/com/yss/cloud/taskflow/task/api/AbstractTask.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-task/yss-component-taskflow-task-api/src/main/java/com/yss/cloud/taskflow/task/api/ShellCommandExecutor.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-task/yss-component-taskflow-task-api/src/main/java/com/yss/cloud/taskflow/task/api/TaskExecutionContext.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-task/yss-component-taskflow-task-api/src/main/java/com/yss/cloud/taskflow/task/api/TaskType.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-task/yss-component-taskflow-task-api/src/main/java/com/yss/cloud/taskflow/task/api/log/TaskflowLogAppender.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-task/yss-component-taskflow-task-api/src/main/java/com/yss/cloud/taskflow/task/api/log/TaskflowLogCollector.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-task/yss-component-taskflow-task-shell/src/main/java/com/yss/cloud/taskflow/task/shell/ShellTask.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-task/yss-component-taskflow-task-sql/src/main/java/com/yss/cloud/taskflow/task/sql/SqlBinds.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-task/yss-component-taskflow-task-sql/src/main/java/com/yss/cloud/taskflow/task/sql/SqlParameters.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-task/yss-component-taskflow-task-sql/src/main/java/com/yss/cloud/taskflow/task/sql/SqlTask.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-task/yss-component-taskflow-task-sqlplus/src/main/java/com/yss/cloud/taskflow/task/sqlplus/SqlBinds.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-task/yss-component-taskflow-task-sqlplus/src/main/java/com/yss/cloud/taskflow/task/sqlplus/SqlPlusTask.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-task/yss-component-taskflow-task-sqlplus/src/main/java/com/yss/cloud/taskflow/task/sqlplus/SqlPlusTaskParameters.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-variable/src/main/java/com.yss.cloud.taskflow.variable/VariableApi.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-variable/src/main/java/com.yss.cloud.taskflow.variable/VariableConfiguration.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-variable/src/main/java/com.yss.cloud.taskflow.variable/VariableProperties.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-variable/src/main/java/com.yss.cloud.taskflow.variable/VariableService.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-variable/src/main/java/com.yss.cloud.taskflow.variable/conf/VariableConf.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-web/src/main/java/com/yss/cloud/taskflow/task/api/TaskInstanceController.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-web/src/main/java/com/yss/cloud/taskflow/task/api/TaskflowDefinitionController.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-web/src/main/java/com/yss/cloud/taskflow/task/api/TaskflowExecuteController.java`
-- `yss-microservice-components/yss-component-taskflow/adapter/yss-component-taskflow-web/src/main/java/com/yss/cloud/taskflow/task/api/TaskflowInstanceController.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-bootstrap/src/main/java/com/yss/cloud/taskflow/YssTaskflowApplication.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/event/EventHandlerManager.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/event/EventType.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/event/TaskflowEventEngine.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/event/TaskflowEventQueue.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/event/event/TaskStateEvent.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/event/event/TaskTimeoutEvent.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/event/event/TaskflowEvent.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/event/event/TaskflowFinishEvent.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/event/event/TaskflowStartEvent.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/event/event/TaskflowStopEvent.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/event/event/TaskflowTimeoutEvent.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/event/handler/EventHandler.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/event/handler/TaskEventStateEventHandler.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/event/handler/TaskTimoutEventHandler.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/event/handler/TaskflowFinishEventHandler.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/event/handler/TaskflowStartEventHandler.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/event/handler/TaskflowStopEventHandler.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/event/handler/TaskflowTimoutEventHandler.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/repository/ProcessDefinitionRepository.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/repository/ProcessInstanceMapRepository.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/repository/ProcessInstanceRepository.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/repository/ProcessTaskRelationRepository.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/repository/TaskDefinitionRepository.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/repository/TaskInstanceLogRepository.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/repository/TaskInstanceRepository.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/repository/entity/DagData.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/repository/entity/ProcessTaskRelation.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/repository/entity/TaskDefinition.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/repository/entity/TaskInstance.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/repository/entity/TaskInstanceLog.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/runner/AsynchTaskDelayQueue.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/runner/AsynchTaskExecutionContext.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/runner/AsynchTaskThreadPool.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/runner/TaskExecutionContextFactory.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/runner/TaskFactory.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/runner/TaskThreadPool.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/runner/TaskflowBootstrap.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/runner/TaskflowContext.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/runner/TaskflowExecutor.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/runner/TaskflowExecutorCacheManager.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/runner/executor/AsynchLogicTaskExecutor.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/runner/executor/BaseTaskExecutor.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/runner/executor/CommonTaskExecutor.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/runner/executor/LogicTaskExecutor.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/runner/executor/SynchLogicTaskExecutor.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/runner/submit/BaseTaskSubmitter.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/runner/submit/CommonTaskSubmitter.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/runner/submit/LogicTaskSubmitter.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/runner/submit/TaskSubmitterFactory.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/service/TaskDefinitionService.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/service/TaskService.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/service/impl/TaskDefinitionServiceImpl.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/service/impl/TaskServiceImpl.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/task/condition/ConditionLogicTask.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/task/dependent/DependentTask.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/task/subflow/SubflowTask.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-core/src/main/java/com/yss/cloud/taskflow/core/task/switchtask/SwitchLogicTask.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/common/TaskflowConstants.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/dto/query/TaskInstancePage.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/dto/query/TaskInstanceQuery.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/dto/query/TaskflowDefinitionPage.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/dto/query/TaskflowDefinitionQuery.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/dto/query/TaskflowInstancePage.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/enums/CommandType.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/enums/DataType.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/enums/DatabaseType.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/enums/Direct.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/enums/ProcessExecutionTypeEnum.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/enums/ReleaseState.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/enums/SqlType.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/enums/TaskDependType.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/enums/TaskExecuteType.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/enums/TaskExecutionStatus.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/enums/TaskTimeoutStrategy.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/enums/WarningType.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/enums/WorkflowExecutionStatus.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/model/Command.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/model/PreviousTaskNode.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/model/TaskNode.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/model/TaskNodeRelation.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/model/TaskResponse.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/model/TaskTimeoutParameter.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/model/dependent/DependResult.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/model/dependent/DependentTaskModel.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/model/dependent/SwitchResultVo.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/utils/FileUtils.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/utils/PageUtil.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/utils/SqlCommentParser.java`
-- `yss-microservice-components/yss-component-taskflow/yss-component-taskflow-domain/src/main/java/com/yss/cloud/taskflow/domain/utils/SwitchTaskUtils.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.