用途:在 Java 项目的 src/main/java 下新建业务包、补齐目录层级,生成 controller/domain/model/repository/service/docs/util 标准骨架,并尽量与当前仓库既有业务包风格保持一致。
主要能力:按固定骨架生成目录,不做 controller 目录风格切换;controller 固定生成 api、innerapi、openapi 三个全小写子目录,分别面向前端、内部服务调用、外部开放平台。默认创建根目录 .gitkeep、repository/.gitkeep、service/.gitkeep;service 根目录放 xxxApplicationService,实现放 service/impl;repository 根目录放 xxxRepository,实现放 repository/impl,MyBatis Mapper 放 repository/mapper。默认骨架、目录职责与命名落位见 references/layout-spec.md。
使用方式:优先运行 scripts/scaffold_java_biz_package.py 生成骨架,命令为 python3 scripts/scaffold_java_biz_package.py <target-dir>,可加 --dry-run 预览。仅在用户明确要求时,再补 Controller、ApplicationService、Repository、Mapper、DTO/VO/Entity 等 Java 文件;仅在明确要求设计文档时,再使用 $eliteforge-tech-doc 和 $eliteforge-java-uml 创建 docs/tech-design.md、.puml、.svg,并按仓库规范调用对应技能。
适用场景:需要新建或补齐 Java 业务包骨架、目录层级,或在此基础上继续补完整模块。
限制:不做 controller 自动探测,也不提供切换参数;不要在所有空目录滥加 .gitkeep,除非明确要求保留空目录;只要目录骨架时不要生成假类、假接口、假 UML 或空内容设计稿;若仓库要求模块设计文档走指定技能,应先按规范调用再补真实产物。文档、类文件的具体生成规则与其余细节暂未提供。