| 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 自动选择对应版本的治理规则执行。
支持的版本
版本检测与路由流程
Step 0: 自动检测工程版本
此步骤在所有其他步骤之前执行，不可跳过。
- 读取当前工程根目录的
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 作为基线默认版本
Step 0 执行示例
检测到工程版本: 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 1: 加载版本规则
根据 Step 0 确定的版本目录，读取该目录下的 REFERENCE.md 文件，获取该版本的完整检查与治理规则。
Step 2: 执行检查或治理
按照加载的版本规则执行具体的项目结构检查或治理操作。规则文件中包含：
- 标准项目分层架构定义
- 检查规则清单（S09 系列 8 条规则）
- 项目脚手架生成模板
- 安全约束
- 所有相关的 examples/、templates/、scripts/ 引用
使用场景
| 场景 | 触发关键词 | 调用功能 |
|---|
| 检查项目目录结构是否合规 | "项目结构检查"、"目录规范"、"分层架构审查" | 版本检测 → 结构检查 |
| 初始化新项目标准结构 | "项目初始化"、"脚手架生成"、"搭建项目" | 版本检测 → 脚手架生成 |
| 治理现有项目结构 | "项目结构治理"、"目录整改"、"结构优化" | 版本检测 → 检查 + 治理 |
前置条件
- 工程为 Vue 3 + TypeScript 前端项目
- 项目根目录存在
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 中该版本特有的规则差异
- 在本文件（SKILL.md）的「支持的版本」表格中添加新条目
- 更新版本映射规则中的匹配逻辑
