create-yss-spec 1.0.0

package/template/.codex/skills/yss-excel-mvc/references/source-index.md

@@ -0,0 +1,72 @@
+# yss-excel-mvc Source Index
+
+Generated: 2026-06-29T16:11:14+00:00
+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.py`. 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-excel-mvc` (existed when indexed)
+- `yss-microservice-components/yss-component-excel-starter` (existed when indexed)
+
+## Documentation Files
+
+- `yss-microservice-components/yss-component-excel-mvc/README.md`
+
+## Maven Modules
+
+- `yss-microservice-components/yss-component-excel-mvc`
+- `yss-microservice-components/yss-component-excel-starter`
+
+## Key Java Entry Points
+
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/annotation/EnableExcelMvc.java`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/annotation/RequestExcel.java`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/annotation/ResponseExcel.java`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/config/FastExcelAutoConfiguration.java`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/exception/ExcelDataValidationData.java`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/exception/ExcelDataValidationException.java`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/exception/ExcelMvcExceptionHandler.java`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/handler/RequestFastExcelArgumentResolver.java`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/handler/ResponseFastExcelReturnValueHandler.java`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/model/ExcelDynamicData.java`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/util/ExcelUtils.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/ExcelAutoConfiguration.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/ExcelControlProperties.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/ExcelDataRequest.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/ExcelResolverConfiguration.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/annotation/EnableExcelControl.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/annotation/ExcelDynamicSelect.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/annotation/ExcelMeta.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/annotation/ExcelNotation.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/annotation/ExcelSelected.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/annotation/RequestExcel.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/annotation/ResponseExcel.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/aop/DynamicExcelAspect.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/handler/DynamicEasyHandler.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/handler/ExcelCellWidthStyleStrategy.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/handler/RequestExcelArgumentResolver.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/handler/ResponseExcelReturnHandler.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/handler/SelectedSheetWriteHandler.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/handler/TitleHandler.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/handler/WorkbookExcelWriteBuilder.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/ExcelComment.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/ExcelGeneralData.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/ExcelMetaData.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/ExcelSelectedResolve.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/RowValidationInfo.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/excel/CellType.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/excel/ExcelCellStyle.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/excel/ExcelColHeader.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/excel/ExcelDisabled.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/processor/DynamicEasyExcelProcessor.java`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/processor/ExcelStyleParseProcessor.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/.codex/skills/yss-exception/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: yss-exception
+description: 用于 YSS exception 组件、统一异常模型、异常处理、错误码和异常 starter 接入排障。
+---
+
+# yss-exception
+
+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-exception`
+
+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. Read `references/source-index.md`, then read `readme.md` before changing exception behavior.
+2. Classify the failure as business exception, known system exception, or unknown exception.
+3. Use `ExceptionFactory` and `ResultErrorCode` conventions instead of ad-hoc runtime exceptions when creating YSS component errors.
+4. Check `YssGlobalExceptionProperties` when global exception output/logging behavior is configurable.
+5. Keep logging semantics aligned: business exceptions usually do not require error-stack logging; system/unknown exceptions usually do.
+
+## Source-Backed Exception Semantics
+
+- `BizException`: clear business meaning, generally no Error log and no retry.
+- `SysException`: known system problem, Error log, retry may be possible.
+- unknown `Exception`: full stack log, retry may be possible.
+
+## Checklist
+
+- Required dependency or starter module is present.
+- Error code/message are meaningful to API consumers.
+- Business validation failures are not reported as unknown system errors.
+- Stack traces are preserved for unknown/system failures.
+- Retry guidance matches exception type.
+
+## 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/.codex/skills/yss-exception/agents/openai.yaml

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

package/template/.codex/skills/yss-exception/references/source-index.md

@@ -0,0 +1,32 @@
+# yss-exception Source Index
+
+Generated: 2026-06-29T16:11:14+00:00
+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.py`. 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-exception` (existed when indexed)
+
+## Documentation Files
+
+- `yss-microservice-components/yss-component-exception/readme.md`
+
+## Maven Modules
+
+- `yss-microservice-components/yss-component-exception`
+
+## Key Java Entry Points
+
+- `yss-microservice-components/yss-component-exception/src/main/java/com/yss/cloud/exception/ExceptionFactory.java`
+- `yss-microservice-components/yss-component-exception/src/main/java/com/yss/cloud/exception/ResultErrorCode.java`
+- `yss-microservice-components/yss-component-exception/src/main/java/com/yss/cloud/exception/YssGlobalExceptionProperties.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/.codex/skills/yss-file/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: yss-file
+description: 用于 YSS 文件基础组件、文件客户端、文件公共模型、文件管理服务、文件解析、上传下载和文件元数据排障。
+---
+
+# yss-file
+
+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-file`, `yss-microservice-components/yss-component-file-parser`, `yss-microservice-components/yss-component-filemanager-common`
+
+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 storage client integration, file-manager API, file parser/import job, SFTP common support, or file metadata management.
+2. Read `references/source-index.md`, then choose the right submodule before editing.
+3. For storage backends, inspect storage modules: adapter, ftp, henghefs, local, minio, s3, sftp.
+4. For file manager APIs, inspect `FileController`, `FileConfigController`, `FileGroupController`, `FileService`, repositories, DTOs, and release/history/tag entities.
+5. For file parsing, inspect `DataImportFileJob`, `DataImportDataJob`, and readers for CSV, DBF, Excel, MDB, PDF, Word, and Map data.
+6. For Camel upload route/starter behavior, inspect the file-related entries in this skill's `references/source-index.md` and the local filemanager source directly.
+
+## Capability Split
+
+- Storage client: `storage-local`, `storage-minio`, `storage-s3`, `storage-sftp`, `storage-ftp`, `storage-henghefs`.
+- Common file protocol: `FsResponse`, command objects, file object DTO, status/result models.
+- File manager: file/group/config controllers, file history/tag/release state, permission and user services.
+- File parser: import jobs, execution context, multi-format readers, PDF Tabula extraction classes.
+
+## Checklist
+
+- Required dependency or starter module is present.
+- Storage backend is chosen before adding configuration.
+- File metadata and physical storage operations stay consistent.
+- Stream/download paths close resources and handle large files.
+- Parser jobs validate file type and encoding before import.
+- User/permission context is explicit for file-manager operations.
+
+## 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/.codex/skills/yss-file/agents/openai.yaml

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

package/template/.codex/skills/yss-file/references/source-index.md

@@ -0,0 +1,161 @@
+# yss-file Source Index
+
+Generated: 2026-06-29T16:11:14+00:00
+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.py`. 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-file` (existed when indexed)
+- `yss-microservice-components/yss-component-file-parser` (existed when indexed)
+- `yss-microservice-components/yss-component-filemanager-common` (existed when indexed)
+
+## Documentation Files
+
+- No component documentation files found.
+
+## Maven Modules
+
+- `yss-microservice-components/yss-component-file`
+- `yss-microservice-components/yss-component-file/yss-component-file-client`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-adapter`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-ftp`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-henghefs`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-local`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-minio`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-s3`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-sftp`
+- `yss-microservice-components/yss-component-file/yss-component-file-common`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager`
+- `yss-microservice-components/yss-component-file-parser`
+- `yss-microservice-components/yss-component-filemanager-common`
+
+## Key Java Entry Points
+
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-adapter/src/main/java/com/yss/henghe/platform/fs/FileServerProperties.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-adapter/src/main/java/com/yss/henghe/platform/fs/StorageAdapterConfiguration.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-ftp/src/main/java/com/yss/henghe/platform/fs/ftp/FtpClientFactory.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-ftp/src/main/java/com/yss/henghe/platform/fs/ftp/StorageFtpConfiguration.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-ftp/src/main/java/com/yss/henghe/platform/fs/ftp/StorageFtpProperties.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-henghefs/src/main/java/com/yss/henghe/platform/fs/client/FsClient.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-henghefs/src/main/java/com/yss/henghe/platform/fs/client/FsClientComparator.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-henghefs/src/main/java/com/yss/henghe/platform/fs/client/FsClientConfiguration.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-henghefs/src/main/java/com/yss/henghe/platform/fs/client/FsClientOnlyConfiguration.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-henghefs/src/main/java/com/yss/henghe/platform/fs/client/FsClientSelector.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-henghefs/src/main/java/com/yss/henghe/platform/fs/client/JRaftGroupsProperties.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-local/src/main/java/com/yss/henghe/platform/fs/local/StorageLocalConfiguration.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-local/src/main/java/com/yss/henghe/platform/fs/local/StorageLocalProperties.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-minio/src/main/java/com/yss/henghe/platform/fs/minio/MinioConfiguration.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-minio/src/main/java/com/yss/henghe/platform/fs/minio/MinioProperty.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-minio/src/main/java/com/yss/henghe/platform/fs/minio/StorageMinio.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-sftp/src/main/java/com/yss/henghe/platform/fs/sftp/StorageProperties.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-sftp/src/main/java/com/yss/henghe/platform/fs/sftp/StorageSftp.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-sftp/src/main/java/com/yss/henghe/platform/fs/sftp/StorageSftpConfiguration.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-client/storage-sftp/src/main/java/com/yss/henghe/platform/fs/sftp/StorageSftpHolderUtils.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/FsResponse.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/FsResponseStream.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/Result.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/Status.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/command/Command.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/command/CopyCommand.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/command/DbCommand.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/command/DbOperateType.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/command/DelBucketCommand.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/command/DelCommand.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/command/DoesExistCommand.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/command/GetBucketCommand.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/command/GetCommand.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/command/GetResponse.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/command/GetResponseStream.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/command/GetStreamCommand.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/command/InvokeResponse.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/command/ListBucketCommand.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/command/MakeBucketCommand.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/command/MkdirCommand.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/command/SaveCommand.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/dto/FileObjectDto.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/meta/Type.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/util/FileSizeFormatter.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-common/src/main/java/com/yss/henghe/platform/fs/util/FilesCompatiUtil.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/common/FileControllerAop.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/common/ResultCode.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/common/ThreadLocalUser.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/common/YssApiResult.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/common/util/CacheUtils.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/common/util/FileUtils.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/common/util/SqlWildcardTransformUtil.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/common/util/UserUtil.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/controller/FileConfigController.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/controller/FileController.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/controller/FileGroupController.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/dto/PageDto.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/dto/PageResp.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/dto/file/EditFileReq.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/dto/file/FileBatchReleaseReq.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/dto/file/FileCopyOrMoveReq.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/dto/file/FileCopyOrMoveResp.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/dto/file/FileFindPageReq.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/dto/file/FileListResp.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/dto/file/FileReleaseReq.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/dto/file/FileReq.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/dto/file/FileResp.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/dto/file/FileType.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/dto/group/GroupPageReq.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/dto/group/GroupTreeFile.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/dto/task/TaskResp.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/dto/task/TaskStatusResp.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/entity/File.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/entity/FileHistory.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/entity/FileTag.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/entity/OperUserDo.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/entity/Task.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/enums/FileReleaseState.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/enums/FileTypeEnum.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/mapper/FileGroupMapper.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/mapper/FileHistoryMapper.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/mapper/FileMapper.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/mapper/FileTagMapper.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/repository/FileRepository.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/repository/GroupRepository.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/service/FileHistoryService.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/service/FileService.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/service/FileTagService.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/service/UserService.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/service/impl/DataMiddleUserServiceImpl.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/service/impl/FileGroupServiceImpl.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/service/impl/FileHistoryServiceImpl.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/service/impl/FilePermissionServiceImpl.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/service/impl/FileServiceImpl.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/service/impl/FileTagServiceImpl.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/util/LeafNode.java`
+- `yss-microservice-components/yss-component-file/yss-component-file-manager/src/main/java/com/yss/cloud/file/manager/util/TreeDirNode.java`
+- `yss-microservice-components/yss-component-file-parser/src/main/java/com/yss/cloud/fileparse/GzExecutionContext.java`
+- `yss-microservice-components/yss-component-file-parser/src/main/java/com/yss/cloud/fileparse/job/DataImportDataJob.java`
+- `yss-microservice-components/yss-component-file-parser/src/main/java/com/yss/cloud/fileparse/job/DataImportFileJob.java`
+- `yss-microservice-components/yss-component-file-parser/src/main/java/com/yss/cloud/fileparse/job/DataImportJob.java`
+- `yss-microservice-components/yss-component-file-parser/src/main/java/com/yss/cloud/fileparse/reader/impl/CsvFileReader.java`
+- `yss-microservice-components/yss-component-file-parser/src/main/java/com/yss/cloud/fileparse/reader/impl/DbfFileReader.java`
+- `yss-microservice-components/yss-component-file-parser/src/main/java/com/yss/cloud/fileparse/reader/impl/ExcelFileReader.java`
+- `yss-microservice-components/yss-component-file-parser/src/main/java/com/yss/cloud/fileparse/reader/impl/FileReader.java`
+- `yss-microservice-components/yss-component-file-parser/src/main/java/com/yss/cloud/fileparse/reader/impl/MapDataReader.java`
+- `yss-microservice-components/yss-component-file-parser/src/main/java/com/yss/cloud/fileparse/reader/impl/MdbFileReader.java`
+- `yss-microservice-components/yss-component-file-parser/src/main/java/com/yss/cloud/fileparse/reader/impl/PdfFileReader.java`
+- `yss-microservice-components/yss-component-file-parser/src/main/java/com/yss/cloud/fileparse/reader/impl/WordFileReader.java`
+- `yss-microservice-components/yss-component-file-parser/src/main/java/com/yss/cloud/fileparse/region/ExecutionContext.java`
+- `yss-microservice-components/yss-component-file-parser/src/main/java/technology/tabula/CommandLineApp.java`
+- `yss-microservice-components/yss-component-file-parser/src/main/java/technology/tabula/ObjectExtractorStreamEngine.java`
+- `yss-microservice-components/yss-component-file-parser/src/main/java/technology/tabula/Page.java`
+- `yss-microservice-components/yss-component-file-parser/src/main/java/technology/tabula/PageDims.java`
+- `yss-microservice-components/yss-component-file-parser/src/main/java/technology/tabula/PageIterator.java`
+- `yss-microservice-components/yss-component-filemanager-common/src/main/java/com/yss/cloud/filemanage/sftp/SftpConnectionFactory.java`
+- `yss-microservice-components/yss-component-filemanager-common/src/main/java/com/yss/cloud/filemanage/sftp/SftpServer.java`
+- `yss-microservice-components/yss-component-filemanager-common/src/main/java/com/yss/cloud/filemanage/sftp/SftpServerOption.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/.codex/skills/yss-filerunner/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: yss-filerunner
+description: 用于 YSS filerunner parent、文件运行 starter、client/core 文件执行流程和文件任务排障。
+---
+
+# yss-filerunner
+
+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-filerunner-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 running SQL/Python files, exposing file-runner APIs, parsing scheduler logs, or adding a new file execution type.
+2. Read `references/source-index.md`, then inspect `FileRunnerController`, `FileRunnerService`, `FileExecuterManager`, and concrete executers.
+3. Current supported `FileType` values are `SQL` and `PYTHON`; unsupported types throw `BizException`.
+4. `FileExecuterManager` depends on `SchedulerFacadeApi`; load `yss-anti-scheduler` when execution delegates to scheduler APIs.
+5. For logs, inspect `DolphinLogParser` and `LogType`.
+6. For starter integration, inspect `DefaultFileRunnerConfiguration`.
+
+## Capability Split
+
+- Client contracts: `FileType`, `LogType`.
+- Core API/service: controller and service implementation.
+- Execution strategy: `AbstractFileExecuter`, `SqlFileExecuter`, `PythonFileExecuter`, `FileExecuterManager`.
+- Scheduler integration: anti-scheduler facade dependency.
+
+## Checklist
+
+- Required dependency or starter module is present.
+- File type is validated before execution.
+- Scheduler facade configuration is available.
+- Log parsing matches the scheduler backend.
+- New file types update enum, manager registration, executor implementation, and tests together.
+
+## 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/.codex/skills/yss-filerunner/agents/openai.yaml

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

package/template/.codex/skills/yss-filerunner/references/source-index.md

@@ -0,0 +1,43 @@
+# yss-filerunner Source Index
+
+Generated: 2026-06-29T16:11:14+00:00
+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.py`. 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-filerunner-parent` (existed when indexed)
+
+## Documentation Files
+
+- No component documentation files found.
+
+## Maven Modules
+
+- `yss-microservice-components/yss-component-filerunner-parent/client`
+- `yss-microservice-components/yss-component-filerunner-parent/core`
+- `yss-microservice-components/yss-component-filerunner-parent`
+- `yss-microservice-components/yss-component-filerunner-parent/yss-component-filerunner-starter`
+
+## Key Java Entry Points
+
+- `yss-microservice-components/yss-component-filerunner-parent/client/src/main/java/com/yss/cloud/filerunner/enums/FileType.java`
+- `yss-microservice-components/yss-component-filerunner-parent/client/src/main/java/com/yss/cloud/filerunner/enums/LogType.java`
+- `yss-microservice-components/yss-component-filerunner-parent/core/src/main/java/com/yss/cloud/filerunner/controller/FileRunnerController.java`
+- `yss-microservice-components/yss-component-filerunner-parent/core/src/main/java/com/yss/cloud/filerunner/execute/AbstractFileExecuter.java`
+- `yss-microservice-components/yss-component-filerunner-parent/core/src/main/java/com/yss/cloud/filerunner/execute/FileExecuterManager.java`
+- `yss-microservice-components/yss-component-filerunner-parent/core/src/main/java/com/yss/cloud/filerunner/execute/PythonFileExecuter.java`
+- `yss-microservice-components/yss-component-filerunner-parent/core/src/main/java/com/yss/cloud/filerunner/execute/SqlFileExecuter.java`
+- `yss-microservice-components/yss-component-filerunner-parent/core/src/main/java/com/yss/cloud/filerunner/service/FileRunnerService.java`
+- `yss-microservice-components/yss-component-filerunner-parent/core/src/main/java/com/yss/cloud/filerunner/service/impl/FileRunnerServiceImpl.java`
+- `yss-microservice-components/yss-component-filerunner-parent/core/src/main/java/com/yss/cloud/filerunner/utils/DolphinLogParser.java`
+- `yss-microservice-components/yss-component-filerunner-parent/yss-component-filerunner-starter/src/main/java/com/yss/cloud/filerunner/config/DefaultFileRunnerConfiguration.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.