@agile-team/wl-skills-kit 1.2.1 → 2.1.1

package/files/.github/skills/core/page-codegen/templates/domains/sale/README.md

@@ -0,0 +1,26 @@
+# 销售域专属模板（待沉淀）
+
+本目录用于沉淀**销售域**特有的页面模板，目前为空。
+
+---
+
+## 待提取候选
+
+如果销售域出现 3+ 页面遵循的非标准交互模式，可考虑提取。当前观察到的可能候选：
+
+- 国内贸易订单 + 期货订单 + 国外订单 → 是否存在共性"订单录入页"模式？
+- 客户档案 + 信用档案 + 资信档案 → 是否存在共性"多档案合一管理"模式？
+
+---
+
+## 如何提取
+
+使用 `skills/core/template-extract/SKILL.md` 自动提取。详见 `templates/domains/_CONTRIBUTING.md`。
+
+---
+
+## 提交模板时
+
+1. 文件命名 `TPL-{NAME}.md` 放在本目录
+2. 同步更新 `templates/_index.md` 注册条目
+3. 删除本说明文件（README.md），让本目录成为正式模板目录

package/files/.github/skills/{page-codegen → core/page-codegen/templates/universal}/TPL-DETAIL-TABS.md

@@ -2,7 +2,6 @@
 
 > 见 SKILL.md 主文件（约束 + 按钮规则 + Mock 规范等共用规则）。
 
-
 > 适用场景：编辑/维护页面，上半区为多 Tab 表单（基本信息/客户信息/其他信息），下半区为子项表格。
 > 布局核心：`C_Splitter direction="vertical"` 垂直分割上下区域。
 > **参考标杆**：`src/views/sale/demo/add-demo/`、`src/views/sale/demo/domestic-trade-order-mainten/`
@@ -117,7 +116,7 @@ import {
   handleCancel,
   addItem,
   loadItems,
-  initPage
+  initPage,
 } from "./data";
 
 onMounted(() => initPage());
@@ -144,7 +143,7 @@ export const API_CONFIG = {
   update: "/[服务缩写]/[主资源]/update",
   itemList: "/[服务缩写]/[子资源]/list",
   itemSave: "/[服务缩写]/[子资源]/save",
-  itemRemove: "/[服务缩写]/[子资源]/remove"
+  itemRemove: "/[服务缩写]/[子资源]/remove",
 } as const;
 
 // ===== 表单状态 =====
@@ -161,7 +160,12 @@ export const rules: FormRules = {
 
 // ===== 表单字段配置（驱动 template 动态渲染） =====
 export const basicFields = [
-  { name: "orderNo", label: "订单号", placeholder: "系统自动生成", disabled: true },
+  {
+    name: "orderNo",
+    label: "订单号",
+    placeholder: "系统自动生成",
+    disabled: true,
+  },
   { name: "customerName", label: "客户名称", required: true },
   {
     name: "orderType",
@@ -169,10 +173,10 @@ export const basicFields = [
     type: "select",
     options: [
       { label: "期货合同", value: "期货合同" },
-      { label: "现货合同", value: "现货合同" }
-    ]
+      { label: "现货合同", value: "现货合同" },
+    ],
   },
-  { name: "createDate", label: "创建日期", type: "date" }
+  { name: "createDate", label: "创建日期", type: "date" },
 ];
 
 // ===== 子项表格 =====
@@ -191,10 +195,10 @@ export const itemColumns: TableColumnDesc<any>[] = [
       {
         name: "remove",
         label: "删除",
-        onClick: (row: any) => removeItem(row)
-      }
-    ]
-  }
+        onClick: (row: any) => removeItem(row),
+      },
+    ],
+  },
 ];
 
 // ===== 数据加载 =====
@@ -202,7 +206,7 @@ export async function loadItems() {
   const res = await getAction(API_CONFIG.itemList, {
     mainId: form.id,
     current: itemPage.current,
-    size: itemPage.size
+    size: itemPage.size,
   });
   const data = res.result || res.data;
   itemList.value = data?.records || data?.list || [];
@@ -331,7 +335,13 @@ export async function initPage() {
     :close-on-click-modal="false"
     @close="handleClose"
   >
-    <el-form ref="formRef" :model="form" :rules="rules" label-width="100px" :disabled="mode === 'view'">
+    <el-form
+      ref="formRef"
+      :model="form"
+      :rules="rules"
+      label-width="100px"
+      :disabled="mode === 'view'"
+    >
       <el-row :gutter="20">
         <el-col :span="12">
           <el-form-item label="[字段名]" prop="[fieldKey]">
@@ -346,8 +356,16 @@ export async function initPage() {
       </el-row>
     </el-form>
     <template #footer>
-      <el-button @click="handleClose">{{ mode === "view" ? "关闭" : "取消" }}</el-button>
-      <el-button v-if="mode !== 'view'" type="primary" :loading="loading" @click="handleSubmit">确定</el-button>
+      <el-button @click="handleClose">{{
+        mode === "view" ? "关闭" : "取消"
+      }}</el-button>
+      <el-button
+        v-if="mode !== 'view'"
+        type="primary"
+        :loading="loading"
+        @click="handleSubmit"
+        >确定</el-button
+      >
     </template>
   </el-dialog>
 </template>
@@ -366,11 +384,15 @@ const loading = ref(false);
 const formRef = ref<FormInstance>();
 
 const title = computed(() =>
-  mode.value === "add" ? "新增[实体名]" : mode.value === "edit" ? "编辑[实体名]" : "查看[实体名]"
+  mode.value === "add"
+    ? "新增[实体名]"
+    : mode.value === "edit"
+      ? "编辑[实体名]"
+      : "查看[实体名]",
 );
 
 const initialForm = () => ({
-  id: ""
+  id: "",
   // [表单字段初始值]
 });
 
@@ -459,7 +481,7 @@ const {
   queryItems,
   columns,
   toolbars,
-  select
+  select,
 } = Page;
 
 onMounted(() => select());
@@ -570,7 +592,12 @@ export function createPage(editModalRef?: any) {
 ```vue
 <template>
   <div class="app-container app-page-container">
-    <BaseQuery :form="queryParam" :items="queryItems" @select="select" @reset="select" />
+    <BaseQuery
+      :form="queryParam"
+      :items="queryItems"
+      @select="select"
+      @reset="select"
+    />
     <BaseToolbar :items="toolbars" />
     <el-tabs v-model="activeView">
       <el-tab-pane label="管理视角" name="management">
@@ -598,7 +625,12 @@ export function createPage(editModalRef?: any) {
 </template>
 
 <script setup lang="ts">
-import { createPage, modalConfig, managementColumns, usageColumns } from "./data";
+import {
+  createPage,
+  modalConfig,
+  managementColumns,
+  usageColumns,
+} from "./data";
 import c_formModal from "@/components/local/c_formModal/index.vue";
 
 const editModalRef = ref();
@@ -614,6 +646,7 @@ onMounted(() => select());
 ```
 
 **要点**：
+
 - ❌ 不使用 `el-radio-group` + 手动 `handleViewChange` 切换 columns
 - ✅ 使用 `el-tabs` + 每个 pane 内放独立 BaseTable
 - ✅ 两个表格共享同一 `list` 数据源和 `tableRef`
@@ -681,6 +714,7 @@ const FORM_ROUTE = "/aiflow/mmwrCustomerApplyAddForm";
 ```
 
 如何确定 FORM_ROUTE：
+
 - `subModuleKey`：取自 pages.ts 中 `gProd("xxx", { subModuleKey: [...] })` 的 key
 - `menuPath`：取自后端菜单表的「菜单路径」字段（camelCase）
 - 不确定时，在浏览器点击侧边栏已有菜单项，观察 URL 格式
@@ -758,10 +792,14 @@ const Page = createPage();
       <span class="page-title">客户申请详情</span>
       <span class="page-tag page-tag--add">新增</span>
       <span class="page-tag page-tag--status">未审核</span>
-      <el-checkbox v-model="onlyRequired" class="only-required-check">只看必填项</el-checkbox>
+      <el-checkbox v-model="onlyRequired" class="only-required-check"
+        >只看必填项</el-checkbox
+      >
     </div>
     <div class="page-toolbar">
-      <el-button type="danger" @click="handleSaveAndChange">保存并变更</el-button>
+      <el-button type="danger" @click="handleSaveAndChange"
+        >保存并变更</el-button
+      >
       <el-button type="warning" @click="handleSave">保存</el-button>
       <el-button @click="handleCancel">取消</el-button>
     </div>
@@ -810,7 +848,11 @@ onMounted(() => {
 ```vue
 <!-- 表格列：v-if 按 mode 控制 -->
 <el-table-column v-if="isChange" label="使用组织" prop="useOrg" />
-<el-table-column v-if="!isChange && !isView" label="免息天数" prop="interestFreeDays" />
+<el-table-column
+  v-if="!isChange && !isView"
+  label="免息天数"
+  prop="interestFreeDays"
+/>
 
 <!-- 操作列：变更模式多一个编辑按钮 -->
 <el-table-column v-if="!isView" label="操作" :width="isChange ? 120 : 80">
@@ -821,12 +863,24 @@ onMounted(() => {
 </el-table-column>
 
 <!-- 底部新增行链接（变更模式） -->
-<div v-if="isChange && !isView" class="add-row-link" @click="addRow">+新增行</div>
+<div
+  v-if="isChange && !isView"
+  class="add-row-link"
+  @click="addRow"
+>+新增行</div>
 
 <!-- Tab 顺序差异：用 v-if 控制渲染位置 -->
-<el-tab-pane v-if="isChange" label="地址信息" name="addressInfo">...</el-tab-pane>
+<el-tab-pane
+  v-if="isChange"
+  label="地址信息"
+  name="addressInfo"
+>...</el-tab-pane>
 <el-tab-pane label="联系人信息" name="contactInfo">...</el-tab-pane>
-<el-tab-pane v-if="!isChange" label="地址信息" name="addressInfo">...</el-tab-pane>
+<el-tab-pane
+  v-if="!isChange"
+  label="地址信息"
+  name="addressInfo"
+>...</el-tab-pane>
 
 <!-- 状态信息区（所有模式均显示，disabled 只读展示） -->
 <div class="status-info-section">
@@ -975,7 +1029,7 @@ spec.features.hiddenMenu === true：
 
 ### 菜单配置
 
-> 菜单配置统一生成到 `.github/docs/SYS_MENU_INFO.md`（集中式），生成规则见 SKILL.md 主文件的「SYS_MENU_INFO 生成规则」章节。
+> 菜单配置统一生成到 `.github/reports/SYS_MENU_INFO.md`（集中式），生成规则见 SKILL.md 主文件的「SYS_MENU_INFO 生成规则」章节。
 
 ---
 
@@ -984,6 +1038,7 @@ spec.features.hiddenMenu === true：
 在项目根目录 `mock/` 下生成，`vite-plugin-mock`（`mockPath: "./mock"`）自动加载，**无需手动注册**。
 
 **要求**：
+
 - URL 和字段与 api.md 完全一致
 - 使用 `MockMethod[]` 类型 + `mockjs` 生成数据
 - 分页查询返回 `{ code, msg, data: { records, total, size, current } }` 结构
@@ -999,7 +1054,7 @@ const Random = Mock.Random;
 
 // 字典选项：从 api.md 字典表复制
 const DICT = {
-  status_code: ["值1", "值2"]
+  status_code: ["值1", "值2"],
 };
 
 // 单条记录生成器：字段对齐 api.md Response
@@ -1008,7 +1063,7 @@ function genRecord() {
     id: Random.id(),
     fieldName: Random.cword(2, 4),
     statusField: Random.pick(DICT.status_code),
-    createTime: Random.datetime("yyyy-MM-dd HH:mm:ss")
+    createTime: Random.datetime("yyyy-MM-dd HH:mm:ss"),
   };
 }
 
@@ -1031,10 +1086,10 @@ const mockApi: MockMethod[] = [
           records: dataPool.slice(start, start + size),
           total: dataPool.length,
           size,
-          current
-        }
+          current,
+        },
       };
-    }
+    },
   },
   {
     url: "/dev-api/[服务缩写]/[资源名]/getById",
@@ -1042,21 +1097,21 @@ const mockApi: MockMethod[] = [
     response: ({ query }: any) => ({
       code: 200,
       msg: "操作成功",
-      data: dataPool.find((d) => d.id === query.id) || dataPool[0]
-    })
+      data: dataPool.find((d) => d.id === query.id) || dataPool[0],
+    }),
   },
   {
     url: "/dev-api/[服务缩写]/[资源名]/remove",
     method: "delete",
     response: ({ query, body }: any) => {
       const id = query?.id || body?.id;
-      const ids = id ? [id] : (query?.ids?.split(",") || body?.ids || []);
+      const ids = id ? [id] : query?.ids?.split(",") || body?.ids || [];
       ids.forEach((rid: string) => {
         const idx = dataPool.findIndex((d) => d.id === rid);
         if (idx > -1) dataPool.splice(idx, 1);
       });
       return { code: 200, msg: "删除成功", data: null };
-    }
+    },
   },
   {
     url: "/dev-api/[服务缩写]/[资源名]/save",
@@ -1065,7 +1120,7 @@ const mockApi: MockMethod[] = [
       const newRecord = { ...genRecord(), ...body, id: Random.id() };
       dataPool.unshift(newRecord);
       return { code: 200, msg: "保存成功", data: { id: newRecord.id } };
-    }
+    },
   },
   {
     url: "/dev-api/[服务缩写]/[资源名]/update",
@@ -1074,8 +1129,8 @@ const mockApi: MockMethod[] = [
       const idx = dataPool.findIndex((d) => d.id === body?.id);
       if (idx > -1) Object.assign(dataPool[idx], body);
       return { code: 200, msg: "更新成功", data: null };
-    }
-  }
+    },
+  },
 ];
 
 export default mockApi;

package/files/.github/skills/{page-codegen → core/page-codegen/templates/universal}/TPL-DRIVEN.md

@@ -1,124 +1,124 @@
-# TEMPLATE_DRIVEN：配置驱动模板页（识别参考）
-
-> ⚠️ **本文件为识别参考，不是代码生成模板。**
-> 配置驱动页面已由现有业务模板组件封装，AI **只需生成 config 配置对象**，不得套用 TPL-A 至 TPL-G 的结构重新手写页面逻辑。
-
----
-
-## 什么是配置驱动模板页
-
-这类页面的 `index.vue` 极为简单，只有 1-3 行：
-
-```vue
-<template>
-  <div class="app-container app-page-container">
-    <XxxTemplate :config="xxxConfig" />
-  </div>
-</template>
-
-<script setup lang="ts">
-import { xxxConfig } from "./data";
-</script>
-```
-
-所有业务逻辑（查询、表格列、导出、翻译等）全部由模板组件内部处理，`data.ts` 只需导出一个 `config` 对象。
-
----
-
-## 已知配置驱动模板一览
-
-> ⚠️ **以下模板是基于高度相似的特定业务场景提炼的**，仅适用于列出的具体页面类型。不得因为"看起来相似"就套用到其他业务场景，否则会出现功能异常。
-
-### 1. ResultQueryTemplate（轧钢实绩查询类）
-
-**适用范围**：`production-mmwr/sjtj/` 下的各工序实绩查询页（查询+表格+导出，无新增/编辑/删除）
-
-**识别特征**：
-- 原型中只有查询区 + 数据表格 + 导出按钮
-- 无 CRUD 操作，纯查询
-- 字段较多，表格列数 10+
-
-**生成规则**：
-
-```typescript
-// data.ts — 只导出一个 config 对象
-import type { ResultQueryConfig } from "@/components/template/ResultQueryTemplate/types";
-import { BusLogicDataType } from "@/types/page";
-
-export const [pageName]Config: ResultQueryConfig = {
-  api: {
-    list: "/[服务缩写]/[资源名]/list",
-    export: "/[服务缩写]/[资源名]/export"  // 有导出时才加
-  },
-  queryItems: [
-    // 同 Template A 的 queryDef 格式
-    { name: "[field]", label: "[中文名]", placeholder: "请输入" },
-    {
-      name: "[dateField]",
-      type: "range",
-      startName: "[startDate]",
-      endName: "[endDate]",
-      label: "[日期名]",
-      logicType: BusLogicDataType.date,
-      rangeSeparator: "至"
-    }
-  ],
-  columns: [
-    // 同 Template A 的 columnsDef 格式（无 selection/index/操作列）
-    { label: "[列名]", name: "[fieldName]", minWidth: 120 }
-  ]
-};
-```
-
-```vue
-<!-- index.vue -->
-<template>
-  <ResultQueryTemplate :config="[pageName]Config" />
-</template>
-
-<script setup lang="ts">
-import ResultQueryTemplate from "@/components/template/ResultQueryTemplate/index.vue";
-import { [pageName]Config } from "./data";
-</script>
-```
-
----
-
-### 2. FinishingAchievementTemplate（精整实绩类）
-
-**适用范围**：`production-mmwr/jzsj/` 下的各精整工序实绩管理页（喷砂、倒棱、矫直、剥皮、检验、酸洗、包装）
-
-**识别特征**：
-- 原型标题含"实绩"二字且在精整工序列表中
-- 有固定的查询区 + 实绩录入 + 汇总数据结构
-- 字段结构高度统一（同一套模板 7 个页面共用）
-
-**生成规则**：参考 `src/components/template/FinishingAchievementTemplate/` 内的 `types.ts` 定义，只生成对应的 config 配置。
-
----
-
-### 3. ApplicationDeterminationTemplate（申请判定类）
-
-**适用范围**：`production-mmwr/` 下的申请判定类页面（如 mmwr-application-determination-jz、mmwr-application-determination-sj）
-
-**识别特征**：原型中有"申请"列表 + "判定"操作的双状态工作流页面
-
----
-
-### 4. SamplingCommissionTemplate（取样委托类）
-
-**适用范围**：`production-mmwr/jhgl/` 下的取样委托管理页（如 mmwr-sampling-commission-jz、mmwr-sampling-commission-sj）
-
-**识别特征**：原型中有"委托单"列表 + 取样记录结构
-
----
-
-## AI 操作规范
-
-1. **识别阶段**：在 page-spec 前置检查时，若页面落入以上任一范围，将交互模式标记为 `TEMPLATE_DRIVEN` 并注明具体模板名
-2. **生成阶段**：只生成 `data.ts`（config 对象）+ `index.vue`（2-3行）+ `index.scss`（空或极少样式）
-3. **禁止行为**：
-   - ❌ 不得手写 `createPage()` + `AbstractPageQueryHook` 结构
-   - ❌ 不得添加独立的 `BaseQuery` / `BaseTable` / `jh-pagination`（模板内部已处理）
-   - ❌ 不得将其他业务场景的页面识别为 TEMPLATE_DRIVEN 并套用以上 config 格式
-4. **不确定时**：如果不确定是否适用配置驱动模板，使用 Template A（LIST）代替，更安全
+# TEMPLATE_DRIVEN：配置驱动模板页（识别参考）
+
+> ⚠️ **本文件为识别参考，不是代码生成模板。**
+> 配置驱动页面已由现有业务模板组件封装，AI **只需生成 config 配置对象**，不得套用 TPL-A 至 TPL-G 的结构重新手写页面逻辑。
+
+---
+
+## 什么是配置驱动模板页
+
+这类页面的 `index.vue` 极为简单，只有 1-3 行：
+
+```vue
+<template>
+  <div class="app-container app-page-container">
+    <XxxTemplate :config="xxxConfig" />
+  </div>
+</template>
+
+<script setup lang="ts">
+import { xxxConfig } from "./data";
+</script>
+```
+
+所有业务逻辑（查询、表格列、导出、翻译等）全部由模板组件内部处理，`data.ts` 只需导出一个 `config` 对象。
+
+---
+
+## 已知配置驱动模板一览
+
+> ⚠️ **以下模板是基于高度相似的特定业务场景提炼的**，仅适用于列出的具体页面类型。不得因为"看起来相似"就套用到其他业务场景，否则会出现功能异常。
+
+### 1. ResultQueryTemplate（轧钢实绩查询类）
+
+**适用范围**：`production-mmwr/sjtj/` 下的各工序实绩查询页（查询+表格+导出，无新增/编辑/删除）
+
+**识别特征**：
+- 原型中只有查询区 + 数据表格 + 导出按钮
+- 无 CRUD 操作，纯查询
+- 字段较多，表格列数 10+
+
+**生成规则**：
+
+```typescript
+// data.ts — 只导出一个 config 对象
+import type { ResultQueryConfig } from "@/components/template/ResultQueryTemplate/types";
+import { BusLogicDataType } from "@/types/page";
+
+export const [pageName]Config: ResultQueryConfig = {
+  api: {
+    list: "/[服务缩写]/[资源名]/list",
+    export: "/[服务缩写]/[资源名]/export"  // 有导出时才加
+  },
+  queryItems: [
+    // 同 Template A 的 queryDef 格式
+    { name: "[field]", label: "[中文名]", placeholder: "请输入" },
+    {
+      name: "[dateField]",
+      type: "range",
+      startName: "[startDate]",
+      endName: "[endDate]",
+      label: "[日期名]",
+      logicType: BusLogicDataType.date,
+      rangeSeparator: "至"
+    }
+  ],
+  columns: [
+    // 同 Template A 的 columnsDef 格式（无 selection/index/操作列）
+    { label: "[列名]", name: "[fieldName]", minWidth: 120 }
+  ]
+};
+```
+
+```vue
+<!-- index.vue -->
+<template>
+  <ResultQueryTemplate :config="[pageName]Config" />
+</template>
+
+<script setup lang="ts">
+import ResultQueryTemplate from "@/components/template/ResultQueryTemplate/index.vue";
+import { [pageName]Config } from "./data";
+</script>
+```
+
+---
+
+### 2. FinishingAchievementTemplate（精整实绩类）
+
+**适用范围**：`production-mmwr/jzsj/` 下的各精整工序实绩管理页（喷砂、倒棱、矫直、剥皮、检验、酸洗、包装）
+
+**识别特征**：
+- 原型标题含"实绩"二字且在精整工序列表中
+- 有固定的查询区 + 实绩录入 + 汇总数据结构
+- 字段结构高度统一（同一套模板 7 个页面共用）
+
+**生成规则**：参考 `src/components/template/FinishingAchievementTemplate/` 内的 `types.ts` 定义，只生成对应的 config 配置。
+
+---
+
+### 3. ApplicationDeterminationTemplate（申请判定类）
+
+**适用范围**：`production-mmwr/` 下的申请判定类页面（如 mmwr-application-determination-jz、mmwr-application-determination-sj）
+
+**识别特征**：原型中有"申请"列表 + "判定"操作的双状态工作流页面
+
+---
+
+### 4. SamplingCommissionTemplate（取样委托类）
+
+**适用范围**：`production-mmwr/jhgl/` 下的取样委托管理页（如 mmwr-sampling-commission-jz、mmwr-sampling-commission-sj）
+
+**识别特征**：原型中有"委托单"列表 + 取样记录结构
+
+---
+
+## AI 操作规范
+
+1. **识别阶段**：在 page-spec 前置检查时，若页面落入以上任一范围，将交互模式标记为 `TEMPLATE_DRIVEN` 并注明具体模板名
+2. **生成阶段**：只生成 `data.ts`（config 对象）+ `index.vue`（2-3行）+ `index.scss`（空或极少样式）
+3. **禁止行为**：
+   - ❌ 不得手写 `createPage()` + `AbstractPageQueryHook` 结构
+   - ❌ 不得添加独立的 `BaseQuery` / `BaseTable` / `jh-pagination`（模板内部已处理）
+   - ❌ 不得将其他业务场景的页面识别为 TEMPLATE_DRIVEN 并套用以上 config 格式
+4. **不确定时**：如果不确定是否适用配置驱动模板，使用 Template A（LIST）代替，更安全