| name | eliteforge-new-java-biz-package |
| description | 为 Java 项目创建或补齐业务包骨架与目录结构。适用于需要在 `src/main/java` 下新建业务包、补齐目录层级、生成 `controller/domain/model/repository/service/docs/util` 标准骨架的场景，并要求结果与当前仓库既有业务包风格一致。 |
| metadata | {"version":"1.0.1"} |
Java 业务包骨架
直接按固定骨架生成，不做 controller 目录风格切换。优先使用 scripts/scaffold_java_biz_package.py 生成目录骨架，再按用户要求补类、文档或占位文件。
工作流
- 确认目标业务包根目录，例如
.../base/config、.../task 或其他 src/main/java 下的领域包。
- 运行脚本创建骨架，controller 固定生成
api、innerapi、openapi。
- 仅当用户明确要求时，再补
Controller、ApplicationService、Repository、Mapper、DTO/VO/Entity 等 Java 文件。
- 仅当用户明确要求设计文档时，再使用
$eliteforge-tech-doc 和 $eliteforge-java-uml 技能创建 docs/tech-design.md、.puml、.svg；如果仓库规范要求，调用对应文档技能，不要写空洞占位文档。
快速命令
python3 scripts/scaffold_java_biz_package.py <target-dir>
python3 scripts/scaffold_java_biz_package.py <target-dir> --dry-run
约束
- 默认骨架、目录职责和命名落位见
references/layout-spec.md。
- controller 子目录固定使用全小写包名
api/innerapi/openapi，不做自动探测，也不提供切换参数。
- 默认创建根目录
.gitkeep、repository/.gitkeep、service/.gitkeep。不要在所有空目录里滥加 .gitkeep，除非用户明确要求保留空目录。
service 根目录放 xxxApplicationService，实现放 service/impl。repository 根目录放 xxxRepository，实现放 repository/impl，MyBatis Mapper 放 repository/mapper。controller/api 面向前端，controller/innerapi 面向内部服务调用，controller/openapi 面向外部开放平台。- 如果当前仓库要求模块设计文档必须走指定技能，先按仓库规范调用对应技能，再补
docs/ 下的真实设计产物。
- 如果用户只要目录骨架，不要额外生成假类、假接口、假 UML 或空内容设计稿。
- 如果用户还要求“补一个完整模块”，先用本 skill 落目录，再继续按仓库规范补代码和文档。
