create-yss-spec 2.1.6 → 2.1.8

package/template/.claude/skills/yss-db2mybatis/scripts/db2mybatis.test.mjs

@@ -1,32 +0,0 @@
-import assert from 'node:assert/strict';
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { spawnSync } from 'node:child_process';
-import test from 'node:test';
-
-const skillRoot = path.resolve(import.meta.dirname, '..');
-const script = path.join(skillRoot, 'scripts', 'db2mybatis.mjs');
-const run = (args, cwd = process.cwd()) => spawnSync(process.execPath, [script, ...args], { cwd, encoding: 'utf8' });
-const temp = () => fs.mkdtempSync(path.join(os.tmpdir(), 'yss-db2mybatis-node-'));
-const scaffoldArgs = (root, metadata, extra = []) => ['scaffold', '--skill-root', skillRoot, '--metadata-file', metadata, '--base-package', 'com.yss.demo', '--domain-segment', 'example', '--domain-java-root', path.join(root, 'domain'), '--infra-java-root', path.join(root, 'infra'), ...extra];
-
-test('DDL 转 metadata，并保留主键、类型与注释', () => {
-  const root = temp(); const metadata = path.join(root, 'metadata.json');
-  const result = run(['ddl2metadata', '--ddl-sql', "CREATE TABLE t_order (id bigint NOT NULL COMMENT '主键', amount decimal(10,2), PRIMARY KEY (id)) COMMENT='订单';", '--db-type', 'mysql', '--database', 'demo', '--output', metadata]);
-  assert.equal(result.status, 0, result.stderr); const parsed = JSON.parse(fs.readFileSync(metadata, 'utf8'));
-  assert.equal(parsed.tables[0].table_name, 't_order'); assert.deepEqual(parsed.tables[0].primary_keys, ['id']); assert.equal(parsed.tables[0].columns[1].sql_type, 'decimal(10,2)');
-});
-
-test('scaffold dry-run 不写文件，正常生成拒绝既有目标', () => {
-  const root = temp(); const metadata = path.join(root, 'metadata.json');
-  fs.writeFileSync(metadata, JSON.stringify({ tables: [{ table_name: 't_order', table_comment: '订单', primary_keys: ['id'], columns: [{ name: 'id', sql_type: 'bigint', primary: true, nullable: false, auto_increment: false }], indexes: [], foreign_keys: [] }] }));
-  const dryRun = run(scaffoldArgs(root, metadata, ['--dry-run'])); assert.equal(dryRun.status, 0, dryRun.stderr); assert.match(dryRun.stdout, /planned:/); assert.equal(fs.existsSync(path.join(root, 'domain')), false);
-  const generated = run(scaffoldArgs(root, metadata)); assert.equal(generated.status, 0, generated.stderr); const again = run(scaffoldArgs(root, metadata)); assert.equal(again.status, 2); assert.match(again.stderr, /文件已存在/);
-});
-
-test('非法参数和缺失数据库驱动均以退出码 2 失败', () => {
-  const invalid = run(['ddl2metadata', '--output', path.join(temp(), 'out.json')]); assert.equal(invalid.status, 2); assert.match(invalid.stderr, /请提供 --ddl-file 或 --ddl-sql/);
-  const unknown = run(['ddl2metadata', '--ddl-sql', 'CREATE TABLE t_x (id bigint)', '--output', path.join(temp(), 'out.json'), '--unexpected', 'x']); assert.equal(unknown.status, 2); assert.match(unknown.stderr, /未知参数/);
-  const missing = run(['extract', '--db-type', 'mysql', '--host', '127.0.0.1', '--port', '3306', '--user', 'u', '--password', 'p', '--database', 'd', '--output', path.join(temp(), 'out.json')], temp()); assert.equal(missing.status, 2); assert.match(missing.stderr, /YSS_DB2MYBATIS_DRIVER_ROOT/);
-});

package/template/.claude/skills/yss-valuation/SKILL.md

@@ -1,40 +0,0 @@
----
-name: yss-valuation
-description: Use when 用于 YSS valuation 组件、Excel/Csv 文件读取、Excel2SqlDDL、ImportFileJob、估值文件导入和区域条件解析排障。
----
-
-# yss-valuation
-
-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-valuation`
-
-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 valuation file import, Excel/CSV reading, Excel-to-DDL generation, table relationship extraction, or import job troubleshooting.
-2. Read `references/source-index.md`, then inspect `Excel2SqlDDL`, `Excel2TableRelationship`, `ImportFileJob`, `FileReader`, `ExcelFileReader`, and `CsvFileReader`.
-3. Use this component for valuation/data-middle file import and DDL derivation; resolve generic file storage or parser infrastructure through the consuming project's source and the available source index.
-4. Validate file format, sheet/column mapping, encoding, and generated DDL before applying changes to a database.
-5. Keep import jobs idempotent or clearly restartable when possible.
-
-## Checklist
-
-- Required dependency or starter module is present.
-- Excel/CSV reader matches the actual file type.
-- Generated DDL uses the expected table/column naming rules.
-- Table relationship extraction is verified with sample files.
-- Import job failure handling records enough context for rerun.
-
-## 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-valuation/agents/openai.yaml

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

package/template/.claude/skills/yss-valuation/references/source-index.md

@@ -1,37 +0,0 @@
-# yss-valuation 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-valuation` (existed when indexed)
-
-## Documentation Files
-
-- No component documentation files found.
-
-## Maven Modules
-
-- `yss-microservice-components/yss-component-valuation`
-
-## Key Java Entry Points
-
-- `yss-microservice-components/yss-component-valuation/src/main/java/com/yss/datamiddle/ddl/Excel2SqlDDL.java`
-- `yss-microservice-components/yss-component-valuation/src/main/java/com/yss/datamiddle/ddl/Excel2TableRelationship.java`
-- `yss-microservice-components/yss-component-valuation/src/main/java/com/yss/datamiddle/job/ImportFileJob.java`
-- `yss-microservice-components/yss-component-valuation/src/main/java/com/yss/datamiddle/reader/FileReader.java`
-- `yss-microservice-components/yss-component-valuation/src/main/java/com/yss/datamiddle/reader/impl/CsvFileReader.java`
-- `yss-microservice-components/yss-component-valuation/src/main/java/com/yss/datamiddle/reader/impl/ExcelFileReader.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-variable/SKILL.md

@@ -1,47 +0,0 @@
----
-name: yss-variable
-description: Use when 用于 YSS variable 组件、变量命名空间、VariableController、VarNameSpaceController、变量解析、占位符替换和变量导入导出排障。
----
-
-# yss-variable
-
-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-variable`
-
-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 variable CRUD, namespace management, variable copy/move, import/export, wildcard search, author write handling, or async task status.
-2. Read `references/source-index.md`, then inspect `VariableController`, `VarNameSpaceController`, `VariableService`, mappers, DTOs, and enums.
-3. Keep namespace operations separate from variable definition operations.
-4. Use `VarTypeEnum` and `UserFlagEnum` semantics instead of stringly typed business flags.
-5. For import/copy/move tasks, inspect request/response DTOs and task response/status models.
-
-## Capability Split
-
-- Controllers: namespace and variable APIs.
-- Service/mapper/entity: variable persistence and operations.
-- DTOs: namespace page query, variable definition/copy/move/import/list responses.
-- Common utilities: author write handler, SQL wildcard transform, result wrappers.
-
-## Checklist
-
-- Required dependency or starter module is present.
-- Namespace and variable IDs/paths are handled consistently.
-- Variable type and user flag values use enums.
-- Import errors are returned through existing error response DTOs.
-- Wildcard search escapes SQL-sensitive characters through existing utility behavior.
-
-## 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-variable/agents/openai.yaml

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

package/template/.claude/skills/yss-variable/references/source-index.md

@@ -1,32 +0,0 @@
-# yss-variable 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-variable` (missing when indexed)
-
-## Documentation Files
-
-- No component documentation files found.
-
-## Maven Modules
-
-- No Maven modules found.
-
-## Key Java Entry Points
-
-- No key Java entry points matched the configured name patterns.
-
-## 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-db2mybatis/SKILL.md

@@ -1,95 +0,0 @@
----
-name: yss-db2mybatis
-description: Use when 用于从数据库元数据或 DDL 生成 YSS 风格的 Domain Gateway、PO、Repository、Convertor 和 GatewayImpl。当用户要求按表结构、DDL、metadata 或数据库连接批量生成持久层代码时调用。
----
-
-# yss-db2mybatis
-
-这是一个生成器型 skill。优先复用脚本 `scripts/db2mybatis.mjs`，不要在对话里手写大段样板代码替代脚本。
-
-## 何时使用
-
-- 用户给出数据库表、DDL、metadata，要求生成 YSS 持久层代码。
-- 用户要求批量生成 `PO / Repository / Convertor / GatewayImpl / Domain Gateway`。
-- 用户要从 MySQL、PostgreSQL、Oracle、OpenGauss、OceanBase 提取元数据。
-- 用户要先从 DDL 离线生成 metadata，再生成代码。
-
-## 不适用
-
-- 复杂 SQL 优化、手写 XML Mapper。
-- 联合主键需要特殊建模且用户未确认策略。
-- 用户只想补某个领域行为，而不是批量落持久层。
-
-## 优先流程
-
-1. 识别输入来源：`metadata.json`、数据库连接、DDL 文件、DDL 文本。
-2. 先执行 `validate` 或 `extract` / `ddl2metadata`，不要直接盲生成。
-3. 生成前优先用 `--dry-run` 预览。
-4. 生成后检查输出路径、命名、主键策略和类型映射。
-5. 如用户要继续补 Domain 或 Web，再衔接 `yss-domain`、`yss-web-controller`。
-
-## 推荐命令
-
-### 从数据库提取 metadata
-
-```bash
-node scripts/db2mybatis.mjs extract \
-  --datasource-config references/datasource-config.example.json \
-  --datasource-name your-datasource \
-  --tables t_example \
-  --output /tmp/metadata.json
-```
-
-### 从 DDL 生成 metadata
-
-```bash
-node scripts/db2mybatis.mjs ddl2metadata \
-  --ddl-file /path/schema.sql \
-  --db-type mysql \
-  --database demo \
-  --output /tmp/metadata.json
-```
-
-### 生成代码
-
-```bash
-node scripts/db2mybatis.mjs scaffold \
-  --skill-root /path/to/.agents/skills/yss-db2mybatis \
-  --metadata-file /tmp/metadata.json \
-  --base-package com.yss.demo \
-  --domain-segment example \
-  --domain-java-root /path/project-domain/src/main/java \
-  --infra-java-root /path/project-infra/src/main/java \
-  --dry-run
-```
-
-## 关键参数
-
-- 表过滤：`--tables`、`--include-tables-regex`、`--exclude-tables-regex`
-- 安全控制：`--dry-run`、`--overwrite`
-- 输入来源：`--metadata-file`、`--ddl-file`、`--ddl-sql`
-- 主键策略：`--pk-strategy error|first`
-- 项目约定：`--convention-file`
-- 实时驱动根目录：`YSS_DB2MYBATIS_DRIVER_ROOT`（未设置时使用当前工作目录；不自动安装依赖）。MySQL / OceanBase 使用 `mysql2`，PostgreSQL / OpenGauss 使用 `pg`，Oracle 使用 `oracledb`；DDL、metadata、scaffold 和 validate 不依赖第三方包。
-
-## 输出预期
-
-- `domain/{segment}/gateway/*Gateway.java`
-- `repository/entity/*PO.java`
-- `repository/*Repository.java`
-- `repository/convertor/*Convertor.java`
-- `repository/gateway/impl/*GatewayImpl.java`
-
-## 质量要求
-
-- 遇到无法推断的类型时，给出明确告警，不要静默猜测。
-- 联合主键默认报错，除非用户明确接受 `first` 策略。
-- 默认先生成可编译骨架，再由调用方补复杂查询。
-- 输出前检查生成路径是否真的对齐当前工程。
-
-## 按需读取
-
-- 主脚本：`scripts/db2mybatis.mjs`（Node `>=22 <27`）
-- 类型映射：`references/type-mapping.json`
-- 数据源示例：`references/datasource-config.example.json`
-- 项目约定示例：`references/project-convention.example.json`

package/template/.codex/skills/yss-db2mybatis/agents/openai.yaml

@@ -1,5 +0,0 @@
-version: 1
-interface:
-  display_name: "YSS DB2MyBatis"
-  short_description: "数据库元数据生成 YSS 持久层与代码脚手架落地规范"
-  default_prompt: "Use $yss-db2mybatis to generate YSS domain gateway, repository, convertor, and gateway implementation code from database metadata."

package/template/.codex/skills/yss-db2mybatis/assets/$.java

@@ -1,19 +0,0 @@
-package ${base_package}.repository.entity;
-
-import com.baomidou.mybatisplus.annotation.IdType;
-import com.baomidou.mybatisplus.annotation.TableField;
-import com.baomidou.mybatisplus.annotation.TableId;
-import com.baomidou.mybatisplus.annotation.TableName;
-import lombok.Data;
-import lombok.EqualsAndHashCode;${extra_imports}
-
-/**
- * ${table_comment}
- */
-@Data
-@EqualsAndHashCode
-@TableName("${table_name}")
-public class ${domain_name}PO {
-
-${fields_block}
-}

package/template/.codex/skills/yss-db2mybatis/assets/convertor.java.template

@@ -1,22 +0,0 @@
-package ${base_package}.repository.convertor;
-
-import ${model_pkg}.${domain_name};
-import ${base_package}.repository.entity.${domain_name}PO;
-import org.mapstruct.Mapper;
-import org.mapstruct.NullValueCheckStrategy;
-import org.mapstruct.NullValuePropertyMappingStrategy;
-import org.mapstruct.factory.Mappers;
-
-import java.util.List;
-
-@Mapper(nullValuePropertyMappingStrategy = NullValuePropertyMappingStrategy.IGNORE, nullValueCheckStrategy = NullValueCheckStrategy.ALWAYS)
-public interface ${domain_name}Convertor {
-
-    ${domain_name}Convertor INSTANCE = Mappers.getMapper(${domain_name}Convertor.class);
-
-    ${domain_name}PO toPO(${domain_name} source);
-
-    ${domain_name} toDomain(${domain_name}PO source);
-
-    List<${domain_name}> toDomainList(List<${domain_name}PO> source);
-}

package/template/.codex/skills/yss-db2mybatis/assets/domain_gateway.java.template

@@ -1,45 +0,0 @@
-package ${gateway_pkg};
-
-import com.yss.cloud.dto.page.PageQuery;
-import com.yss.cloud.dto.result.PageResult;
-import ${model_pkg}.${domain_name};
-
-import java.util.Optional;
-
-public interface ${domain_name}Gateway{
-    /**
-     * Add ${domain_name}
-     *
-     * @param entity entity
-     * @return id
-     */
-    ${pk_java_type} ${method_add}(${domain_name} entity);
-    /**
-     * Update ${domain_name}
-     *
-     * @param entity entity
-     * @return boolean
-     */
-    boolean ${method_update}(${domain_name} entity);
-    /**
-     * Delete ${domain_name}
-     *
-     * @param ${pk_field_name} id
-     * @return boolean
-     */
-    boolean ${method_delete}(${pk_java_type} ${pk_field_name});
-    /**
-     * Get ${domain_name} by id
-     *
-     * @param ${pk_field_name} id
-     * @return optional
-     */
-    Optional<${domain_name}> ${method_get}(${pk_java_type} ${pk_field_name});
-    /**
-      * Page ${domain_name}
-      *
-      * @param query query
-      * @return page result
-      */
-    PageResult<${domain_name}> ${method_page}(PageQuery query);
-}

package/template/.codex/skills/yss-db2mybatis/assets/domain_model.java.template

@@ -1,16 +0,0 @@
-package ${model_pkg};
-
-import lombok.Data;
-import java.io.Serializable;
-${extra_imports}
-
-/**
- * ${table_comment}
- */
-@Data
-public class ${domain_name} implements Serializable {
-
-    private static final long serialVersionUID = 1L;
-
-    ${fields_block}
-}

package/template/.codex/skills/yss-db2mybatis/assets/gateway_impl.java.template

@@ -1,62 +0,0 @@
-package ${base_package}.repository.gateway.impl;
-
-import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
-import com.baomidou.mybatisplus.core.metadata.IPage;
-import com.baomidou.mybatisplus.core.toolkit.Wrappers;
-import com.yss.cloud.dto.page.PageQuery;
-import com.yss.cloud.dto.result.PageResult;
-import ${gateway_pkg}.${domain_name}Gateway;
-import ${model_pkg}.${domain_name};
-import ${base_package}.repository.${domain_name}Repository;
-import ${base_package}.repository.convertor.${domain_name}Convertor;
-import ${base_package}.repository.entity.${domain_name}PO;
-import ${base_package}.repository.util.PageUtil;
-import lombok.RequiredArgsConstructor;
-import org.springframework.stereotype.Repository;
-
-import java.util.List;
-import java.util.Optional;
-import java.util.stream.Collectors;
-
-@Repository
-@RequiredArgsConstructor
-public class ${domain_name}GatewayImpl implements ${domain_name}Gateway {
-
-    private final ${domain_name}Repository ${repository_field_name};
-
-    @Override
-    public ${pk_java_type} ${method_add}(${domain_name} entity) {
-        ${domain_name}PO po = ${domain_name}Convertor.INSTANCE.toPO(entity);
-        ${repository_field_name}.insert(po);
-        //fixme 补充返回数据唯一id
-        return null;
-    }
-
-    @Override
-    public boolean ${method_update}(${domain_name} entity) {
-        return ${repository_field_name}.updateById(${domain_name}Convertor.INSTANCE.toPO(entity)) > 0;
-    }
-
-    @Override
-    public boolean ${method_delete}(${pk_java_type} ${pk_field_name}) {
-        return ${repository_field_name}.deleteById(${pk_field_name}) > 0;
-    }
-
-    @Override
-    public Optional<${domain_name}> ${method_get}(${pk_java_type} ${pk_field_name}) {
-        return Optional.ofNullable(${repository_field_name}.selectById(${pk_field_name})).map(this::toDomain);
-    }
-
-    @Override
-    public PageResult<${domain_name}> ${method_page}(PageQuery query) {
-        LambdaQueryWrapper<${domain_name}PO> wrapper = Wrappers.lambdaQuery(${domain_name}PO.class);
-        ${logic_delete_condition}
-        IPage<${domain_name}PO> result = ${repository_field_name}.selectPage(PageUtil.page(query), wrapper);
-        List<${domain_name}> records = result.getRecords().stream().map(this::toDomain).collect(Collectors.toList());
-        return PageResult.of(records, result.getTotal(), result.getSize(), result.getCurrent());
-    }
-
-    private ${domain_name} toDomain(${domain_name}PO source) {
-        return ${domain_name}Convertor.INSTANCE.toDomain(source);
-    }
-}

package/template/.codex/skills/yss-db2mybatis/assets/po.java.template

@@ -1,18 +0,0 @@
-package ${base_package}.repository.entity;
-
-import com.baomidou.mybatisplus.annotation.IdType;
-import com.baomidou.mybatisplus.annotation.TableField;
-import com.baomidou.mybatisplus.annotation.TableId;
-import com.baomidou.mybatisplus.annotation.TableName;
-import lombok.Data;
-import lombok.EqualsAndHashCode;${extra_imports}
-
-/**
- * ${table_comment}
- */
-@Data
-@EqualsAndHashCode
-@TableName("${table_name}")
-public class ${domain_name}PO {
-    ${fields_block}
-}

package/template/.codex/skills/yss-db2mybatis/assets/repository.java.template

@@ -1,7 +0,0 @@
-package ${base_package}.repository;
-
-import com.yss.cloud.mybatis.support.BasePlusRepository;
-import ${base_package}.repository.entity.${domain_name}PO;
-
-public interface ${domain_name}Repository extends BasePlusRepository<${domain_name}PO> {
-}