@mingfuyun/star-allinone 0.3.2 → 0.4.0

package/scripts/gen/page.js

@@ -1,8 +1,16 @@
 const fs = require('fs');
 const path = require('path');
-const { toPascal, parseOperationSelector } = require('./names');
+const { toPascal } = require('./names');
 const { generateService } = require('./service');
 const { loadProject, writeFile } = require('./project');
+const {
+  schemaFields,
+  formComponent,
+  columnValueType,
+  fallbackFields,
+  SKIP_FORM,
+  querySearchNames,
+} = require('./fields');
 
 function detectLayout(root) {
   const hasPageContainer = fs.existsSync(path.join(root, 'src/components/PageContainer/index.tsx'));
@@ -28,30 +36,39 @@ function featureNames(options) {
   };
 }
 
-function columnFields(itemTypeSource = '') {
-  const fields = [...itemTypeSource.matchAll(/^\s+(\w+)\??:/gm)].map((match) => match[1]);
-  const preferred = fields.filter((name) => !['created_at', 'updated_at', 'createTime', 'updateTime'].includes(name));
-  return (preferred.length ? preferred : fields).slice(0, 6);
+function searchFieldNames(fields) {
+  return fields
+    .filter((field) => field.name !== 'id' && (field.type === 'string' || !field.type))
+    .slice(0, 2)
+    .map((field) => field.name);
 }
 
-function emitColumns(names, itemType, fields, permissions) {
-  const columns = fields.map((field, index) => {
-    const search = index < 2;
+function emitColumns(names, itemType, fields, permissions, queryNames) {
+  const columnFields = fields.length ? fields : [{ name: 'id', title: 'ID', type: 'string' }];
+  const searchable = new Set(
+    queryNames?.length
+      ? columnFields.filter((field) => queryNames.includes(field.name)).map((field) => field.name)
+      : searchFieldNames(columnFields),
+  );
+  const columns = columnFields.map((field) => {
+    const search = searchable.has(field.name);
     return `  {
-    title: '${field}',
-    dataIndex: '${field}',
-    key: '${field}',
+    title: ${JSON.stringify(field.title)},
+    dataIndex: '${field.name}',
+    key: '${field.name}',
     hideInSearch: ${search ? 'false' : 'true'},
-    ellipsis: true,
-    render: (_, record) => record.${field} ?? '-',
+    ellipsis: true,${valueTypeBlock(field)}${enumBlock(field)}
+    render: (_, record) => record.${field.name} ?? '-',
   }`;
   });
-  if (!columns.length) {
+  for (const name of queryNames || []) {
+    if (columnFields.some((field) => field.name === name)) continue;
     columns.push(`  {
-    title: 'ID',
-    dataIndex: 'id',
-    key: 'id',
-    hideInSearch: true,
+    title: ${JSON.stringify(name)},
+    dataIndex: '${name}',
+    key: '${name}',
+    hideInTable: true,
+    hideInSearch: false,
   }`);
   }
   const permCreate = permissions.create ? `      permission: '${permissions.create}',\n` : '';
@@ -105,14 +122,47 @@ ${permCreate}    onClick: handleCreate,
 `;
 }
 
-function emitIndex(names, layout, types, fns, pagination) {
-  const pageImport = layout.hasPageContainer
+function valueTypeBlock(field) {
+  const valueType = columnValueType(field);
+  return valueType ? `\n    valueType: '${valueType}',` : '';
+}
+
+function enumBlock(field) {
+  if (field.enum?.length) {
+    const entries = field.enum
+      .map((value) => `      ${JSON.stringify(String(value))}: { text: ${JSON.stringify(String(value))} }`)
+      .join(',\n');
+    return `\n    valueEnum: {\n${entries},\n    },`;
+  }
+  if (field.type === 'boolean') {
+    return `\n    valueEnum: { true: { text: '是' }, false: { text: '否' } },`;
+  }
+  return '';
+}
+
+function emitContainerIndex() {
+  return `import Container from '@/components/Page/Container';
+
+export default () => {
+  return <Container />;
+};
+`;
+}
+
+function emitIndex(names, layout, types, fns, pagination, variant = 'page') {
+  const isList = variant === 'list';
+  const usePageContainer = layout.hasPageContainer && !layout.hasContainerConfig && !isList;
+  const pageImport = usePageContainer
     ? `import PageContainer from '@/components/PageContainer';\n`
     : '';
-  const open = layout.hasPageContainer
+  const overlayDir = isList ? './' : './components/';
+  const constImport = isList ? '../const' : './const';
+  const stylesImport = isList ? '../index.less' : './index.less';
+  const exportName = isList ? 'List' : names.leaf;
+  const open = usePageContainer
     ? `    <PageContainer header={{ title: undefined }}>`
     : '    <>';
-  const close = layout.hasPageContainer ? `    </PageContainer>` : '    </>';
+  const close = usePageContainer ? `    </PageContainer>` : '    </>';
   const listAccess = pagination === 'results-count'
     ? 'list: data?.results || [],\n          total: data?.count || 0,'
     : 'list: data?.list || [],\n          total: data?.total || 0,';
@@ -130,14 +180,14 @@ import { message } from 'antd';
 import { useCallback, useRef } from 'react';
 import ${names.confirm}, {
   type ${names.confirm}Ref,
-} from './components/${names.confirm}';
+} from '${overlayDir}${names.confirm}';
 import ${names.drawer}, {
   type ${names.drawer}Ref,
-} from './components/${names.drawer}';
-import { columns, getActionColumn, getToolBarRender } from './const';
-import styles from './index.less';
+} from '${overlayDir}${names.drawer}';
+import { columns, getActionColumn, getToolBarRender } from '${constImport}';
+import styles from '${stylesImport}';
 
-export default function ${names.leaf}() {
+export default function ${exportName}() {
   const tableRef = useRef<MFTableRef>(null);
   const drawerRef = useRef<${names.drawer}Ref>(null);
   const confirmRef = useRef<${names.confirm}Ref>(null);
@@ -224,8 +274,62 @@ function emitLess(layout) {
 `;
 }
 
-function emitDrawer(names, types, fns) {
+function emitFormItem(field) {
+  const component = formComponent(field);
+  const label = JSON.stringify(field.title);
+  const requiredVerb = component === 'ProFormSelect' ? '请选择' : '请输入';
+  const required = field.required
+    ? `\n          rules={[{ required: true, message: ${JSON.stringify(`${requiredVerb}${field.title}`)} }]}`
+    : '';
+  if (component === 'ProFormSelect') {
+    const options = (field.enum || [])
+      .map((value) => `{ label: ${JSON.stringify(String(value))}, value: ${JSON.stringify(value)} }`)
+      .join(', ');
+    return `        <ProFormSelect
+          name="${field.name}"
+          label={${label}}
+          options={[${options}]}${required}
+        />`;
+  }
+  if (component === 'ProFormSwitch') {
+    return `        <ProFormSwitch
+          name="${field.name}"
+          label={${label}}
+        />`;
+  }
+  if (component === 'ProFormDigit') {
+    return `        <ProFormDigit
+          name="${field.name}"
+          label={${label}}
+          placeholder={${JSON.stringify(`请输入${field.title}`)}}${required}
+        />`;
+  }
+  if (component === 'ProFormDateTimePicker' || component === 'ProFormDatePicker') {
+    return `        <${component}
+          name="${field.name}"
+          label={${label}}${required}
+        />`;
+  }
+  if (component === 'ProFormTextArea') {
+    return `        <ProFormTextArea
+          name="${field.name}"
+          label={${label}}
+          placeholder={${JSON.stringify(`请输入${field.title}`)}}${required}
+        />`;
+  }
+  return `        <ProFormText
+          name="${field.name}"
+          label={${label}}
+          placeholder={${JSON.stringify(`请输入${field.title}`)}}${required}
+        />`;
+}
+
+function emitDrawer(names, types, fns, formFields) {
   const itemType = types.itemType || 'Record<string, unknown>';
+  const fields = formFields.length
+    ? formFields
+    : [{ name: 'name', title: '名称', required: true, type: 'string' }];
+  const components = ['ProForm', ...new Set(fields.map(formComponent))];
   const createCall = fns.create
     ? `        await Service.${fns.create}(values);`
     : '        // TODO: call create service';
@@ -233,7 +337,7 @@ function emitDrawer(names, types, fns) {
     ? `        await Service.${fns.update}(record.id, values);`
     : '        // TODO: call update service';
   return `import Service from '@/services';
-import { ProForm, ProFormText } from '@ant-design/pro-components';
+import { ${components.join(', ')} } from '@ant-design/pro-components';
 import { CustomDrawer, HocModal } from '@mingfuyun/star-allinone';
 import { Form, message } from 'antd';
 import { useEffect, useState } from 'react';
@@ -303,12 +407,7 @@ ${createCall}
         layout="horizontal"
         submitter={false}
       >
-        <ProFormText
-          name="name"
-          label="名称"
-          placeholder="请输入名称"
-          rules={[{ required: true, message: '请输入名称' }]}
-        />
+${fields.map(emitFormItem).join('\n')}
       </ProForm>
     </CustomDrawer>
   );
@@ -407,6 +506,41 @@ function patchRoute(root, names, dryRun) {
   writeFile(file, next, dryRun);
 }
 
+function patchContainerConfig(root, names, dryRun) {
+  const file = path.join(root, 'src/components/Page/Container/config.tsx');
+  if (!fs.existsSync(file)) return false;
+  let current = fs.readFileSync(file, 'utf8');
+  const importPath = `@/pages/${names.featurePath}/components/List`;
+  const hasRoute = current.includes(`'${names.route}'`) || current.includes(`"${names.route}"`);
+  const hasLoader =
+    current.includes(`import('${importPath}')`) || current.includes(`import("${importPath}")`);
+  if (hasLoader && hasRoute) {
+    console.log(`tab container already has ${names.route}`);
+    return false;
+  }
+  if (!hasRoute) {
+    const entry = `  '${names.route}': [
+    {
+      key: 'tab-${names.leaf}',
+      label: ${JSON.stringify(names.title)},
+      loader: () => import('${importPath}'),
+    },
+  ],
+`;
+    if (/export default \{\r?\n/.test(current)) {
+      current = current.replace(/export default \{\r?\n/, (match) => `${match}${entry}`);
+    } else if (current.includes('export default {')) {
+      current = current.replace('export default {', `export default {\n${entry}`);
+    } else {
+      console.log('Could not patch src/components/Page/Container/config.tsx; register the tab manually.');
+      return false;
+    }
+  }
+  writeFile(file, current, dryRun);
+  console.log(`${dryRun ? '[dry-run] ' : ''}registered tab ${names.route} in src/components/Page/Container/config.tsx`);
+  return true;
+}
+
 function generatePage(cwd, options) {
   const operations = [
     ['list', options.listOperation],
@@ -429,6 +563,9 @@ function generatePage(cwd, options) {
     path.join(pageDir, 'components', `${names.drawer}.tsx`),
     path.join(pageDir, 'components', `${names.confirm}.tsx`),
   ];
+  if (layout.hasContainerConfig) {
+    files.push(path.join(pageDir, 'components', 'List.tsx'));
+  }
   const exists = files.filter((file) => fs.existsSync(file));
   if (exists.length) {
     throw new Error(`Refusing to overwrite existing page files:\n${exists.map((file) => path.relative(project.root, file)).join('\n')}`);
@@ -438,6 +575,7 @@ function generatePage(cwd, options) {
   let types = { itemType: `${toPascal(names.leaf)}_API.${names.leaf}Item`, queryType: undefined };
   let pagination = 'list-total';
   let itemSource = '';
+  const operationByKey = {};
 
   for (const [key, selector] of operations) {
     const result = generateService(cwd, {
@@ -446,6 +584,7 @@ function generatePage(cwd, options) {
       mockFile: false,
     });
     fns[key] = result.fn;
+    operationByKey[key] = result.operation;
     if (key === 'list') {
       types = {
         itemType: result.itemType || types.itemType,
@@ -459,25 +598,37 @@ function generatePage(cwd, options) {
     }
   }
 
-  const fields = columnFields(itemSource);
+  const spec = project.spec;
+  let fields = schemaFields(spec, operationByKey.list?.itemSchema, { limit: 8 });
+  if (!fields.length) fields = fallbackFields(itemSource);
+  const formFields = schemaFields(
+    spec,
+    operationByKey.create?.bodySchema || operationByKey.update?.bodySchema || operationByKey.list?.itemSchema,
+    { skip: SKIP_FORM, forForm: true },
+  );
   const permissions = {
     create: options.permissionCreate,
     edit: options.permissionEdit,
     delete: options.permissionDelete,
   };
 
-  writeFile(files[0], emitIndex(names, layout, types, fns, pagination), project.dryRun);
+  const queryNames = querySearchNames(operationByKey.list?.queryParams);
   writeFile(files[1], emitLess(layout), project.dryRun);
-  writeFile(files[2], emitColumns(names, types.itemType, fields, permissions), project.dryRun);
-  writeFile(files[3], emitDrawer(names, types, fns), project.dryRun);
+  writeFile(files[2], emitColumns(names, types.itemType, fields, permissions, queryNames), project.dryRun);
+  writeFile(files[3], emitDrawer(names, types, fns, formFields), project.dryRun);
   writeFile(files[4], emitConfirm(names), project.dryRun);
-  patchRoute(project.root, names, project.dryRun);
-
   if (layout.hasContainerConfig) {
-    console.log(`starscope-style tab container detected. Register ${names.featurePath} in src/components/Page/Container/config.tsx if this page should appear as a tab.`);
+    writeFile(files[0], emitContainerIndex(), project.dryRun);
+    writeFile(files[5], emitIndex(names, layout, types, fns, pagination, 'list'), project.dryRun);
+    patchRoute(project.root, names, project.dryRun);
+    patchContainerConfig(project.root, names, project.dryRun);
+  } else {
+    writeFile(files[0], emitIndex(names, layout, types, fns, pagination), project.dryRun);
+    patchRoute(project.root, names, project.dryRun);
   }
+
   console.log(`${project.dryRun ? '[dry-run] ' : ''}generated page ${names.route} -> src/pages/${names.featurePath}`);
   return names;
 }
 
-module.exports = { generatePage, featureNames };
+module.exports = { generatePage, featureNames, patchContainerConfig };

package/skills/README.md

@@ -46,11 +46,13 @@ Cursor / Codex 的常驻说明只放仓库根 `AGENTS.md`（模板见 `examples/
         ├── design-to-page/          # 页面；标准列表内部跑 gen page
         ├── review-and-submit/       # 审查并提交；步骤在 references/
         ├── publish-test/            # 测发
-        ├── project-conventions/     # architecture / review-checklist / quality-checklist
+        ├── project-conventions/     # architecture / component-contract / mfprotable / review-checklist / quality-checklist
         └── i-have-adhd/             # 用户输出格式
 ```
 
-公共入口写死两边已对齐的硬规则，例如：页面走 `MFRequest`、DTO 放 namespace typings、`MFProTable` + `ProForm`、弹层用 `BaseModal` / `CustomDrawer` / `HocModal`、`await` 必须 try/catch、禁止无说明的 `any`。
+公共入口写死两边已对齐的硬规则，例如：页面走 `MFRequest`、DTO 放 namespace typings、表格用业务仓 `@/components/CommonTable/MFProTable`（不要从包里找 `MFTablePro`）、`ProForm`、弹层从 `@mingfuyun/star-allinone` 导入 `BaseModal` / `CustomDrawer` / `HocModal`、`await` 必须 try/catch、禁止无说明的 `any`、React 18。
+
+接入或升级后跑 `pnpm exec star-allinone doctor`。
 
 业务项目的 `.agents/project/` 只写差异：路径、权限体系、OpenAPI 位置、领域特例。项目文件可以补充，但不能削弱公共硬规则。
 
@@ -70,6 +72,7 @@ npm 包中的 skills/shared
 
 ```bash
 pnpm exec star-allinone skills sync
+pnpm exec star-allinone doctor
 ```
 
 同步会整体替换 `shared-*` 目录，并删除包中已不存在的过期 `shared-*`，但不会改动 `custom-*`。
@@ -132,7 +135,7 @@ git commit -m "chore(skill): 更新公共 skill"
 | `shared-design-to-page` | SKILL + `page-conventions.md`、`overlays.md`、`list-page-template.md` | 页面分层、标准列表 CLI、弹层合同 |
 | `shared-review-and-submit` | SKILL + `impact-analysis.md`、`verify.md`、`ai-review.md`、`commit.md` | 影响分析 → 验证 → 确认后提交 |
 | `shared-publish-test` | SKILL + `scripts/publish-current-branch.sh` | 云效测发；只读 `publishPipelineId` |
-| （非入口）`shared-project-conventions` | `architecture.md`、`review-checklist.md`、`quality-checklist.md` | 架构与质量清单 |
+| （非入口）`shared-project-conventions` | `architecture.md`、`mfprotable.md`、`component-contract.md`、`review-checklist.md`、`quality-checklist.md` | 架构、导入合同、质量清单 |
 | （非入口）`shared-i-have-adhd` | `i-have-adhd.md` | 用户输出格式 |
 
 以下内容**不**写进公共 skill 源码：
@@ -141,6 +144,16 @@ git commit -m "chore(skill): 更新公共 skill"
 - OpenAPI 快照：业务仓库数据文件
 - 真正的业务特例：权限常量名、IP 校验、设备/节点领域规则
 
+## 云效门禁
+
+业务仓通常没有 pipeline YAML。在云效构建控制台显式增加：
+
+```bash
+pnpm typecheck && pnpm lint
+```
+
+再跑现有 `pnpm build`。`pnpm test` 若实际是 `max dev`（测网开发服务），改名为 `start:test` / `dev:test`，避免 Agent 当成单测。
+
 ## 最终推荐流程
 
 ```text

package/skills/shared/design-to-page/SKILL.md

@@ -48,8 +48,8 @@ pnpm exec star-allinone gen page \
 Add `--permission-create`, `--permission-edit`, `--permission-delete` when codes are known.
 
 2. If only services are missing, run `pnpm exec star-allinone gen service --operation "METHOD /path/"` first. Follow `.agents/skills/shared-api-to-service/SKILL.md`.
-3. Fill generated placeholders using [references/list-page-template.md](references/list-page-template.md): columns, form fields, rowKey, permission constants, and pagination adapter (`results/count` vs `list/total`).
-4. If `src/components/Page/Container/config.tsx` exists, register the new page as a tab after generating the standalone files. Do not invent a second page shell.
+3. The CLI fills columns and drawer fields from the OpenAPI schema (required, enum → `ProFormSelect`, dates/numbers). Review labels and permission codes; do not recreate the file tree. See [references/list-page-template.md](references/list-page-template.md).
+4. If `src/components/Page/Container/config.tsx` exists, `gen page` writes a Container `index.tsx`, puts the table in `components/List.tsx`, and registers a Tab with `loader: () => import(...)`. Do not invent a second page shell.
 5. Do not overwrite existing page files. Tell the user the CLI refused, then edit in place.
 
 ## Design path
@@ -67,7 +67,7 @@ For non-standard layouts:
 ## Hard rules
 
 - React function components, TypeScript, Ant Design 5, Pro Components, Less.
-- `ProForm` for business forms. `MFProTable` for management lists.
+- `ProForm` for business forms. `MFProTable` from `@/components/CommonTable/MFProTable` (not from the npm package).
 - Overlays from `@mingfuyun/star-allinone`: `CustomDrawer`, `BaseModal`, `HocModal`.
 - Pages consume `import Service from '@/services'` only.
 - Keep columns and toolbar builders in `const.tsx`. Empty cells render as `-`.

package/skills/shared/design-to-page/references/list-page-template.md

@@ -13,9 +13,11 @@ src/pages/<Feature>/
     └── <Feature>ConfirmModal.tsx
 ```
 
-## index.tsx
+When `src/components/Page/Container/config.tsx` exists, `index.tsx` is a Container shell and the table lives in `components/List.tsx`. The CLI also registers a tab for the new route.
 
-- Wrap with `PageContainer` when `src/components/PageContainer` exists.
+## index.tsx / List.tsx
+
+- Wrap with `PageContainer` when `src/components/PageContainer` exists and the page is not a Container tab.
 - `fetchData` is a `useCallback` that calls `Service.<listFn>`, maps pagination, and returns `{ code, data: { list, total } }`.
 - Open the drawer with `drawerRef.current?.show({ record })`.
 - Destructive actions go through the confirm modal ref, then `tableRef.current?.reload()`.
@@ -23,6 +25,7 @@ src/pages/<Feature>/
 ## const.tsx
 
 - Export `columns`, `getActionColumn`, `getToolBarRender`.
+- Columns come from the list item schema: types, enums, and the first string fields as search.
 - Put permission strings on actions and toolbar items when the project uses them.
 - Render empty cells as `'-'`.
 
@@ -30,6 +33,7 @@ src/pages/<Feature>/
 
 - `CustomDrawer` + `HocModal`.
 - `ProForm` with `submitter={false}` and `layout="horizontal"`.
+- Fields come from the create/update body schema: required rules, `enum` → `ProFormSelect`, numbers → `ProFormDigit`, dates → date pickers.
 - `validateFields()` in `try`. Create vs update from `record`.
 - Reset fields when `visible` becomes true.
 
@@ -41,4 +45,10 @@ src/pages/<Feature>/
 
 ## Container tabs
 
-If the project uses `src/components/Page/Container/config.tsx`, the generated `src/pages/<Feature>/index.tsx` is still the source of truth. Add a tab entry that renders the feature component. Do not duplicate fetch logic inside Container.
+If the project uses `src/components/Page/Container/config.tsx`, the CLI:
+
+1. Writes `index.tsx` as `import Container from '@/components/Page/Container'`.
+2. Writes the table in `components/List.tsx`.
+3. Registers `'<route>': [{ key, label, loader: () => import('.../List') }]` in `config.tsx`. Do not add a static page import or `children: <List />`.
+
+Do not duplicate fetch logic inside Container. Do not wrap the List with a second `PageContainer`.

package/skills/shared/design-to-page/references/overlays.md

@@ -2,6 +2,12 @@
 
 Use this reference for every modal, confirmation dialog, and drawer. Import `@mingfuyun/star-allinone/dist/styles.css` once from the application entry, not from feature components.
 
+Overlays belong to the npm package. Do not add `src/components/CustomDrawer`, `src/components/BaseModal`, or `src/components/HocModal`.
+
+```tsx
+import { CustomDrawer, BaseModal, HocModal } from '@mingfuyun/star-allinone';
+```
+
 ## Required components
 
 - `CustomDrawer` for create, edit, detail, or configuration drawers.

package/skills/shared/design-to-page/references/page-conventions.md

@@ -31,7 +31,8 @@ Styles live in the current page directory. Reuse shared mixins such as `@/styles
 
 ## Tables
 
-- Prefer `MFProTable` for management lists. Use Ant Design `Table` only for a deliberately simple static shell.
+- Prefer `MFProTable` for management lists. Import it from `@/components/CommonTable/MFProTable`. See [mfprotable.md](../../project-conventions/references/mfprotable.md). Use Ant Design `Table` only for a deliberately simple static shell.
+- Do not import `MFTablePro` or any table from `@mingfuyun/star-allinone`.
 - Extract `fetchData` as an `async` method. Do not inline request logic in JSX props.
 - Wrap `await` in `try-catch` and return a table-safe empty shape on failure.
 - Adapt backend pagination to the table contract. Common backend shapes are `{ results, count }` or `{ list, total }`; the table adapter is typically `{ code, data: { list, total } }`. Follow the nearest page.

package/skills/shared/project-conventions/references/architecture.md

@@ -8,10 +8,11 @@ Apply these rules to every non-trivial frontend change. Shared review, commit, m
 - Use React function components and TypeScript.
 - Put transport code in `src/services`. Pages must not call axios or the request helper directly.
 - Keep API DTOs in the domain `typings.d.ts`. Use named types and adapters instead of `any`.
-- Reuse `MFProTable`, `BaseModal`, `CustomDrawer`, `HocModal`, permission wrappers, table cells, hooks, and shared styles before adding abstractions.
+- Reuse `MFProTable` from `@/components/CommonTable/MFProTable` (see [component-contract.md](./component-contract.md) and [mfprotable.md](./mfprotable.md)). It is not exported by `@mingfuyun/star-allinone`.
+- Overlays (`CustomDrawer`, `BaseModal`, `HocModal`) and `ErrorBoundary` / `Cron` come from `@mingfuyun/star-allinone`. Do not keep local copies under `src/components`.
 - Use `@/` imports for application modules and keep feature-local imports relative.
 - Do not add a UI/state library or duplicate an existing component without explicit approval.
-- Prefer feature-level code splitting for Excel, editors, charts, drag-and-drop, and other heavy modules.
+- Prefer feature-level code splitting for Excel, editors, charts, drag-and-drop, and other heavy modules. `xlsx`, `@uiw/react-codemirror` / `@codemirror` / monaco, and chart libraries must use `import()`. Do not static-import them from `src/app.ts` or generated list pages.
 
 ## Business behavior
 
@@ -43,4 +44,6 @@ Prefer `pnpm typecheck` when that script exists.
 
 Run `pnpm lint` for broad or shared changes. Run `pnpm run build` when routes, entry behavior, shared runtime, or multiple page modules change. If `.star-allinone.json` documents a TypeScript `baseUrl` or build script, use that command.
 
+Yunxiao (and any CI without in-repo pipeline YAML) must run `pnpm typecheck && pnpm lint` as an explicit build step. `pnpm test` / `pnpm start:test` in business apps starts the test-env dev server; it is not a unit-test suite.
+
 Distinguish failures introduced by the current change from pre-existing or environment failures.

package/skills/shared/project-conventions/references/component-contract.md

@@ -0,0 +1,38 @@
+# Component contract
+
+Use this file as the import source of truth. Do not invent package exports.
+
+## From `@mingfuyun/star-allinone`
+
+The npm package ships overlays, Cron, and ErrorBoundary. It does **not** export a table.
+
+```ts
+import {
+  BaseModal,
+  Cron,
+  CustomDrawer,
+  ErrorBoundary,
+  HocModal,
+} from '@mingfuyun/star-allinone';
+import '@mingfuyun/star-allinone/dist/styles.css';
+```
+
+Do not write any of the following:
+
+- `import { MFTablePro } from '@mingfuyun/star-allinone'`
+- `import { MFProTable } from '@mingfuyun/star-allinone'`
+- `@mingfuyun/star-allinone/components/BaseModal` (use the main export)
+
+## From the business app
+
+Management lists use the local wrapper. Props and usage are in [mfprotable.md](./mfprotable.md).
+
+```ts
+import MFProTable from '@/components/CommonTable/MFProTable';
+```
+
+Pages still consume APIs with `import Service from '@/services'`. Overlay shells come from the package above, not from `@/components/CustomDrawer` or `@/components/BaseModal`.
+
+## Runtime
+
+Peer React is **18.3.x**. Do not assume React 19 APIs. Ant Design 5 and Pro Components live in the business app.

package/skills/shared/project-conventions/references/mfprotable.md

@@ -0,0 +1,59 @@
+# MFProTable contract
+
+`MFProTable` lives in the **business app**, not in `@mingfuyun/star-allinone`. Do not invent `MFTablePro` and do not import a table from the npm package.
+
+```tsx
+import MFProTable from '@/components/CommonTable/MFProTable';
+import type { MFTableRef } from '@/components/CommonTable/type';
+```
+
+The capability package will not absorb this component until peer/externals/Umi versions are stable across apps.
+
+## Required usage
+
+```tsx
+<MFProTable<Item, Query>
+  ref={tableRef}
+  actionColumn={{
+    actions: getActionColumn({ handleEdit, handleDelete }),
+  }}
+  bordered
+  columns={columns()}
+  fetchData={fetchData}
+  queryParams={{}}
+  rowKey="id"
+  scroll={{ x: 'max-content' }}
+  topTitle={false}
+  toolBarRender={getToolBarRender({ handleCreate })}
+/>
+```
+
+- `fetchData` is an `async` callback. On failure return `{ code: 0, data: { list: [], total: 0 } }`.
+- Adapt backend `{ results, count }` or `{ list, total }` to `{ code, data: { list, total } }`.
+- Put columns, action builders, and toolbar items in `const.tsx`.
+- Empty display values render as `'-'`.
+- Open overlays through refs. Do not store drawer visibility on the page when `HocModal` owns it.
+
+## Common props
+
+These names match `src/components/CommonTable/type.ts` (`ITableProps` / `MFTableRef`):
+
+| Prop | Role |
+| --- | --- |
+| `columns` | `ProColumns<T>[]` from `const.tsx` |
+| `fetchData` | `(params) => Promise<{ code, data: { list, total } }>` |
+| `queryParams` | Extra query merged into requests |
+| `rowKey` | Stable id field, usually `id` |
+| `actionColumn.actions` | Row actions; `permission` when the project uses it |
+| `toolBarRender` | Toolbar buttons (`TableSearchType[]`) |
+| `scroll` | Wide tables: `{ x: 'max-content' }` |
+| `columnsStateKey` | Persist column state via the project hook |
+| `ref.reload` / `ref.reloadAndReset` | After mutations |
+
+Permission filtering is implemented **in the app** (`useAuthFilter`, `withAuth`, `TableActions`). The package overlays do not wrap table permissions.
+
+## Do not
+
+- `import { MFTablePro } from '@mingfuyun/star-allinone'`
+- `import { MFProTable } from '@mingfuyun/star-allinone'`
+- Copy `MFProTable` into a second path and import both.

package/skills/shared/project-conventions/references/quality-checklist.md

@@ -17,3 +17,17 @@ Check unsafe HTML, URL construction, upload/download names, sensitive logs/stora
 ## Testing
 
 Request tests for concrete regression boundaries such as transformations, races, conditional validation, reusable hooks, complex transitions, or likely recurring bugs. Run focused Prettier, TypeScript, lint, `git diff --check`, and a production build in proportion to risk.
+
+## CI / Yunxiao
+
+These apps do not keep pipeline YAML in the repo. In the Yunxiao build step run:
+
+```bash
+pnpm typecheck && pnpm lint
+```
+
+`pnpm test` is not a unit-test command in the business apps (use `start:test` / `dev:test` for the test-env dev server). `@mingfuyun/star-allinone` `npm test` only covers codegen fixtures.
+
+## Performance
+
+Flag new top-level imports of `xlsx`, `@uiw/react-codemirror` / CodeMirror, chart libraries, and similar heavy modules. They must be `import()` inside the feature that needs them. Generated pages must not pull them into `src/app.ts`.

package/skills/shared/project-conventions/references/review-checklist.md

@@ -19,8 +19,8 @@ This checklist is complete for shared review and commit. If `.agents/project/rev
 
 ## Pages and forms
 
-- Management lists prefer `MFProTable`. Column and toolbar configuration belong outside the render function.
-- Business forms use `ProForm`. Drawers use `CustomDrawer`. Dialogs use `BaseModal` / `HocModal`.
+- Management lists prefer `MFProTable` from `@/components/CommonTable/MFProTable`. Column and toolbar configuration belong outside the render function.
+- Business forms use `ProForm`. Drawers use `CustomDrawer`. Dialogs use `BaseModal` / `HocModal` from `@mingfuyun/star-allinone`.
 - Successful mutations refresh the parent list. Closing an overlay clears form, loading, selected record, and other async state.
 - Every `await` has error handling. Loading restores in `finally`.
 - Check loading, empty, error, disabled, long content, and narrow-screen layout.

package/skills/shared/publish-test/SKILL.md

@@ -41,6 +41,16 @@ Read `.star-allinone.json` before running. `publishPipelineId` is required:
 
 Never ask the user to repeat the pipeline ID. Never copy another project's pipeline ID.
 
+## Yunxiao build gates
+
+The pipeline lives in the Yunxiao console (there is no in-repo YAML). The build step must run:
+
+```bash
+pnpm typecheck && pnpm lint
+```
+
+before or as part of `max build`. Do not treat `pnpm test` as unit tests; in business apps that script was the test-env dev server and is now `start:test` / `dev:test`. `ANALYZE=1` is a manual pre-release chunk check, not a pipeline substitute.
+
 ## Preconditions
 
 - Current HEAD is a named branch, not detached.