create-yss-spec 3.4.5 → 3.4.6

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

@@ -1,86 +1,10 @@
-# yss-distributed-id Source Index
+# yss-distributed-id Source Index Router
 
-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.
+Index schema: `backend-component-source-index-router-v1`
 
-This file is generated by `yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
+Select the source index from the approved `platform_configuration.component_platform_line`; do not infer a line from imports, a branch name or a requested upgrade.
 
-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.
+- `boot2-java8` — [Spring Boot 2.7 / Java 8 maintenance line](source-index.boot2-java8.md)
+- `boot3-java17` — [Spring Boot 3.5 / Java 17 mainline](source-index.boot3-java17.md)
 
-## Component Path Hints
-
-- `yss-microservice-components/yss-component-distributed-id` (existed when indexed)
-- `yss-microservice-components/yss-component-leaf` (existed when indexed)
-
-## Documentation Files
-
-- `yss-microservice-components/yss-component-distributed-id/readme.md`
-- `yss-microservice-components/yss-component-leaf/README.md`
-- `yss-microservice-components/yss-component-leaf/TECHNICAL_DESIGN.md`
-
-## Maven Modules
-
-- `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-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
-
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/EnableDistributedId.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/EnableDistributedImportSelector.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/ApplicationContextHelper.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/SegmentContextHelper.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/SnowflakeContextHelper.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/DistributedIdInjectionModeGuard.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/DistributedIdProperties.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/LeafConf.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/LeafDataSourceConfiguration.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/LeafDatabaseType.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/LeafSegmentProperties.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/MissingTagPolicy.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/SnowflakeProperties.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/exception/LeafIdErrorCode.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/exception/LeafIdException.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/exception/LeafServerException.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/health/LeafSegmentHealth.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/inf/leaf/common/PropertyFactory.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/inf/leaf/common/Result.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/inf/leaf/common/Status.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/inf/leaf/segment/dao/IDAllocMapper.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/inf/leaf/segment/model/LeafAlloc.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/inf/leaf/snowflake/SnowflakeNodeIdentity.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/inf/leaf/snowflake/SnowflakeNodeIdentityResolver.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/metrics/LeafSegmentMetrics.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/mybatis/AutoIdInterceptor.java`
-- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/mybatis/DistributedIdIdentifierGenerator.java`
-- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-feign/src/main/java/com/yss/cloud/leaf/conf/YssCloudLeafAutoConfiguration.java`
-- `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-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`
-- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc-lib/src/main/java/com/yss/cloud/grpc/protobuf/GenerateUniqueIdResponseOrBuilder.java`
-- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc-lib/src/main/java/com/yss/cloud/grpc/protobuf/IdGenType.java`
-- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc-lib/src/main/java/com/yss/cloud/grpc/protobuf/UniqueIdProto.java`
-- `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`
-- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-rest/src/main/java/com/yss/cloud/leaf/health/LeafSegmentHealthIndicator.java`
-- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-rest/src/main/java/com/yss/cloud/leaf/health/LeafSnowflakeHealthIndicator.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.
+Run the freshness checker with the same explicit `--platform-line` and its matching clean source root before exact integration guidance.

package/template/.agents/skills/yss-dto/SKILL.md

@@ -92,6 +92,6 @@ description: "实现或核验 YSS Result、PageResult、PageQuery、CommandDTO
 - POJO 样板可 `controlled-generation`；校验、权限输入、错误结构和序列化行为必须由对应 `behavior-tdd` 工作单元覆盖。
 - 必须加载合同要求的 `lombok`、`mapstruct` 和 `alibaba-java-code-style`，并按统一 `YSS Skill Execution Result` 返回文件、契约测试和偏离。
 
-## 新脚手架平台约束
+## 平台与源码门禁
 
-消费批准切片架构身份中的 `platform_configuration`，与工程 Manifest 核对后使用对应 YSS 组件。Boot 2.7 使用 `javax` Web/Validation API；Boot 3.5/4.1 使用 `jakarta`。Boot 4 按 Jackson 3、对应自动配置和 starter 适配；不替换 `javax.sql` 等 Java SE 包。平台不一致、兼容条目缺失或候选未验证时回合同编译器阻断，不在业务实现中升级或替换组件。详见 仓库共享合同 `docs/engineering/backend-platforms.md`。
+接入、修改、代码生成或给出精确类名/配置前，读取 [后端组件平台与源码门禁](../yss-skill-source-index-refresh/references/backend-component-platform-compatibility.md)，从批准的 `platform_configuration.component_platform_line` 选择 `source-index.boot2-java8.md` 或 `source-index.boot3-java17.md`，并以 `--skill yss-dto --platform-line <line> --source-root <matching-root>` 运行统一 freshness 校验。平台线与源码根不匹配、组件 tree 不一致、组件子树 dirty、索引缺少平台信号，或 Manifest / 组件 GAV 缺少 verified 兼容证据时返回 `blocked`；不得回退另一代索引，也不在业务实现中升级、降级或替换 YSS 组件。既有工程只读分诊可继续，但不得据此宣称跨 Boot/JDK 兼容。

package/template/.agents/skills/yss-dto/references/source-index.boot2-java8.md

@@ -0,0 +1,67 @@
+# yss-dto Source Index
+
+Index schema: `backend-component-source-index-v2`
+Platform line: `boot2-java8`
+Generated: 2026-09-18T18:40:26.031Z
+Source commit: `a3be2b2e33dca4545782e2b31894aaa00d0305cd`
+Component worktree: `clean`
+Component tree `yss-microservice-components/yss-component-dto`: `3add70b98d26f6534a4ebf7d9b09d74790ea60a5`
+Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT_BOOT2_JAVA8` to reproduce or refresh.
+
+This file is generated by `yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
+
+Paths are relocatable source hints. Exact guidance requires a matching component tree and a clean indexed component subtree; the repository commit is trace metadata and may differ when unrelated components change.
+
+## Component Path Hints
+
+- `yss-microservice-components/yss-component-dto` (existed when indexed)
+
+## Documentation Files
+
+- `yss-microservice-components/yss-component-dto/readme.md`
+
+Component documentation is a discovery aid. For API signatures, conditions and defaults, prefer the indexed source facts below when documentation differs.
+
+## Maven Modules
+
+- `yss-microservice-components/yss-component-dto/pom.xml` — GAV `com.yss.cloud:yss-component-dto:2.0.0-SNAPSHOT`; parent `com.yss.cloud:yss-microservice-components:2.0.0-SNAPSHOT`
+
+## Platform Signals
+
+- Inherited Java signals: `1.8`.
+- Inherited Spring Boot signals: `2.7.18`.
+- Namespace source signals: `javax.*` in 0 main Java files; `jakarta.*` in 0 main Java files.
+- Auto-configuration metadata: 0 `spring.factories`; 0 `AutoConfiguration.imports` files.
+- These are source observations, not compatibility certification. Use the approved `platform_configuration` and verified compatibility evidence before integration or generation.
+
+## Key Java Entry Points
+
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/SystemIdEnum.java` — `sha256:9020b1c1f5b50c391c6d9c59986bb991725b729a0e35ee5fa110238450671f29`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/cache/CacheKey.java` — `sha256:226063adae6cba030c0193331c8b706ef31402adcbbec20cd6bc18b2ecc6d111`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/cache/CacheKeyCode.java` — `sha256:234f7c2ba2e96a28ef66fea958dd319aef12e25b93dda48fd5c959b49bcc2e0e`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/cache/CacheType.java` — `sha256:f5a565ec95348c16ba74665953c3ac2a03c7b82bbf93e93e4bbffaefb67dca8b`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/CommandDTO.java` — `sha256:7a60b0034f15a3879ff6348d66648deb6d3383dcb3ff72d4273f88e2279227a5`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/QueryDTO.java` — `sha256:5b16982feb8696dca989bb5fd877229042cfdff588a73acab31f0f1ad0157b2c`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/audit/message/AuditMessage.java` — `sha256:74e6239cf391e643d246743e6bb7f3c7e820f1ccacaaf544f24ed5a5b08b2967`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/audit/message/AuditOperationType.java` — `sha256:09fc77b1fc627abefe66c6bbdc68bf3ae1255f3d8e2c56c263741928625eba4e`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/audit/message/AuditResourceType.java` — `sha256:f2650ce24c5fab975329dd6fb1f99d3e1e2ebfb1de5e451ed8005107fe877eff`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/audit/message/EventMessage.java` — `sha256:833b63b800c903dd8a69b41367b05490e7410017cd1658257f0e050a5d5b6104`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/camel/RouteInfo.java` — `sha256:e89e5857aee3cfc1aa0fa2bd213ebe09ba1bb647d4c75bf99aa14c1fab1bb278`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/page/PageQuery.java` — `sha256:cd10750339a7b9ff055f2ac004889113bd592b6da3b12dd8bc76828667cf128f`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/page/PageRequestFactory.java` — `sha256:fb3428ed689a30ec01f94ecf440623c508cfd5fbae390ed2b41831afaba3c419`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/result/MultiResult.java` — `sha256:36bca80b6326333bef239eb4d5347f24d9d87130dfa6f790b119e27dfb40b198`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/result/PageResult.java` — `sha256:90a568d6ccd1082285c3a94c67fee8221d13f2bdf64178930f00fb99ee0899a9`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/result/Result.java` — `sha256:9ae6b91465152a65eed91545f3afc5acb4a54ad5f9b0fbc8f273d32590fd615f`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/result/SingleResult.java` — `sha256:df6b077334047c4975352b5cb8d3f9e6180131b5d890150c6ac67aa4800517d1`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/support/DicMapUtil.java` — `sha256:812e5dbe270912a29fcfc6d4e99ef2df94947be189008b39cea6e2d25d1bd22d`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/upload/FileInfo.java` — `sha256:ccb84cff8b8650567a229c70748864f14d099488b1a0914500adbf4e56c51fc4`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/user/UserInfo.java` — `sha256:df30966767fa3f0d58a0f54d814ca663f9182ec85dce1ed0898307e586560d2f`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/sankuai/GenerationTypeSeq.java` — `sha256:b6d52e51effd73f4fe71044ccd734af1b0cb0cf060c9a7ee52f4ff78d278b750`
+
+## Freshness and Use
+
+- Locate the current source root using `YSS_SOURCE_ROOT_BOOT2_JAVA8`, CodeGraph, Maven artifact names or repository search.
+- Compare each indexed `Component tree` with `git rev-parse HEAD:<component-path>` and require the current component subtree to be clean before exact guidance.
+- Run `node ../yss-skill-source-index-refresh/scripts/check-backend-skill-source-index.mjs --skill <skill-id> --platform-line boot2-java8 --source-root <root>` from the canonical skill root before exact integration guidance.
+- A repository commit difference alone is not stale when the component tree is unchanged; a component tree mismatch or component-local dirty state is stale.
+- Read only the source entries needed for the current decision or troubleshooting path.

package/template/.agents/skills/yss-dto/references/source-index.boot3-java17.md

@@ -0,0 +1,70 @@
+# yss-dto Source Index
+
+Index schema: `backend-component-source-index-v2`
+Platform line: `boot3-java17`
+Generated: 2026-09-18T18:40:26.031Z
+Source commit: `5041c41fbe96c25821bbc15f688c0521b8c97a3d`
+Component worktree: `clean`
+Component tree `yss-microservice-components/yss-component-dto`: `8e3ad58d6e90df4a4afc00d55fe5428bd3364f66`
+Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT_BOOT3_JAVA17` to reproduce or refresh.
+
+This file is generated by `yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
+
+Paths are relocatable source hints. Exact guidance requires a matching component tree and a clean indexed component subtree; the repository commit is trace metadata and may differ when unrelated components change.
+
+## Component Path Hints
+
+- `yss-microservice-components/yss-component-dto` (existed when indexed)
+
+## Documentation Files
+
+- `yss-microservice-components/yss-component-dto/readme.md`
+
+Component documentation is a discovery aid. For API signatures, conditions and defaults, prefer the indexed source facts below when documentation differs.
+
+## Maven Modules
+
+- `yss-microservice-components/yss-component-dto/pom.xml` — GAV `com.yss.cloud:yss-component-dto:3.0.0-SNAPSHOT`; parent `com.yss.cloud:yss-microservice-components:3.0.0-SNAPSHOT`
+
+## Platform Signals
+
+- Inherited Java signals: `17`.
+- Inherited Spring Boot signals: `3.5.16`.
+- Namespace source signals: `javax.*` in 0 main Java files; `jakarta.*` in 0 main Java files.
+- Auto-configuration metadata: 0 `spring.factories`; 0 `AutoConfiguration.imports` files.
+- These are source observations, not compatibility certification. Use the approved `platform_configuration` and verified compatibility evidence before integration or generation.
+
+## Key Java Entry Points
+
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/SystemIdEnum.java` — `sha256:9020b1c1f5b50c391c6d9c59986bb991725b729a0e35ee5fa110238450671f29`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/cache/CacheKey.java` — `sha256:226063adae6cba030c0193331c8b706ef31402adcbbec20cd6bc18b2ecc6d111`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/cache/CacheKeyCode.java` — `sha256:234f7c2ba2e96a28ef66fea958dd319aef12e25b93dda48fd5c959b49bcc2e0e`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/cache/CacheType.java` — `sha256:f5a565ec95348c16ba74665953c3ac2a03c7b82bbf93e93e4bbffaefb67dca8b`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/CommandDTO.java` — `sha256:7a60b0034f15a3879ff6348d66648deb6d3383dcb3ff72d4273f88e2279227a5`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/QueryDTO.java` — `sha256:5b16982feb8696dca989bb5fd877229042cfdff588a73acab31f0f1ad0157b2c`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/audit/message/AuditMessage.java` — `sha256:ba76a4bdd2975f1d9d7f4071a6fe917c4db466b5ceba95b7e995e4ca14f06341`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/audit/message/AuditOperationType.java` — `sha256:09fc77b1fc627abefe66c6bbdc68bf3ae1255f3d8e2c56c263741928625eba4e`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/audit/message/AuditResourceType.java` — `sha256:f2650ce24c5fab975329dd6fb1f99d3e1e2ebfb1de5e451ed8005107fe877eff`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/audit/message/EventMessage.java` — `sha256:833b63b800c903dd8a69b41367b05490e7410017cd1658257f0e050a5d5b6104`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/page/PageQuery.java` — `sha256:cd10750339a7b9ff055f2ac004889113bd592b6da3b12dd8bc76828667cf128f`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/page/PageRequestFactory.java` — `sha256:fb3428ed689a30ec01f94ecf440623c508cfd5fbae390ed2b41831afaba3c419`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/response/MultiResult.java` — `sha256:8399312fcf4f7ac8f4f0b787355942d75e3213b3f600ae100e29887412a199f3`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/response/PageResult.java` — `sha256:8b2edfdd3f3318c15787cc55b00eb9b0cb2366d54ad232fe4c088ae573893dce`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/response/Result.java` — `sha256:4f9b350b50968afb0e215642805fd3adb19f8bdc3fb9c2e68da5eeb719c1a9f7`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/response/SingleResult.java` — `sha256:89fa522d8a5638b09c05abd3a33558038c82a480a11d1bd41f2696f52b4e3ef5`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/result/MultiResult.java` — `sha256:3ec2ee0189b19a5b2af8a37926b677a14e5c81dcb3dcab1fbcf12135fce52146`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/result/PageResult.java` — `sha256:90a568d6ccd1082285c3a94c67fee8221d13f2bdf64178930f00fb99ee0899a9`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/result/Result.java` — `sha256:7c2a905a8bb06e254ecfff1eea55be280160c6e3088b05fea17a7c8fb76b6d93`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/result/SingleResult.java` — `sha256:6bb23e9d74050e208b266b35b268bb626e8d7cbe67ace5d3fdd71a7fec62b992`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/support/DicMapUtil.java` — `sha256:812e5dbe270912a29fcfc6d4e99ef2df94947be189008b39cea6e2d25d1bd22d`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/upload/FileInfo.java` — `sha256:ccb84cff8b8650567a229c70748864f14d099488b1a0914500adbf4e56c51fc4`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/user/UserInfo.java` — `sha256:df30966767fa3f0d58a0f54d814ca663f9182ec85dce1ed0898307e586560d2f`
+- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/sankuai/GenerationTypeSeq.java` — `sha256:b6d52e51effd73f4fe71044ccd734af1b0cb0cf060c9a7ee52f4ff78d278b750`
+
+## Freshness and Use
+
+- Locate the current source root using `YSS_SOURCE_ROOT_BOOT3_JAVA17`, CodeGraph, Maven artifact names or repository search.
+- Compare each indexed `Component tree` with `git rev-parse HEAD:<component-path>` and require the current component subtree to be clean before exact guidance.
+- Run `node ../yss-skill-source-index-refresh/scripts/check-backend-skill-source-index.mjs --skill <skill-id> --platform-line boot3-java17 --source-root <root>` from the canonical skill root before exact integration guidance.
+- A repository commit difference alone is not stale when the component tree is unchanged; a component tree mismatch or component-local dirty state is stale.
+- Read only the source entries needed for the current decision or troubleshooting path.

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

@@ -1,55 +1,10 @@
-# yss-dto Source Index
+# yss-dto Source Index Router
 
-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.
+Index schema: `backend-component-source-index-router-v1`
 
-This file is generated by `yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
+Select the source index from the approved `platform_configuration.component_platform_line`; do not infer a line from imports, a branch name or a requested upgrade.
 
-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.
+- `boot2-java8` — [Spring Boot 2.7 / Java 8 maintenance line](source-index.boot2-java8.md)
+- `boot3-java17` — [Spring Boot 3.5 / Java 17 mainline](source-index.boot3-java17.md)
 
-## Component Path Hints
-
-- `yss-microservice-components/yss-component-dto` (existed when indexed)
-
-## Documentation Files
-
-- `yss-microservice-components/yss-component-dto/readme.md`
-
-## Maven Modules
-
-- `yss-microservice-components/yss-component-dto`
-
-## Key Java Entry Points
-
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/SystemIdEnum.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/cache/CacheKey.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/cache/CacheKeyCode.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/cache/CacheType.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/CommandDTO.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/QueryDTO.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/audit/message/AuditMessage.java`
-- `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/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`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/result/SingleResult.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/support/DicMapUtil.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/upload/FileInfo.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/user/UserInfo.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/sankuai/GenerationTypeSeq.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.
+Run the freshness checker with the same explicit `--platform-line` and its matching clean source root before exact integration guidance.

package/template/.agents/skills/yss-excel-mvc/SKILL.md

@@ -64,3 +64,7 @@ description: "实现或排查 YSS Spring MVC Excel 导入导出、RequestExcel
 - 源码索引：`references/source-index.md`
 - 注解与返回结构：`assets/RequestExcel.java`、`assets/ResponseExcel.java`、`assets/ExcelDynamicData.java`
 - MVC 解析器：`assets/RequestFastExcelArgumentResolver.java`、`assets/ResponseFastExcelReturnValueHandler.java`
+
+## 平台与源码门禁
+
+接入、修改、代码生成或给出精确类名/配置前，读取 [后端组件平台与源码门禁](../yss-skill-source-index-refresh/references/backend-component-platform-compatibility.md)，从批准的 `platform_configuration.component_platform_line` 选择 `source-index.boot2-java8.md` 或 `source-index.boot3-java17.md`，并以 `--skill yss-excel-mvc --platform-line <line> --source-root <matching-root>` 运行统一 freshness 校验。平台线与源码根不匹配、组件 tree 不一致、组件子树 dirty、索引缺少平台信号，或 Manifest / 组件 GAV 缺少 verified 兼容证据时返回 `blocked`；不得回退另一代索引，也不在业务实现中升级、降级或替换 YSS 组件。既有工程只读分诊可继续，但不得据此宣称跨 Boot/JDK 兼容。

package/template/.agents/skills/yss-excel-mvc/references/source-index.boot2-java8.md

@@ -0,0 +1,90 @@
+# yss-excel-mvc Source Index
+
+Index schema: `backend-component-source-index-v2`
+Platform line: `boot2-java8`
+Generated: 2026-09-18T19:31:25.688Z
+Source commit: `a3be2b2e33dca4545782e2b31894aaa00d0305cd`
+Component worktree: `clean`
+Component tree `yss-microservice-components/yss-component-excel-mvc`: `acc02f7747905f715708dfe029c3f66a8457e3a5`
+Component tree `yss-microservice-components/yss-component-excel-starter`: `82345616c26950981497f254c45bf0b2bc2077a8`
+Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT_BOOT2_JAVA8` to reproduce or refresh.
+
+This file is generated by `yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
+
+Paths are relocatable source hints. Exact guidance requires a matching component tree and a clean indexed component subtree; the repository commit is trace metadata and may differ when unrelated components change.
+
+## Component Path Hints
+
+- `yss-microservice-components/yss-component-excel-mvc` (existed when indexed)
+- `yss-microservice-components/yss-component-excel-starter` (existed when indexed)
+
+## Documentation Files
+
+- `yss-microservice-components/yss-component-excel-mvc/README.md`
+
+Component documentation is a discovery aid. For API signatures, conditions and defaults, prefer the indexed source facts below when documentation differs.
+
+## Maven Modules
+
+- `yss-microservice-components/yss-component-excel-mvc/pom.xml` — GAV `com.yss.cloud:yss-component-excel-mvc:2.0.0-SNAPSHOT`; parent `com.yss.cloud:yss-microservice-components:2.0.0-SNAPSHOT`
+- `yss-microservice-components/yss-component-excel-starter/pom.xml` — GAV `com.yss.cloud:yss-component-excel-starter:2.0.0-SNAPSHOT`; parent `com.yss.cloud:yss-microservice-components:2.0.0-SNAPSHOT`
+
+## Platform Signals
+
+- Inherited Java signals: `1.8`.
+- Inherited Spring Boot signals: `2.7.18`.
+- Namespace source signals: `javax.*` in 10 main Java files; `jakarta.*` in 0 main Java files.
+- Auto-configuration metadata: 1 `spring.factories`; 0 `AutoConfiguration.imports` files.
+- These are source observations, not compatibility certification. Use the approved `platform_configuration` and verified compatibility evidence before integration or generation.
+
+## Key Java Entry Points
+
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/annotation/EnableExcelMvc.java` — `sha256:e8c6d751fd66d4337d52d63aa519db3f1dc13abfb1581c1c852bbc94a6d44591`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/annotation/RequestExcel.java` — `sha256:8b3a9880352ae6efbd737748e4f9ec352e614b98b689810e9d2b1f43fdaef0a8`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/annotation/ResponseExcel.java` — `sha256:7afc2c69bf8691144da1d59fd8c42f9ba99329eecb5ce768a8902cee48248fbd`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/config/FastExcelAutoConfiguration.java` — `sha256:6809156179659bb2d22d3b51782e709c65e6f9d49387a795530108a4f40b11df`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/exception/ExcelDataValidationData.java` — `sha256:ff5551647d78055cbac8fb40181a21e80e6fbe91f5a817415af66f8844ff6441`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/exception/ExcelDataValidationException.java` — `sha256:185433dd49e556a1a5b20077fcb83e71bf7338401f444636c20ea33221b92579`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/exception/ExcelMvcExceptionHandler.java` — `sha256:f96de1bb87cbb06506b8b956e10ff4d784c2405ecaddf2fc06d180d8b41bab1c`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/handler/RequestFastExcelArgumentResolver.java` — `sha256:73d6213b5ac70a89e53cd1629cdfee72b08b894fbdb01cc0eee05bb184ef6595`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/handler/ResponseFastExcelReturnValueHandler.java` — `sha256:4f97afb6e5d0c4a1aab988dbcbcfa054150484ad460718abc620e7b0779807da`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/model/ExcelDynamicData.java` — `sha256:15c6aefc8a17ca06aa4b9fac5ff6e0a1688c93da8fc12be60a89c5f577c5f0f9`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/util/ExcelUtils.java` — `sha256:ff0e40e66435729ce1aaa10af2b8b35cd46f1d6ca7fe3c9c3d6ed3126788206c`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/ExcelAutoConfiguration.java` — `sha256:1f428d48df8af10e9933fd454f8e831556bab135e5e86f6c4aa56a0f69798f13`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/ExcelControlProperties.java` — `sha256:c1f4c81e7082d8135b7e26c33b61f7eab45183d2b9857f1a95948113f4631d46`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/ExcelDataRequest.java` — `sha256:4559a5d6908236e69295fd87dc359659bdf13bdc0f75618268c0dc3f03a62f67`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/ExcelResolverConfiguration.java` — `sha256:14cbdd3dcc5557ccd1db15006a74a80e30a3c965e7c5ce9ff99cdfbceae61c2f`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/annotation/EnableExcelControl.java` — `sha256:926f6e480e8a37504a5d7caf127df36bf27528c8be4ba3e33783ff9ad79c2673`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/annotation/ExcelDynamicSelect.java` — `sha256:db48eaede1f7f10eef4c31d58aa15ff5e0c518c1b13195edfd44d4a6f134c80b`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/annotation/ExcelMeta.java` — `sha256:03833573ea64c3792a6871fb3c31817cf4f1586a97d47eefcd28e2f432b2fc96`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/annotation/ExcelNotation.java` — `sha256:ceb35628b0401c94ccc1929b77ca2afd56acd54e93bad2ec1563a7ef29be51da`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/annotation/ExcelSelected.java` — `sha256:bfc8a45b8d8615f8e131f35c3ab128113082d356843ed40c4658be6e7f4f9a82`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/annotation/RequestExcel.java` — `sha256:6e9b172b4d096daf87d57b6539d2711f2e865bc82c7c392a5f111f353dd1394a`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/annotation/ResponseExcel.java` — `sha256:71b3a75afa1e058a597a5a0b568f37f53360a8218beec4c8afa95e7925b11c70`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/aop/DynamicExcelAspect.java` — `sha256:8849af16bf963a34dc1e9a1fb5b7bb6a163fa5cbc8f256cff139ff2ae02e7572`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/handler/DynamicEasyHandler.java` — `sha256:0e8e1c4abb52baf4f2cc82cfc16a07706685a403b5346ac668de5dbbb97fbdf4`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/handler/ExcelCellWidthStyleStrategy.java` — `sha256:35c2c364bb5b19074392059da11a8402320c5f52de3bc62b8acd2357d2bc1e6b`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/handler/RequestExcelArgumentResolver.java` — `sha256:de7f814439531b2cf78552a0836fc3a53f73f4bb40f236328cdb3b30ded775d5`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/handler/ResponseExcelReturnHandler.java` — `sha256:51846fc9f656b04f2d3ffed9e1df976c7eac4268a587713be19f67ef46e8024b`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/handler/SelectedSheetWriteHandler.java` — `sha256:249f7bb596e57ad4b0a258ddab0c5d6c2cef4630230abc28994f81759e097d0c`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/handler/TitleHandler.java` — `sha256:566d38cf1529398fbfa5480e60e83dbf72f2f56b021db916ed28fa666cdc743f`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/handler/WorkbookExcelWriteBuilder.java` — `sha256:842b7290c04d7109e0fce19aa24bfaf732bf544d89a9cb132819fe44e7f0b442`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/ExcelComment.java` — `sha256:dfed08fa70e533f32881c7252179db582d2b0ea702056c21b9ac7d3f444be5c3`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/ExcelGeneralData.java` — `sha256:a3cfa6c2239104467cac4f7212c9176c7af82952e5135ff6dd8b2a305d4c2953`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/ExcelMetaData.java` — `sha256:6e07500ec5f6e4f2762e466231af4b93ef2565991151407ff32a289df72c201a`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/ExcelSelectedResolve.java` — `sha256:113cf28bc59da3ec95b976d2a48e8cfdf928c6050b3daf2fac9f444e13e3248f`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/RowValidationInfo.java` — `sha256:55b373d380fd297c0058c999f8a7933dd7e662659a9b731ff867df51e275187b`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/excel/CellType.java` — `sha256:4653a148ecfdf0eee7c4eade000e119a5b4ab07672fadb2607fb8e4dc4f2d82b`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/excel/ExcelCellStyle.java` — `sha256:9eaae92954696062a7c24cce12121e50b5875bff4c0a710a001133e67f78bb08`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/excel/ExcelColHeader.java` — `sha256:944c8cfd78b8a60a8103c35da97dc143d2d71b672ebac769f5cb5516721bb55d`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/excel/ExcelDisabled.java` — `sha256:46b85ff903f965a4c4e99ac92ca581716a569642802a5bb41dc531c0b12abd1a`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/processor/DynamicEasyExcelProcessor.java` — `sha256:642932249e4ec80b369c5a634542b5a2632982f5b00848d546353e4c022308eb`
+- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/processor/ExcelStyleParseProcessor.java` — `sha256:374aaffdf05287cc6e76220e313499a4cd6159b915346638e7fae535fdeb0f32`
+
+## Freshness and Use
+
+- Locate the current source root using `YSS_SOURCE_ROOT_BOOT2_JAVA8`, CodeGraph, Maven artifact names or repository search.
+- Compare each indexed `Component tree` with `git rev-parse HEAD:<component-path>` and require the current component subtree to be clean before exact guidance.
+- Run `node ../yss-skill-source-index-refresh/scripts/check-backend-skill-source-index.mjs --skill <skill-id> --platform-line boot2-java8 --source-root <root>` from the canonical skill root before exact integration guidance.
+- A repository commit difference alone is not stale when the component tree is unchanged; a component tree mismatch or component-local dirty state is stale.
+- Read only the source entries needed for the current decision or troubleshooting path.

package/template/.agents/skills/yss-excel-mvc/references/source-index.boot3-java17.md

@@ -0,0 +1,58 @@
+# yss-excel-mvc Source Index
+
+Index schema: `backend-component-source-index-v2`
+Platform line: `boot3-java17`
+Generated: 2026-09-18T19:31:25.688Z
+Source commit: `a1c284f1d4507894003eb7dfc7b0db263957e345`
+Component worktree: `clean`
+Component tree `yss-microservice-components/yss-component-excel-mvc`: `e629d0d76cb73fbfc8d9bfd813bc10a6381b4bed`
+Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT_BOOT3_JAVA17` to reproduce or refresh.
+
+This file is generated by `yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
+
+Paths are relocatable source hints. Exact guidance requires a matching component tree and a clean indexed component subtree; the repository commit is trace metadata and may differ when unrelated components change.
+
+## Component Path Hints
+
+- `yss-microservice-components/yss-component-excel-mvc` (existed when indexed)
+
+## Documentation Files
+
+- `yss-microservice-components/yss-component-excel-mvc/README.md`
+
+Component documentation is a discovery aid. For API signatures, conditions and defaults, prefer the indexed source facts below when documentation differs.
+
+## Maven Modules
+
+- `yss-microservice-components/yss-component-excel-mvc/pom.xml` — GAV `com.yss.cloud:yss-component-excel-mvc:3.0.0-SNAPSHOT`; parent `com.yss.cloud:yss-microservice-components:3.0.0-SNAPSHOT`
+
+## Platform Signals
+
+- Inherited Java signals: `17`.
+- Inherited Spring Boot signals: `3.5.16`.
+- Namespace source signals: `javax.*` in 0 main Java files; `jakarta.*` in 3 main Java files.
+- Auto-configuration metadata: 0 `spring.factories`; 1 `AutoConfiguration.imports` files.
+- These are source observations, not compatibility certification. Use the approved `platform_configuration` and verified compatibility evidence before integration or generation.
+
+## Key Java Entry Points
+
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/annotation/EnableExcelMvc.java` — `sha256:e8c6d751fd66d4337d52d63aa519db3f1dc13abfb1581c1c852bbc94a6d44591`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/annotation/RequestExcel.java` — `sha256:8b3a9880352ae6efbd737748e4f9ec352e614b98b689810e9d2b1f43fdaef0a8`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/annotation/ResponseExcel.java` — `sha256:7afc2c69bf8691144da1d59fd8c42f9ba99329eecb5ce768a8902cee48248fbd`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/config/ExcelMvcProperties.java` — `sha256:1eb5715e3c1bba1cac8a6dc7ee48a5cd73cc0c2e5adcfa781907ea6d09dae51a`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/config/FastExcelAutoConfiguration.java` — `sha256:7ff6fc613c070db32012f67ba1ce80fe4afd74c949156c160681e43f1bef4802`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/exception/ExcelDataValidationData.java` — `sha256:ff5551647d78055cbac8fb40181a21e80e6fbe91f5a817415af66f8844ff6441`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/exception/ExcelDataValidationException.java` — `sha256:185433dd49e556a1a5b20077fcb83e71bf7338401f444636c20ea33221b92579`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/exception/ExcelMvcExceptionHandler.java` — `sha256:f96de1bb87cbb06506b8b956e10ff4d784c2405ecaddf2fc06d180d8b41bab1c`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/handler/RequestFastExcelArgumentResolver.java` — `sha256:caed3dcb17969ae4a63e5c63492191892f89a7d23d9d4b4539c20c573d5c74da`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/handler/ResponseFastExcelReturnValueHandler.java` — `sha256:c5bcb7f1e61104172df10e500d530e7a100925e32bf83be4615e03b650973fca`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/model/ExcelDynamicData.java` — `sha256:15c6aefc8a17ca06aa4b9fac5ff6e0a1688c93da8fc12be60a89c5f577c5f0f9`
+- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/util/ExcelUtils.java` — `sha256:8160e43a3e92dd5f88f3932bc06c9a50b35f338edd6fa88ea829d38901436927`
+
+## Freshness and Use
+
+- Locate the current source root using `YSS_SOURCE_ROOT_BOOT3_JAVA17`, CodeGraph, Maven artifact names or repository search.
+- Compare each indexed `Component tree` with `git rev-parse HEAD:<component-path>` and require the current component subtree to be clean before exact guidance.
+- Run `node ../yss-skill-source-index-refresh/scripts/check-backend-skill-source-index.mjs --skill <skill-id> --platform-line boot3-java17 --source-root <root>` from the canonical skill root before exact integration guidance.
+- A repository commit difference alone is not stale when the component tree is unchanged; a component tree mismatch or component-local dirty state is stale.
+- Read only the source entries needed for the current decision or troubleshooting path.

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

@@ -1,74 +1,10 @@
-# yss-excel-mvc Source Index
+# yss-excel-mvc Source Index Router
 
-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.
+Index schema: `backend-component-source-index-router-v1`
 
-This file is generated by `yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
+Select the source index from the approved `platform_configuration.component_platform_line`; do not infer a line from imports, a branch name or a requested upgrade.
 
-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.
+- `boot2-java8` — [Spring Boot 2.7 / Java 8 maintenance line](source-index.boot2-java8.md)
+- `boot3-java17` — [Spring Boot 3.5 / Java 17 mainline](source-index.boot3-java17.md)
 
-## Component Path Hints
-
-- `yss-microservice-components/yss-component-excel-mvc` (existed when indexed)
-- `yss-microservice-components/yss-component-excel-starter` (existed when indexed)
-
-## Documentation Files
-
-- `yss-microservice-components/yss-component-excel-mvc/README.md`
-
-## Maven Modules
-
-- `yss-microservice-components/yss-component-excel-mvc`
-- `yss-microservice-components/yss-component-excel-starter`
-
-## Key Java Entry Points
-
-- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/annotation/EnableExcelMvc.java`
-- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/annotation/RequestExcel.java`
-- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/annotation/ResponseExcel.java`
-- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/config/FastExcelAutoConfiguration.java`
-- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/exception/ExcelDataValidationData.java`
-- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/exception/ExcelDataValidationException.java`
-- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/exception/ExcelMvcExceptionHandler.java`
-- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/handler/RequestFastExcelArgumentResolver.java`
-- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/handler/ResponseFastExcelReturnValueHandler.java`
-- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/model/ExcelDynamicData.java`
-- `yss-microservice-components/yss-component-excel-mvc/src/main/java/com/yss/excel/mvc/util/ExcelUtils.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/ExcelAutoConfiguration.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/ExcelControlProperties.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/ExcelDataRequest.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/ExcelResolverConfiguration.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/annotation/EnableExcelControl.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/annotation/ExcelDynamicSelect.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/annotation/ExcelMeta.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/annotation/ExcelNotation.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/annotation/ExcelSelected.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/annotation/RequestExcel.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/annotation/ResponseExcel.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/aop/DynamicExcelAspect.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/handler/DynamicEasyHandler.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/handler/ExcelCellWidthStyleStrategy.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/handler/RequestExcelArgumentResolver.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/handler/ResponseExcelReturnHandler.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/handler/SelectedSheetWriteHandler.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/handler/TitleHandler.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/handler/WorkbookExcelWriteBuilder.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/ExcelComment.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/ExcelGeneralData.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/ExcelMetaData.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/ExcelSelectedResolve.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/RowValidationInfo.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/excel/CellType.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/excel/ExcelCellStyle.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/excel/ExcelColHeader.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/model/excel/ExcelDisabled.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/processor/DynamicEasyExcelProcessor.java`
-- `yss-microservice-components/yss-component-excel-starter/src/main/java/com/yss/cloud/excel/processor/ExcelStyleParseProcessor.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.
+Run the freshness checker with the same explicit `--platform-line` and its matching clean source root before exact integration guidance.