@deepstorm/cli 0.11.0 → 0.11.1

package/dist/skills/sweep-explore/SKILL.md

@@ -14,12 +14,14 @@ deepstorm:
 ## 适用场景
 
 **何时使用：**
+
 - 已有线上运行的系统，但缺乏需求文档/PRD
 - 想为遗留系统添加 E2E 测试覆盖
 - 团队接手一个不熟悉的新项目，想快速理解其功能结构
 - 需要为大型系统按模块逐步添加测试，而非一次性覆盖
 
 **何时不使用：**
+
 - 已有完善的需求文档 → 请使用 `/sweep-plan`（正向流程）
 - 已有现成的 .flow.md 和测试脚本 → 无需再次生成
 - 非主流前端框架（如 Svelte、Solid.js、Preact 等），暂不支持
@@ -46,13 +48,13 @@ flowchart LR
 
 ## 使用方式
 
-| 方式 | 说明 |
-|------|------|
-| **直接启动** | `/sweep-explore` → 自动检测框架并进入探索流程 |
-| **指定项目路径** | `/sweep-explore path=../my-app` → 分析指定路径的前端项目 |
-| **指定框架** | `/sweep-explore framework=react` → 跳过框架检测，按指定框架分析 |
-| **指定模块** | `/sweep-explore module=user-management` → 跳过阶段零和一，直接分析指定模块 |
-| **增量模式** | `/sweep-explore incremental` → 只分析新增模块 |
+| 方式             | 说明                                                                       |
+| ---------------- | -------------------------------------------------------------------------- |
+| **直接启动**     | `/sweep-explore` → 自动检测框架并进入探索流程                              |
+| **指定项目路径** | `/sweep-explore path=../my-app` → 分析指定路径的前端项目                   |
+| **指定框架**     | `/sweep-explore framework=react` → 跳过框架检测，按指定框架分析            |
+| **指定模块**     | `/sweep-explore module=user-management` → 跳过阶段零和一，直接分析指定模块 |
+| **增量模式**     | `/sweep-explore incremental` → 只分析新增模块                              |
 
 ---
 
@@ -69,12 +71,12 @@ flowchart LR
 cat package.json | grep -E '"react"|"@angular/core"|"vue"|"vue-router"|"react-router-dom"' 2>/dev/null
 ```
 
-| 框架 | 关键依赖 | 特征文件 | 路由方案 |
-|------|---------|---------|---------|
-| **React** | `react` + `react-router-dom` / `react-router` | `.jsx` / `.tsx` | React Router v5/v6 |
-| **Angular** | `@angular/core` + `@angular/router` | `@Component` 装饰器 | Angular Router |
-| **Vue 3** | `vue` (3.x) + `vue-router` (4.x) | `.vue` Composition API | vue-router 4 |
-| **Vue 2** | `vue` (2.x) + `vue-router` (3.x) | `.vue` Options API | vue-router 3 |
+| 框架        | 关键依赖                                      | 特征文件               | 路由方案           |
+| ----------- | --------------------------------------------- | ---------------------- | ------------------ |
+| **React**   | `react` + `react-router-dom` / `react-router` | `.jsx` / `.tsx`        | React Router v5/v6 |
+| **Angular** | `@angular/core` + `@angular/router`           | `@Component` 装饰器    | Angular Router     |
+| **Vue 3**   | `vue` (3.x) + `vue-router` (4.x)              | `.vue` Composition API | vue-router 4       |
+| **Vue 2**   | `vue` (2.x) + `vue-router` (3.x)              | `.vue` Options API     | vue-router 3       |
 
 ### 降级策略
 
@@ -82,9 +84,9 @@ cat package.json | grep -E '"react"|"@angular/core"|"vue"|"vue-router"|"react-ro
 
 1. 扫描 `.jsx` / `.tsx` 文件 → 很可能为 React
 2. 扫描 `.vue` 文件 → 很可能为 Vue
-2. 扫描 `@Component` / `@Injectable` 装饰器 → 很可能为 Angular
-3. 对每种可能框架都尝试分析路由，命中最多的结果作为框架推断
-4. 输出检测结果供用户确认
+3. 扫描 `@Component` / `@Injectable` 装饰器 → 很可能为 Angular
+4. 对每种可能框架都尝试分析路由，命中最多的结果作为框架推断
+5. 输出检测结果供用户确认
 
 ```
 🔍 框架检测结果：
@@ -121,14 +123,15 @@ flowchart TD
 
 **常见配置文件：**
 
-| 文件路径 | 路由版本 | 特征 API |
-|---------|---------|---------|
-| `src/routes.tsx` / `src/routes.ts` | v5/v6 | `<Routes>`, `<Route>`, `createBrowserRouter` |
-| `src/router/index.tsx` | v6 | `createBrowserRouter`, `RouterProvider` |
-| `src/App.tsx` | v5/v6 | 内联 `<Switch>` / `<Routes>` |
-| `src/config/routes.ts` | v5 | 对象数组 + `<Route>` 渲染 |
+| 文件路径                           | 路由版本 | 特征 API                                     |
+| ---------------------------------- | -------- | -------------------------------------------- |
+| `src/routes.tsx` / `src/routes.ts` | v5/v6    | `<Routes>`, `<Route>`, `createBrowserRouter` |
+| `src/router/index.tsx`             | v6       | `createBrowserRouter`, `RouterProvider`      |
+| `src/App.tsx`                      | v5/v6    | 内联 `<Switch>` / `<Routes>`                 |
+| `src/config/routes.ts`             | v5       | 对象数组 + `<Route>` 渲染                    |
 
 **分析方法：**
+
 - 提取 `<Route path="..." element={<Component />}>` 的 path 和组件名
 - 提取 `createBrowserRouter([{ path, element }])` 的路由配置
 - 注意 `React.lazy(() => import(...))` 懒加载模式
@@ -138,13 +141,14 @@ flowchart TD
 
 **常见配置文件：**
 
-| 文件路径 | 特征 API |
-|---------|---------|
+| 文件路径                        | 特征 API                       |
+| ------------------------------- | ------------------------------ |
 | `src/app/app-routing.module.ts` | `RouterModule.forRoot(routes)` |
-| `src/app/app.module.ts` | 内联路由配置 |
-| `src/app/*.module.ts` | 各模块的路由配置 |
+| `src/app/app.module.ts`         | 内联路由配置                   |
+| `src/app/*.module.ts`           | 各模块的路由配置               |
 
 **分析方法：**
+
 - 读取 `Routes` 类型数组：`{ path: 'users', component: UserListComponent }`
 - 提取 `loadChildren: () => import('./users/users.module').then(m => m.UsersModule)` 懒加载模块
 - 关注 `canActivate`, `canLoad` 权限守卫——这些是业务规则线索
@@ -155,12 +159,13 @@ flowchart TD
 
 **常见配置文件：**
 
-| 文件路径 | 特征 API |
-|---------|---------|
-| `src/router/index.ts` | `createRouter({ routes })` |
-| `src/router/routes.ts` | 单独的路由配置数组 |
+| 文件路径               | 特征 API                   |
+| ---------------------- | -------------------------- |
+| `src/router/index.ts`  | `createRouter({ routes })` |
+| `src/router/routes.ts` | 单独的路由配置数组         |
 
 **分析方法：**
+
 - 读取 `createRouter` 的 `routes` 数组
 - 提取 `{ path, name, component }` 配置
 - 注意 `() => import('@/views/...')` 懒加载模式
@@ -170,12 +175,13 @@ flowchart TD
 
 **常见配置文件：**
 
-| 文件路径 | 特征 API |
-|---------|---------|
+| 文件路径              | 特征 API                    |
+| --------------------- | --------------------------- |
 | `src/router/index.js` | `new VueRouter({ routes })` |
 | `src/router/index.ts` | `new VueRouter({ routes })` |
 
 **分析方法：**
+
 - 读取 `new VueRouter({ routes })` 配置
 - 与 Vue 3 类似，使用 `() => import(...)` 懒加载
 - `children` 嵌套路由表示父子模块
@@ -200,12 +206,12 @@ find src -name "*.ts" -o -name "*.js" | xargs grep -l "new VueRouter\|new Router
 
 根据检测到的框架，查找对应的导航/菜单组件：
 
-| 框架 | 常见组件/库 | 查找关键词 |
-|------|-----------|-----------|
-| **React** | Ant Design Menu, Material UI List/Sidebar | `Menu`, `Sidebar`, `Sider`, `Nav` |
-| **Angular** | Angular Material Sidenav, PrimeNG Menu | `mat-sidenav`, `p-menu`, `nav`, `sidebar` |
-| **Vue 3** | Element Plus Menu, Naive UI Menu | `el-menu`, `n-menu`, `Sidebar` |
-| **Vue 2** | Element UI NavMenu, iView Menu | `el-menu`, `i-menu`, `NavMenu` |
+| 框架        | 常见组件/库                               | 查找关键词                                |
+| ----------- | ----------------------------------------- | ----------------------------------------- |
+| **React**   | Ant Design Menu, Material UI List/Sidebar | `Menu`, `Sidebar`, `Sider`, `Nav`         |
+| **Angular** | Angular Material Sidenav, PrimeNG Menu    | `mat-sidenav`, `p-menu`, `nav`, `sidebar` |
+| **Vue 3**   | Element Plus Menu, Naive UI Menu          | `el-menu`, `n-menu`, `Sidebar`            |
+| **Vue 2**   | Element UI NavMenu, iView Menu            | `el-menu`, `i-menu`, `NavMenu`            |
 
 **分析查找：**
 
@@ -223,14 +229,15 @@ find src -name "*.vue" | xargs grep -l "el-menu\|n-menu\|sidebar\|Sidebar" 2>/de
 
 **菜单组织方式：**
 
-| 方式 | 说明 |
-|------|------|
-| 硬编码 UI | 组件内直接写菜单项（如 `<el-menu-item>用户管理</el-menu-item>`） |
-| 配置驱动 | 菜单数据与渲染分离，如 `menuConfig: { label: '用户管理', path: '/users' }` |
-| 后端返回 | 菜单由 API 动态返回（`fetchMenu()` 后渲染） |
-| 权限过滤 | 菜单项按角色/权限条件渲染 |
+| 方式      | 说明                                                                       |
+| --------- | -------------------------------------------------------------------------- |
+| 硬编码 UI | 组件内直接写菜单项（如 `<el-menu-item>用户管理</el-menu-item>`）           |
+| 配置驱动  | 菜单数据与渲染分离，如 `menuConfig: { label: '用户管理', path: '/users' }` |
+| 后端返回  | 菜单由 API 动态返回（`fetchMenu()` 后渲染）                                |
+| 权限过滤  | 菜单项按角色/权限条件渲染                                                  |
 
 **分析要点：**
+
 - 菜单项的 label 是业务模块名称的第一手来源
 - 菜单层级组织反映模块的父子关系（如 系统管理 → 用户管理）
 - 注意 `v-if` / `*ngIf` / 条件渲染的菜单——按角色/权限控制是重要线索
@@ -240,11 +247,11 @@ find src -name "*.vue" | xargs grep -l "el-menu\|n-menu\|sidebar\|Sidebar" 2>/de
 
 当路由和菜单信息不足时，通过目录结构辅助判断。不同框架的页面目录命名习惯：
 
-| 框架 | 常见页面目录 | 页面文件扩展名 |
-|------|------------|--------------|
-| **React** | `src/pages/`, `src/views/`, `src/routes/` | `.tsx`, `.jsx` |
-| **Angular** | `src/app/`（每个模块一个目录） | `.ts`（组件类）+ `.html`（模板） |
-| **Vue** | `src/views/`, `src/pages/` | `.vue`（单文件组件） |
+| 框架        | 常见页面目录                              | 页面文件扩展名                   |
+| ----------- | ----------------------------------------- | -------------------------------- |
+| **React**   | `src/pages/`, `src/views/`, `src/routes/` | `.tsx`, `.jsx`                   |
+| **Angular** | `src/app/`（每个模块一个目录）            | `.ts`（组件类）+ `.html`（模板） |
+| **Vue**     | `src/views/`, `src/pages/`                | `.vue`（单文件组件）             |
 
 **示例——视图目录结构（React/Vue）：**
 
@@ -282,6 +289,7 @@ src/app/
 ```
 
 **组合推断规则：**
+
 - 路由 path + 组件名 + 目录名 → 互相印证，取多数一致的结果
 - 路由不足以确定模块归属时，以菜单结构为准（菜单反映业务组织）
 - 路由和菜单都没有时，使用目录结构并标注"推测"
@@ -319,12 +327,12 @@ src/app/
 
    ```
    ⚠️ 系统无法自动发现功能模块。
-   
+
    可能原因：
    - 路由配置方式非标准（如动态路由、后端下发路由）
    - 菜单由后端动态返回，前端无静态配置
    - 项目结构不符合常见约定
-   
+
    建议操作：
    1. 手动输入模块名称，系统将按目录结构分析
    2. 检查路由配置后重新运行
@@ -359,23 +367,27 @@ flowchart TD
 针对选定模块的入口页面组件，按框架特性分析子组件关系。
 
 **通用分析方法：**
+
 1. 读取页面组件的代码
 2. 查看 import / 引用语句，识别子组件
 3. 跟踪子组件文件，理解其功能
 4. 从组件命名推断业务功能
 
 **React 组件分析：**
+
 - 查看 JSX 中使用的子组件标签：`<UserTable>`, `<CreateUserModal>`
 - 从 import 语句追踪组件路径：`import CreateUserModal from './modals/CreateUserModal'`
 - 注意 `React.lazy` 和动态导入
 
 **Angular 组件分析：**
+
 - 查看模板（`.html`）中的选择器标签：`<app-user-table>`, `<app-create-user-modal>`
 - 从模块装饰器 `declarations` / `imports` 中查找组件注册
 - 注意 `@Input()` / `@Output()` 数据流接口
 - 留意 `*ngIf`, `*ngFor` 等结构性指令中的业务逻辑
 
 **Vue 组件分析：**
+
 - 查看 `.vue` 文件中 `<template>` 段的子组件标签
 - 从 `<script>` 段的 `import` / `components` 注册中追踪组件
 - 注意 `v-if`, `v-for` 中的业务逻辑
@@ -396,34 +408,38 @@ flowchart TD
 
 **组件命名约定——常见推断模式（跨框架通用）：**
 
-| 组件名模式 | 推断的业务功能 |
-|-----------|--------------|
-| `*List*`, `*Table*`, `*Grid*` | 列表查看/搜索/分页 |
-| `*Create*`, `*Add*`, `*New*` | 新增创建 |
-| `*Edit*`, `*Update*`, `*Form*` | 编辑修改 |
-| `*Delete*`, `*Remove*` | 删除操作 |
-| `*Detail*`, `*View*` | 详情查看 |
-| `*Modal*`, `*Dialog*`, `*Drawer*` | 弹窗表单 |
-| `*Import*`, `*Upload*` | 数据导入 |
-| `*Export*`, `*Download*` | 数据导出 |
-| `*Approve*`, `*Reject*`, `*Audit*` | 审批/审核 |
-| `*Setting*`, `*Config*` | 配置管理 |
-| `*Chart*`, `*Stat*`, `*Dashboard*` | 数据统计 |
+| 组件名模式                         | 推断的业务功能     |
+| ---------------------------------- | ------------------ |
+| `*List*`, `*Table*`, `*Grid*`      | 列表查看/搜索/分页 |
+| `*Create*`, `*Add*`, `*New*`       | 新增创建           |
+| `*Edit*`, `*Update*`, `*Form*`     | 编辑修改           |
+| `*Delete*`, `*Remove*`             | 删除操作           |
+| `*Detail*`, `*View*`               | 详情查看           |
+| `*Modal*`, `*Dialog*`, `*Drawer*`  | 弹窗表单           |
+| `*Import*`, `*Upload*`             | 数据导入           |
+| `*Export*`, `*Download*`           | 数据导出           |
+| `*Approve*`, `*Reject*`, `*Audit*` | 审批/审核          |
+| `*Setting*`, `*Config*`            | 配置管理           |
+| `*Chart*`, `*Stat*`, `*Dashboard*` | 数据统计           |
 
 ### 2.2 识别 CRUD 流程
 
 根据组件组合推断标准 CRUD 业务流程：
 
 **列表流程（Read）：**
+
 - 页面进入时调用列表 API → 展示分页表格 → 搜索/筛选 → 重新查询
 
 **创建流程（Create）：**
+
 - 点击"新增"按钮 → 打开创建弹窗/页面 → 填写表单 → 提交 → 成功后关闭/刷新列表
 
 **编辑流程（Update）：**
+
 - 点击列表中的"编辑"操作 → 打开编辑弹窗/页面 → 预填数据 → 修改表单 → 提交 → 刷新列表
 
 **删除流程（Delete）：**
+
 - 点击删除操作 → 弹出确认对话框 → 用户确认 → 执行删除 → 刷新列表
 
 ### 2.3 识别状态流转
@@ -431,6 +447,7 @@ flowchart TD
 对于包含状态变更的业务流程（如审批、订单流转）：
 
 **查找线索：**
+
 - 状态枚举/常量定义（`type OrderStatus = 'pending' | 'approved' | 'rejected'`）
 - 状态机逻辑（`switch` / `if-else` 状态判断）
 - 业务状态对应的操作按钮（条件渲染的 action）
@@ -440,10 +457,10 @@ flowchart TD
 ```typescript
 // 状态枚举
 enum OrderStatus {
-  PENDING = 'PENDING',       // 待审核
-  APPROVED = 'APPROVED',     // 已通过
-  REJECTED = 'REJECTED',     // 已驳回
-  CANCELLED = 'CANCELLED',   // 已取消
+  PENDING = 'PENDING', // 待审核
+  APPROVED = 'APPROVED', // 已通过
+  REJECTED = 'REJECTED', // 已驳回
+  CANCELLED = 'CANCELLED', // 已取消
 }
 
 // 状态 → 可操作映射
@@ -451,16 +468,18 @@ const STATUS_ACTIONS = {
   [OrderStatus.PENDING]: ['approve', 'reject'],
   [OrderStatus.APPROVED]: ['view'],
   [OrderStatus.REJECTED]: ['edit', 'delete'],
-}
+};
 ```
 
 ### 2.4 识别导入导出
 
 **导入流程（Import/Upload）：**
+
 - 查找 `<input type="file">` 或 Upload/Dropzone 组件
 - 关联的提交按钮和结果页面（导入进度、导入结果）
 
 **导出流程（Export/Download）：**
+
 - 查找导出按钮（如 `<Button>导出</Button>`）
 - 关联的文件格式选择、导出参数设置、下载处理
 
@@ -487,19 +506,19 @@ const STATUS_ACTIONS = {
 
    ```
    ⚠️ 系统无法自动推断 [模块名] 的业务流程。
-   
+
    可能原因：
    - 组件命名不包含业务语义（如 GenericForm、MyTable）
    - 业务逻辑通过配置驱动或后端下发
    - 代码结构复杂，涉及跨模块引用
-   
+
    以下是该模块的组件目录结构：
    src/modules/xxx/
    ├── components/
    │   ├── GenericForm.vue       ← 可能是表单组件
    │   ├── DataTable.vue         ← 可能是列表组件
    │   └── ActionBar.vue         ← 可能是操作按钮
-   
+
    请手动描述该模块包含哪些业务功能，例如：
    - "用户列表查看 → 创建用户 → 编辑用户 → 删除用户"
    - "订单列表 → 审核订单 → 导出订单"
@@ -519,11 +538,11 @@ const STATUS_ACTIONS = {
 
 每个业务流程的 .flow.md 需要覆盖以下三类场景：
 
-| 场景类型 | 说明 | 优先级 |
-|---------|------|-------|
-| **正常流程** | 业务操作成功完成的路径 | P0 |
-| **边界条件** | 输入边界值、空数据、极限情况 | P1 |
-| **异常流程** | 必填校验、重复提交、网络超时等 | P1 |
+| 场景类型     | 说明                           | 优先级 |
+| ------------ | ------------------------------ | ------ |
+| **正常流程** | 业务操作成功完成的路径         | P0     |
+| **边界条件** | 输入边界值、空数据、极限情况   | P1     |
+| **异常流程** | 必填校验、重复提交、网络超时等 | P1     |
 
 ### 3.1 生成正常路径场景
 
@@ -535,11 +554,13 @@ const STATUS_ACTIONS = {
 ## Flow: L01 - 创建用户正常流程
 
 ### 前置条件
+
 - 用户已登录系统
 - 用户有「用户管理」权限
 - 用户列表页面已加载
 
 ### 执行步骤
+
 1. 点击"新增用户"按钮
    ✅ 验证点：弹出创建用户弹窗，表单包含用户名、邮箱、角色等字段
 2. 填写必填字段（用户名：`testuser`、邮箱：`test@example.com`、角色：`普通用户`）
@@ -550,6 +571,7 @@ const STATUS_ACTIONS = {
    ✅ 验证点：搜索结果仅包含新创建的用户
 
 ### 环境要求
+
 - 目标环境：test
 - 所需账号：管理员权限账号
 ```
@@ -560,9 +582,11 @@ const STATUS_ACTIONS = {
 ## Flow: L02 - 创建用户边界条件
 
 ### 前置条件
+
 - 用户已登录系统
 
 ### 执行步骤
+
 1. 点击"新增用户"按钮，不填写任何字段，直接点击"保存"
    ✅ 验证点：表单校验提示必填字段错误，弹窗未关闭
 2. 用户名输入超过最大长度的文本（如 50 个字符）
@@ -577,9 +601,11 @@ const STATUS_ACTIONS = {
 ## Flow: L03 - 创建用户异常场景
 
 ### 前置条件
+
 - 用户已登录系统
 
 ### 执行步骤
+
 1. 点击"新增用户"按钮，填写必填字段，提交前断网
 2. 点击"保存"按钮
    ✅ 验证点：显示网络错误提示，弹窗未关闭，数据未提交
@@ -601,24 +627,27 @@ const STATUS_ACTIONS = {
 
 ## 场景清单
 
-| ID | 场景 | 类型 | 优先级 |
-|----|------|------|--------|
-| L01 | 创建用户正常流程 | 正常流程 | P0 |
-| L02 | 创建用户边界条件 | 边界条件 | P1 |
-| L03 | 创建用户异常场景 | 异常场景 | P1 |
+| ID  | 场景             | 类型     | 优先级 |
+| --- | ---------------- | -------- | ------ |
+| L01 | 创建用户正常流程 | 正常流程 | P0     |
+| L02 | 创建用户边界条件 | 边界条件 | P1     |
+| L03 | 创建用户异常场景 | 异常场景 | P1     |
 
 ---
 
 ## Flow: L01 - 创建用户正常流程
 
 ### 前置条件
+
 ...
 
 ### 执行步骤
+
 1. {操作步骤}
    ✅ 验证点：{预期结果}
 
 ### 环境要求
+
 ...
 ```
 
@@ -646,12 +675,12 @@ const STATUS_ACTIONS = {
 
 ### 4.1 .flow.md → Playwright 语义映射
 
-| .flow.md 元素 | Playwright 代码 | 说明 |
-|--------------|----------------|------|
-| 前置条件 | `test.beforeEach()` | 登录、导航到页面 |
-| 执行步骤 中的操作 | `page.locator().click()` / `.fill()` / `.selectOption()` | 页面交互 |
-| ✅ 验证点 | `expect().toBeVisible()` / `.toHaveText()` / `.toHaveValue()` | 断言 |
-| 环境要求 | `baseURL` 配置 | 测试配置 |
+| .flow.md 元素     | Playwright 代码                                               | 说明             |
+| ----------------- | ------------------------------------------------------------- | ---------------- |
+| 前置条件          | `test.beforeEach()`                                           | 登录、导航到页面 |
+| 执行步骤 中的操作 | `page.locator().click()` / `.fill()` / `.selectOption()`      | 页面交互         |
+| ✅ 验证点         | `expect().toBeVisible()` / `.toHaveText()` / `.toHaveValue()` | 断言             |
+| 环境要求          | `baseURL` 配置                                                | 测试配置         |
 
 ### 4.2 生成脚本模板
 
@@ -772,13 +801,13 @@ test('L01 - 创建用户正常流程', async ({ page }) => {
 
 ### 命令速查
 
-| 命令 | 说明 |
-|------|------|
-| `/sweep-explore` | 启动完整探索流程（阶段零 → 四） |
-| `/sweep-explore module=<name>` | 跳过阶段零和一，直接分析指定模块 |
-| `/sweep-explore framework=react\|angular\|vue3\|vue2` | 跳过框架检测，按指定框架执行 |
-| `/sweep-explore path=<project-path>` | 分析指定路径的前端项目 |
-| `/sweep-explore incremental` | 增量模式，只分析新增模块 |
+| 命令                                                  | 说明                             |
+| ----------------------------------------------------- | -------------------------------- |
+| `/sweep-explore`                                      | 启动完整探索流程（阶段零 → 四）  |
+| `/sweep-explore module=<name>`                        | 跳过阶段零和一，直接分析指定模块 |
+| `/sweep-explore framework=react\|angular\|vue3\|vue2` | 跳过框架检测，按指定框架执行     |
+| `/sweep-explore path=<project-path>`                  | 分析指定路径的前端项目           |
+| `/sweep-explore incremental`                          | 增量模式，只分析新增模块         |
 
 ### 源码分析优先级
 
@@ -788,8 +817,8 @@ test('L01 - 创建用户正常流程', async ({ page }) => {
 
 ### 场景类型覆盖
 
-| 类型 | 覆盖内容 | 优先级 |
-|------|---------|-------|
-| 正常流程 | 业务操作成功完成的路径 | P0 |
-| 边界条件 | 空数据、极限值、特殊字符 | P1 |
-| 异常场景 | 必填校验、重复提交、网络超时 | P1 |
+| 类型     | 覆盖内容                     | 优先级 |
+| -------- | ---------------------------- | ------ |
+| 正常流程 | 业务操作成功完成的路径       | P0     |
+| 边界条件 | 空数据、极限值、特殊字符     | P1     |
+| 异常场景 | 必填校验、重复提交、网络超时 | P1     |

package/dist/skills/sweep-explore/references/explore-flow-template.md

@@ -7,21 +7,21 @@
 
 ## 模块信息
 
-| 字段 | 内容 |
-| :--- | :--- |
-| 模块名 | {模块名，如 用户管理} |
-| 源码路径 | {对应的前端源码目录} |
+| 字段     | 内容                   |
+| :------- | :--------------------- |
+| 模块名   | {模块名，如 用户管理}  |
+| 源码路径 | {对应的前端源码目录}   |
 | 涉及页面 | {页面列表，以逗号分隔} |
 
 ---
 
 ## 场景清单
 
-| ID | 场景 | 类型 | 优先级 |
-| :--- | :--- | :--- | :--- |
-| L01 | {场景标题} | 正常流程 | P0 |
-| L02 | {场景标题} | 边界条件 | P1 |
-| L03 | {场景标题} | 异常场景 | P1 |
+| ID  | 场景       | 类型     | 优先级 |
+| :-- | :--------- | :------- | :----- |
+| L01 | {场景标题} | 正常流程 | P0     |
+| L02 | {场景标题} | 边界条件 | P1     |
+| L03 | {场景标题} | 异常场景 | P1     |
 
 ---
 

package/dist/skills/sweep-init/SKILL.md

@@ -37,6 +37,7 @@ cat .deepstorm/settings.json 2>/dev/null | grep -o '"e2eFramework"[^,]*' | head
 如果配置不存在或为空，使用默认值 `playwright` 并输出提示。
 
 当前支持的框架：
+
 - **playwright** — Microsoft Playwright（默认）
 
 ---
@@ -57,10 +58,12 @@ cat .deepstorm/settings.json 2>/dev/null | grep -o '"e2eFramework"[^,]*' | head
 ```
 
 **如果选择 a（独立项目）：**
+
 - 设置 TARGET_DIR 为当前目录（`.`）
 - 继续到步骤 1
 
 **如果选择 b（混放项目）：**
+
 - 进一步询问子目录选择：
 
 ```
@@ -114,6 +117,7 @@ node packages/sweep/skills/sweep-init/scripts/init-project.mjs \
 ```
 
 脚本会自动：
+
 - 创建 `flows/`、`flows/reports/`、`scripts/` 目录
 - 生成 `package.json`（含框架对应依赖）、`tsconfig.json`、`playwright.config.ts`（仅 playwright）
 - 不覆盖已有的 `topology.yaml`

package/dist/skills/sweep-init/scripts/flow-selector.mjs

@@ -88,14 +88,10 @@ export function resolveFlowFile(modulePath, flowsDir = BASE_FLOWS_DIR) {
 
   const parts = modulePath.split('/');
   const leafName = parts[parts.length - 1];
-  const parentDir = parts.length > 1
-    ? join(flowsDir, parts.slice(0, -1).join('/'))
-    : flowsDir;
+  const parentDir = parts.length > 1 ? join(flowsDir, parts.slice(0, -1).join('/')) : flowsDir;
   if (existsSync(parentDir)) {
     const files = readdirSync(parentDir);
-    const found = files.find(
-      (f) => f.endsWith('.flow.md') && f.toLowerCase().includes(leafName.toLowerCase())
-    );
+    const found = files.find((f) => f.endsWith('.flow.md') && f.toLowerCase().includes(leafName.toLowerCase()));
     if (found) return join(parentDir, found);
   }
 
@@ -187,7 +183,9 @@ export function normalizeSelection(answer) {
         if (!fileMap.has(file)) fileMap.set(file, []);
         const flows = fileMap.get(file);
         if (!flows.includes(flowId)) flows.push(flowId);
-      } catch { /* ignore */ }
+      } catch {
+        /* ignore */
+      }
     }
   }
 
@@ -278,10 +276,7 @@ async function main() {
       }
     }
 
-    choices = [
-      { name: '📋 全部执行', value: '__all__' },
-      ...choices,
-    ];
+    choices = [{ name: '📋 全部执行', value: '__all__' }, ...choices];
 
     const { default: checkbox } = await import('@inquirer/checkbox');
     const answer = await checkbox({