메뉴
[Step8] Java微服务公共模块提取工具（产品线适配）。根据工程pom.xml中的groupId自动选择对应产品线的检查与提取规则。将能力层模块中的公共代码包（util、cache、constant、enums、exception、config）提取到grp-{module}-common模块下，统一管理公共代码，不改变业务逻辑。执行链路：Step1→Step2→Step3→Step4→Step5→Step6→Step7→Step8（当前）→Step9。当用户提到'Step8检查'、'Step8修复'、'公共模块提取'、'common提取'时使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | Step8-公共模块提取 |
| description | [Step8] Java微服务公共模块提取工具（产品线适配）。根据工程pom.xml中的groupId自动选择对应产品线的检查与提取规则。将能力层模块中的公共代码包（util、cache、constant、enums、exception、config）提取到grp-{module}-common模块下，统一管理公共代码，不改变业务逻辑。执行链路：Step1→Step2→Step3→Step4→Step5→Step6→Step7→Step8（当前）→Step9。当用户提到'Step8检查'、'Step8修复'、'公共模块提取'、'common提取'时使用。 |
本技能是公共模块提取的产品线适配版本。将能力层模块中的公共代码包（util、cache、constant、enums、exception、config）提取到 grp-{module}-common 模块下，实现公共代码统一管理。不同产品线可能存在目录结构差异，本技能会根据工程 pom.xml 中声明的 <groupId> 自动选择对应产品线的规则执行。
| 序号 | 包名 | 说明 |
|---|---|---|
| 1 | util/ | 工具类 |
| 2 | cache/ | 缓存相关 |
| 3 | constant/ | 常量定义 |
| 4 | enums/ | 枚举定义 |
| 5 | exception/ | 异常定义 |
| 6 | config/ | 配置类 |
此步骤在所有其他步骤之前执行，不可跳过。
pom.xml 文件<groupId> 标签的值<groupId>，则查找 <parent> 中的 <groupId>提取到的 groupId → 匹配规则 → 加载的产品线目录
───────────────────────────────────────────────────
grp.pt → 精确匹配 → products/技术中台/
grp.budget → 精确匹配 → products/预算/
gfmis.bgtex → 精确匹配 → products/执行/
com.ctjsoft.gfmis → 精确匹配 → products/执行/
grp.gfmis → 精确匹配 → products/执行/
grp.gfmis.* → 前缀匹配 → products/执行/
com.ctjsoft.gfmis.v3 → 精确匹配 → products/指标/
其他 groupId → 降级到默认 → products/技术中台/ (默认产品线)
匹配优先级：精确匹配优先于前缀匹配。例如
com.ctjsoft.gfmis.v3精确匹配到「指标」，不会被com.ctjsoft.gfmis的规则截获。grp.gfmis.xxx形式的 groupId 通过前缀匹配到「执行」。
examples/、scripts/、templates/products/{产品线}/REFERENCE.md 及其子目录在执行任何检查或修复操作之前，必须读取并遵守全局编码防护规范： → shared/encoding-guard.md
| 编号 | 检查项 | 说明 | 判定方法 |
|---|---|---|---|
| S8-01 | util/ 包归属检查 | 工具类是否仍在业务模块内 | Grep 分析依赖 |
| S8-02 | cache/ 包归属检查 | 缓存类是否仍在业务模块内 | Grep 分析依赖 |
| S8-03 | constant/ 包归属检查 | 常量类 | Grep 分析依赖 |
| S8-04 | enums/ 包归属检查 | 枚举类 | Grep 分析依赖 |
| S8-05 | exception/ 包归属检查 | 异常类 | Grep 区分异常定义/处理器 |
| S8-06 | config/ 包归属检查 | 配置类 | Grep 分析 @MapperScan/@ComponentScan |
详细规则参见 scripts/check-rules.md
| 判定 | 含义 | 后续动作 |
|---|---|---|
| EXTRACT | 推荐提取 | 自动列入迁移清单 |
| EVALUATE | 需人工判断 | 等用户确认 |
| RETAIN | 建议保留 | 自动排除 |
分类决策树 → scripts/classification-guide.md 检查报告示例 → examples/check-report.md
EXTRACT 自动列入 → EVALUATE 等用户确认 → RETAIN 自动排除
按迁移顺序（constant → enums → exception → util → cache → config），标准 7 步流程： 参见 scripts/refactor-rules.md
详见 scripts/safety-constraints.md
核心原则：
| 场景 | 触发关键词 | 调用功能 |
|---|---|---|
| 检查公共代码 | "公共模块检查"、"Step8检查" | 产品线检测 → 检查 |
| 提取公共代码 | "公共模块提取"、"Step8修复" | 产品线检测 → 检查 + 迁移 |
grp-{module}-common 模块Step8-公共模块提取/
├── SKILL.md
├── examples/
│ ├── check-report.md
│ └── migration-flow.md
├── scripts/
│ ├── check-rules.md
│ ├── classification-guide.md
│ ├── refactor-rules.md
│ └── safety-constraints.md
├── templates/
│ └── standard-directory.md
└── products/
├── 技术中台/
│ ├── REFERENCE.md
│ ├── examples/
│ ├── scripts/
│ └── templates/
├── 预算/
│ └── ...
└── 执行/
└── ...
| 文件 | 说明 |
|---|---|
| scripts/check-rules.md | 6 项检查规则（含 Grep 模式） |
| scripts/classification-guide.md | 文件分类判定指南（全局决策树） |
| scripts/refactor-rules.md | 迁移执行规范（7 步标准流程） |
| scripts/safety-constraints.md | 安全约束与红线 |
| templates/standard-directory.md | common 模块标准目录结构 |
| examples/check-report.md | 检查报告示例 |
| examples/migration-flow.md | 迁移流程示例 |
[Step1] 四层架构Maven工程检查与重构工具（产品线适配）。根据工程pom.xml中的groupId自动选择对应产品线的重构规则。支持技术中台(grp.pt)、预算(grp.budget)、执行(gfmis.bgtex/com.ctjsoft.gfmis)三大产品线。执行链路：Step1（当前）→Step2→Step3→Step4→Step5→Step6→Step7→Step8→Step9。当用户提到'架构检查'、'目录规范'、'结构校验'、'四层架构审查'、'架构重构'、'结构迁移'、'四层架构改造'时使用。
[Step2] 在 Step1（四层架构工程重构）执行完成后，对能力层模块进行二次命名微调（产品线适配）。根据工程pom.xml中的groupId自动选择对应产品线的规则。将 `{module}-server` 重命名为 `{module}-controller`，将 `{module}-server-com` 重命名为 `{module}-service`，并同步更新所有 POM 引用和 Java package/import。执行链路：Step1→Step2（当前）→Step3→Step4→Step5→Step6→Step7→Step8→Step9。当用户提到'架构微调'、'模块重命名'、'server改controller'、'server-com改service'时使用。
[Step3] Java微服务DAO层治理检查与修复工具（产品线适配）。不改变model实体类的路径和引用，只调整DAO层相关内容。包括：目录命名修正(imp→impl)、DAO层接口/实现分离、mapper/entity分离、将model实体集中到api模块(不改变package和引用)。执行链路：Step1→Step2→Step3（当前）→Step4→Step5→Step6→Step7→Step8→Step9。当用户提到'Step3检查'、'Step3修复'、'DAO层治理'、'DAO检查'时使用。
[Step4] Java微服务Service层治理检查与修复工具（产品线适配）。根据工程pom.xml中的groupId自动选择对应产品线的检查与修复规则。检查并修复Service层接口/实现分离(facade/impl)、facade目录存在性、Service接口归属正确性、Service实现归属正确性、非Service文件处理等问题，不改变业务逻辑。执行链路：Step1→Step2→Step3→Step4（当前）→Step5→Step6→Step7→Step8→Step9。当用户提到'Step4检查'、'Step4修复'、'Service层治理检查'、'Service层治理修复'时使用。
[Step5] Java微服务Controller层接口分离检查与修复工具（产品线适配）。根据工程pom.xml中的groupId自动选择对应产品线的检查与修复规则。检查并修复Controller是否按外部/内部接口分离原则划分为custom/(外部接口)和common/(内部接口)两级子目录，不改变业务逻辑。执行链路：Step1→Step2→Step3→Step4→Step5（当前）→Step6→Step7→Step8→Step9。当用户提到'Step5检查'、'Step5修复'、'Controller层治理检查'、'Controller层治理修复'、'custom/common检查'时使用。
[Step6] Java微服务分层架构依赖检查与修复工具（产品线适配）。根据工程pom.xml中的groupId自动选择对应产品线的检查与修复规则。检查并修复Controller→Controller依赖、Controller直接依赖DAO/Mapper、Controller注入ServiceImpl而非接口、Entity泄露到Controller层、跨模块直接类引用等严重架构违规问题，不改变业务逻辑。执行链路：Step1→Step2→Step3→Step4→Step5→Step6（当前）→Step7→Step8→Step9。当用户提到'Step6检查'、'Step6修复'、'架构依赖检查'、'架构依赖修复'、'分层依赖检查'、'分层依赖修复'时使用。