cloudsen/eliteforge-new-java-maven-model

Java Maven Model 模块

优先运行 scripts/scaffold_java_maven_model.py 创建模块骨架，不要手写模块名、pom.xml、包路径和父模块声明。脚本会从根 pom.xml 的 description 提取 公司名称、产品名称、服务名称，并按约定完成命名转换；如果父 pom.xml 已存在同族内部模块的 dependencyManagement 条目，也会一并补齐。空目录使用 .gitkeep 保证能被 Git 跟踪。

工作流

1. 先在目标仓库根目录执行一次 --dry-run；如果当前目录不是根目录，传 --repo-root。
2. 复核脚本输出的 moduleName、packageName、groupId、artifactId、parent、managedDependency。
3. 确认无误后再执行正式命令，创建 <serviceName>-<modelName> 模块。
4. 执行后用 git diff 或直接打开父 pom.xml，确认至少同步了 <modules>，并检查是否按仓库既有约定补齐了 dependencyManagement。
5. 仅当用户明确要求，或仓库规范明确要求时，再继续补类、依赖、文档或测试。

快速命令

python3 .agents/skills/eliteforge-new-java-maven-model/scripts/scaffold_java_maven_model.py reasoning-engine
python3 .agents/skills/eliteforge-new-java-maven-model/scripts/scaffold_java_maven_model.py reasoning-engine --repo-root /path/to/repo
python3 .agents/skills/eliteforge-new-java-maven-model/scripts/scaffold_java_maven_model.py reasoning-engine --dry-run

固定规则

• 模块名使用 <serviceName>-<modelName>，serviceName 必须从根 pom.xml 的 description 读取。
• 包名使用 cn.<companyName>.<productName>.<serviceName>.<modelName>，全部转 dot 风格。
• artifactId 使用 app-<companyName>-<productName>-<serviceName>-<modelName>，全部转短横线风格。
• groupId 使用 cn.<companyName>.<productName>，全部转 dot 风格。
• parent 通过目标目录向上查找最近的 Maven 聚合父项目识别，<version> 固定写 ${revision}。
• 默认创建 pom.xml、src/main/java/<packagePath>/.gitkeep、src/main/resources/.gitkeep、src/test/java/.gitkeep。
• 如果父 pom.xml 已有 <modules>，追加新模块；如果没有，则创建 <modules> 块；不要重复写入。
• 如果父 pom.xml 已按相同 groupId 和 app-<company>-<product>-<service>-* 约定维护内部模块 dependencyManagement，则追加当前模块的受管依赖；如果仓库没有这套约定，不要凭空新增。
• 如果仓库里存在 <serviceName>-runtime-plane，可把它当作可选参考模块，用于观察命名和最小目录习惯；找不到时仍按内置最小骨架创建，不影响 skill 适用性。
• 脚手架完成后，优先回看 git diff，确认没有遗漏父 pom.xml 的模块聚合或内部依赖管理同步。
• 如果用户还要求补业务代码、测试或模块文档，先落模块骨架，再继续执行其他技能或仓库规范。