create-yss-spec 2.1.6 → 2.1.8

package/template/skills-lock.json

@@ -935,26 +935,11 @@
           ".trae/skills"
         ]
       },
-      "yss-db2mybatis": {
-        "source": "project",
-        "sourceType": "local",
-        "skillPath": ".agents/skills/yss-db2mybatis/SKILL.md",
-        "effectiveHash": "a3f79aee897482335f992588f6daea10862b7b899ec6e0d7600ae92d22e14e23",
-        "targets": [
-          ".agents/skills",
-          ".claude/skills",
-          ".codex/skills",
-          ".hermes/skills",
-          ".pi/skills",
-          ".qoder/skills",
-          ".trae/skills"
-        ]
-      },
       "yss-ddd-scaffold-generator": {
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-ddd-scaffold-generator/SKILL.md",
-        "effectiveHash": "398e762b94976d24f415914172a20ccd319ac73a2d7417b3598738b97d3bbbee",
+        "effectiveHash": "b7b48933e2c1f1f49e7690562e40021cc210dd79fdef2618fdeec30af0dd0f25",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1014,7 +999,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-domain/SKILL.md",
-        "effectiveHash": "cd67ad8a8bbade6fe4100570353bdef480637dbed88f85d33e320366d6568743",
+        "effectiveHash": "ab033e854f63850208253bf705d92172e1a2425de4fe271a7a2fec4133c63713",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1029,7 +1014,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-dto/SKILL.md",
-        "effectiveHash": "d697e0182ac21fe1b75c95db8ec38c7c13a8b2c0dbbe83e087a506b8cbac2655",
+        "effectiveHash": "2a950d5399056a081139df2246a8f42ae68d354c19bd0e675055dcbf71187275",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1179,7 +1164,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-mybatis/SKILL.md",
-        "effectiveHash": "85f23a368f8a5fc5bb2e10091152833114befb5479967e2383479263e49de2e2",
+        "effectiveHash": "ecacb9029a72dacf5fca6e9bb7527725df7ea92e67674e6523984ccb74cccfda",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1194,7 +1179,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-openapi-draft-review/SKILL.md",
-        "effectiveHash": "dcf5c6125081e1adb3b3ee0204f2e14fec62dd2ccb7857d2f0d46c1b64e2755c",
+        "effectiveHash": "fa3016e145778e73f0a1e83017b009fe92941b221cc7c5bb8f2666e6c99d9376",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1209,7 +1194,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-openapi-governance/SKILL.md",
-        "effectiveHash": "f3c782d3f59fa54e00066641f70fb18f54f2a8f222a851dda1148b4e74f02793",
+        "effectiveHash": "828e2af6395f3e3bb05a0623f0e0a326219283377112b88bdfb8baaabc426677",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1269,7 +1254,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-repository/SKILL.md",
-        "effectiveHash": "34ae2569183f28cbc513af92d191bd69b522d619f0c9c6e6e1f2ded89481bcc6",
+        "effectiveHash": "f6c0d635694a618c3e9a5b8af54e227fd558413393e938f74d71b5339ba63327",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1299,7 +1284,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-router/SKILL.md",
-        "effectiveHash": "b17814592ca0e2dd1361752c3cb8bbb25d9cabbab462dcecaeff09ef4cec676c",
+        "effectiveHash": "12a7e5f108c4373978c446efd172dcabe1885af360bbaaea38d1cda4f22663b8",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1329,7 +1314,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-source-index/SKILL.md",
-        "effectiveHash": "b4e9e8b16950d1d130b3604594f148987a9503f65a566d50dd24af9732758ba3",
+        "effectiveHash": "3af070ade640dadca352aea92af770188f0675f1fa18dc397ba0bbdbe9a97841",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1445,41 +1430,11 @@
           ".trae/skills"
         ]
       },
-      "yss-valuation": {
-        "source": "project",
-        "sourceType": "local",
-        "skillPath": ".agents/skills/yss-valuation/SKILL.md",
-        "effectiveHash": "6c8f98a0ecc4035cd742e81be5d68bd22d25f55ce0a23e8c36d011affad33aee",
-        "targets": [
-          ".agents/skills",
-          ".claude/skills",
-          ".codex/skills",
-          ".hermes/skills",
-          ".pi/skills",
-          ".qoder/skills",
-          ".trae/skills"
-        ]
-      },
-      "yss-variable": {
-        "source": "project",
-        "sourceType": "local",
-        "skillPath": ".agents/skills/yss-variable/SKILL.md",
-        "effectiveHash": "5782e4f309a0a7cf92a01c054b42e9d2f05756187c5b9fc80d9645ab5fd10c09",
-        "targets": [
-          ".agents/skills",
-          ".claude/skills",
-          ".codex/skills",
-          ".hermes/skills",
-          ".pi/skills",
-          ".qoder/skills",
-          ".trae/skills"
-        ]
-      },
       "yss-web-controller": {
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-web-controller/SKILL.md",
-        "effectiveHash": "029da4cdfc87401abb2cfb7d1b0bcfa28d79faf0f78411c0725955b659bdb86b",
+        "effectiveHash": "9ee7c25b49bcbc41597ca6403dae16fecb1f4c3b74970e8b301d1eccdb3e59fc",
         "targets": [
           ".agents/skills",
           ".claude/skills",

package/template/wiki/wiki/YSS/345/267/245/347/250/213/346/212/200/350/203/275/344/275/223/347/263/273.md

@@ -2,7 +2,7 @@
 
 YSS skills 是项目内置的 YSS 工程规范技能，用于 DDD、UI、OpenAPI、Repository、Controller、DTO、组件和编码规范，与 Matt Pocock 的轻量流程技能互补（见 [[Matt技能体系]]）。
 
-按领域划分：后端脚手架（`yss-ddd-scaffold-generator` 及 Domain / Application / Infrastructure / Web / Adapter 分层技能）、领域建模（`yss-domain`）、持久层（`yss-repository`、`yss-mybatis`、`yss-db2mybatis`）、Web 契约（`yss-web-controller`、`yss-dto`、`yss-openapi-governance`、`yss-openapi-draft-review`）、前端（`yss-ui`、`yss-components`、`yss-formily`、`yss-hook`、`yss-page-module-development`、`api-integration`）、以及横切组件（`yss-cache`、`yss-exception`、`yss-log`、`yss-userinfo`、`yss-distributed-id`、`yss-security-algorithm`、`yss-resilience4j` 等）。
+按领域划分：后端脚手架（`yss-ddd-scaffold-generator` 及 Domain / Application / Infrastructure / Web / Adapter 分层技能）、领域建模（`yss-domain`）、持久层（`yss-repository`、`yss-mybatis`）、Web 契约（`yss-web-controller`、`yss-dto`、`yss-openapi-governance`、`yss-openapi-draft-review`）、前端（`yss-ui`、`yss-components`、`yss-formily`、`yss-hook`、`yss-page-module-development`、`api-integration`）、以及横切组件（`yss-cache`、`yss-exception`、`yss-log`、`yss-userinfo`、`yss-security-algorithm`、`yss-resilience4j` 等）。
 
 技能路由纪律：核心 YSS skills 必须消费批准合同并返回 YSS Skill Execution Result（见 [[切片实现合同]]）；路径越界、证据缺失、未执行验证、`drift`、`violation` 或 `new_impacts` 阻断继续实现或触发重路由。禁止绕过合同与检查清单直接在 `AGENTS.md` 中自行发明细则。
 

package/template/yss-public-skills.json

@@ -11,7 +11,6 @@
     "yss-backend-scaffold-web",
     "yss-cache",
     "yss-components",
-    "yss-db2mybatis",
     "yss-ddd-scaffold-generator",
     "yss-design-system",
     "yss-dictionary",
@@ -45,8 +44,6 @@
     "yss-use-tree-height",
     "yss-userinfo",
     "yss-validation",
-    "yss-valuation",
-    "yss-variable",
     "yss-web-controller"
   ],
   "groupings": [
@@ -68,7 +65,6 @@
         "yss-backend-scaffold-domain",
         "yss-backend-scaffold-infrastructure",
         "yss-backend-scaffold-web",
-        "yss-db2mybatis",
         "yss-ddd-scaffold-generator",
         "yss-domain",
         "yss-dto",
@@ -119,9 +115,7 @@
         "yss-taskflow",
         "yss-up-springboot3",
         "yss-userinfo",
-        "yss-validation",
-        "yss-valuation",
-        "yss-variable"
+        "yss-validation"
       ]
     },
     {

package/template.manifest.json

@@ -22,7 +22,9 @@
     ".codex/hooks.json",
     ".codex/settings.local.json",
     ".codex/skills/.DS_Store",
-    ".pi/settings.json"
+    ".pi/settings.json",
+    "docs/.scratch",
+    "docs/reviews"
   ],
   "renderPaths": [
     "AGENTS.md",

package/template.snapshot.json

@@ -3,14 +3,14 @@
   "templateName": "yss-spec-project-template",
   "templateSource": "github:iloveZzz/yss-spec-project-template",
   "templateRepository": "https://github.com/iloveZzz/yss-spec-project-template.git",
-  "requestedRef": "68c367a13d5006cca83f1c5e369678af28c4bf15",
-  "templateCommit": "68c367a13d5006cca83f1c5e369678af28c4bf15",
+  "requestedRef": "772758e064889829576d55fd20b17421d98982a8",
+  "templateCommit": "772758e064889829576d55fd20b17421d98982a8",
   "encodedPaths": {
     ".codex/skills/data-analytics/.gitignore": ".codex/skills/data-analytics/__yss_dotfile__.gitignore",
     ".codex/skills/product-design/.npmignore": ".codex/skills/product-design/__yss_dotfile__.npmignore",
     ".codex/skills/product-design/templates/prototype/.npmrc": ".codex/skills/product-design/templates/prototype/__yss_dotfile__.npmrc",
     ".gitignore": "__yss_dotfile__.gitignore"
   },
-  "snapshotHash": "f4276bfa8e6ca7781f905372d912f8fd9ba806566e212550b4548eda0f877387",
-  "generatedAt": "2026-08-17T12:35:54.519Z"
+  "snapshotHash": "75a23afd5b5fd4f063e133e7c397d537ad94db407826f480c138b7f9a912a6c1",
+  "generatedAt": "2026-08-18T08:42:21.882Z"
 }

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