create-yss-spec 2.1.4 → 2.1.6

package/template/.hermes/skills/yss-design-system/SKILL.md

@@ -13,6 +13,7 @@ description: Use when YSS 产品设计系统与 Ant Design 企业级 UI 风格
 - 项目 token 快照：`docs/design/tokens/theme.json`、`docs/design/tokens/tokens.default.json`、`docs/design/tokens/tokens.dark.json`、`docs/design/tokens/tokens.compact.json`、`docs/design/tokens/variables.css`、`docs/design/tokens/variables.dark.css`。
 - 本技能执行清单：`references/design-system.md`，用于 Agent 执行和评审，不替代 `docs/design/design.md`。
 - 历史输入包：`/Users/zhudaoming/Downloads/Product-Design-System`，只用于追溯首次引入来源，不作为后续工程依赖。
+- 原型阶段合同：`yss-prototype-stage`，用于统一跨 Agent 的原型资产、AntD 事实和浏览器验证证据。
 
 如果只需要快速判断，先读本文件。若要写 UI 规范、实现页面、评审设计或调整 token，必须读项目内 `docs/design/design.md`；若要执行评审或实现检查，再读 `references/design-system.md`。
 
@@ -21,7 +22,7 @@ description: Use when YSS 产品设计系统与 Ant Design 企业级 UI 风格
 1. 先判断任务阶段：设计系统引入 / 产品设计 / 原型评审 / 前端实现 / UI 改造 / 主题 token 落地。
 2. 读取已有资产：`docs/design/design.md`、相关 Spec、交互说明、状态矩阵、OpenAPI Draft、现有页面代码。
 3. 按设计系统基线约束输出或修改产物：颜色、排版、间距、圆角、动效、组件、状态、响应式。
-4. 若是产品设计阶段，配合 `product-design-prototype` 产出页面、流程、状态矩阵和 OpenAPI 反推清单。
+4. 若是产品设计阶段，先使用 `yss-prototype-stage`；Codex 以 `product-design:index` 为主入口，其他 Agent 必须交付等价合同资产和证据。
 5. 若是前端实现阶段，配合 `yss-ui`、`yss-components`、`yss-formily`、`yss-page-module-development`，但本技能负责风格与体验一致性门禁。
 6. 若发现现有设计系统文档不足，先更新 `docs/design/design.md`，再让实现或评审引用该文档。
 
@@ -76,10 +77,10 @@ description: Use when YSS 产品设计系统与 Ant Design 企业级 UI 风格
 
 | 场景 | 配合技能 |
 | --- | --- |
-| Spec 后做页面 / 原型 / 交互说明 | `product-design-prototype` |
+| Spec 后做页面 / 原型 / 交互说明 | `yss-prototype-stage` → `product-design:index` |
 | 低保真原型进入高保真前评审 | `prototype-review` |
-| 低保真评审通过后的高保真 HTML 原型 | `high-fidelity-html-prototype` |
-| 低保真线框或流程图 | `wireframe-prototype` / `excalidraw-diagram-generator` |
+| 低保真评审通过后的高保真 HTML 原型 | `yss-prototype-stage`；`high-fidelity-html-prototype` 仅兼容入口 |
+| 低保真线框或流程图 | `product-design:index` 或 `wireframe-prototype` 兼容入口 |
 | 前端页面实现 | `yss-ui` / `yss-page-module-development` |
 | 表单 schema | `yss-formily` |
 | YTable / YTree / 高度自适应 | `yss-components` / `yss-use-table-height` / `yss-use-tree-height` |
@@ -95,4 +96,4 @@ description: Use when YSS 产品设计系统与 Ant Design 企业级 UI 风格
 3. 将 Agent 执行入口落到 `.agents/skills/yss-design-system/SKILL.md`。
 4. 将 Agent 执行检查清单更新到 `.agents/skills/yss-design-system/references/design-system.md`。
 5. 更新 `docs/design/README.md` 和必要的 `AGENTS.md` 入口规则。
-6. 运行 `.agents/skills/yss-design-system/scripts/validate-frontmatter.py` 和 markdown/diff 基础检查；若当前环境安装了 `PyYAML`，再运行 skill-creator 的 `quick_validate.py`。
+6. 运行 `node .agents/skills/yss-design-system/scripts/validate-frontmatter.mjs`、对应 `node --test` 和 markdown/diff 基础检查。

package/template/.hermes/skills/yss-design-system/scripts/validate-frontmatter.mjs

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+export function validateFrontmatter(text) {
+  const match = /^---\n([\s\S]*?)\n---/.exec(text);
+  if (!match) throw new Error("Invalid SKILL.md frontmatter block");
+  const fields = new Map();
+  for (const line of match[1].split("\n")) {
+    if (!line.trim()) continue;
+    const index = line.indexOf(":");
+    if (index < 0) throw new Error(`Invalid frontmatter line: ${line}`);
+    fields.set(line.slice(0, index).trim(), line.slice(index + 1).trim());
+  }
+  const keys = [...fields.keys()].sort();
+  if (keys.join(",") !== "description,name") throw new Error(`Expected keys ['description', 'name'], got ${JSON.stringify(keys)}`);
+  const name = fields.get("name");
+  const description = fields.get("description");
+  if (!/^[a-z0-9-]+$/.test(name)) throw new Error("Invalid skill name: " + name);
+  if (!description || description.length > 1024) throw new Error("Description must be present and <= 1024 chars");
+  return name;
+}
+
+async function main() {
+  const skill = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "SKILL.md");
+  try {
+    const name = validateFrontmatter(await readFile(skill, "utf8"));
+    console.log(`${name} frontmatter ok`);
+  } catch (error) {
+    console.error(error.message);
+    process.exitCode = 1;
+  }
+}
+
+if (process.argv[1] === fileURLToPath(import.meta.url)) await main();

package/template/.hermes/skills/yss-design-system/scripts/validate-frontmatter.test.mjs

@@ -0,0 +1,12 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { validateFrontmatter } from "./validate-frontmatter.mjs";
+
+test("accepts the required skill frontmatter", () => {
+  assert.equal(validateFrontmatter("---\nname: yss-design-system\ndescription: Use when validating a skill.\n---\n"), "yss-design-system");
+});
+
+test("rejects missing and unsupported frontmatter fields", () => {
+  assert.throws(() => validateFrontmatter("# no frontmatter"), /Invalid SKILL/);
+  assert.throws(() => validateFrontmatter("---\nname: bad\nextra: x\n---"), /Expected keys/);
+});

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

@@ -1,11 +1,11 @@
 # yss-dictionary 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.
 
@@ -20,34 +20,13 @@ Paths below are source path hints captured at refresh time. If they do not exist
 ## Maven Modules
 
 - `yss-microservice-components/yss-component-dictionary-parent`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary`
 - `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-client`
 - `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-feign`
 - `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-starter`
+- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary`
 
 ## Key Java Entry Points
 
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/config/DicExcelImportTemplate.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/config/DicExcelTemplate.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/config/MybatisDicConfiguration.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/controller/DicController.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/controller/DicQueryController.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/convertor/Audit2AddMapping.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/convertor/Audit2EditMapping.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/convertor/DicBasicConvertor.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/convertor/DicClassConvertor.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/entity/AuditableEntity.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/entity/DicBasicEntity.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/entity/DicClassEntity.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/entity/DicSystemEntity.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/gateway/DicQueryGateway.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/gateway/impl/DicQueryGatewayImpl.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/repository/DicBasicRepository.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/repository/DicClassRepository.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/repository/DicSystemRepository.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/scheduler/DicCacheScheduler.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/service/DicService.java`
-- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/service/impl/DicServiceImpl.java`
 - `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-client/src/main/java/com/yss/cloud/dic/dto/cmd/DicAddCmd.java`
 - `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-client/src/main/java/com/yss/cloud/dic/dto/cmd/DicBasicAddCmd.java`
 - `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-client/src/main/java/com/yss/cloud/dic/dto/cmd/DicClassAddCmd.java`
@@ -72,6 +51,27 @@ Paths below are source path hints captured at refresh time. If they do not exist
 - `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-starter/src/main/java/com/yss/cloud/dic/EnableDicManage.java`
 - `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-starter/src/main/java/com/yss/cloud/dic/EnableDicManageImportSelector.java`
 - `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary-starter/src/main/java/com/yss/cloud/dic/config/DefaultDicConfiguration.java`
+- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/config/DicExcelImportTemplate.java`
+- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/config/DicExcelTemplate.java`
+- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/config/MybatisDicConfiguration.java`
+- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/controller/DicController.java`
+- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/controller/DicQueryController.java`
+- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/convertor/Audit2AddMapping.java`
+- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/convertor/Audit2EditMapping.java`
+- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/convertor/DicBasicConvertor.java`
+- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/convertor/DicClassConvertor.java`
+- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/entity/AuditableEntity.java`
+- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/entity/DicBasicEntity.java`
+- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/entity/DicClassEntity.java`
+- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/entity/DicSystemEntity.java`
+- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/gateway/DicQueryGateway.java`
+- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/gateway/impl/DicQueryGatewayImpl.java`
+- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/repository/DicBasicRepository.java`
+- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/repository/DicClassRepository.java`
+- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/repository/DicSystemRepository.java`
+- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/scheduler/DicCacheScheduler.java`
+- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/service/DicService.java`
+- `yss-microservice-components/yss-component-dictionary-parent/yss-component-dictionary/src/main/java/com/yss/cloud/dic/service/impl/DicServiceImpl.java`
 
 ## Recommended Next Reads
 

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

@@ -1,11 +1,11 @@
 # yss-distributed-id 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.
 
@@ -25,8 +25,8 @@ Paths below are source path hints captured at refresh time. If they do not exist
 - `yss-microservice-components/yss-component-distributed-id`
 - `yss-microservice-components/yss-component-leaf`
 - `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-feign`
-- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc`
 - `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc-lib`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc`
 - `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-rest`
 
 ## Key Java Entry Points
@@ -62,8 +62,6 @@ Paths below are source path hints captured at refresh time. If they do not exist
 - `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-feign/src/main/java/com/yss/cloud/leaf/context/RestGenIdContextHelper.java`
 - `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-feign/src/main/java/com/yss/cloud/leaf/feign/YssIdGenFeign.java`
 - `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-feign/src/main/java/com/yss/cloud/leaf/mybatis/FeignAutoIdInterceptor.java`
-- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc/src/main/java/com/yss/cloud/leaf/conf/YssCloudLeafAutoConfiguration.java`
-- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc/src/main/java/com/yss/cloud/leaf/service/UniqueIdService.java`
 - `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc-lib/src/main/java/com/yss/cloud/grpc/protobuf/GenerateUniqueIdRequest.java`
 - `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc-lib/src/main/java/com/yss/cloud/grpc/protobuf/GenerateUniqueIdRequestOrBuilder.java`
 - `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc-lib/src/main/java/com/yss/cloud/grpc/protobuf/GenerateUniqueIdResponse.java`
@@ -73,6 +71,8 @@ Paths below are source path hints captured at refresh time. If they do not exist
 - `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc-lib/src/main/java/com/yss/cloud/grpc/protobuf/UniqueIdServiceGrpc.java`
 - `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc-lib/src/main/java/com/yss/cloud/leaf/context/GrpcClientService.java`
 - `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc-lib/src/main/java/com/yss/cloud/leaf/context/GrpcGenIdContextHelper.java`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc/src/main/java/com/yss/cloud/leaf/conf/YssCloudLeafAutoConfiguration.java`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc/src/main/java/com/yss/cloud/leaf/service/UniqueIdService.java`
 - `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-rest/src/main/java/com/yss/cloud/leaf/conf/YssLeafRestConfiguration.java`
 - `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-rest/src/main/java/com/yss/cloud/leaf/controller/IdGenController.java`
 - `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-rest/src/main/java/com/yss/cloud/leaf/controller/LeafIdRestResponseFactory.java`

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

@@ -1,11 +1,11 @@
 # yss-dto 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.
 
@@ -33,9 +33,12 @@ Paths below are source path hints captured at refresh time. If they do not exist
 - `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/audit/message/AuditOperationType.java`
 - `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/audit/message/AuditResourceType.java`
 - `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/audit/message/EventMessage.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/camel/RouteInfo.java`
 - `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/page/PageQuery.java`
 - `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/page/PageRequestFactory.java`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/response/MultiResult.java`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/response/PageResult.java`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/response/Result.java`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/response/SingleResult.java`
 - `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/result/MultiResult.java`
 - `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/result/PageResult.java`
 - `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/result/Result.java`

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

@@ -1,11 +1,11 @@
 # yss-excel-mvc 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/.hermes/skills/yss-exception/references/source-index.md

@@ -1,11 +1,11 @@
 # yss-exception 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/.hermes/skills/yss-hook/references/frontend-docs.md

@@ -1,6 +1,6 @@
 # yss-hook 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/.hermes/skills/yss-jdbc/references/source-index.md

@@ -1,11 +1,11 @@
 # yss-jdbc 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/.hermes/skills/yss-log/references/source-index.md

@@ -1,11 +1,11 @@
 # yss-log 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/.hermes/skills/yss-mybatis/references/source-index.md

@@ -1,11 +1,11 @@
 # yss-mybatis 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/.hermes/skills/yss-page-module-development/references/frontend-docs.md

@@ -1,6 +1,6 @@
 # yss-page-module-development 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/.hermes/skills/yss-product-lifecycle/SKILL.md

@@ -33,6 +33,8 @@ YSS 仓库以本 skill 为直接入口，不机械嵌套调用 `ask-matt`。`ask
 - 安全 / 权限不设独立生命周期资料、专属门禁或 `not-applicable` 记录。只有需求或冻结资产明确要求改变认证、授权、租户隔离、敏感数据或合规行为时，才把该行为写入普通 Spec、API、架构、验收和测试 seam，并仅按实际 UI、API、Backend、Data、High-risk 影响触发既有门禁；普通 action 注册、沿用认证中间件、未变化的 `401` / `403`、一般字段、SQL / DDL / 迁移和上传 / 下载本身不触发安全 / 权限流程。
 - 有效 `yss-project.yaml` 存在时，`ask-matt` 和 `setup-matt-pocock-skills` 只能作为子流程；最终入口、仓库身份和模式裁决归本编排器。
 - `template-source` 命中产品 flow 时必须返回 `blocked`（`template-source-product-artifact-forbidden`），不得继续到产品资产或 Ticket 生成。
+- `template-source` 迁移共享工具或验证器前，先区分维护侧构建资产、实例分发面和实例运行资产；冻结公开入口、运行时前提、旧实现处置和跨仓消费者契约后，才可改写实现。
+- 替换自身验证门禁时，不得只用候选门禁自证；必须保留独立 baseline oracle 或同一 fixture 的双跑证据。涉及共享运行资产时，只有生成/同步实例、失败回滚和跨仓消费者的 fresh evidence 齐备，才能声明生态完成或可发布。
 - 文件存在不等于就绪。按内容、审查结论和上游新鲜度评估资产。
 - 父 Ticket/checkpoint 的状态只是索引；与真实资产冲突时，以权威资产为准并修复索引。
 - 上游变化按依赖图精准传播 `stale`；不要无条件重跑完整阶段。
@@ -41,7 +43,7 @@ YSS 仓库以本 skill 为直接入口，不机械嵌套调用 `ask-matt`。`ask
 - YSS active 调用 `to-tickets` 时，新建垂直切片统一写为 `ready-for-human`；只有本编排器复算完整 `ready-for-agent` 公式后才能提升，Matt 的通用默认标签不得提前覆盖生命周期状态。
 - `orchestrate`/`resume` 连续执行安全工作单元，直到人工门禁、真实阻塞、新授权、实现/发布裁决或专项失败。
 - 进入实现后继续主控，通过 `yss-router`、`implement`、`tdd` 和 YSS 专项 skills 执行；独立审查和 fresh verification 后才能作完成判断。只有工作单元真实触碰当前用户、审计、加密或明确的权限业务行为时，才增加 `yss-userinfo`、`yss-audit-log`、`yss-security-algorithm` 等专项依赖。
-- 原型确认 → 后端脚手架：当 YSS 高保真原型已经完成 Prototype Review、AntD CLI 校验和用户确认，且 backend `scaffold_status=required` 时，先完成工程基线，由 `yss-router` 编译脚手架受控生成工作单元合同，经生命周期编排器批准并持久化后，才使用 `yss-ddd-scaffold-generator` 生成后端骨架；随后由 `yss-backend-scaffold-parent` 校验并重新进入 `yss-router`，不得先写业务代码。
+- 原型确认 → 后端脚手架：命中产品设计影响时，先按 `yss-prototype-stage` 形成交互说明、独立 Prototype Review、高保真 HTML、AntD CLI 与浏览器验证、用户确认；只有 `gate.prototype-reviewed`、`gate.prototype-verified` 和 `gate.user-confirmation` 均满足时，才能进入下游。若 backend `scaffold_status=required`，随后先完成工程基线，由 `yss-router` 编译脚手架受控生成工作单元合同，经生命周期编排器批准并持久化后，才使用 `yss-ddd-scaffold-generator` 生成后端骨架；随后由 `yss-backend-scaffold-parent` 校验并重新进入 `yss-router`，不得先写业务代码。
 - 所有后续生成的后端代码都必须消费生命周期批准、已持久化且版本当前的 Slice Implementation Contract，绑定最小 YSS skill 闭包、允许写路径、证据文件和 YSS Skill Execution Result；没有这些证据时必须阻断。
 - Harness 内承载运行时代码时，项目路径策略固定为 `apps/backend/<project>/` 和 `apps/frontend/<project>/`；`apps/backend/`、`apps/frontend/` 仅是项目容器，`app/backend/`、`app/frontend/` 及其子路径禁止生成。外部实现仓库不强制使用该目录，但必须登记真实项目根路径并写入合同。
 - Setup readiness 每个任务只评估一次并在本轮缓存；只有 tracker、主远端、真实标签或配置变化时重查。
@@ -54,7 +56,7 @@ YSS 仓库以本 skill 为直接入口，不机械嵌套调用 `ask-matt`。`ask
 - 在 Matt 阶段边界（phase boundary）先按 `Continue → /clear → /handoff → subagent → /compact` 判断上下文动作；只在 checkpoint 记录可选 `phase_boundary` 证据，不新增生命周期状态。
 - `to-questionnaire` 进入结构化 `external-input-required` 暂停；回答回流后必须重新分类影响面并更新权威资产，不能直接恢复下游实现。
 - `wait-what` 只重新解释当前结论，不改变阶段、门禁、Ticket 或 `ready-for-agent` 状态；`wizard` 只处理人工才能完成的步骤，默认临时使用，秘密值不得进入持久化输出。
-- Matt `prototype` 是保留在 `prototype/<name>` 分支的单文件可分享 HTML 主来源；YSS 高保真 HTML 原型仍必须经过 Prototype Review、AntD CLI 校验和用户确认，两者不得互相替代。
+- Matt `prototype` 是保留在 `prototype/<name>` 分支的单文件可分享 HTML 主来源；YSS 高保真 HTML 原型仍必须经过 Prototype Review、AntD CLI、浏览器验证和用户确认，两者不得互相替代。
 - Matt skill 返回结果必须先归一化为 `Matt Skill Result`；`drift`、`new_impacts`、`violation`、`stale_candidates`、缺失证据或不完整结果不得推进为 `completed`。
 
 ### 原型完成后的后端脚手架与代码生成边界

package/template/.hermes/skills/yss-product-lifecycle/references/orchestration-contract.yaml

@@ -151,7 +151,7 @@ backend_scaffold:
   scaffold_statuses: [existing, required, initialized]
   required_status: required
   sequence:
-    after: [prototype_confirmation, engineering_baseline]
+    after: [prototype_review, prototype_verification, antd_cli_verification, browser_verification, prototype_confirmation, engineering_baseline]
     before_generator: [yss-router-scaffold-contract, lifecycle-approve-scaffold-contract]
     before: [business_code_generation, implement]
   generator_skill: yss-ddd-scaffold-generator
@@ -360,7 +360,7 @@ prototype_modes:
     replaces_yss_high_fidelity: false
   yss_high_fidelity:
     asset: ant_design_v6_html
-    required: [prototype_mode, prototype_review, antd_cli_verification, user_confirmation]
+    required: [prototype_mode, prototype_review, antd_cli_verification, browser_verification, prototype_evidence, user_confirmation]
     purpose: product_design_review
     replaces_matt_logic: false
 

package/template/.hermes/skills/yss-prototype-stage/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: yss-prototype-stage
+description: Use when a YSS feature has product-design impact on a primary flow, navigation, state, recovery, permission experience, or UI-driven API contract and needs prototype assets before implementation readiness.
+---
+
+# YSS Prototype Stage
+
+把产品设计影响收敛为跨 Agent 一致的产物、证据和生命周期回流合同。它不替代 `yss-product-lifecycle` 的门禁裁决，也不把原型当作生产前端代码。
+
+## 进入条件与主入口
+
+- 先由 `yss-product-lifecycle` 判断产品设计影响；无行为变化的孤立视觉修复记录 `not-applicable`，不创建空资产。
+- Codex 的产出主入口是 `product-design:index`；其他 Agent 使用等价的产品设计能力，但必须产出本技能规定的相同资产和证据。能力或证据不能等价时，暂停并回到人工确认。
+- 旧 `product-design-prototype`、`wireframe-prototype`、`high-fidelity-html-prototype` 仅为兼容入口；从它们进入时立即回到本合同。
+
+## 资产与门禁顺序
+
+1. 以 Spec、产品总体设计和 `docs/design/design.md` 形成交互说明、低保真页面/流程与状态矩阵。
+2. 用 `prototype-review` 形成独立评审结论；未通过不得生成高保真或进入需求冻结。
+3. 通过 `product-design:index` 产出 `docs/.scratch/<feature>/design/prototypes/index.html`。
+4. 写入 `docs/.scratch/<feature>/verification/prototype-evidence.yaml`，完成 AntD CLI 与浏览器验证。
+5. 用户确认后，才可校准 Spec、分析 API 影响或进入 Router readiness。
+
+## 设计与 AntD 依据
+
+优先级固定为：官方 `design.md` 的上游默认 → `docs/design/design.md` 与项目 token 的 `project_design` 项目覆盖 → 当前功能的语义组件映射。不得用上游默认覆盖项目 token。
+
+使用官方 `antd` skill / CLI 查询事实，始终用 `--format json`，并记录实际 `antd`、CLI 和目标组件版本。至少保存 `antd design.md`、已选组件的 `info`/`demo`/`token`/`semantic` 查询和 `antd lint` 结果；目标版本存在时，将同一 `<target_antd_version>` 传给版本敏感查询，禁止在模板中固化某个 CLI 或组件版本。
+
+## 验证与回流
+
+`browser_verification` 至少覆盖非空渲染、主流程、一个失败/权限/冲突状态、桌面与窄屏视口和控制台错误；优先使用 Browser 或可执行浏览器自动化，Computer Use 只作人工交互补充。把路径、命令、版本、视口、结果和阻塞项写入证据清单。
+
+`gate.prototype-reviewed` 的证据是评审记录；`gate.prototype-verified` 的证据是 AntD CLI 与浏览器验证；`gate.user-confirmation` 的证据是确认记录。三者均不是实现授权。
+
+## 常见错误
+
+- 仅有截图或 HTML，却没有可复现的 CLI、浏览器和确认记录。
+- 把 `product-design:index` 或某个旧技能当作生命周期批准者。
+- 直接复制官方默认颜色、圆角或间距，忽略项目覆盖。

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

@@ -1,11 +1,11 @@
 # yss-resilience4j 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/.hermes/skills/yss-router/references/router-contract.yaml

@@ -20,7 +20,7 @@ subcontract_statuses: [required, not-applicable]
 
 readiness:
   common: [spec, slice_ticket, architecture_review, build_architecture_checklist, implementation_repository, verification_commands]
-  ui_impact: [requirement_freeze, low_fidelity_review, high_fidelity_html, antd_cli_evidence, prototype_confirmation]
+  ui_impact: [requirement_freeze, low_fidelity_review, prototype_review, high_fidelity_html, prototype_verification, antd_cli_evidence, browser_verification_evidence, prototype_confirmation]
   api_impact: [openapi_freeze]
   no_api_impact: [no_api_impact_record]
   data_impact: [data_architecture]
@@ -39,7 +39,7 @@ exclusive_flags:
 
 slice_contract_required:
   root: [schema_version, contract_id, contract_version, slice_id, status, lifecycle_refs, readiness, common, frontend, backend, contract, cross_repo, work_units]
-  lifecycle_refs: [spec, ticket, requirement_freeze, low_fidelity_review, high_fidelity_html, antd_cli_evidence, prototype_confirmation, openapi_freeze_or_no_impact, architecture_review, data_architecture, engineering_baseline, build_architecture_checklist, implementation_repository, frontend_repository, backend_repository, maven_wrapper]
+  lifecycle_refs: [spec, ticket, requirement_freeze, low_fidelity_review, prototype_review, high_fidelity_html, prototype_verification, antd_cli_evidence, browser_verification_evidence, prototype_confirmation, openapi_freeze_or_no_impact, architecture_review, data_architecture, engineering_baseline, build_architecture_checklist, implementation_repository, frontend_repository, backend_repository, maven_wrapper]
   readiness: [blockers, stale_inputs, not_applicable]
   common: [impacted_areas, implementation_path_policy, project_roots, required_skills, optional_skills, unavailable_skills, allowed_write_paths, forbidden_patterns, expected_evidence_files, verification_commands, human_review_points, full_reroute_triggers]
   frontend: [status, required_skills, approved_prototype_ref, state_matrix_ref, allowed_write_paths, component_test_seams, e2e_paths]
@@ -55,8 +55,11 @@ lifecycle_ref_by_readiness:
   implementation_repository: implementation_repository
   requirement_freeze: requirement_freeze
   low_fidelity_review: low_fidelity_review
+  prototype_review: prototype_review
   high_fidelity_html: high_fidelity_html
+  prototype_verification: prototype_verification
   antd_cli_evidence: antd_cli_evidence
+  browser_verification_evidence: browser_verification_evidence
   prototype_confirmation: prototype_confirmation
   openapi_freeze: openapi_freeze_or_no_impact
   no_api_impact_record: openapi_freeze_or_no_impact

package/template/.hermes/skills/yss-router/references/slice-implementation-contract.md

@@ -14,8 +14,11 @@ slice_contract:
     ticket:
     requirement_freeze:
     low_fidelity_review:
+    prototype_review:
     high_fidelity_html:
+    prototype_verification:
     antd_cli_evidence:
+    browser_verification_evidence:
     prototype_confirmation:
     openapi_freeze_or_no_impact:
     architecture_review:

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

@@ -1,11 +1,11 @@
 # yss-security-algorithm 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/.hermes/skills/yss-source-index/SKILL.md

@@ -24,7 +24,7 @@ Run:
 ```bash
 export YSS_SKILLS_ROOT="/path/to/.agents/skills"
 export YSS_SOURCE_ROOT="/path/to/yss-cloud-microservice"
-python3 "$YSS_SKILLS_ROOT/yss-source-index/scripts/refresh-yss-skill-index.py"
+node "$YSS_SKILLS_ROOT/yss-source-index/scripts/refresh-yss-skill-index.mjs"
 ```
 
 Backend-only refreshes may set `YSS_REFRESH_FRONTEND=false` to avoid unrelated frontend timestamp churn.
@@ -56,8 +56,8 @@ Before exact class/config/security guidance, compare the index `Source commit` w
 
 ## After Refresh
 
-Validate changed skills with:
+Validate the migrated Node helper with:
 
 ```bash
-python3 /path/to/skill-creator/scripts/quick_validate.py /path/to/.agents/skills/yss-source-index
+node --test "$YSS_SKILLS_ROOT/yss-source-index/scripts/refresh-yss-skill-index.test.mjs"
 ```

package/template/.hermes/skills/yss-source-index/scripts/refresh-yss-skill-index.mjs

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import { execFileSync } from "node:child_process";
+import { access, mkdir, readdir, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const BACKEND = {"yss-cache":["yss-microservice-components/yss-component-cache-parent"],"yss-mybatis":["yss-microservice-components/yss-component-persistence"],"yss-dto":["yss-microservice-components/yss-component-dto"],"yss-audit-log":["yss-microservice-components/yss-component-audit-log"],"yss-excel-mvc":["yss-microservice-components/yss-component-excel-mvc","yss-microservice-components/yss-component-excel-starter"],"yss-distributed-id":["yss-microservice-components/yss-component-distributed-id","yss-microservice-components/yss-component-leaf"],"yss-jdbc":["yss-microservice-components/yss-component-jdbc"],"yss-dictionary":["yss-microservice-components/yss-component-dictionary-parent"],"yss-log":["yss-microservice-components/yss-component-log-starter"],"yss-resilience4j":["yss-microservice-components/yss-component-resilience4j-starter"],"yss-taskflow":["yss-microservice-components/yss-component-taskflow"],"yss-validation":["yss-microservice-components/yss-component-validation-engine-parent","yss-microservice-components/yss-component-validation-jsr303"],"yss-security-algorithm":["yss-microservice-components/yss-component-security-algorithm"],"yss-userinfo":["yss-microservice-components/yss-component-userinfo-starter"],"yss-variable":["yss-microservice-components/yss-component-variable"],"yss-exception":["yss-microservice-components/yss-component-exception"],"yss-valuation":["yss-microservice-components/yss-component-valuation"]};
+const FRONTEND={"yss-ui":["components","hooks","skills"],"yss-components":["components"],"yss-hook":["hooks"],"yss-page-module-development":["components","hooks","skills"],"yss-use-table-height":["hooks"],"yss-use-tree-height":["hooks"]};
+const URLS={components:"http://192.168.164.27:3200/components",hooks:"http://192.168.164.27:3200/hooks",skills:"http://192.168.164.27:3200/skills"};
+const KEYS=["Audit","Cache","Clear","Command","Configuration","Controller","DTO","Data","Enable","Excel","Handler","Interceptor","Jdbc","Mapper","Mybatis","Page","Properties","Query","Repository","Request","Response","Result","Update","Aspect","Leaf","Id","Dir","Dic","Dictionary","File","Upload","Log","Message","Mail","Liquibase","Circuit","Breaker","Sql","Tpl","Tag","Task","Flow","Report","Validation","Validator","Security","Crypto","User","Variable","Quality","Search","Similarity","Scheduler","Runner","Duck","Dynamic","Factory","Client","Feign","Gateway","Convertor","Adapter","Advice","Bridge","Route","Uploader","Sftp","Minio","Parser","Express","Rule","Template","Generator","Importer","Engine","Event","Submitter","Executor","Context","Status","Type","State"];
+const DOCS=new Set(["README.md","readme.md","HELP.md","TECHNICAL_DESIGN.md"]);
+const exists=async p=>{try{await access(p);return true}catch{return false}};
+async function walk(root){if(!await exists(root))return[];const out=[];for(const item of await readdir(root,{withFileTypes:true})){const p=path.join(root,item.name);if(item.isDirectory())out.push(...await walk(p));else if(item.isFile())out.push(p)}return out}
+const relative=(root,p)=>{const value=path.relative(root,p);return value&&!value.startsWith("..")?value:p};
+function state(root){try{const run=args=>execFileSync("git",["-C",root,...args],{encoding:"utf8",stdio:["ignore","pipe","ignore"]}).trim();return[run(["rev-parse","HEAD"]),run(["status","--porcelain"])?"dirty":"clean"]}catch{return["unavailable","unknown"]}}
+async function sourceRoot(){if(process.env.YSS_SOURCE_ROOT){const root=path.resolve(process.env.YSS_SOURCE_ROOT);if(await exists(path.join(root,"yss-microservice-components")))return root;throw new Error(`YSS_SOURCE_ROOT must point to the repository root containing \`yss-microservice-components\`: ${root}`)}const home=os.homedir(),candidates=[process.cwd(),...ancestors(process.cwd()),path.join(home,"Documents/yss-project/yss-cloud-microservice"),path.join(home,"Documents/yss-project"),path.join(home,"Projects/yss-cloud-microservice"),path.join(home,"Projects")];for(const base of [path.join(home,"Projects"),path.join(home,"Documents"),path.join(home,"Documents/yss-project")])if(await exists(base))for(const entry of await readdir(base,{withFileTypes:true}))if(entry.isDirectory())candidates.push(path.join(base,entry.name));for(const root of candidates)if(await exists(path.join(root,"yss-microservice-components")))return path.resolve(root);throw new Error("Could not find a YSS source repository containing `yss-microservice-components`. Export YSS_SOURCE_ROOT=/absolute/path/to/yss-cloud-microservice and rerun.")}
+function ancestors(start){const out=[];let current=path.resolve(start);while(path.dirname(current)!==current){current=path.dirname(current);out.push(current)}return out}
+async function files(bases){const out={docs:[],poms:[],java:[]};for(const base of bases)for(const p of await walk(base)){if(DOCS.has(path.basename(p)))out.docs.push(p);else if(path.basename(p)==="pom.xml")out.poms.push(p);else if(p.endsWith(".java")&&p.includes(`${path.sep}src${path.sep}main${path.sep}java${path.sep}`))out.java.push(p)}for(const a of Object.values(out))a.sort();return out}
+export async function refresh({skillsRoot,source,now=new Date().toISOString(),frontend=true}){const [commit,worktree]=state(source);for(const [skill,parts]of Object.entries(BACKEND)){const bases=parts.map(item=>path.join(source,item));const found=await files(bases);const java=found.java.filter(p=>KEYS.some(key=>path.basename(p,".java").includes(key))).slice(0,120);const list=(items,map,empty)=>items.length?items.map(map):[empty];const baseHints=await Promise.all(bases.map(async p=>`- \`${relative(source,p)}\` (${await exists(p)?"existed":"missing"} when indexed)`));const lines=[`# ${skill} Source Index`,``,`Generated: ${now}`,`Source commit: \`${commit}\``,`Source worktree: \`${worktree}\``,`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`,``,...baseHints,``,`## Documentation Files`,``,...list(found.docs,p=>`- \`${relative(source,p)}\``,"- No component documentation files found."),``,`## Maven Modules`,``,...list(found.poms,p=>`- \`${relative(source,path.dirname(p))}\``,"- No Maven modules found."),``,`## Key Java Entry Points`,``,...list(java,p=>`- \`${relative(source,p)}\``,"- 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.`,``];const target=path.join(skillsRoot,skill,"references","source-index.md");await mkdir(path.dirname(target),{recursive:true});await writeFile(target,lines.join("\n"),"utf8")}
+ if(frontend)for(const[skill,keys]of Object.entries(FRONTEND)){if(!await exists(path.join(skillsRoot,skill)))continue;const target=path.join(skillsRoot,skill,"references","frontend-docs.md");await mkdir(path.dirname(target),{recursive:true});await writeFile(target,[`# ${skill} Frontend Documentation`,``,`Generated: ${now}`,``,`Use these YSS UI documentation entry points as authoritative references when local repo examples are insufficient.`,``,...keys.map(key=>`- ${key}: ${URLS[key]}`),``,`When documentation and local code differ, inspect the current project code before editing and prefer established local usage.`,``].join("\n"),"utf8")}
+ return{backend:Object.keys(BACKEND).length,frontend:frontend?Object.keys(FRONTEND).length:0}}
+async function main(){try{const script=path.dirname(fileURLToPath(import.meta.url));const result=await refresh({skillsRoot:path.resolve(process.env.YSS_SKILLS_ROOT||path.join(script,"../..")),source:await sourceRoot(),frontend:!["0","false","no"].includes((process.env.YSS_REFRESH_FRONTEND||"true").toLowerCase())});console.log(`Updated ${result.backend} backend indexes and ${result.frontend} frontend doc references.`)}catch(error){console.error(error.message);process.exitCode=1}}
+if(process.argv[1]===fileURLToPath(import.meta.url))await main();

package/template/.hermes/skills/yss-source-index/scripts/refresh-yss-skill-index.test.mjs

@@ -0,0 +1,15 @@
+import assert from "node:assert/strict";
+import { mkdir, mkdtemp, readFile, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import test from "node:test";
+import { refresh } from "./refresh-yss-skill-index.mjs";
+
+test("writes Node-labelled generated indexes", async () => {
+  const root=await mkdtemp(path.join(tmpdir(),"yss-index-")); const source=path.join(root,"source"); const skills=path.join(root,"skills");
+  await mkdir(path.join(source,"yss-microservice-components/yss-component-cache-parent/src/main/java/demo"),{recursive:true}); await writeFile(path.join(source,"yss-microservice-components/yss-component-cache-parent/src/main/java/demo/CacheConfiguration.java"),"class CacheConfiguration {}");
+  for(const name of ["yss-cache","yss-ui"])await mkdir(path.join(skills,name),{recursive:true});
+  await refresh({skillsRoot:skills,source,now:"2026-01-01T00:00:00Z"});
+  assert.match(await readFile(path.join(skills,"yss-cache/references/source-index.md"),"utf8"),/refresh-yss-skill-index\.mjs/);
+  assert.match(await readFile(path.join(skills,"yss-ui/references/frontend-docs.md"),"utf8"),/components/);
+});