eliteforge-framework-specification
约束 Java 开发优先复用璀璨工坊统一框架能力,避免重复造轮子。基于《璀璨工坊统一框架-使用手册-nightly》提供统一框架接入、升级、配置、Starter 选型与排障指引。命中框架能力时必须使用框架内 Starter 和对应抽象 API,禁止回退到 Spring 官方 starter 或绕过框架抽象层(如缓存场景绕过 CacheService 直接用 StringRedisTemplate)。用户提到“统一框架”“starter清单”“接入步骤”“升级步骤”“系统要求”“Web MVC/服务间调用/Mybatis-Plus/加解密/缓存/多数据源/代码生成器/资源抽象层”或需要判断“该功能是否应直接使用某个 starter(如 cache-starter)”时使用。
How do I install this agent skill?
npx skills add https://github.com/cloudsen/eliteforge-skills --skill eliteforge-framework-specificationIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides developer guidelines and technical specifications for the EliteForge Java framework by CloudSen. It includes comprehensive documentation for various framework starters and implements local search functionality using standard shell utilities to assist users in navigating the nightly reference manual. No security vulnerabilities or malicious patterns were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
1/4 files flagged
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
EliteForge Framework Specification (Nightly)
目标
在 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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/cloudsen/eliteforge-skills/eliteforge-framework-specification">View eliteforge-framework-specification on skillZs</a>