| name | Step3-DAO-Model层治理 |
| description | [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检查'时使用。 |
S2 DAO 层治理（不改变 model 实体路径）
概述
本技能是 S2 DAO 层治理检查与修复的产品线适配版本。本技能严格禁止修改 model 实体类的路径、package 和引用，只聚焦于 DAO 层的目录结构治理。
核心约束：
- 移动 model 实体类到
grp-{module}-model 模块（物理文件移动）
- 不修改 model 实体类的 package 声明（保持原有包路径）
- 不修改 引用 model 实体类的 import 语句（因 package 未变）
- 只调整 DAO 层的目录结构和 model 实体的物理位置
执行链路定位：S2 是代码级重构的第一步（底层 DAO 文件归位），前置依赖 Step1/Step2（工程结构），后续为 Step4（Service层治理）。
执行顺序：
Step1 → Step2 → Step3（当前）→ Step4 → Step5 → Step6 → Step7 → Step8
包含两大核心功能：
- DAO 层检查：扫描 Java 微服务代码中 DAO 层的目录结构与文件分类问题，输出结构化检查报告。
- DAO 层修复：修复检查发现的 DAO 层目录结构问题，修正命名、归位文件、分离 mapper/entity，并将 model 实体集中到 model 模块（不改变 package 和引用）。
产品线检测与路由流程
Step 0: 自动检测产品线
此步骤在所有其他步骤之前执行，不可跳过。
- 读取当前工程根目录（或所在 module）的
pom.xml 文件
- 提取
<groupId> 标签的值
- 如果当前 POM 没有直接声明
<groupId>，则查找 <parent> 中的 <groupId>
- 将提取到的 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/技术中台/ (默认产品线)
匹配优先级：精确匹配优先于前缀匹配。
资源加载流程
- 始终加载通用资源：读取技能根目录下的
examples/、scripts/、templates/ 目录中的文件
- 加载产品线特有资源：根据 Step 0 确定的产品线，读取
products/{产品线}/REFERENCE.md 及其子目录
- 冲突处理：如通用规则与产品线规则冲突，以产品线规则为准
编码防护规范（强制前置）
在执行任何检查或修复操作之前，必须读取并遵守全局编码防护规范：
→ shared/encoding-guard.md
检查项总览
| 编号 | 检查项 | 严重级别 | 说明 |
|---|
| S2-01 | 目录命名规范（imp→impl） | FAIL | 非标准命名影响协作一致性 |
| S2-02 | DAO 层接口/实现分离 | FAIL/WARN | 基于文件名确定性分类规则表判定 |
| S2-03 | DAO 层 mapper/entity 分离 | FAIL | Mapper 和 Entity 应分离到子目录 |
| S2-04 | 核心四层目录完整性 | WARN | controller/service/dao/model |
| S2-05 | resources/mapper 目录对应 | WARN | MyBatis XML 按模块分组 |
| S2-06 | model 实体集中到 model 模块 | INFO | 集中管理但不改变 package 和引用 |
版本说明：
S2-03 DTO/VO/Query 分类归档 → 移除，不处理 model 层分类S2-07 Model 层 dto/vo/query/po 分类 → 移除，不移动 model 实体S2-08 公共模块结构检查 → 移除，属于 Step8 职责
完整检查规则详情 → scripts/check-rules.md
功能一：DAO 层检查流程
Step 0: 识别独立业务域模块
在执行任何检查前，先识别并记录项目中的独立业务域模块，将其排除在检查范围之外。
Step 1: 确定检查范围与冻结快照
用户提供目录路径或模块名称。
Step 2: 扫描目录结构
逐层扫描 DAO 层目录结构。
Step 3: 逐项检查
按 S2 检查清单（6 项）逐项排查。
完整检查规则 → scripts/check-rules.md
Step 4: 输出检查报告
检查报告示例 → examples/check-report.md
功能二：DAO 层修复流程
核心原则
- DAO 层目录调整：修正 imp→impl、DAO 接口/实现分离、mapper/entity 分离
- model 实体集中到 model 模块：物理文件移动到
grp-{module}-model，但不改变 package 声明
- 不修改 model 实体的 package 声明：保持原有包路径不变
- 不修改引用 model 实体的 import 语句：因 package 未变，import 无需修改
- 安全迁移：先读取原文件 → 冲突预检 → 在新位置创建文件 → 验证 → 删除原文件
- 逐步执行：按优先级逐项修复
- 确定性原则：分类完全依据机械匹配，禁止通过阅读文件内容决定分类
Phase 0: 幂等性前置检查
在正式执行修复前，先检查当前治理状态，输出治理状态报告。
Phase 1: 扫描分析与冻结快照
扫描 DAO 层目录结构，识别不合规项。
Phase 2: 生成修复计划
列出所有需要迁移的文件和目录变更。
Phase 3: 用户确认
展示修复计划，必须获得确认后才开始执行修复操作。
Phase 4: 逐项执行修复
按以下 5 大修复步骤执行：
- 目录命名修正：
imp → impl
- DAO 层归位：按确定性分类规则表处理
- DAO 层 mapper/entity 分离
- model 实体集中到 model 模块：物理文件移动，不改变 package 和引用
- 全局验证无残留
完整修复规则 → scripts/refactor-rules.md
标准目录结构模板 → templates/standard-directory.md
Phase 5: 验证结果
执行后自动校验机制（V1~V4），确认治理完成。
安全约束
完整安全约束 → scripts/safety-constraints.md
一致性保证机制
| 机制 | 说明 |
|---|
| Phase 0 幂等性检查 | 执行前检查治理状态 |
| model 实体集中到 model 模块 | 物理文件移动，但 package 和引用不变 |
| 标准化确认流程 | 引导用户选择"全部执行" |
| 执行后校验机制 | 5 个校验检查点 |
| import 语句规范化 | 禁止通配符导入 |
使用场景
| 场景 | 触发关键词 | 调用功能 |
|---|
| 检查 DAO 层是否符合规范 | "S2检查"、"DAO层治理检查"、"DAO检查" | 产品线检测 → 检查 |
| 修复不符合规范的 DAO 层 | "S2修复"、"DAO层治理修复"、"DAO修复" | 产品线检测 → 修复 |
| 先检查再修复 | "S2检查并修复"、"DAO层治理全流程" | 产品线检测 → 检查 + 修复 |
前置条件
- 工程为 Java 微服务项目（Spring Boot/Cloud）
- S1（架构依赖守卫）已完成
- 修复前用户需确认修复计划
目录结构
Step3-DAO-Model层治理/
├── SKILL.md
├── examples/
│ ├── check-report.md
│ └── migration-flow.md
├── scripts/
│ ├── check-rules.md
│ ├── refactor-rules.md
│ └── safety-constraints.md
├── templates/
│ └── standard-directory.md
└── products/
├── 技术中台/
│ └── REFERENCE.md
├── 预算/
│ └── REFERENCE.md
└── 执行/
└── REFERENCE.md
文件索引
