EliteForge Framework Specification (Nightly)
触发门槛
仅当用户明确说明当前项目遵守 璀璨工坊规范 或 eliteforge specification 时，才使用本技能。若用户未做出该项目级声明，不要启用本技能；按通用能力处理。
目标
在 Java 开发中优先复用统一框架，默认避免重复造轮子。命中能力后必须使用框架内 Starter 和对应框架抽象 API，不允许回退 Spring 官方 starter，也不允许绕过框架抽象层。依据 nightly 手册输出可执行答案，避免脱离文档“凭经验”回答。
复用优先约束（核心）
- 先匹配统一框架能力 收到功能需求后，先判断手册是否已有对应 Starter/工具能力。
- 命中即强制采用框架内 Starter 若已覆盖，必须输出“直接接入统一框架 Starter”的方案，不给 Spring 官方 starter（如
spring-boot-starter-web、spring-boot-starter-cache）或自研轮子作为首选。 - 命中即强制使用框架抽象 API 若手册提供框架抽象接口/服务，必须优先使用该接口/服务，不得绕过抽象层直接调用底层组件。
- 禁止回退到 Spring 官方 Starter 任何命中框架能力的场景，都不得输出“先用 Spring 官方 starter 兜底/替代”的建议。
- 缓存能力强制示例 用户提出缓存需求时，必须使用
cisdigital-elite-forge-infra-cache-spring-boot3-starter+CacheService。 禁止用StringRedisTemplate/RedisTemplate作为业务实现，禁止把它们作为“快速连通性验证”捷径。 - 未覆盖时处理边界 仅当手册没有对应能力，或明确无法满足场景时，才给“框架补齐能力/升级版本/自研扩展”建议，并说明原因与边界；此时也不得推荐 Spring 官方 starter 或绕过抽象层的底层组件作为兜底。
执行流程
- 识别问题类型 先判断属于
系统要求、新项目接入、存量升级、Starter 选型、具体模块配置/使用/扩展、升级差异或排障。 - 最小化定位章节 优先读取
references/toc.md定位章节行号，再按需读取references/framework-nightly-readme.md对应片段。 先用检索再局部读取，避免整篇加载。 - 抽取可执行信息 提取
依赖坐标、配置项、注解/接口、框架抽象API、步骤顺序、约束条件、版本要求。 需要示例时，优先给手册中可直接落地的最小示例。 - 结构化输出 按固定结构回答：
结论（是否命中统一框架能力）、推荐Starter、必须使用的框架抽象API、步骤、示例（可选）、注意事项（含禁止回退/禁止绕过抽象层）、文档定位。
快速检索指令
# 先看目录索引（标题 + 行号）
cat references/toc.md
# 按关键字定位（starter、模块、配置项、注解）
rg -n "starter|系统要求|接入统一框架|升级统一框架|Web Mvc|服务间调用|Mybatis-Plus|加解密|缓存抽象层|多数据源|代码生成器|资源抽象层" references/framework-nightly-readme.md
# 按行号读取局部内容（示例：1600-1705行）
sed -n '1600,1705p' references/framework-nightly-readme.md高频问题映射
有哪些 starter：优先看1.2.2 提供统一的Starter依赖治理环境要求是什么：看2 系统要求新项目怎么接入：看3.1 新项目直接在线生成老项目怎么升级接入：看3.2 存量项目手动升级统一框架升级步骤：看4 升级统一框架模块如何配置/使用：看5.x 对应模块章节
Starter 清单（快速回答）
cisdigital-elite-forge-infra-web-spring-boot3-startercisdigital-elite-forge-infra-httpexchange-spring-boot3-startercisdigital-elite-forge-infra-mybatis-plus-spring-boot3-startercisdigital-elite-forge-infra-crypto-spring-boot3-startercisdigital-elite-forge-infra-cache-spring-boot3-startercisdigital-elite-forge-infra-dynamic-datasource-spring-boot3-startercisdigital-elite-forge-infra-code-generatorcisdigital-elite-forge-infra-resource-spring-boot3-starter
输出约束
- 明确标注该手册为
nightly，包含实验性能力。 - 涉及版本选择时，优先引用手册写法“最新发布版本”，不要臆造具体版本号。
- 涉及改造建议时，先给“最小可行接入路径（优先Starter）”，再给可选增强项。
- 命中框架能力时，只给统一框架内 Starter 方案；不得把
spring-boot-starter-*作为备选、降级或兜底。 - 命中框架能力时，必须给出“框架抽象 API 落点”（例如缓存场景必须是
CacheService）；不得给StringRedisTemplate/RedisTemplate等绕过抽象层实现。 - 连通性验证、最小可用验证、PoC 也必须遵循框架抽象层；不得以“先快验”作为绕过理由。
- 手册未覆盖时，明确说明“当前框架暂无对应 Starter，需补齐能力/升级版本或自研扩展”，不得引导回退 Spring 官方 starter。
- 未在手册中出现的信息，明确标记为“需用户补充或需外部确认”。
参考资料
- 目录索引：
references/toc.md - 完整手册：
references/framework-nightly-readme.md