@teamix-evo/skills 0.4.0 → 0.6.0

package/src/teamix-evo-design-opentrek/rules/layout-rules.json

@@ -0,0 +1,218 @@
+{
+  "version": "1.2",
+  "description": "页面容器规则 — PageContainer 嵌套约束与内容组织模式。所有页面布局遵循此规范。页面框架（TopNavigation/Sidebar/Breadcrumb/返回按钮）由 page-frame.json 定义。",
+  "nestingRules": {
+    "description": "标准嵌套层次，定义页面从外到内的层级结构。",
+    "hierarchy": {
+      "layer1_layout": {
+        "name": "Layout",
+        "description": "最外层布局框架，提供 Sidebar + Header + Footer",
+        "required": true
+      },
+      "layer2_pageContainer": {
+        "name": "PageContainer",
+        "description": "页面级容器，面包屑、标题、操作",
+        "required": true
+      },
+      "layer3_contentWrapper": {
+        "name": "ContentWrapper",
+        "description": "右侧内容大容器，包裹白卡容器",
+        "required": true
+      },
+      "layer4_cardWrapper": {
+        "name": "Card (白卡容器)",
+        "description": "白色卡片容器，包裹 PageHeader + ActionToolbar + 业务组件 + Pagination，形成统一的内容块",
+        "required": true
+      },
+      "layer5_businessComponent": {
+        "name": "内容组件",
+        "description": "具体业务组件（Table / Form / Descriptions / Chart 等）",
+        "required": true
+      }
+    },
+    "constraints": [
+      {
+        "from": "Layout",
+        "to": "PageContainer",
+        "status": "ALLOW"
+      },
+      {
+        "from": "PageContainer",
+        "to": "ContentWrapper",
+        "status": "ALLOW"
+      },
+      {
+        "from": "ContentWrapper",
+        "to": "Card (白卡容器)",
+        "status": "ALLOW"
+      },
+      {
+        "from": "Card (白卡容器)",
+        "to": "PageHeader / ActionToolbar / DataTable / CardGrid / Card / Tabs / QueryFilter / Form / Pagination / BulkActionBar",
+        "status": "ALLOW"
+      },
+      {
+        "from": "ContentWrapper",
+        "to": "PageHeader / ActionToolbar / DataTable / CardGrid / Pagination",
+        "status": "FORBID",
+        "reason": "业务组件必须经过白卡容器包裹，禁止直接挂在 ContentWrapper 下"
+      },
+      {
+        "from": "Card (白卡容器)",
+        "to": "Card (白卡容器)",
+        "status": "FORBID",
+        "reason": "白卡容器为单例，禁止嵌套"
+      },
+      {
+        "from": "PageContainer",
+        "to": "PageContainer",
+        "status": "FORBID",
+        "reason": "禁止嵌套 PageContainer"
+      },
+      {
+        "from": "PageContainer",
+        "to": "DataTable / CardGrid / Pagination",
+        "status": "FORBID",
+        "reason": "业务组件必须经过 ContentWrapper + Card 包裹，禁止直接挂在 PageContainer 下"
+      },
+      {
+        "from": "PageContainer",
+        "to": "PageHeader / Breadcrumb / ActionToolbar",
+        "status": "FORBID",
+        "reason": "PageHeader / Breadcrumb / ActionToolbar 必须在 Card 白卡容器内顶部渲染，禁止直接挂在 PageContainer 下"
+      },
+      {
+        "from": "Card (白卡容器)",
+        "to": "hr / section-divider / Separator",
+        "status": "FORBID",
+        "reason": "Card 内部组件间距通过 padding + margin 控制，禁止使用分割线分隔 PageHeader / ActionToolbar / DataTable 等组件"
+      }
+    ]
+  },
+  "pageContainerModes": {
+    "description": "PageContainer 内容组织的 4 种标准模式。",
+    "modes": {
+      "模式A": {
+        "name": "直接内容",
+        "structure": "PageContainer → ContentWrapper → Card(白卡容器) → PageHeader + Table/Form/Chart + Pagination",
+        "scenario": "简单页面，无需额外分组",
+        "examples": [
+          "简洁列表页",
+          "简单表单页"
+        ]
+      },
+      "模式B": {
+        "name": "Card分组",
+        "structure": "PageContainer → ContentWrapper → Card(白卡容器) → PageHeader + Card[搜索区] + Card[表格区] + Pagination",
+        "scenario": "多区块页面",
+        "examples": [
+          "多区块详情页",
+          "分区表单页"
+        ]
+      },
+      "模式C": {
+        "name": "Tabs分组",
+        "structure": "PageContainer → ContentWrapper → Card(白卡容器) → PageHeader + Tabs → TabPaneA + TabPaneB + Pagination",
+        "scenario": "分类展示",
+        "examples": [
+          "Tab 分类详情页",
+          "多视图设置页"
+        ]
+      },
+      "模式D": {
+        "name": "复合模式",
+        "structure": "PageContainer → ContentWrapper → Card(白卡容器) → PageHeader + ActionToolbar + DataTable + Pagination",
+        "scenario": "列表页标准模式",
+        "examples": [
+          "标准列表页",
+          "高级筛选列表页"
+        ]
+      }
+    }
+  },
+  "pageContainerExtensions": {
+    "description": "v4.0 新增的 PageContainer 扩展模式。",
+    "extensions": {
+      "模式D+": {
+        "name": "高级筛选列表",
+        "structure": "PageContainer → ContentWrapper → Card(白卡容器) → PageHeader + ActionToolbar + AdvancedFilterPanel(可展开) + DataTable + BulkActionBar + Pagination",
+        "scenario": "多条件组合筛选",
+        "detail": "高级筛选按钮位于 ActionToolbar 右侧，展开后显示多条件组合面板，收起后恢复基础 SearchCombo"
+      },
+      "视图切换": {
+        "name": "列表↔卡片视图切换",
+        "structure": "PageContainer → ContentWrapper → Card(白卡容器) → PageHeader + ActionToolbar + ViewToggle[列表|卡片] → CardGrid/DataTable + Pagination",
+        "scenario": "用户可切换视图模式",
+        "cardGridCSS": "grid-template-columns: repeat(auto-fill, minmax(320px, 1fr))，gap 16px",
+        "responsiveBreakpoints": {
+          ">1400px": "4列",
+          "1080-1400px": "3列",
+          "768-1080px": "2列",
+          "<768px": "1列"
+        }
+      },
+      "模式D-CARD": {
+        "name": "常规卡片列表",
+        "structure": "PageContainer → ContentWrapper → Card(白卡容器) → PageHeader + ActionToolbar(ToggleGroup胶囊筛选) + CardGrid(CardGrid > ItemCard + CardActionBar，完整规格见 pages/list-page/patterns/card-list.md §9) + Pagination",
+        "scenario": "有 Sidebar 的纯卡片视图，无 ViewToggle",
+        "cardGridCSS": "grid-template-columns: repeat(auto-fill, minmax(300px, 1fr))，gap 16px",
+        "defaultPageSize": 12,
+        "typicalScenarios": [
+          "分类资源管理",
+          "团队项目卡片",
+          "分组知识库"
+        ]
+      },
+      "模式A-CARD": {
+        "name": "纯卡片列表",
+        "structure": "PageContainer → ContentWrapper → Card(白卡容器) → PageHeader + ActionToolbar(ToggleGroup胶囊筛选) + CardGrid(CardGrid > ItemCard + CardActionBar，完整规格见 pages/list-page/patterns/card-list.md §9) + Pagination",
+        "scenario": "纯卡片视图，无 Sidebar，无 ViewToggle",
+        "cardGridCSS": "grid-template-columns: repeat(auto-fill, minmax(300px, 1fr))，gap 16px",
+        "defaultPageSize": 12,
+        "typicalScenarios": [
+          "智能体管理",
+          "模型管理",
+          "插件管理",
+          "资源目录"
+        ]
+      }
+    }
+  },
+  "layoutToPageMapping": {
+    "description": "页面类型与布局模式的对应关系。",
+    "mapping": [
+      {
+        "pageType": "ListPage(标准)",
+        "mode": "模式D"
+      },
+      {
+        "pageType": "ListPage(高级筛选)",
+        "mode": "模式D+"
+      },
+      {
+        "pageType": "ListPage(视图切换)",
+        "mode": "模式D + ViewToggle"
+      },
+      {
+        "pageType": "ListPage(纯卡片)",
+        "mode": "模式A-CARD"
+      },
+      {
+        "pageType": "ListPage(常规卡片)",
+        "mode": "模式D-CARD"
+      },
+      {
+        "pageType": "ListPage(简洁)",
+        "mode": "模式A"
+      },
+      {
+        "pageType": "DetailPage",
+        "mode": "模式A 或 模式B"
+      },
+      {
+        "pageType": "FormPage",
+        "mode": "模式A 或 模式B"
+      }
+    ]
+  }
+}

package/src/teamix-evo-design-opentrek/rules/page-flow.json

@@ -0,0 +1,351 @@
+{
+  "version": "1.0",
+  "description": "页面流转规则 — CRUD 操作路径 + 页面间导航 + 交互触发逻辑。",
+  "crudFlow": {
+    "description": "标准 CRUD 页面流转路径，定义了操作从源页面到目标页面的完整链路。",
+    "operations": [
+      {
+        "operation": "创建(C)",
+        "sourcePage": "ListPage",
+        "targetPage": "FormPage(新建模式)",
+        "trigger": "点击「新建」按钮",
+        "returnBehavior": "保存成功返回列表，失败留表单页",
+        "urlPattern": "/entity/new",
+        "toastMessage": "创建成功"
+      },
+      {
+        "operation": "读取(R)",
+        "sourcePage": "ListPage",
+        "targetPage": "DetailPage",
+        "trigger": "点击行链接或「查看」按钮",
+        "returnBehavior": "点击「返回」或面包屑回到 ListPage",
+        "urlPattern": "/entity/:id",
+        "toastMessage": null
+      },
+      {
+        "operation": "更新(U)",
+        "sourcePage": "ListPage 或 DetailPage",
+        "targetPage": "FormPage(编辑模式)",
+        "trigger": "点击「编辑」按钮",
+        "returnBehavior": "保存后返回原页面",
+        "urlPattern": "/entity/:id/edit",
+        "toastMessage": "保存成功"
+      },
+      {
+        "operation": "删除(D)",
+        "sourcePage": "ListPage",
+        "targetPage": "Dialog(确认弹窗)",
+        "trigger": "点击「删除」按钮",
+        "returnBehavior": "确认后刷新 ListPage",
+        "urlPattern": "无路由变化",
+        "toastMessage": "删除成功"
+      }
+    ]
+  },
+  "pageNavigation": {
+    "description": "页面间导航交互，定义了各种导航动作的目标页面和返回约定。",
+    "navigations": [
+      {
+        "sourceAction": "操作列「管理/查看」",
+        "targetPage": "DetailPage",
+        "navType": "页面跳转",
+        "returnConvention": "Breadcrumb + PageHeader 提供返回入口，返回后保持列表筛选+分页"
+      },
+      {
+        "sourceAction": "操作列「编辑」",
+        "targetPage": "FormPage 或 Sheet",
+        "navType": "页面跳转/侧滑",
+        "returnConvention": "保存后返回列表，Sonner 提示结果；取消返回列表"
+      },
+      {
+        "sourceAction": "操作列「删除」",
+        "targetPage": "Dialog确认弹窗",
+        "navType": "弹窗",
+        "returnConvention": "确认后刷新列表，Sonner 提示；取消关闭弹窗"
+      },
+      {
+        "sourceAction": "操作列「远程连接」",
+        "targetPage": "Dialog(连接弹窗)",
+        "navType": "弹窗",
+        "returnConvention": "关闭后返回列表"
+      },
+      {
+        "sourceAction": "创建实例",
+        "targetPage": "FormPage(新建模式)",
+        "navType": "页面跳转",
+        "returnConvention": "创建成功/取消后返回列表"
+      },
+      {
+        "sourceAction": "批量创建",
+        "targetPage": "FormPage(批量模式)",
+        "navType": "页面跳转",
+        "returnConvention": "提交后返回列表"
+      },
+      {
+        "sourceAction": "监控图标",
+        "targetPage": "DetailPage(monitor)",
+        "navType": "页面跳转",
+        "returnConvention": "返回后保持列表筛选"
+      },
+      {
+        "sourceAction": "ID 链接点击",
+        "targetPage": "DetailPage",
+        "navType": "页面跳转",
+        "returnConvention": "同操作列「管理」"
+      },
+      {
+        "sourceAction": "搜索执行",
+        "targetPage": "当前列表页(刷新数据)",
+        "navType": "数据刷新",
+        "returnConvention": "保持分页在第1页"
+      },
+      {
+        "sourceAction": "筛选条件变更",
+        "targetPage": "当前列表页(刷新数据)",
+        "navType": "数据刷新",
+        "returnConvention": "重置到第1页，保持筛选条件"
+      },
+      {
+        "sourceAction": "列配置确认",
+        "targetPage": "当前表格(列变更)",
+        "navType": "列显隐切换",
+        "returnConvention": "不刷新数据"
+      }
+    ]
+  },
+  "actionPageCombos": {
+    "description": "页面动作与页面组合模式的标准映射。",
+    "combos": [
+      {
+        "comboName": "列表页标准组合",
+        "actions": "查看 + 编辑 + 删除 + 批量",
+        "uiManifestation": "行内操作按钮 + 顶部批量操作栏",
+        "detail": "查看→详情页；编辑→表单页/行内编辑；删除→确认弹窗；批量→选中行后启用"
+      },
+      {
+        "comboName": "详情页标准组合",
+        "actions": "编辑 + 删除 + 返回",
+        "uiManifestation": "顶部操作栏 + 内容区",
+        "detail": "编辑→跳转表单页；删除→确认弹窗；返回→返回列表页"
+      },
+      {
+        "comboName": "表单页标准组合",
+        "actions": "保存 + 取消 + 提交",
+        "uiManifestation": "底部操作栏(保存/取消) 或 顶部",
+        "detail": "保存→本地校验后提交；取消→确认未保存更改；提交→校验+提交流程"
+      },
+      {
+        "comboName": "Dashboard 标准组合",
+        "actions": "筛选 + 刷新 + 下钻",
+        "uiManifestation": "顶部筛选栏 + 刷新按钮 + 图表可点击",
+        "detail": "筛选→联动刷新所有图表；刷新→重新获取数据；下钻→点击图表进入明细页"
+      }
+    ]
+  },
+  "actionAreaLayout": {
+    "description": "操作区排列规则 — 不同类型页面的操作按钮对齐方式与主按钮位置。",
+    "areas": {
+      "页面级操作区": {
+        "description": "列表页 ActionToolbar、概览页操作区",
+        "alignment": "左右分布（左侧主要操作 + 右侧搜索工具）",
+        "primaryButton": "左侧第一位",
+        "constraint": "同一区域 Primary 按钮最多 1 个",
+        "buttonLimit": "直接展示 ≤3 个，超出入 Dropdown"
+      },
+      "表单操作区": {
+        "description": "表单页底部/顶部操作栏",
+        "alignment": "左对齐（页面表单）/ 右对齐（弹窗表单）",
+        "primaryButton": "页面表单最左侧，弹窗表单最右侧",
+        "constraint": "[取消] [确定] 顺序，主按钮在右侧（弹窗）或左侧（页面）",
+        "buttonLimit": "≤3 个，超出入 Dropdown"
+      },
+      "弹窗操作区": {
+        "description": "Dialog/Sheet 底部操作栏",
+        "alignment": "右对齐",
+        "primaryButton": "最右侧",
+        "constraint": "[取消] [确定] 顺序",
+        "buttonLimit": "≤2-3 个"
+      },
+      "表格行操作区": {
+        "description": "操作列内的行级操作",
+        "alignment": "左对齐（行内）",
+        "primaryButton": "主操作（管理/查看）为第一个链接",
+        "constraint": "≤3 个直接展示，>3 入 Dropdown(···)",
+        "separatorRule": "主操作 | 次要操作 | 状态操作 | 更多，以 | 分隔"
+      }
+    }
+  },
+  "asyncOperationHandling": {
+    "description": "异步操作的 Sonner 反馈与列表刷新规则。",
+    "operations": [
+      {
+        "operationType": "启动/停止/重启",
+        "postBehavior": "异步任务，不阻塞UI",
+        "feedback": "Sonner「操作已提交」",
+        "listRefresh": "轮询状态或任务完成通知"
+      },
+      {
+        "operationType": "删除",
+        "postBehavior": "异步任务",
+        "feedback": "Sonner「删除已提交」",
+        "listRefresh": "移除对应行或刷新列表"
+      },
+      {
+        "operationType": "批量操作",
+        "postBehavior": "异步任务",
+        "feedback": "Sonner「批量操作已提交，共N条」",
+        "listRefresh": "轮询状态"
+      },
+      {
+        "operationType": "创建/批量创建",
+        "postBehavior": "同步跳转",
+        "feedback": "跳转 FormPage",
+        "listRefresh": "创建成功后返回列表"
+      }
+    ]
+  },
+  "operationConfirmationLevels": {
+    "description": "操作确认三级规范。",
+    "levels": [
+      {
+        "level": "一级（可逆）",
+        "confirmationMethod": "无确认，直接执行",
+        "applicableOperations": "查看、编辑、远程连接"
+      },
+      {
+        "level": "二级（有未保存内容）",
+        "confirmationMethod": "Dialog确认弹窗",
+        "applicableOperations": "取消/离开、启动、停止、重启"
+      },
+      {
+        "level": "三级（不可逆）",
+        "confirmationMethod": "Dialog + 输入确认文本",
+        "applicableOperations": "删除（需输入「DELETE」）、资源释放"
+      }
+    ]
+  },
+  "feedbackMechanism": {
+    "description": "反馈机制矩阵，定义各种场景下的反馈类型和持续时间。",
+    "feedbacks": [
+      {
+        "scenario": "操作成功",
+        "type": "Sonner/Sonner 成功提示",
+        "duration": "3s",
+        "note": "「操作成功，实例正在启动」"
+      },
+      {
+        "scenario": "操作失败",
+        "type": "Sonner/Sonner 错误提示",
+        "duration": "5s",
+        "note": "含错误原因"
+      },
+      {
+        "scenario": "异步任务",
+        "type": "通知中心 + Sonner",
+        "duration": "持久",
+        "note": "任务完成时通知"
+      },
+      {
+        "scenario": "加载中",
+        "type": "Skeleton / Spinner",
+        "duration": "至加载完成",
+        "note": "首次加载/筛选加载"
+      },
+      {
+        "scenario": "空数据",
+        "type": "Empty",
+        "duration": "持久",
+        "note": "含创建引导按钮"
+      },
+      {
+        "scenario": "网络异常",
+        "type": "Alert",
+        "duration": "手动关闭",
+        "note": "含重试按钮"
+      },
+      {
+        "scenario": "保存成功",
+        "type": "Sonner/Sonner 提示",
+        "duration": "3s",
+        "note": "「保存成功」"
+      },
+      {
+        "scenario": "删除确认",
+        "type": "Dialog 二次确认",
+        "duration": "用户操作",
+        "note": "危险操作需输入确认文本"
+      }
+    ]
+  },
+  "loadingStrategy": {
+    "description": "加载状态反馈策略，根据等待时间选择适当的加载提示方式。",
+    "thresholds": [
+      {
+        "duration": "< 300ms",
+        "strategy": "无需加载提示",
+        "type": "none"
+      },
+      {
+        "duration": "300ms - 1s",
+        "strategy": "可选加载提示",
+        "type": "optional"
+      },
+      {
+        "duration": "1s - 10s",
+        "strategy": "必须使用加载反馈",
+        "type": "required",
+        "types": [
+          "Skeleton 骨架屏",
+          "区域蒙层 Spinner(50%透明度)",
+          "按钮内 Spinner",
+          "图标 Spinner(24px/32px)"
+        ]
+      },
+      {
+        "duration": "> 10s",
+        "strategy": "进度条 + 预估时间",
+        "type": "progress",
+        "types": [
+          "进度条",
+          "时间预估",
+          "可取消"
+        ]
+      }
+    ],
+    "loadingTypes": {
+      "全局骨架屏": "用于首次加载或页面切换",
+      "区域蒙层Spinner": "用于局部数据刷新，50%透明度遮罩",
+      "按钮内Spinner": "用于提交/保存等按钮操作反馈",
+      "图标Spinner": "用于24px/32px的加载动画图标"
+    }
+  },
+  "keyboardShortcuts": {
+    "description": "全局键盘快捷键。",
+    "shortcuts": [
+      {
+        "key": "Enter",
+        "action": "执行搜索"
+      },
+      {
+        "key": "Esc",
+        "action": "关闭弹窗/取消选择"
+      },
+      {
+        "key": "Ctrl/Cmd + A",
+        "action": "全选当前页"
+      },
+      {
+        "key": "Ctrl/Cmd + F",
+        "action": "聚焦搜索框"
+      },
+      {
+        "key": "↑/↓",
+        "action": "表格行导航（聚焦时）"
+      },
+      {
+        "key": "Space",
+        "action": "切换行选中状态"
+      }
+    ]
+  }
+}