eliteforge-new-java-biz-package

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 生成目录骨架，再按用户要求补类、文档或占位文件。

工作流

1. 确认目标业务包根目录，例如 .../base/config、.../task 或其他 src/main/java 下的领域包。
2. 运行脚本创建骨架，controller 固定生成 api、innerapi、openapi。
3. 仅当用户明确要求时，再补 Controller、ApplicationService、Repository、Mapper、DTO/VO/Entity 等 Java 文件。
4. 仅当用户明确要求设计文档时，再使用 $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 落目录，再继续按仓库规范补代码和文档。