메뉴
[Step1] 前端项目目录结构检查与治理工具（多版本适配）。根据工程package.json中的version自动选择对应版本的治理规则。支持3.6.0-SNAPSHOT、3.6.1-SNAPSHOT、3.7.0-SNAPSHOT等多版本。执行链路：Step1（当前）→Step2→Step3→Step4→Step5。当用户提到'项目结构检查'、'目录规范'、'分层架构审查'、'项目初始化'、'脚手架生成'、'项目结构治理'时使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
[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修复'、'架构依赖检查'、'架构依赖修复'、'分层依赖检查'、'分层依赖修复'时使用。
| name | Step1-project-structure-versioned-项目结构治理 |
| description | [Step1] 前端项目目录结构检查与治理工具（多版本适配）。根据工程package.json中的version自动选择对应版本的治理规则。支持3.6.0-SNAPSHOT、3.6.1-SNAPSHOT、3.7.0-SNAPSHOT等多版本。执行链路：Step1（当前）→Step2→Step3→Step4→Step5。当用户提到'项目结构检查'、'目录规范'、'分层架构审查'、'项目初始化'、'脚手架生成'、'项目结构治理'时使用。 |
本技能是前端项目目录结构检查与治理的多版本适配版本。基于 framework-web2-server 项目分包规范，对前端项目的顶层目录、分层架构、组件分层、引用方向等进行标准化约束与治理。不同工程版本可能存在结构差异，本技能会根据工程 package.json 中声明的 version 自动选择对应版本的治理规则执行。
| 工程版本 | 规则目录 | 说明 |
|---|---|---|
3.6.0-SNAPSHOT | versions/3.6.0-SNAPSHOT/ | 基线版本，完整项目结构治理规则 |
3.6.1-SNAPSHOT | versions/3.6.1-SNAPSHOT/ | 增量修订版本 |
3.7.0-SNAPSHOT | versions/3.7.0-SNAPSHOT/ | 新特性版本 |
此步骤在所有其他步骤之前执行，不可跳过。
package.json 文件version 字段的值3.6.0-SNAPSHOT 版本提取到的版本号 → 匹配规则 → 加载的版本规则目录
───────────────────────────────────────────────
3.6.0-SNAPSHOT → 精确匹配 → versions/3.6.0-SNAPSHOT/
3.6.1-SNAPSHOT → 精确匹配 → versions/3.6.1-SNAPSHOT/
3.7.0-SNAPSHOT → 精确匹配 → versions/3.7.0-SNAPSHOT/
3.6.x-SNAPSHOT → 模糊匹配 3.6 → versions/3.6.1-SNAPSHOT/ (取3.6系列最新)
3.7.x-SNAPSHOT → 模糊匹配 3.7 → versions/3.7.0-SNAPSHOT/ (取3.7系列最新)
其他版本 → 降级到默认 → versions/3.6.0-SNAPSHOT/ (基线版本)
模糊匹配逻辑：
3.6.0-SNAPSHOT 作为基线默认版本检测到工程版本: 3.6.0-SNAPSHOT
→ 精确匹配: versions/3.6.0-SNAPSHOT/
→ 加载该版本的 REFERENCE.md 作为执行规则
检测到工程版本: 3.6.1-SNAPSHOT
→ 精确匹配: versions/3.6.1-SNAPSHOT/
→ 加载 versions/3.6.1-SNAPSHOT/REFERENCE.md
检测到工程版本: 4.0.0-SNAPSHOT
→ 无精确匹配，无系列匹配
→ 降级到基线: versions/3.6.0-SNAPSHOT/REFERENCE.md
→ 输出警告: "当前工程版本 4.0.0-SNAPSHOT 无匹配规则，已降级使用 3.6.0-SNAPSHOT 基线规则"
根据 Step 0 确定的版本目录，读取该目录下的 REFERENCE.md 文件，获取该版本的完整检查与治理规则。
按照加载的版本规则执行具体的项目结构检查或治理操作。规则文件中包含：
| 场景 | 触发关键词 | 调用功能 |
|---|---|---|
| 检查项目目录结构是否合规 | "项目结构检查"、"目录规范"、"分层架构审查" | 版本检测 → 结构检查 |
| 初始化新项目标准结构 | "项目初始化"、"脚手架生成"、"搭建项目" | 版本检测 → 脚手架生成 |
| 治理现有项目结构 | "项目结构治理"、"目录整改"、"结构优化" | 版本检测 → 检查 + 治理 |
package.json（用于版本检测）Step1-project-structure-versioned-项目结构治理/
├── SKILL.md # 本文件 - 版本检测与路由入口
└── versions/
├── 3.6.0-SNAPSHOT/ # 基线版本
│ ├── REFERENCE.md # 该版本完整规则
│ ├── examples/ # 项目结构示例
│ ├── templates/ # 脚手架模板
│ └── scripts/ # 检查规则脚本
├── 3.6.1-SNAPSHOT/ # 增量修订版本
│ ├── REFERENCE.md
│ ├── examples/
│ ├── templates/
│ └── scripts/
└── 3.7.0-SNAPSHOT/ # 新特性版本
├── REFERENCE.md
├── examples/
├── templates/
└── scripts/
如需支持新的工程版本：
versions/ 下创建新的版本目录，如 versions/3.8.0-SNAPSHOT/REFERENCE.md 中该版本特有的规则差异