create-yss-spec 2.1.4 → 2.1.6

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

@@ -1,11 +1,11 @@
 # yss-taskflow Source Index
 
-Generated: 2026-08-08T15:43:04+00:00
-Source commit: `a34644e2dfc4eb2bfa2b0a1c69dc6b61cc98539a`
+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.py`. Do not hand-edit generated sections.
+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.
 

package/template/.trae/skills/yss-ui/references/frontend-docs.md

@@ -1,6 +1,6 @@
 # yss-ui Frontend Documentation
 
-Generated: 2026-06-29T16:11:14+00:00
+Generated: 2026-08-17T12:03:37.436Z
 
 Use these YSS UI documentation entry points as authoritative references when local repo examples are insufficient.
 

package/template/.trae/skills/yss-use-table-height/references/frontend-docs.md

@@ -1,6 +1,6 @@
 # yss-use-table-height Frontend Documentation
 
-Generated: 2026-06-29T16:11:14+00:00
+Generated: 2026-08-17T12:03:37.436Z
 
 Use these YSS UI documentation entry points as authoritative references when local repo examples are insufficient.
 

package/template/.trae/skills/yss-use-tree-height/references/frontend-docs.md

@@ -1,6 +1,6 @@
 # yss-use-tree-height Frontend Documentation
 
-Generated: 2026-06-29T16:11:14+00:00
+Generated: 2026-08-17T12:03:37.436Z
 
 Use these YSS UI documentation entry points as authoritative references when local repo examples are insufficient.
 

package/template/.trae/skills/yss-userinfo/references/source-index.md

@@ -1,11 +1,11 @@
 # yss-userinfo Source Index
 
-Generated: 2026-08-08T15:43:04+00:00
-Source commit: `a34644e2dfc4eb2bfa2b0a1c69dc6b61cc98539a`
+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.py`. Do not hand-edit generated sections.
+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.
 

package/template/.trae/skills/yss-validation/references/source-index.md

@@ -1,17 +1,17 @@
 # yss-validation Source Index
 
-Generated: 2026-08-08T15:43:04+00:00
-Source commit: `a34644e2dfc4eb2bfa2b0a1c69dc6b61cc98539a`
+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.py`. Do not hand-edit generated sections.
+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-validation-engine-parent` (existed when indexed)
+- `yss-microservice-components/yss-component-validation-engine-parent` (missing when indexed)
 - `yss-microservice-components/yss-component-validation-jsr303` (existed when indexed)
 
 ## Documentation Files
@@ -20,30 +20,11 @@ Paths below are source path hints captured at refresh time. If they do not exist
 
 ## Maven Modules
 
-- `yss-microservice-components/yss-component-validation-engine-parent`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser`
 - `yss-microservice-components/yss-component-validation-jsr303`
 
 ## Key Java Entry Points
 
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/bean/Properties.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/enums/ExpressParserEnum.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/base/AbstractAndOrNotExpressParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/base/AbstractExpressParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/base/AbstractLoopExpressParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/base/ExpressParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/el/AndOrConditionParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/el/CatchConditionParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/el/ForConditionParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/el/IfConditionParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/el/NotConditionParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/el/SwitchConditionParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/el/ThenConditionParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/el/WhenConditionParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/el/WhileConditionParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/factory/ExpressParserFactory.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/generator/ExpressGenerator.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/selector/ParserSelector.java`
+- No key Java entry points matched the configured name patterns.
 
 ## Recommended Next Reads
 

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

@@ -1,11 +1,11 @@
 # yss-valuation Source Index
 
-Generated: 2026-08-08T15:43:04+00:00
-Source commit: `a34644e2dfc4eb2bfa2b0a1c69dc6b61cc98539a`
+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.py`. Do not hand-edit generated sections.
+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.
 

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

@@ -1,17 +1,17 @@
 # yss-variable Source Index
 
-Generated: 2026-08-08T15:43:04+00:00
-Source commit: `a34644e2dfc4eb2bfa2b0a1c69dc6b61cc98539a`
+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.py`. Do not hand-edit generated sections.
+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` (existed when indexed)
+- `yss-microservice-components/yss-component-variable` (missing when indexed)
 
 ## Documentation Files
 
@@ -19,39 +19,11 @@ Paths below are source path hints captured at refresh time. If they do not exist
 
 ## Maven Modules
 
-- `yss-microservice-components/yss-component-variable`
+- No Maven modules found.
 
 ## Key Java Entry Points
 
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/common/AuthorWriteHandler.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/common/DataListener.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/common/ResultCode.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/common/YssApiResult.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/common/util/SqlWildcardTransformUtil.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/controller/VarNameSpaceController.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/controller/VariableController.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/PageDto.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/namespace/PageNameSpaceReq.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/task/TaskResp.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/task/TaskStatusResp.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/Excel.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableCopyOrMoveReq.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableCopyOrMoveResp.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableDefinitionReq.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableFindPageReq.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableImportErrorResp.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableListResp.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableReq.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableResp.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/entity/OperUserDo.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/entity/Task.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/entity/Variable.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/enums/UserFlagEnum.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/enums/VarTypeEnum.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/mapper/VarNameSpaceMapper.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/mapper/VariableMapper.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/service/VariableService.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/service/impl/VariableServiceImpl.java`
+- No key Java entry points matched the configured name patterns.
 
 ## Recommended Next Reads
 

package/template/.trae/skills/yss-web-controller/SKILL.md

@@ -5,7 +5,7 @@ description: Use when generating or refactoring YSS Web Adapter Controllers, req
 
 # yss-web-controller
 
-这是一个 Web 适配层生成型 skill。优先复用脚本 `scripts/generate_controller.py` 和模板，不手写重复 CRUD。
+这是一个 Web 适配层生成型 skill。优先复用脚本 `scripts/generate_controller.mjs` 和模板，不手写重复 CRUD。
 
 ## 何时使用
 
@@ -23,14 +23,14 @@ description: Use when generating or refactoring YSS Web Adapter Controllers, req
 1. 先确认冻结 OpenAPI/no-impact record、Application Service 接口、metadata、基础包、模块名、领域 segment、domain/web 落盘目录。
 2. 涉及 DTO / VO / CMD / Query POJO 样板代码时，加载并遵守 `lombok`。
 3. 涉及 Domain / Application Result 到 VO / DTO 或 CMD / Query 到输入模型的转换时，加载并遵守 `mapstruct`。
-4. 运行 `scripts/generate_controller.py`。
+4. 运行 `node scripts/generate_controller.mjs`。
 5. 生成后检查路径、命名、返回值包装、Application Service 引用、`@Valid`、Lombok 注解和 MapStruct WebConvertor 是否对齐项目。
 6. 对复杂接口做少量手工修正，不在 skill 中承诺自动覆盖全部业务逻辑。
 
 ## 推荐命令
 
 ```bash
-python3 scripts/generate_controller.py \
+node scripts/generate_controller.mjs \
   --metadata-file /path/metadata.json \
   --base-package com.yss.demo \
   --module-name demo \
@@ -63,7 +63,7 @@ python3 scripts/generate_controller.py \
 
 ## 按需读取
 
-- 生成脚本：`scripts/generate_controller.py`
+- 生成脚本：`scripts/generate_controller.mjs`
 - Controller 模板：`assets/templates/Controller.java.template`
 - Convertor 模板：`assets/templates/WebConvertor.java.template`
 - POJO 样板代码：`lombok`

package/template/.trae/skills/yss-web-controller/scripts/generate_controller.mjs

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const TYPE_MAPPING = { bigint: "Long", int: "Integer", integer: "Integer", smallint: "Integer", tinyint: "Integer", number: "Long", numeric: "BigDecimal", decimal: "BigDecimal", float: "Float", double: "Double", real: "Float", varchar: "String", varchar2: "String", nvarchar2: "String", char: "String", nchar: "String", text: "String", clob: "String", nclob: "String", date: "LocalDateTime", datetime: "LocalDateTime", timestamp: "LocalDateTime", "timestamp with time zone": "LocalDateTime", boolean: "Boolean", bool: "Boolean", bit: "Boolean", json: "String", jsonb: "String", uuid: "String" };
+const required = ["metadata-file", "base-package", "module-name", "domain-segment"];
+const valued = new Set([...required, "output-dir", "domain-project-dir", "web-project-dir", "domain-output-dir", "web-output-dir", "author", "application-service-package", "validation-namespace"]);
+
+function usage() {
+  return "Usage: node generate_controller.mjs --metadata-file FILE --base-package PACKAGE --module-name NAME --domain-segment SEGMENT [--output-dir DIR] [--domain-project-dir DIR] [--web-project-dir DIR] [--domain-output-dir DIR] [--web-output-dir DIR] [--author NAME] [--force] [--application-service-package PACKAGE] [--validation-namespace javax|jakarta]";
+}
+export function parseArgs(argv) {
+  const args = { "output-dir": "./output", author: "System", "validation-namespace": "javax", force: false };
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
+    if (token === "--help" || token === "-h") return { help: true };
+    if (token === "--force") { args.force = true; continue; }
+    if (!token.startsWith("--") || !valued.has(token.slice(2))) throw new Error(`unrecognized argument: ${token}`);
+    const value = argv[++index];
+    if (!value || value.startsWith("--")) throw new Error(`argument ${token} requires a value`);
+    args[token.slice(2)] = value;
+  }
+  for (const key of required) if (!args[key]) throw new Error(`the following arguments are required: --${key}`);
+  if (!new Set(["javax", "jakarta"]).has(args["validation-namespace"])) throw new Error("--validation-namespace must be javax or jakarta");
+  return args;
+}
+const pascal = (value) => value.toLowerCase().split("_").map((part) => part ? part[0].toUpperCase() + part.slice(1) : "").join("");
+const lowerCamel = (value) => { const output = pascal(value); return output ? output[0].toLowerCase() + output.slice(1) : ""; };
+const kebab = (value) => value.toLowerCase().replaceAll("_", "-");
+const packagePath = (value) => value.replaceAll(".", path.sep);
+const ensureSubdir = (root, name) => path.basename(path.normalize(root)) === name ? root : path.join(root, name);
+const javaType = (sqlType = "") => TYPE_MAPPING[sqlType.toLowerCase().split("(")[0]] || "String";
+
+function fields(columns, { skipPk = false, command = false, skipAudit = true } = {}) {
+  const audit = new Set(["create_time", "update_time", "create_by", "update_by", "deleted", "version"]);
+  return columns.filter((column) => !(skipPk && column.primary) && !(skipAudit && audit.has(String(column.name).toLowerCase()))).map((column) => {
+    const type = javaType(column.sql_type);
+    const name = lowerCamel(column.name);
+    const comment = column.comment || "";
+    const documentation = comment ? `    /**\n     * ${comment}\n     */\n` : "";
+    const validation = command && !column.nullable ? `    @${type === "String" ? "NotBlank" : "NotNull"}(message = \"${comment || name}不能为空\")\n` : "";
+    return `${documentation}${validation}    private ${type} ${name};`;
+  }).join("\n\n");
+}
+function render(template, context) { return template.replace(/\$(?:\{([A-Za-z_][A-Za-z0-9_]*)\}|([A-Za-z_][A-Za-z0-9_]*))/g, (_, braced, plain) => { const key = braced || plain; if (!(key in context)) throw new Error(`missing template field: ${key}`); return context[key]; }); }
+async function exists(target) { try { await access(target); return true; } catch { return false; } }
+
+export async function generate(args, logger = console) {
+  if (!await exists(args["metadata-file"])) throw new Error(`Metadata file not found: ${args["metadata-file"]}`);
+  let metadata;
+  try { metadata = JSON.parse(await readFile(args["metadata-file"], "utf8")); } catch (error) { throw new Error(`Error reading metadata file: ${error.message}`); }
+  const tables = metadata.tables || [];
+  if (!tables.length) { logger.warn("Warning: No tables found in metadata."); return []; }
+  const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+  const templatesDir = path.resolve(scriptDir, "../assets/templates");
+  const template = async (name) => { const target = path.join(templatesDir, name); if (!await exists(target)) throw new Error(`Template not found: ${target}`); return readFile(target, "utf8"); };
+  const templates = Object.fromEntries(await Promise.all(["Controller.java.template", "WebConvertor.java.template", "domain/vo/VO.java.template", "domain/dto/cmd/AddCmd.java.template", "domain/dto/cmd/UpdateCmd.java.template", "domain/dto/query/PageQuery.java.template"].map(async (name) => [name, await template(name)])));
+  const basePath = packagePath(args["base-package"]);
+  const domainBase = args["domain-output-dir"] || (args["domain-project-dir"] ? path.join(args["domain-project-dir"], "src", "main", "java", basePath) : path.join(args["output-dir"], basePath));
+  const webBase = args["web-output-dir"] || (args["web-project-dir"] ? path.join(args["web-project-dir"], "src", "main", "java", basePath) : path.join(args["output-dir"], basePath));
+  const domainRoot = ensureSubdir(domainBase, "client");
+  const webRoot = ensureSubdir(webBase, "rest");
+  const written = [];
+  const write = async (target, contents) => { await mkdir(path.dirname(target), { recursive: true }); if (!await exists(target) || args.force) { await writeFile(target, contents, "utf8"); logger.log(`Generated: ${target}`); written.push(target); } else logger.log(`Skipped (exists): ${target}`); };
+  for (const table of tables) {
+    const domainClass = pascal(table.table_name); const domainVar = lowerCamel(table.table_name); const domainDesc = String(table.table_comment || domainClass).trim().replaceAll("\n", " ");
+    const applicationPackage = args["application-service-package"] || `${args["base-package"]}.application.service`;
+    const context = { base_package: args["base-package"], module_name: args["module-name"], domain_class: domainClass, domain_var: domainVar, domain_desc: domainDesc, domain_url_path: kebab(table.table_name), domain_pkg_name: args["domain-segment"], author: args.author, dto_imports: [`import ${args["base-package"]}.client.dto.cmd.${domainClass}AddCmd;`, `import ${args["base-package"]}.client.dto.cmd.${domainClass}UpdateCmd;`, `import ${args["base-package"]}.client.dto.query.${domainClass}PageQuery;`, `import ${args["base-package"]}.client.vo.${domainClass}VO;`].join("\n"), application_service_import: `import ${applicationPackage}.${domainClass}Service;`, domain_import: `import ${args["base-package"]}.domain.${args["domain-segment"]}.model.${domainClass};`, web_convertor_import: `import ${args["base-package"]}.rest.convertor.${domainClass}WebConvertor;`, web_convertor_class: `${domainClass}WebConvertor`, application_service_field: `private final ${domainClass}Service ${domainVar}Service;`, query_call: `${domainVar}Service.page(query)`, detail_call: `${domainVar}Service.detail(id)`, add_call: `${domainVar}Service.add(cmd)`, update_call: `${domainVar}Service.update(cmd)`, delete_call: `${domainVar}Service.delete(id)`, vo_class: `${domainClass}VO`, add_cmd_class: `${domainClass}AddCmd`, update_cmd_class: `${domainClass}UpdateCmd`, query_class: `${domainClass}PageQuery`, validation_namespace: args["validation-namespace"] };
+    await write(path.join(webRoot, `${domainClass}Controller.java`), render(templates["Controller.java.template"], context));
+    await write(path.join(webRoot, "convertor", `${domainClass}WebConvertor.java`), render(templates["WebConvertor.java.template"], context));
+    for (const [templateName, target, declaration] of [["domain/vo/VO.java.template", path.join(domainRoot, "vo", `${domainClass}VO.java`), fields(table.columns || [], { skipAudit: false })], ["domain/dto/cmd/AddCmd.java.template", path.join(domainRoot, "dto/cmd", `${domainClass}AddCmd.java`), fields(table.columns || [], { skipPk: true, command: true })], ["domain/dto/cmd/UpdateCmd.java.template", path.join(domainRoot, "dto/cmd", `${domainClass}UpdateCmd.java`), fields(table.columns || [], { command: true })], ["domain/dto/query/PageQuery.java.template", path.join(domainRoot, "dto/query", `${domainClass}PageQuery.java`), fields(table.columns || [])]]) await write(target, render(templates[templateName], { ...context, field_declarations: declaration }));
+  }
+  return written;
+}
+async function main() { try { const args = parseArgs(process.argv.slice(2)); if (args.help) { console.log(usage()); return; } await generate(args); } catch (error) { console.error(`Error: ${error.message}`); process.exitCode = 1; } }
+if (process.argv[1] === fileURLToPath(import.meta.url)) await main();

package/template/.trae/skills/yss-web-controller/scripts/generate_controller.test.mjs

@@ -0,0 +1,19 @@
+import assert from "node:assert/strict";
+import { mkdtemp, readFile, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import test from "node:test";
+import { generate, parseArgs } from "./generate_controller.mjs";
+
+test("generates application-service controller with requested validation profile", async () => {
+  const root = await mkdtemp(path.join(tmpdir(), "yss-controller-"));
+  const metadata = path.join(root, "metadata.json");
+  await writeFile(metadata, JSON.stringify({ tables: [{ table_name: "quality_rule", table_comment: "质量规则", columns: [{ name: "id", sql_type: "bigint", primary: true, nullable: false }, { name: "rule_name", sql_type: "varchar(64)", nullable: false }] }] }));
+  await generate(parseArgs(["--metadata-file", metadata, "--base-package", "com.yss.demo", "--module-name", "demo", "--domain-segment", "quality", "--output-dir", path.join(root, "out"), "--application-service-package", "com.yss.demo.application.service", "--validation-namespace", "jakarta"]), { log() {}, warn() {} });
+  const controller = await readFile(path.join(root, "out", "com", "yss", "demo", "rest", "QualityRuleController.java"), "utf8");
+  assert.match(controller, /import com\.yss\.demo\.application\.service\.QualityRuleService;/);
+  assert.match(controller, /import jakarta\.validation\.Valid;/);
+  assert.doesNotMatch(controller, /Gateway/);
+});
+
+test("rejects missing required CLI arguments", () => assert.throws(() => parseArgs(["--module-name", "demo"]), /required/));

package/template/AGENTS.md

@@ -104,7 +104,7 @@ README、用户指南和其他说明文档只引用或解释上述事实，不
 |---|---|
 | 技术事实、标准、第三方 API 或框架行为影响决策 | `research` 或等价的一手资料记录 |
 | 竞品、市场或用户口碑事实 | `competitive-intelligence` |
-| UI 设计、原型、组件或主题 | `yss-design-system` 后路由 `product-design:index`；产出前用 `antd` 查询 Ant Design v6 事实 |
+| UI 设计、原型、组件或主题 | `yss-design-system` 后使用 `yss-prototype-stage`；Codex 再路由 `product-design:index`，其他 Agent 交付等价合同资产；产出前后用 `antd` CLI 记录 Ant Design v6 与浏览器验证事实 |
 | Bug、测试失败或性能回退 | `diagnosing-bugs` 建立可复现反馈，再用 `tdd` |
 | merge / rebase 冲突 | `resolving-merge-conflicts` |
 | 架构治理、难测模块或深模块设计 | `improve-codebase-architecture` / `codebase-design` |

package/template/CONTEXT.md

@@ -55,6 +55,8 @@
 | 跨仓库契约变更 | 需要两个或多个独立仓库协同实现、验证和按顺序发布的共享契约变化。 | 任一参与仓库未完成契约对齐和集成验证时，不得单独声称整体可发布。 |
 | 模板源仓库（`template-source`） | 承载 `yss-spec-project-template` 权威模板资产及其演进规则的仓库身份。 | 只管理可复用模板，不承载某个具体产品的研发生命周期资产。 |
 | 模板实例仓库（`project-instance`） | 由模板初始化后生成、承载某个具体产品研发生命周期资产的仓库身份。 | 不作为通用流程模板的权威来源。 |
+| 模板实例分发面 | 模板源中应随 CLI 快照进入 `project-instance` 的共享生命周期、模板、用户指南和验证资产集合。 | 不包含模板源审查、研究、发布路线或源仓库专属 ADR。 |
+| 模板源治理区 | 仅供 `template-source` 使用、保存审查证据、研究记录、跨仓契约、发布路线和源仓库治理决策的归档区域。 | 不随 CLI 分发；不等于产品实例的研发管理资产。 |
 | 仓库身份清单 | 显式声明仓库身份和清单结构版本的机器可读资产。 | 不承载项目名称、团队规模、Tracker 或其他易变业务配置。 |
 
 只有在计划、分诊、调试或架构讨论中明确沉淀出稳定语言时，才新增术语。

package/template/README.md

@@ -106,10 +106,8 @@ scripts/verify-template
 | [docs/process/PDCA-SCRUM.md](./docs/process/PDCA-SCRUM.md) | PDCA × Scrum × AI |
 | [docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md](./docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md) | Matt Pocock Engineering Skills 集成与使用 |
 | [docs/process/lifecycle-registry.yaml](./docs/process/lifecycle-registry.yaml) | 生命周期结构事实源：主阶段、门禁、产物、工作单元、证据与稳定 ID |
-| [docs/process/harness-work-unit-map.md](./docs/process/harness-work-unit-map.md) | 由生命周期注册表派生的 Harness 工作单元地图 |
 | [docs/process/harness-process-tailoring.md](./docs/process/harness-process-tailoring.md) | 小改动 / 中等变更 / 新模块的流程裁剪指南 |
 | [docs/process/harness-executive-blueprint.md](./docs/process/harness-executive-blueprint.md) | 面向业务方和管理者的 Harness 一页式蓝图 |
-| [docs/process/harness-optimization-backlog.md](./docs/process/harness-optimization-backlog.md) | Harness 工程优化调整待办 |
 | [docs/process/implementation-repo-integration.md](./docs/process/implementation-repo-integration.md) | 外部前端 / 后端实现仓库接入与跨仓库切片绑定 |
 | [docs/agents/README.md](./docs/agents/README.md) | Agent 协作文档目录说明 |
 | [docs/agents/skills-maintenance.md](./docs/agents/skills-maintenance.md) | Agent skills 安装与维护 |

package/template/__yss_dotfile__.gitignore

@@ -36,21 +36,6 @@ htmlcov/
 Excalidraw
 .obsidian
 .ua
-docs/process/*
-!docs/process/
-!docs/process/templates/
-!docs/process/templates/stage-checkpoint-template.md
-!docs/process/lifecycle-artifact-map.md
-!docs/process/lifecycle-registry.yaml
-!docs/process/lifecycle-registry-baseline.json
-!docs/process/schemas/
-!docs/process/schemas/lifecycle-registry.schema.json
-!docs/process/harness-process-tailoring.md
-!docs/process/implementation-repo-integration.md
-!docs/process/subagent-collaboration.md
-!docs/process/PDCA-SCRUM.md
-!docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md
-!docs/process/harness-executive-blueprint.md
-!docs/process/harness-optimization-backlog.md
-!docs/process/harness-work-unit-map.md
+docs/process/presentations/
+docs/process/yss-product-lifecycle-team-guide.md
 docs/graphify-out

package/template/docs/adr/0001-product-design-prototype-entrypoint.md

@@ -48,7 +48,7 @@ YSS Harness 需要把有 UI 功能的产品原型产出收敛到一个稳定入
 ## 相关
 
 - `AGENTS.md`
-- `docs/process/product-prototype-workflow.md`
+- `docs/design/README.md`
 - `docs/process/lifecycle-artifact-map.md`
 - `docs/design/README.md`
 - `docs/design/templates/prototype-confirmation-template.md`

package/template/docs/agents/skills-maintenance.md

@@ -49,6 +49,8 @@
    scripts/verify-template
    ```
 
+   若模板维护引入或更新分发到实例的 Node 工具，先在 `.template-source/tooling/node/` 使用 `pnpm install --frozen-lockfile`，再运行 `pnpm build:vendor` 与 `pnpm check:vendor`；实例门禁不得安装依赖或重建 vendor。运行时、公开入口和跨仓回滚规则以 `.template-source/adr/0009-zero-install-node-tooling-runtime.md` 及对应契约为准。
+
 6. 需要重新加载技能的客户端在变更落地后重启或刷新项目。
 
 ## 单独检查

package/template/docs/architecture/README.md

@@ -17,16 +17,7 @@
 
 对于数据模型、元数据管理、ER 设计、版本管理或血缘分析类产品，数据架构是核心产品能力，必须在 Repository / MyBatis / 持久化开发前完成；如果 OpenAPI schema 依赖元模型，也必须在 OpenAPI Freeze 前完成。
 
-推荐配套图：
-
-```text
-docs/.scratch/<feature>/architecture/diagrams/<feature>-business-capability.excalidraw
-docs/.scratch/<feature>/architecture/diagrams/<feature>-functional-modules.excalidraw
-docs/.scratch/<feature>/architecture/diagrams/<feature>-system-architecture.excalidraw
-docs/.scratch/<feature>/architecture/diagrams/<feature>-data-model.excalidraw
-```
-
-使用 `excalidraw-diagram-generator` 生成图时，图只作为审查辅助；发现的问题必须回写到 Spec、OpenAPI、ADR、系统 / 数据架构设计 或对应架构文档。
+图表只作为审查辅助；发现的问题必须回写到 Spec、OpenAPI、ADR、系统 / 数据架构设计或对应架构文档。
 
 推荐模板：
 
@@ -61,14 +52,6 @@ delegate_task(
 )
 ```
 
-### 图表生成者
-```python
-delegate_task(
-    goal="使用 excalidraw-diagram-generator 生成架构图",
-    context="根据阶段选择：业务能力图/功能模块图/系统架构图/ER 图/血缘图/数据流图"
-)
-```
-
 ---
 
 ## 六维度审查清单 (39项)

package/template/docs/design/README.md

@@ -4,7 +4,7 @@
 
 设计系统基线：
 
-- `docs/design/design.md`：从本地 `Product-Design-System` 引入并整理的 Ant Design 企业级设计系统说明，后续页面设计、交互说明、原型评审和前端实现默认引用该文件。
+- `docs/design/design.md`：从本地 `Product-Design-System` 引入并整理的 Ant Design 企业级设计系统说明，后续页面设计、交互说明、原型评审和前端实现默认引用该文件；官方 `design.md` 是上游默认，项目 token 是项目覆盖，优先级以该文件为准。
 - `docs/design/tokens/`：随仓库保存的主题、亮色 / 暗色 / 紧凑 token 和 CSS 变量快照，后续实现不得依赖本机 Downloads 目录。
 
 产品原型产出默认以 `product-design:index` 为主入口。该 skill 只负责路由，实际按 Product Design plugin 规则进入 `$get-context`、`$ideate`、`$prototype`、`$image-to-code`、`$url-to-code`、`$share` 或 `$design-qa` 等 focused skill；YSS 生命周期仍负责校验低保真评审、高保真 HTML 原型、AntD CLI 校验证据、用户确认和 Spec / OpenAPI 回填。
@@ -16,7 +16,7 @@
 - 页面清单和信息架构。
 - 用户主路径和异常路径。
 - 低保真线框图，或 Figma / 即时设计 / Axure 等原型工具链接。
-- Excalidraw 流程图、泳道图、页面地图、状态流或架构辅助图。
+- 流程图、泳道图、页面地图、状态流或架构辅助图。
 - 表单、表格、弹窗、抽屉、步骤流等交互说明。
 - loading、empty、error、readonly、disabled、no-permission、conflict 等状态矩阵。
 - 页面字段、筛选条件、操作按钮和权限规则。
@@ -31,16 +31,17 @@
 - `docs/design/templates/state-matrix-template.md`：loading、empty、error、readonly、no-permission、conflict 等状态。
 - `docs/design/templates/prototype-review-checklist.md`：进入 Spec 校准 / API 影响分析 / 契约草案前的原型评审门禁。
 - `docs/design/templates/prototype-confirmation-template.md`：高保真 HTML 原型产出后的用户确认记录。
+- `docs/design/templates/prototype-evidence-template.yaml`：原型阶段的 AntD CLI、浏览器验证、评审和确认的机器可读证据清单。
 
 推荐技能：
 
 - `yss-design-system`：项目设计系统与 Ant Design 企业级 UI 风格基线；页面设计、原型评审、UI 实现和主题 token 落地时默认先引用。
-- `product-design:index`：产品原型产出的主路由；根据输入是否有 URL、截图、Figma、代码目标或视觉方向，进入 `$get-context`、`$ideate`、`$prototype`、`$image-to-code`、`$url-to-code`、`$share` 或 `$design-qa` 等 focused skill。
+- `yss-prototype-stage`：跨 Agent 的原型阶段合同，固定资产、证据、设计优先级与生命周期回流；Codex 的主路由为 `product-design:index`。
+- `product-design:index`：Codex 产品原型产出的主路由；根据输入是否有 URL、截图、Figma、代码目标或视觉方向，进入 `$get-context`、`$ideate`、`$prototype`、`$image-to-code`、`$url-to-code`、`$share` 或 `$design-qa` 等 focused skill。
 - Product Design focused skills：基于 Spec 初稿和产品总体设计 / 功能架构，产出低保真 / 高保真页面、原型、交互设计资产和可分享原型；高保真 HTML 原型默认由该路由链路产出。
 - `antd`：Ant Design v6 组件、demo、token、semantic 和 design.md 查询工具；生成或修改高保真 HTML 原型前后必须留下 CLI 校验证据。
 - `prototype-review`：原型阶段评审门禁；未通过则不要进入 Spec 校准 / API 影响分析 / 契约草案。
 - 兼容入口：`product-design-prototype`、`wireframe-prototype`、`high-fidelity-html-prototype` 仅作为历史兼容或产物门禁名称保留；新的产品原型产出默认使用 `product-design:index`。
-- `excalidraw-diagram-generator`：根据已形成的 Discovery、Spec、OpenAPI Draft、Architecture 或 系统 / 数据架构设计 生成 `.excalidraw` 图；用于说明和审查，不替代文本规格。
 
 推荐目录：
 

package/template/docs/design/design.md

@@ -19,6 +19,10 @@
 
 结论：这不是营销型视觉系统，而是面向中后台、数据密集、表单密集、流程密集产品的 Ant Design 风格企业级设计系统。项目内 UI 默认应以“清晰、确定、低装饰、可扫描、高一致性”为目标。
 
+## 原型设计依据的优先级
+
+原型使用 Ant Design 时，`https://ant.design/design.md` 与官方 `antd` CLI 提供的是**上游默认**和组件事实；项目的 `docs/design/design.md`、`docs/design/tokens/*` 是经过确认的**项目覆盖**。当前功能只能在这两层之下完成语义组件映射。若上游默认与项目 token 不同，以项目覆盖为准，并在 `prototype-evidence.yaml` 中记录差异；不得把上游默认直接写回项目实现。
+
 ## 设计原则
 
 本项目采用该设计系统时，优先遵循四个原则：

package/template/docs/design/templates/interaction-spec-template.md

@@ -10,10 +10,10 @@
 | 产品总体设计 / 功能架构 | `docs/.scratch/<feature>/design/<feature>-product-overview-design.md` | 必需；缺失时先返回产品总体设计阶段 |
 | 领域术语 | `CONTEXT.md` | 核心名词、状态和业务规则 |
 | Discovery | `docs/.scratch/<feature>/discovery/<feature>-discovery.md` | 可选 |
-| Product Design 路由 | `product-design:index -> <focused skill>` | 必需；记录 `$get-context`、`$ideate`、`$prototype`、`$image-to-code` 或 `$url-to-code` |
+| 原型阶段合同 / Product Design 路由 | `yss-prototype-stage -> product-design:index -> <focused skill>` | 必需；记录 `$get-context`、`$ideate`、`$prototype`、`$image-to-code` 或 `$url-to-code` |
 | 原型 / 线框图 | `<链接或导出图片路径>` | Excalidraw / Figma / Penpot / tldraw / Axure / Markdown |
 | 高保真 HTML 原型 | `docs/.scratch/<feature>/design/prototypes/index.html` | 低保真原型评审通过后补齐；必须使用 Ant Design v6；可由系统 / Agent 自动产出；产出后必须获得用户确认 |
-| AntD CLI 校验证据 | `<命令输出或记录路径>` | `antd design.md/info/demo/token/semantic --version 6.0.0 --format json` |
+| 原型验证清单 | `docs/.scratch/<feature>/verification/prototype-evidence.yaml` | 记录实际 CLI / AntD 版本、CLI JSON 输出、浏览器验证和阻塞项 |
 | 现有 API 草案 | `docs/.scratch/<feature>/api/<feature>.yaml` | 可选；通常应先完成产品设计和 Spec 校准 |
 
 ## 2. 页面地图
@@ -106,7 +106,7 @@
 - 每个表格列、筛选条件、表单字段、抽屉、弹窗和按钮都有数据来源或契约反推说明。
 - 设计可以拆成独立可演示的垂直切片。
 - 低保真原型评审通过后，高保真 HTML 原型使用 Ant Design v6 覆盖主流程、关键状态和响应式断点。
-- 原型产出前已使用 `antd` CLI 查询设计语言、组件 API、demo、token 和 semantic 信息；原型产出后已记录 AntD v6 校验证据。
+- 原型产出前已使用 `antd` CLI 查询设计语言、组件 API、demo、token 和 semantic 信息；原型产出后已在 `prototype-evidence.yaml` 记录实际版本、CLI 与浏览器验证证据。
 
 ## 9. 决策与未决问题
 

package/template/docs/design/templates/prototype-confirmation-template.md

@@ -13,21 +13,24 @@
 | 状态矩阵 | `docs/.scratch/<feature>/design/<feature>-state-matrix.md` |
 | 原型评审 | `docs/.scratch/<feature>/design/<feature>-prototype-review.md` |
 | 高保真 HTML 原型 | `docs/.scratch/<feature>/design/prototypes/index.html` |
+| 机器可读验证清单 | `docs/.scratch/<feature>/verification/prototype-evidence.yaml` |
 | Product Design 路由 | `product-design:index -> <focused skill>` |
 | 产出方式 | 系统 / Agent 自动产出 / 人工补充 |
-| Ant Design 版本 | v6 |
+| Ant Design 目标版本 | `<实际项目选择的 v6 版本>` |
 
 ## 2. AntD CLI 校验证据
 
 | 校验项 | 命令 / 记录路径 | 结论 |
 |---|---|---|
-| 设计语言 | `antd design.md --version 6.0.0 --format json` |  |
-| 组件 API | `antd info <Component> --version 6.0.0 --format json` |  |
-| 组件 demo | `antd demo <Component> <demo> --version 6.0.0 --format json` |  |
-| 组件 token | `antd token <Component> --version 6.0.0 --format json` |  |
-| semantic | `antd semantic <Component> --version 6.0.0 --format json` |  |
+| 设计语言 | `antd design.md --format json` |  |
+| 组件 API | `antd info <Component> --version <target_antd_version> --format json` |  |
+| 组件 demo | `antd demo <Component> <demo> --version <target_antd_version> --format json` |  |
+| 组件 token | `antd token <Component> --version <target_antd_version> --format json` |  |
+| semantic | `antd semantic <Component> --version <target_antd_version> --format json` |  |
 | lint / 替代校验 | `antd lint <prototype path> --format json` |  |
 
+CLI 实际版本、目标 AntD 版本、完整 JSON 输出与浏览器验证结论以 `prototype-evidence.yaml` 为准；不得用本文中的示例版本替代实际记录。
+
 ## 3. 用户确认
 
 | 项目 | 内容 |

package/template/docs/design/templates/prototype-evidence-template.yaml

@@ -0,0 +1,46 @@
+# 复制到 docs/.scratch/<feature>/verification/prototype-evidence.yaml。
+# 本文件是原型验证证据清单；命令输出、截图和审查记录可存为相邻文件并由路径引用。
+schema_version: 1
+feature: <feature>
+prototype_ref: docs/.scratch/<feature>/design/prototypes/index.html
+design_baseline:
+  project_design_ref: docs/design/design.md
+  project_token_refs: []
+  upstream_design_md_source: https://ant.design/design.md
+  upstream_design_md_record_ref: <path-to-json-output-or-summary>
+  project_override_reviewed: false
+antd:
+  cli_command: antd
+  cli_version: <actual-cli-version>
+  target_antd_version: <project-selected-v6-version>
+  queries:
+    design_md: <path-to-json-output>
+    components:
+      - component: <Component>
+        info_ref: <path-to-json-output>
+        demo_ref: <path-to-json-output>
+        token_ref: <path-to-json-output>
+        semantic_ref: <path-to-json-output>
+  lint_ref: <path-to-json-output>
+  lint_passed: false
+browser_verification:
+  executor: <browser-or-automation-name>
+  rendered_nonblank: false
+  prototype_digest: <sha256-or-version-ref>
+  viewports:
+    - name: desktop
+      size: <width>x<height>
+      result: pending
+    - name: narrow-mobile
+      size: <width>x<height>
+      result: pending
+  main_flow_result: pending
+  failure_permission_or_conflict_result: pending
+  console_error_ref: <path-to-console-output-or-none>
+review:
+  prototype_review_ref: docs/.scratch/<feature>/design/<feature>-prototype-review.md
+  result: pending
+user_confirmation:
+  confirmation_ref: docs/.scratch/<feature>/design/<feature>-prototype-confirmation.md
+  result: pending
+blockers: []