create-yss-spec 2.2.10 → 3.0.1

package/template/.hermes/skills/yss-up-springboot3/SKILL.md

@@ -1,40 +0,0 @@
----
-name: yss-up-springboot3
-description: Use when YSS Spring Boot 3 / Spring Cloud 升级辅助技能。Use when auditing or migrating YSS backend services/components from Spring Boot 2.x or Spring Cloud 2021-era dependencies toward Spring Boot 3, Jakarta namespace, newer Spring Security, MyBatis, OpenFeign, gateway, validation, and related compatibility changes.
----
-
-# yss-up-springboot3
-
-Use this skill for YSS backend upgrade analysis and migration tasks around Spring Boot 3 / Spring Cloud compatibility.
-
-中文说明：这个技能是升级核查入口，不替代具体组件技能。遇到缓存、审计、MyBatis、DTO、Excel、JDBC 等组件细节时，应同时读取对应专项技能和源码索引。
-
-## When To Use
-
-- The user asks to upgrade YSS backend code to Spring Boot 3 or newer Spring Cloud baselines.
-- The task mentions `javax.*` to `jakarta.*`, Spring Security migration, validation changes, Servlet API changes, Gateway/OpenFeign compatibility, or dependency BOM changes.
-- The task involves checking whether a YSS component can run on Spring Boot 3.
-
-## Workflow
-
-1. Identify affected modules and current dependency versions from the local repository.
-2. Check for Jakarta namespace changes (`javax.servlet`, `javax.validation`, `javax.annotation`, JPA APIs, and related imports).
-3. Check Spring Security configuration style, deprecated adapters, authorization server dependencies, and filter registration behavior.
-4. Check component-specific integration by loading specialist skills such as `yss-mybatis`, `yss-dto`, `yss-cache`, `yss-audit-log`, `yss-excel-mvc`, or `yss-jdbc`.
-5. Prefer source-backed evidence from the local workspace or a source root resolved via `yss-source-index/references/source-location.md` before recommending code changes.
-6. Produce an upgrade checklist or patch with explicit compatibility risks and verification commands.
-
-## Common Checks
-
-- Maven BOM and plugin versions are aligned before changing code.
-- `javax.*` imports are migrated only where the target framework expects Jakarta APIs.
-- Spring Security configuration no longer depends on removed `WebSecurityConfigurerAdapter` patterns.
-- Validation annotations and exception handlers still map to the expected DTO/Result contract.
-- MyBatis interceptors, auto configurations, and starter metadata are compatible with Spring Boot 3 auto-configuration loading.
-- Tests or sample modules are updated together with framework code.
-
-## Do Not
-
-- Do not blindly rewrite all `javax.*` imports without checking whether the dependency still uses the old namespace.
-- Do not mix unrelated business refactors into migration patches.
-- Do not assume component compatibility from memory; inspect source and specialist skill indexes.

package/template/.hermes/skills/yss-up-springboot3/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "YSS Spring Boot 3 Upgrade"
-  short_description: "YSS 后端 Spring Boot 3 升级核查"
-  default_prompt: "Use $yss-up-springboot3 to audit a YSS backend module for Spring Boot 3 compatibility."

package/template/.hermes/skills/yss-use-table-height/SKILL.md

@@ -1,130 +0,0 @@
----
-name: yss-use-table-height
-description: 指导 YTable、YEditTable、左树右表、分页列表、工具栏表格和弹窗/抽屉内表格使用 @yss-ui/hooks 的 useTableHeight 实现稳定自适应高度；当需要避免双滚动条、底部空白、容器撑开闪烁，或需要计入分页、工具栏、添加按钮偏移时使用。
----
-
-# useTableHeight 使用
-
-## 触发条件
-
-- YTable/YEditTable 需要自适应滚动高度，或页面出现双滚动条、底部空白和容器撑开闪烁。
-- 表格内含分页、工具栏、添加按钮，或位于弹窗/抽屉/shrink-wrap 容器内。
-
-## 不适用场景
-
-- 纯短表且页面不需要独立滚动区。
-- 当前布局组件已完整托管表格高度，且没有内部偏移需要扣减。
-
-## 实施流程
-
-1. MCP 可用时，先用 `get_component_docs` 精确查询 `useTableHeight`，需要示例时再调用 `get_demo`；不要仅凭 Skill 中的静态签名推断当前 API。
-2. 精确查询无结果时，先用 `search_docs` 校正名称；仅在 MCP 不可用、调用失败或仍无结果时，回退读取最新 `llms-full.txt`。文档版本与当前依赖不一致时，再核对 Hook 源码、CodeGraph 和真实导出。
-3. 先确认容器是稳定 flex 区域还是被表格内容撑开的 shrink-wrap 区域。
-4. 盘点表格内部实际开启的分页、工具栏、YEditTable 添加按钮和额外 padding。
-5. 把受约束的容器 `ref` 传给 Hook，将 `tableHeight` 绑定到表格 `height`。
-6. 在弹窗/抽屉动画结束或布局切换后视情况调用 `recalculateHeight()` 验证最终高度。
-
-## 硬约束（禁止/必须）
-
-- 使用真实签名 `useTableHeight(tableAreaRef, options)` 和真实返回值 `tableHeight/isReady/recalculateHeight`。
-- `tableAreaRef` 支持原生 DOM 或 Vue 组件实例（如 `YCard`）。绑定 DOM 时使用表格的直接父容器；绑定 Card 时 Hook 会尝试获取 `.ant-card-body`。
-- 稳定布局使用“外层可计算高度 + flex column，表格区 `flex: 1; min-height: 0; overflow: hidden`”。禁止用大常量高度替代 Hook。
-- YTable 开启 `pageable` 时设置 `withPagination: true`；开启 `toolbarConfig.custom` 或工具栏插槽时设置 `withToolbar: true`；YEditTable 显示 `addable` 按钮时设置 `withAddButton: true`。
-- 默认偏移常量分别是分页 48px、工具栏 48px、添加按钮 40px；只在实际样式不同时使用 `paginationHeight/toolbarHeight/addButtonHeight` 覆盖。
-- 把结果绑定到 `YTable/YEditTable` 的 `:height="tableHeight"`，不只设置 `max-height`。
-- 直属容器由表格内容撑开时，不要观察该容器形成“子元素改变父高度、父高度又改变子元素”循环；传入更外层稳定容器 `boundaryRef`，并用 `extraOffset` 扣除边界内其他区域。
-- Hook 已用 `ResizeObserver` 监听容器尺寸。不强制为每个弹窗/抽屉写 watch；只在动画或隐藏初始化导致高度不准时，于可见后 `nextTick(recalculateHeight)`。
-
-## 标准代码骨架
-
-```vue
-<script setup lang="ts">
-import { ref } from 'vue';
-import { YTable, type YTableColumn } from '@yss-ui/components';
-import { useTableHeight } from '@yss-ui/hooks';
-
-const tableAreaRef = ref<HTMLDivElement>();
-const dataList = ref<Array<{ id: string; name: string }>>([]);
-const columns: YTableColumn[] = [
-  { type: 'seq', title: '序号', width: 70 },
-  { field: 'name', title: '名称', minWidth: 180 },
-];
-const { tableHeight, isReady, recalculateHeight } = useTableHeight(tableAreaRef, {
-  withPagination: true,
-  withToolbar: true,
-});
-</script>
-
-<template>
-  <div class="page">
-    <div ref="tableAreaRef" class="table-area">
-      <YTable
-        v-if="isReady"
-        :height="tableHeight"
-        :data="dataList"
-        :columns="columns"
-        :toolbar-config="{ custom: true }"
-        pageable
-      />
-    </div>
-  </div>
-</template>
-
-<style scoped lang="less">
-@import './style.less';
-</style>
-```
-
-```less
-/* style.less */
-.page {
-  height: 100%;
-  display: flex;
-  flex-direction: column;
-}
-
-.table-area {
-  flex: 1;
-  min-height: 0;
-  overflow: hidden;
-}
-```
-
-## shrink-wrap 容器
-
-```typescript
-const tableAreaRef = ref<HTMLDivElement>();
-const boundaryRef = ref<HTMLDivElement>();
-
-const { tableHeight } = useTableHeight(tableAreaRef, {
-  boundaryRef,
-});
-```
-
-`extraOffset` 必须来自可说明的实际布局占位；如果区域高度会变，优先改成稳定 flex 布局，不固定一个近似大数。
-
-## 弹层可见后补算
-
-```typescript
-import { nextTick } from 'vue';
-
-/** 弹层完全展开后重算表格高度。 */
-const handleAfterOpenChange = async (open: boolean) => {
-  if (!open) return;
-  await nextTick();
-  recalculateHeight();
-};
-```
-
-## 交付检查清单
-
-- [ ] 观察容器具有稳定高度，需要时已使用 `boundaryRef`。
-- [ ] 分页、工具栏、添加按钮的偏移与实际开关一致，未重复扣减。
-- [ ] 表格绑定 `height`，容器有 `min-height: 0`，无双滚动条和底部大空白。
-- [ ] 只在实际出现隐藏态/动画时机问题时手动调用 `recalculateHeight()`。
-
-## 失败兜底策略
-
-- 高度持续闪烁时，检查被观察容器是否由表格内容撑开；是则使用稳定 `boundaryRef` 或改为 flex 布局。
-- 底部空白或内容被遮挡时，逐项核对 `withPagination/withToolbar/withAddButton` 与实际开关，不反复调大 `extraOffset`。
-- 弹层首次打开高度不准时，在可见或动画结束后 `nextTick(recalculateHeight)`；正常 ResizeObserver 已生效时不增加重复 watch。

package/template/.hermes/skills/yss-use-table-height/agents/openai.yaml

@@ -1,5 +0,0 @@
-version: 1
-interface:
-  display_name: "YSS Table Height"
-  short_description: "YTable 自适应高度计算、分页偏移与布局处理规范"
-  default_prompt: "Use $yss-use-table-height to wire a responsive table height calculation for a YSS page."

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

@@ -1,9 +0,0 @@
-# yss-use-table-height Frontend Documentation
-
-Generated: 2026-08-17T12:03:37.436Z
-
-Use these YSS UI documentation entry points as authoritative references when local repo examples are insufficient.
-
-- hooks: http://192.168.164.27:3200/hooks
-
-When documentation and local code differ, inspect the current project code before editing and prefer established local usage.

package/template/.hermes/skills/yss-use-tree-height/SKILL.md

@@ -1,98 +0,0 @@
----
-name: yss-use-tree-height
-description: 指导 YTree、左树右表、组织树、分类树、树搜索和 Tab/抽屉内树区域使用 @yss-ui/hooks 的 useTreeHeight 实现自适应高度；当树区域需要独立滚动、容器切换后高度不正确或需要扣除 YTree 内置搜索高度时使用。
----
-
-# useTreeHeight 使用
-
-## 触发条件
-
-- YTree 或左树右表需要独立滚动区和自适应高度。
-- 树区域含内置搜索，或在 Tab/抽屉/折叠面板切换后高度不正确。
-
-## 不适用场景
-
-- 树节点很少、无需独立滚动，且父级布局已托管高度。
-- 主要问题是树节点与右侧数据联动，而非布局高度。
-
-## 文档检索
-
-1. MCP 可用时，先用 `get_component_docs` 精确查询 `useTreeHeight`，需要示例时再调用 `get_demo`；不要仅凭 Skill 中的静态签名推断当前 API。
-2. 精确查询无结果时，先用 `search_docs` 校正名称；仅在 MCP 不可用、调用失败或仍无结果时，回退读取最新 `llms-full.txt`。文档版本与当前依赖不一致时，再核对 Hook 源码、CodeGraph 和真实导出。
-
-## 硬约束（禁止/必须）
-
-- 把树区域的直接父容器 `ref` 传给 `useTreeHeight(treeAreaRef, options)`，并使用真实返回值 `treeHeight/recalculateHeight`。
-- 最外层必须有可计算高度；树区域使用 `flex: 1; min-height: 0; overflow: hidden;`。
-- 计算结果绑定到 `YTree` 的 `:height="treeHeight"`，不用固定魔法高度替代 Hook，也不为了触发虚拟滚动默认添加 `:virtual="true"`。
-- 使用 YTree 内置搜索时配置 `extraOffset: YTREE_SEARCH_HEIGHT`；搜索区已放在 `treeAreaRef` 外部时不再扣除。
-- `extraOffset` 只用于树区域内部实际占位的搜索、padding 或边框，禁止无依据叠加 `+16` 等偏移。
-- Hook 仅在挂载时为当时存在的 `treeAreaRef` 建立 `ResizeObserver`。优先保持树区域外层容器挂载（如使用 `v-show`）；Tab/抽屉可见后在 `nextTick` 调用 `recalculateHeight()`。
-- 隐藏态容器可能得到 `minHeight` 而不是真实可用高度；不把该值当成最终布局结果。
-
-## 标准代码骨架
-
-```vue
-<script setup lang="ts">
-import { ref } from 'vue';
-import { YTree } from '@yss-ui/components';
-import { useTreeHeight, YTREE_SEARCH_HEIGHT } from '@yss-ui/hooks';
-
-const treeAreaRef = ref<HTMLDivElement>();
-const treeData = ref([]);
-const { treeHeight, recalculateHeight } = useTreeHeight(treeAreaRef, {
-  extraOffset: YTREE_SEARCH_HEIGHT,
-});
-</script>
-
-<template>
-  <div ref="treeAreaRef" class="tree-area">
-    <YTree :height="treeHeight" :tree-data="treeData" filterable />
-  </div>
-</template>
-
-<style scoped lang="less">
-@import './style.less';
-</style>
-```
-
-```less
-/* style.less */
-.tree-layout {
-  height: 100%;
-  display: flex;
-  flex-direction: column;
-}
-
-.tree-area {
-  flex: 1;
-  min-height: 0;
-  overflow: hidden;
-}
-```
-
-## 容器切换时机
-
-```typescript
-import { nextTick } from 'vue';
-
-/** 容器显示后补充一次高度计算。 */
-const handleVisibleChange = async (visible: boolean) => {
-  if (!visible) return;
-  await nextTick();
-  recalculateHeight();
-};
-```
-
-## 交付检查清单
-
-- [ ] `treeAreaRef` 在 Hook 挂载时可用，父级高度可计算。
-- [ ] 内置搜索开关与 `YTREE_SEARCH_HEIGHT` 偏移一致，没有重复扣减。
-- [ ] Tab/抽屉切换后使用真实的 `recalculateHeight()` 重算。
-- [ ] 节点较少时未裁剪 DOM 被识别为正常虚拟滚动阈值行为。
-
-## 失败兜底策略
-
-- 树高度显示为 `minHeight` 且与容器不符时，检查是否在隐藏态完成首次计算，并在可见后重算。
-- `treeAreaRef` 由 `v-if` 延迟创建且尺寸不再自动更新时，保持外层容器挂载后重新初始化 Hook，或使用 `v-show + recalculateHeight()`。
-- 节点较少未触发 DOM 裁剪时，核对虚拟滚动阈值，不加 `virtual=true` 伪装修复。

package/template/.hermes/skills/yss-use-tree-height/agents/openai.yaml

@@ -1,5 +0,0 @@
-version: 1
-interface:
-  display_name: "YSS Tree Height"
-  short_description: "YTree 自适应高度计算、搜索偏移与布局处理规范"
-  default_prompt: "Use $yss-use-tree-height to wire a responsive tree height calculation for a YSS page."

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

@@ -1,9 +0,0 @@
-# yss-use-tree-height Frontend Documentation
-
-Generated: 2026-08-17T12:03:37.436Z
-
-Use these YSS UI documentation entry points as authoritative references when local repo examples are insufficient.
-
-- hooks: http://192.168.164.27:3200/hooks
-
-When documentation and local code differ, inspect the current project code before editing and prefer established local usage.

package/template/.hermes/skills/yss-userinfo/SKILL.md

@@ -1,49 +0,0 @@
----
-name: yss-userinfo
-description: Use when YSS current-user context, `AuthUserInfoUtil`, propagated user headers, JWT user payloads, Redis user cache, or background-user fallback is involved.
----
-
-# yss-userinfo
-
-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-userinfo-starter`
-
-Read `references/source-index.md` as a path-hint index whenever the task depends on exact modules, annotations, auto configuration, properties, controllers, clients, repositories, DTOs, handlers, or troubleshooting.
-
-## Workflow
-
-1. Identify whether the task is current-user lookup, request header propagation, JWT parsing, Redis user cache lookup, or non-REST/background fallback behavior.
-2. Read `references/source-index.md`, then inspect `AuthUserInfoUtil`, `DmUser`, and `DmUserDetails`.
-3. Prefer `AuthUserInfoUtil.userInfo()`, `userName()`, `userCode()`, or `currentUserJson()` over manually parsing headers in business code, but treat the result as propagated context, not as JWT signature verification.
-4. Check lookup order before debugging: `X-Username`/`X-Usercode`/`X-LoginDisplayName` headers, Bearer JWT payload, then Redis cache via `CacheManagerCompose`.
-5. For scheduled/background tasks, expect fallback behavior such as default `system` user unless the caller explicitly provides context.
-
-## Source-Backed Notes
-
-- Header names include `X-Username`, `X-Usercode`, and `X-LoginDisplayName`.
-- Bearer token parsing reads payload fields such as `sub`, `loginDisplayName`, `email`, and `userCode` without verifying signature/issuer/audience/expiry in this utility. Authentication decisions must use a verified security context.
-- The current source has a known reversed `userCode` header assignment condition; do not claim that header path is reliable until fixed and tested.
-- Redis cache lookup uses the JWT user-info cache key path; load `yss-cache` if changing cache behavior.
-
-## Checklist
-
-- Required dependency or starter module is present.
-- Request context exists before relying on servlet headers.
-- Gateway/auth service forwards expected user headers or Authorization token.
-- Cache fallback is checked when headers exist but detailed user info is incomplete.
-- Business code does not duplicate JWT parsing logic.
-- Header/JWT/cache/background precedence and overwrite behavior are covered by tests; `system` fallback is distinguished from an authenticated system user.
-- User info propagation is tested for REST calls and async/background execution separately.
-
-## 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/.hermes/skills/yss-userinfo/agents/openai.yaml

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

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

@@ -1,34 +0,0 @@
-# yss-userinfo 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-userinfo-starter` (existed when indexed)
-
-## Documentation Files
-
-- No component documentation files found.
-
-## Maven Modules
-
-- `yss-microservice-components/yss-component-userinfo-starter`
-
-## Key Java Entry Points
-
-- `yss-microservice-components/yss-component-userinfo-starter/src/main/java/com/yss/cloud/domain/DmUser.java`
-- `yss-microservice-components/yss-component-userinfo-starter/src/main/java/com/yss/cloud/domain/DmUserDetails.java`
-- `yss-microservice-components/yss-component-userinfo-starter/src/main/java/com/yss/cloud/user/AuthUserInfoUtil.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/.hermes/skills/yss-validation/SKILL.md

@@ -1,56 +0,0 @@
----
-name: yss-validation
-description: Use when YSS Bean Validation/JSR-303 dependencies, validation messages, LiteFlow EL parsing, `ExpressParserFactory`, parser registration, or validation-error mapping is involved.
----
-
-# yss-validation
-
-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-validation-engine-parent`, `yss-microservice-components/yss-component-validation-jsr303`
-
-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 JSR-303 annotation validation, validation engine expression parsing, LiteFlow EL parsing, or parser extension.
-2. Read `references/source-index.md`; for JSR-303 behavior, read `yss-component-validation-jsr303/readme.md` first.
-3. For expression parsing, inspect `ExpressParserFactory` and concrete `ExpressParser` implementations before adding syntax.
-4. Register new parsers as Spring beans; `ExpressParserFactory` auto-registers available parser beans by `parserType().getType()`.
-5. Keep validation failures mapped to the service/API error contract used by the local project.
-
-## Capability Split
-
-- `validation-jsr303`: currently a dependency/message-resource aggregation module; it has no local Validator, Advice, or auto-configuration Java implementation.
-- `validation-el-parser`: LiteFlow/EL expression parser infrastructure.
-- `ExpressParserFactory`: central parser registry backed by a concurrent map.
-- Parser extension point: implement/provide `ExpressParser` with a non-null parser type and register it as a bean.
-
-## Troubleshooting Notes
-
-- If a parser is not found, confirm it is a Spring bean and `parserType()` is non-null.
-- If validation annotations do not fire, check controller/service validation annotations and Spring validation starter wiring before editing parser code.
-- The component README is empty; use the POM, message resources, Controller annotations, and `GlobalExceptionAdvice` as current evidence.
-- Duplicate parser type keys are silently overwritten by `PARSER_MAP.put`; require collision and round-trip tests for extensions.
-- If behavior differs between expression validation and DTO validation, route the problem to the correct submodule first.
-
-## Checklist
-
-- Required dependency or starter module is present.
-- JSR-303 and expression validation concerns are not mixed in the same fix.
-- New parser implementations have deterministic parser type keys.
-- Parser registration is verified through `ExpressParserFactory.PARSER_MAP`.
-- Validation errors preserve readable messages for Chinese business users.
-- Existing project conventions are reused before adding new wrappers.
-
-## 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/.hermes/skills/yss-validation/agents/openai.yaml

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

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

@@ -1,33 +0,0 @@
-# yss-validation 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-validation-engine-parent` (missing when indexed)
-- `yss-microservice-components/yss-component-validation-jsr303` (existed when indexed)
-
-## Documentation Files
-
-- `yss-microservice-components/yss-component-validation-jsr303/readme.md`
-
-## Maven Modules
-
-- `yss-microservice-components/yss-component-validation-jsr303`
-
-## 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/.hermes/skills/yss-web-controller/SKILL.md

@@ -1,79 +0,0 @@
----
-name: yss-web-controller
-description: Use when generating or refactoring YSS Web Adapter Controllers, request DTOs, response VOs, validation, result wrappers, or Web Convertors from frozen contracts and stable Application interfaces.
----
-
-# yss-web-controller
-
-这是一个 Web 适配层生成型 skill。优先复用脚本 `scripts/generate_controller.mjs` 和模板，不手写重复 CRUD。
-
-## 何时使用
-
-- 用户要批量生成 Controller。
-- 用户要根据冻结 OpenAPI 字段合同、metadata 和稳定 Application 接口生成 Request / Response / Controller / WebConvertor。
-- 用户要求统一 Web Adapter 风格、返回值和接口路径。
-
-## 不适用
-
-- 用户只是要新增一个手写复杂接口，不一定要用脚本。
-- 用户还没有稳定的领域模型或 metadata，先补 `yss-domain` 并准备完整的 metadata 输入。
-
-## 优先流程
-
-1. 先确认冻结 OpenAPI、批准的 Web generation contract、Application Service 接口、metadata、基础包、模块名、领域 segment 和 web 落盘目录；合同中的 `base_package`、`module_name`、`domain_segment` 必须与 CLI 一致。
-2. 涉及 DTO / VO / CMD / Query POJO 样板代码时，加载并遵守 `lombok`。
-3. 涉及 Domain / Application Result 到 VO / DTO 或 CMD / Query 到输入模型的转换时，加载并遵守 `mapstruct`。
-4. 运行 `node scripts/generate_controller.mjs`。
-5. 生成后检查路径、命名、返回值包装、Application Service 引用、`@Valid`、Lombok 注解和 MapStruct WebConvertor 是否对齐项目。
-6. 对复杂接口做少量手工修正，不在 skill 中承诺自动覆盖全部业务逻辑。
-
-## 推荐命令
-
-```bash
-node scripts/generate_controller.mjs \
-  --metadata-file /path/metadata.json \
-  --contract-file /path/approved-web-generation-contract.json \
-  --base-package com.yss.demo \
-  --module-name demo \
-  --domain-segment example \
-  --web-project-dir /path/demo-adapter/demo-web \
-  --application-service-package com.yss.demo.application.service \
-  --validation-namespace javax
-```
-
-## 输出预期
-
-- `rest/dto/request/*CreateRequest.java`
-- `rest/dto/request/*UpdateRequest.java`
-- `rest/dto/request/*PageRequest.java`
-- `rest/dto/response/*Response.java`
-- `rest/*Controller.java`
-- `rest/convertor/*WebConvertor.java`
-
-## 约束
-
-- 生成代码只依赖既有 Application Service；读写操作都禁止绕过 Application。复杂查询经 Application Query Port 接入 Infrastructure。
-- 返回结构保持项目既有 `SingleResult`、`PageResult`、`MultiResult` 体系。
-- DTO / VO / CMD / Query 默认用 Lombok 处理 getter/setter、constructor、builder 和日志样板；不要在 Controller 内部类或非约定包临时定义主要 DTO / VO。
-- `WebConvertor` 使用 `@Mapper(componentModel = "spring")` 和构造器注入；禁止静态 `INSTANCE`、在 Controller / Application 中大段手写字段赋值、使用 `BeanUtils.copyProperties` 或反射式通用拷贝。
-- HTTP Request 不继承会暴露内部协作字段的 `PageQuery`；只生成冻结 OpenAPI allowlist 字段，禁止把 `offset`、`needTotalCount`、`tempTotalCount` 变成客户端输入。
-- 先跑脚本，再按项目规范做少量手调。
-- `javax` / `jakarta` validation namespace 必须来自工程基线，不得按记忆选择。
-- 若用户只是要改单个 Controller，先看现有代码，不要盲覆盖整个目录。
-- 脚本是 initialize-only；写入前先规划全部目标，任一目标已存在或传入 `--force` 时整体返回 `unsupported` 且不得留下部分文件。旧项目迁移不属于该生成器。
-
-## 按需读取
-
-- 分层开发规范：`references/web-adapter-layer-guide.md`
-- 生成脚本：`scripts/generate_controller.mjs`
-- Controller 模板：`assets/templates/Controller.java.template`
-- Convertor 模板：`assets/templates/WebConvertor.java.template`
-- POJO 样板代码：`lombok`
-- 对象转换：`mapstruct`
-
-## 阶段 7 合同
-
-- 只消费已批准合同和冻结 OpenAPI/no-impact record；不得用 Controller 或半成品 backend 反向定义产品契约。
-- DTO/VO/WebConvertor 机械骨架可用 `controlled-generation`；权限、错误映射、校验语义和接口行为必须使用 `behavior-tdd`。
-- 写入必须位于合同 `allowed_write_paths`，并提供 Controller、DTO/VO、WebConvertor、契约/API 测试和实际验证结果。
-- 按统一 `YSS Skill Execution Result` 返回偏离与新增影响；出现新 API/schema、权限或响应包装变化时暂停并回到 Router/生命周期。

package/template/.hermes/skills/yss-web-controller/agents/openai.yaml

@@ -1,5 +0,0 @@
-version: 1
-interface:
-  display_name: "YSS Web Controller"
-  short_description: "Web Controller、DTO、VO 与响应封装规范"
-  default_prompt: "Use $yss-web-controller to generate or refactor a YSS REST controller, request DTO, and response VO."

package/template/.hermes/skills/yss-web-controller/assets/templates/Controller.java.template

@@ -1,72 +0,0 @@
-package ${base_package}.rest;
-
-${application_service_import}
-${dto_imports}
-${web_convertor_import}
-import com.yss.cloud.dto.result.PageResult;
-import com.yss.cloud.dto.result.SingleResult;
-import lombok.RequiredArgsConstructor;
-import org.springframework.web.bind.annotation.*;
-import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.tags.Tag;
-import ${validation_namespace}.validation.Valid;
-
-/**
- * ${domain_desc} 管理
- *
- * @author ${author}
- */
-@RestController
-@RequestMapping("/api/${module_name}/${domain_url_path}")
-@RequiredArgsConstructor
-@Tag(name = "${domain_desc}管理")
-public class ${domain_class}Controller {
-
-    ${application_service_field}
-    private final ${web_convertor_class} webConvertor;
-
-    /**
-     * 分页查询 ${domain_desc}
-     */
-    @PostMapping("/page")
-    @Operation(summary = "分页查询")
-    public PageResult<${response_class}> page(@Valid @RequestBody ${page_request_class} request) {
-        return webConvertor.toResponsePage(${query_call});
-    }
-
-    /**
-     * 根据ID查询 ${domain_desc}
-     */
-    @GetMapping("/{id}")
-    @Operation(summary = "详情查询")
-    public SingleResult<${response_class}> detail(@PathVariable Long id) {
-        return SingleResult.of(webConvertor.toResponse(${detail_call}));
-    }
-
-    /**
-     * 新增 ${domain_desc}
-     */
-    @PostMapping
-    @Operation(summary = "新增")
-    public SingleResult<Long> add(@Valid @RequestBody ${create_request_class} request) {
-        return SingleResult.of(${add_call});
-    }
-
-    /**
-     * 更新 ${domain_desc}
-     */
-    @PutMapping
-    @Operation(summary = "更新")
-    public SingleResult<Boolean> update(@Valid @RequestBody ${update_request_class} request) {
-        return SingleResult.of(${update_call});
-    }
-
-    /**
-     * 删除 ${domain_desc}
-     */
-    @DeleteMapping("/{id}")
-    @Operation(summary = "删除")
-    public SingleResult<Boolean> delete(@PathVariable Long id) {
-        return SingleResult.of(${delete_call});
-    }
-}