@teamix-evo/skills 0.12.1 → 0.13.0

package/src/teamix-evo-code-uni-manager/file-structure.md

@@ -10,13 +10,13 @@
 
 ```
 src/
+├── features/         # 业务领域(每个子目录聚合 api/hooks/types/mocks/schema)
 ├── pages/            # 路由页面(每个目录对应一条路由)
 ├── components/       # 跨页面复用的业务组件
-├── services/         # 后端通信(纯函数,见 api-layering.md)
-├── hooks/            # 自定义 Hook(包含数据 hook、UI hook)
+├── hooks/            # 跨领域共享的通用 Hook(极少数,如 useDebounce / useDangerConfirm)
 ├── contexts/         # React Context(跨子树共享、低频更新的全局态;含 TenantContext / RegionContext)
 ├── stores/           # 高频全局态(zustand / jotai / redux,首次需要时引入,只用一种)
-├── types/            # Domain / API 类型声明(.ts 仅类型,无运行时)
+├── types/            # 跨领域通用类型(ApiResponse<T>、Pagination<T>)
 ├── utils/            # 纯函数工具(无 React、无副作用)
 ├── lib/              # 三方 SDK 包装、http 实例、active-context、monitor
 ├── routes/           # 路由配置 + 守卫(若用 react-router 集中式声明)
@@ -29,22 +29,22 @@ src/
 └── App.tsx           # 根组件
 ```
 
-> 没列出的目录按需补,但**不要**新增同义层(如同时有 `utils/` 和 `helpers/`、`api/` 和 `services/`、`views/` 和 `pages/`)。`*.test.ts(x)` 文件**就近**放在被测文件同目录,**不要**集中堆到顶层 `tests/`(见 [`testing.md`](testing.md))。
+> 没列出的目录按需补,但**不要**新增同义层(如同时有 `utils/` 和 `helpers/`、`services/` 和 `features/`、`views/` 和 `pages/`)。`*.test.ts(x)` 文件**就近**放在被测文件同目录,**不要**集中堆到顶层 `tests/`(见 [`testing.md`](testing.md))。
 
 ---
 
 ## uni-manager 增量目录约定
 
-| 路径                             | 用途                                                                            |
-| -------------------------------- | ------------------------------------------------------------------------------- |
-| `src/contexts/TenantContext.tsx` | 租户上下文 Provider + `useTenant()`                                             |
-| `src/contexts/RegionContext.tsx` | 区域上下文 Provider + `useRegion()`                                             |
-| `src/lib/active-context.ts`      | vanilla TS 实现的 active tenant/region/cloud 单例(供 interceptor 与 React 共享) |
-| `src/lib/http.ts`                | 集中注入 `X-Tenant-Id` / `X-Region-Id` / `X-Cloud-Provider` 请求头              |
-| `src/components/cloud/`          | 跨云通用组件占位:`CloudBadge`、`RegionBadge`、`ProviderIcon`                    |
-| `src/components/danger/`         | 危险操作组件占位:`DangerConfirmDialog`、`useDangerConfirm`                      |
-| `src/components/context/`        | 上下文切换组件占位:`ContextSwitcher`(切租户/区域时弹 AlertDialog)               |
-| `src/services/<domain>.cloud.ts` | 跨云查询服务(显式覆盖 interceptor，并发多 cloud)                                |
+| 路径                                  | 用途                                                                            |
+| ------------------------------------- | ------------------------------------------------------------------------------- |
+| `src/contexts/TenantContext.tsx`      | 租户上下文 Provider + `useTenant()`                                             |
+| `src/contexts/RegionContext.tsx`      | 区域上下文 Provider + `useRegion()`                                             |
+| `src/lib/active-context.ts`           | vanilla TS 实现的 active tenant/region/cloud 单例(供 interceptor 与 React 共享) |
+| `src/lib/http.ts`                     | 集中注入 `X-Tenant-Id` / `X-Region-Id` / `X-Cloud-Provider` 请求头              |
+| `src/components/cloud/`               | 跨云通用组件占位:`CloudBadge`、`RegionBadge`、`ProviderIcon`                    |
+| `src/components/danger/`              | 危险操作组件占位:`DangerConfirmDialog`、`useDangerConfirm`                      |
+| `src/components/context/`             | 上下文切换组件占位:`ContextSwitcher`(切租户/区域时弹 AlertDialog)               |
+| `src/features/<domain>/api.cloud.ts`  | 跨云查询服务(显式覆盖 interceptor，并发多 cloud)                                |
 
 > 这些目录是"概念占位拼装"的标准落点(详见 [reuse-first.md](reuse-first.md))。biz-ui/uni-manager 已实装 `um-topbar`，其余先以本工程内组件兜底，后续逐步抽包。
 
@@ -73,7 +73,7 @@ src/pages/
 
 - 页面组件**默认 default export**,与文件名一致
 - `_components/` `_hooks/` 用下划线前缀标记**私有**,**禁止跨页面 import**
-- 跨页面用得到的组件/hook → 升到 `src/components/` `src/hooks/`
+- 跨页面用得到的组件 → 升到 `src/components/`；领域 hook → 放 `src/features/<domain>/hooks.ts`
 
 ### `src/components/`
 
@@ -104,36 +104,51 @@ src/components/
 - **不要**写"小工具组件"如 `Wrapper`、`Container` —— 用 div + tailwind 即可
 - 跨云/危险/上下文相关组件统一放 `cloud/` `danger/` `context/` 子目录,便于后续抽到 biz-ui/uni-manager
 
-### `src/services/`
+### `src/features/`
 
-**职责**:后端通信纯函数。详见 [`api-layering.md`](api-layering.md)。
+**职责**:业务领域代码。每个子目录聚合一个领域的全部代码。详见 [`api-layering.md`](api-layering.md)。
 
-uni-manager 强约定:
+```
+src/features/
+├── instance/
+│   ├── api.ts          # 请求纯函数(listInstances, createInstance, ...)
+│   ├── api.cloud.ts    # 跨云查询(显式覆盖 interceptor，并发多 cloud)
+│   ├── hooks.ts        # react-query 封装(useInstanceList, useCreateInstance, ...)
+│   ├── types.ts        # 领域类型(Instance, InstanceStatus, ...)
+│   ├── mocks.ts        # 本地 mock 数据(开发阶段)
+│   └── schema.ts       # zod schema(CreateInstanceInputSchema, ...)
+├── tenant/
+│   └── ...
+├── region/
+│   └── ...
+└── audit-log/
+    └── ...
+```
+
+约束:
 
-- service **不显式拼 tenantId / regionId**(走 `lib/http.ts` interceptor 自动注入)
-- 例外:跨云/跨租户查询接口 `*.cloud.ts`,可显式 `headers: { 'X-Tenant-Id': tenantId }` 覆盖
+- 一个领域 = 一个子目录,**不按技术类型拆**
+- api.ts 是纯函数层,**不依赖 React**;**不显式拼 tenantId / regionId**(走 `lib/http.ts` interceptor 自动注入)
+- 例外:跨云/跨租户查询接口 `api.cloud.ts`,可显式 `headers: { 'X-Tenant-Id': tenantId }` 覆盖
+- hooks.ts 调同目录 api.ts,**禁止**直接 fetch
+- types.ts 仅类型,无运行时代码
+- 同领域内用相对路径 `./types`、`./api`
 
 ### `src/hooks/`
 
-**职责**:跨页面复用的自定义 Hook。
+**职责**:跨领域共享的通用 Hook（极少数）。
 
 ```
 src/hooks/
-├── useInstanceList.ts       # 数据 hook(queryKey 必须含 tenantId/regionId)
-├── useCreateInstance.ts
-├── useTenant.ts             # 读取 TenantContext + 切换 active tenant
-├── useRegion.ts
-├── useCloudProvider.ts
-├── useDangerConfirm.ts      # 危险操作(输入资源名才执行)
-└── useDebounce.ts
+├── useDangerConfirm.ts      # 危险操作(输入资源名才执行,跨领域通用)
+├── useDebounce.ts           # 通用 UI hook
+└── useMediaQuery.ts
 ```
 
 约束:
 
-- 命名必须 `use` 开头
-- 单 hook = 单文件
-- 数据 hook 调 `src/services/`,**禁止**直接 fetch
-- queryKey **必须**包含 `tenantId` / `regionId`(见 [`api-layering.md`](api-layering.md) §3)
+- 领域数据 hook **不放这里**,放 `src/features/<domain>/hooks.ts`
+- 只放与业务领域无关的通用 hook(如 useDebounce、useMediaQuery)及跨领域通用业务 hook(如 useDangerConfirm)
 
 ### `src/contexts/`
 
@@ -180,13 +195,13 @@ src/contexts/
 
 ### `src/types/`
 
-**职责**:类型声明。
+**职责**:跨领域通用类型声明。
 
 约束:
 
 - 只放 `.ts` 类型文件,**不导出运行时代码**
-- 按 domain 拆:`instance.ts`、`tenant.ts`、`region.ts`、`cloud.ts`
-- 通用类型放 `api.ts`、`common.ts`
+- Domain 类型放 `src/features/<domain>/types.ts`,**不放这里**
+- 仅放跨领域通用类型:`api.ts`（ApiResponse<T>、Pagination<T>）、`common.ts`
 
 ### `src/utils/`
 
@@ -194,9 +209,9 @@ src/contexts/
 
 约束:
 
-- **不依赖 React**(用了 React 应该是 hook,放 `src/hooks/`)
+- **不依赖 React**(用了 React 应该是 hook,放 `src/features/<domain>/hooks.ts` 或 `src/hooks/`)
 - **不依赖 DOM**(用了 DOM 应该是 lib 层包装)
-- **不发请求**(发请求是 service)
+- **不发请求**(发请求是 features/<domain>/api.ts)
 - 一个文件一个主题:`format.ts`、`validate.ts`、`array.ts`、`cloud.ts`(云厂商显示名映射)
 
 ### `src/lib/`
@@ -215,7 +230,7 @@ src/lib/
 约束:
 
 - 这一层**与 React 解耦**,可以在 Node / 测试中跑
-- **不放业务逻辑** —— 业务逻辑去 service / hook
+- **不放业务逻辑** —— 业务逻辑去 features/<domain>/api.ts / hooks.ts
 - `active-context.ts` 是 Context 与 interceptor 的桥梁:Context Provider 内 setter 双向同步它
 
 ### `src/routes/`
@@ -240,7 +255,7 @@ src/routes/
 | 目录           | kebab-case                           | `src/pages/instance-detail/`        |
 | React 组件文件 | PascalCase.tsx                       | `InstanceStatusBadge.tsx`           |
 | Hook 文件      | camelCase.ts,`use` 前缀              | `useInstanceList.ts`                |
-| Service 文件   | camelCase.ts,domain 名               | `instance.ts` / `instance.cloud.ts` |
+| API 文件       | camelCase.ts,domain 名               | `api.ts` / `api.cloud.ts`           |
 | 工具文件       | camelCase.ts                         | `formatDate.ts`                     |
 | 类型文件       | camelCase.ts,domain 名               | `instance.ts`                       |
 | 常量文件       | camelCase.ts 或 SCREAMING_SNAKE 导出 | `constants.ts`                      |
@@ -256,11 +271,11 @@ src/routes/
 // ✅
 import { Button } from '@teamix-evo/ui';
 import { Topbar } from 'biz-ui/uni-manager/um-topbar';
-import { listInstances } from '@/services/instance';
+import { listInstances } from '@/features/instance/api';
 import { CloudBadge } from '@/components/cloud/CloudBadge';
 
 // ❌
-import { listInstances } from '../../../services/instance';
+import { listInstances } from '../../../features/instance/api';
 ```
 
 ---
@@ -268,22 +283,22 @@ import { listInstances } from '../../../services/instance';
 ## Import 边界(单向依赖)
 
 ```
-pages   ──▶ components, hooks, services, types, utils, lib, stores, contexts
-components ──▶ hooks, services, types, utils, lib, contexts (NOT pages)
-hooks   ──▶ services, types, utils, lib, stores, contexts (NOT components, NOT pages)
-services ──▶ types, lib (NOT hooks, NOT components, NOT pages, NOT contexts)
-contexts ──▶ types, utils, lib (NOT services, NOT hooks)
-stores  ──▶ types, utils, lib (NOT services, NOT hooks)
-types   ──▶ (no runtime imports)
-utils   ──▶ types only
-lib     ──▶ types only
+pages      ──▶ components, features, hooks, types, utils, lib, stores, contexts
+components ──▶ features, hooks, types, utils, lib, contexts (NOT pages)
+features/* ──▶ lib, types (内部 api→types, hooks→api+types; NOT components, NOT pages)
+hooks      ──▶ types, utils, lib (NOT features, NOT components, NOT pages)
+contexts   ──▶ types, utils, lib (NOT features, NOT hooks)
+stores     ──▶ types, utils, lib (NOT features, NOT hooks)
+types      ──▶ (no runtime imports)
+utils      ──▶ types only
+lib        ──▶ types only
 ```
 
 要点:
 
-- **services 不依赖 React** —— 它是纯函数层(tenant/region 走 interceptor,不在 service 显式读 Context)
+- **features/*/api.ts 不依赖 React** —— 它是纯函数层(tenant/region 走 interceptor,不在 api 显式读 Context)
 - **types / utils / lib 是叶子层** —— 不依赖业务层,谁都能引
-- **反向依赖直接否决**(component 不能 import page,service 不能 import hook)
+- **反向依赖直接否决**(component 不能 import page,api 不能 import hook)
 
 ---
 
@@ -292,10 +307,10 @@ lib     ──▶ types only
 | 反模式                                                | 为什么禁                         | 应该怎么做                                                                                   |
 | ----------------------------------------------------- | -------------------------------- | -------------------------------------------------------------------------------------------- |
 | `src/views/`、`src/screens/` 与 `src/pages/` 并存     | 同义层,认知爆炸                  | 二选一,统一叫 `pages/`                                                                       |
-| `src/api/` 与 `src/services/` 并存                    | 同义层                           | 统一叫 `services/`                                                                           |
+| `src/services/` 与 `src/features/` 并存               | 同义层                           | 统一用 `features/`                                                                           |
 | `src/utils/` 与 `src/helpers/` 并存                   | 同义层                           | 统一叫 `utils/`                                                                              |
 | 在 `src/components/` 里写 page-only 组件              | 抽象层级别错位                   | 放 `src/pages/<id>/_components/`                                                             |
-| 在 `src/utils/` 里写 React Hook                       | 边界错位                         | 放 `src/hooks/`                                                                              |
+| 在 `src/utils/` 里写 React Hook                       | 边界错位                         | 领域 hook → `features/<domain>/hooks.ts`；通用 hook → `src/hooks/`                           |
 | 一个文件 export 5 个不相关的工具                      | 命名失焦                         | 拆成多文件,一个主题一个文件                                                                  |
 | `index.ts` 大量 `export *` 当 barrel                  | 影响 tree-shaking、循环依赖      | 显式 named export 需要的几个                                                                 |
 | 为消除一处 props drilling 直接引 zustand              | 升级过度,徒增心智                | 用 React `Context`                                                                           |
@@ -307,7 +322,7 @@ lib     ──▶ types only
 | 测试堆在顶层 `tests/` 目录                            | 改文件忘记移动测试,易漂移        | `*.test.ts(x)` 就近紧邻被测文件                                                              |
 | `alert()` / `window.location.href = ...`              | 阻断、丑、丢状态                 | `toast.error()` / `useNavigate()`                                                            |
 | 自建 `Topbar.tsx` 替代 `biz-ui/uni-manager/um-topbar` | 一致性三件套 UM1 红线            | 直接用 `um-topbar`(见 [reuse-first.md](reuse-first.md))                                      |
-| service 函数手动拼接 `tenantId`                       | 上下文与传输层耦合,散点漂移      | `lib/http.ts` interceptor 集中注入(见 [`api-layering.md`](api-layering.md))                  |
+| api 函数手动拼接 `tenantId`                           | 上下文与传输层耦合,散点漂移      | `lib/http.ts` interceptor 集中注入(见 [`api-layering.md`](api-layering.md))                  |
 | 危险删除接口只用 `confirm("确定?")`                   | UM 红线,误操作概率高             | `useDangerConfirm`(见 [`forms-and-validation.md`](forms-and-validation.md) §10)              |
 
 ---
@@ -319,15 +334,15 @@ lib     ──▶ types only
 | 新增实例列表页                                     | `src/pages/instances/index.tsx`                                                                        |
 | 新增实例状态徽章(跨页面用)                         | `src/components/InstanceStatusBadge.tsx`                                                               |
 | 新增实例状态徽章(只在实例页用)                     | `src/pages/instances/_components/InstanceStatusBadge.tsx`                                              |
-| 新增"释放实例"接口调用                             | `src/services/instance.ts` 加 `releaseInstance`                                                        |
-| 新增"释放实例"的 mutation hook                     | `src/hooks/useReleaseInstance.ts`(用 useDangerConfirm 包装)                                            |
+| 新增"释放实例"接口调用                             | `src/features/instance/api.ts` 加 `releaseInstance`                                                    |
+| 新增"释放实例"的 mutation hook                     | `src/features/instance/hooks.ts` 加 `useReleaseInstance`(用 useDangerConfirm 包装)                     |
 | 新增日期格式化函数                                 | `src/utils/format.ts`(先 grep 是否已存在)                                                              |
 | 新增鉴权 + 租户 header 拦截器                      | `src/lib/http.ts` 加 interceptor;active 值放 `src/lib/active-context.ts`                               |
-| 新增实例 domain 类型                               | `src/types/instance.ts`                                                                                |
+| 新增实例 domain 类型                               | `src/features/instance/types.ts`                                                                       |
 | 跨少量组件分享当前用户 / 主题 / 租户 / 区域        | `src/contexts/<Name>Context.tsx`(同时同步 `lib/active-context.ts`)                                     |
 | 跨域高频全局态(首次需要)                           | `src/stores/useXxxStore.ts`(按需引 zustand,固定后只用一种)                                             |
-| 列表 / 详情等服务端数据                            | `src/hooks/useXxx.ts` 包 `react-query`,queryKey 含 tenantId/regionId,**不进** store / Context          |
-| 新增"创建实例表单"                                 | `src/pages/instances/new/_components/CreateInstanceForm.tsx` + `src/services/instance.schema.ts`       |
+| 列表 / 详情等服务端数据                            | `src/features/<domain>/hooks.ts` 包 `react-query`,queryKey 含 tenantId/regionId,**不进** store         |
+| 新增"创建实例表单"                                 | `src/pages/instances/new/_components/CreateInstanceForm.tsx` + `src/features/instance/schema.ts`       |
 | 跨页面复用表单(地址 / 标签编辑)                    | `src/components/forms/<Name>Form.tsx` + 对应 schema                                                    |
 | 新增路由 / 页面入口                                | `src/routes/index.tsx` 注册 + `src/pages/<id>/index.tsx`(default export,被 `React.lazy` 引入)          |
 | 新增鉴权 / 角色守卫                                | `src/routes/guards.tsx`                                                                                |
@@ -335,7 +350,7 @@ lib     ──▶ types only
 | 跨云资源 404 兜底(资源被删除/迁移)                 | `src/components/cloud/CloudResourceNotFound.tsx`(见 [`error-and-loading.md`](error-and-loading.md) §7) |
 | Sentry / 日志上报包装                              | `src/lib/monitor.ts`(`reportError(err, extra?)`)                                                       |
 | 测试基础设施(msw handler / 自定义 render)          | `src/test/handlers.ts` / `src/test/render.tsx`                                                         |
-| 纯函数 / service / hook 的测试                     | 同目录 `<name>.test.ts(x)`(就近,不集中)                                                                |
-| 跨云查询(并发多 cloud / 显式 tenantId 覆盖)        | `src/services/<domain>.cloud.ts`(显式传 header,**不**走 active-context)                                |
+| 纯函数 / api / hook 的测试                         | 同目录 `<name>.test.ts(x)`(就近,不集中)                                                                |
+| 跨云查询(并发多 cloud / 显式 tenantId 覆盖)        | `src/features/<domain>/api.cloud.ts`(显式传 header,**不**走 active-context)                            |
 | 危险确认对话框(输入资源名才执行)                   | `src/components/danger/DangerConfirmDialog.tsx` + `src/hooks/useDangerConfirm.ts`                      |
 | 全局 topbar(品牌 / 租户切换 / 区域切换 / 用户菜单) | **直接用** `biz-ui/uni-manager/um-topbar`,**不要**自建                                                 |

package/src/teamix-evo-code-uni-manager/forms-and-validation.md

@@ -22,22 +22,24 @@
 ## Schema 落点
 
 ```
-src/services/
-├── instance.ts                # 请求函数:listInstances、createInstance
-└── instance.schema.ts         # zod schema:CreateInstanceInput、UpdateInstanceInput
+src/features/instance/
+├── api.ts              # 请求函数:listInstances、createInstance
+├── schema.ts           # zod schema:CreateInstanceInput、UpdateInstanceInput
+├── hooks.ts            # react-query 封装
+└── types.ts            # 领域类型
 ```
 
 约定:
 
-- **每个 domain 一个 `<domain>.schema.ts`**,与 service 同目录
+- **每个 domain 一个 `schema.ts`**,与 api / hooks / types 同目录
 - 从 schema 派生类型:`export type CreateInstanceInput = z.infer<typeof CreateInstanceInputSchema>`
-- service 的入参 / 返回类型**优先用** schema 推导,而不是手写 interface
+- api 的入参 / 返回类型**优先用** schema 推导,而不是手写 interface
 - **不要**把 schema 写在页面 / 组件文件里 —— schema 是 domain 资产,跨页面复用
 
 ### 示例
 
 ```ts
-// src/services/instance.schema.ts
+// src/features/instance/schema.ts
 import { z } from 'zod';
 
 export const CreateInstanceInputSchema = z.object({
@@ -55,10 +57,10 @@ export type CreateInstanceInput = z.infer<typeof CreateInstanceInputSchema>;
 ```
 
 ```ts
-// src/services/instance.ts
+// src/features/instance/api.ts
 import { http } from '@/lib/http';
-import type { CreateInstanceInput } from './instance.schema';
-import type { Instance } from '@/types/instance';
+import type { CreateInstanceInput } from './schema';
+import type { Instance } from './types';
 
 export async function createInstance(
   input: CreateInstanceInput,
@@ -100,11 +102,11 @@ src/components/forms/
 // src/pages/instances/new/_components/CreateInstanceForm.tsx
 import { useForm } from 'react-hook-form';
 import { zodResolver } from '@hookform/resolvers/zod';
-import { useCreateInstance } from '@/hooks/useCreateInstance';
+import { useCreateInstance } from '@/features/instance/hooks';
 import {
   CreateInstanceInputSchema,
   type CreateInstanceInput,
-} from '@/services/instance.schema';
+} from '@/features/instance/schema';
 import { Button, Input, Form, FormField, FormItem } from '@/components/ui';
 
 export function CreateInstanceForm() {
@@ -160,7 +162,7 @@ export function CreateInstanceForm() {
 - ❌ 在 `onChange` 里手写 `if (value.length > 20) setError(...)`
 - ❌ 校验报错信息硬编码在组件里("请输入正确的实例名") —— 写在 schema 里,UI 只读
 - ❌ 表单状态用 `useState`,然后再加 `useEffect` 同步校验 —— 直接用 `useForm`
-- ❌ schema 在组件文件里就地定义 —— 抽到 `<domain>.schema.ts`
+- ❌ schema 在组件文件里就地定义 —— 抽到 `features/<domain>/schema.ts`
 - ❌ 提交逻辑写在 `<form onSubmit>` 里直接 fetch —— 走 mutation hook
 
 ---
@@ -452,10 +454,10 @@ pnpm add react-hook-form zod @hookform/resolvers
 ```
 ## 表单改动
 
-- src/services/instance.schema.ts: 新增 CreateInstanceInputSchema(zod)、派生类型
-- src/services/instance.ts: createInstance 入参用派生类型(不显式拼 tenantId)
+- src/features/instance/schema.ts: 新增 CreateInstanceInputSchema(zod)、派生类型
+- src/features/instance/api.ts: createInstance 入参用派生类型(不显式拼 tenantId)
 - src/pages/instances/new/_components/CreateInstanceForm.tsx: useForm + zodResolver + useBlocker(脏态拦截)
-- src/hooks/useCreateInstance.ts: useMutation 包 createInstance,onError 区分字段级 / 通用
+- src/features/instance/hooks.ts: useCreateInstance — useMutation 包 createInstance,onError 区分字段级 / 通用
 - 危险操作: ✅ 释放实例走 useDangerConfirm(输入 instance.id 校验)
 - 切租户保护: ✅ 表单 isDirty 时拦截 search 变化
 ```

package/src/teamix-evo-code-uni-manager/reuse-first.md

@@ -40,8 +40,8 @@
 
 ### 查询顺序（从快到慢）
 
-1. **MCP `list_components`** —— 一次列全部，扫描是否有同名 / 近义。
-2. **MCP `find_components` query=<关键词>** —— 子串匹配 id / name / description。
+1. **读 `.teamix-evo/meta/ui/manifest.json`** —— 一次列全部，扫描是否有同名 / 近义。
+2. **`grep <关键词> .teamix-evo/meta/ui/manifest.json`** —— 子串匹配 id / name / description；需要详细 Props/示例时读 `.teamix-evo/meta/ui/<id>.md`。
 3. **本项目 grep** —— `grep -r "from '@/components/ui'" src/` 看哪些已经装机。
 4. **本项目 `.teamix-evo/ui/manifest.lock.json`** —— 已装机的 ui entry 清单。
 
@@ -111,21 +111,18 @@
 
 ### 页面骨架来源（列表 / 详情 / 表单 / Console Home）
 
-> ⚠️ **AI 默认不调用 `@teamix-evo/templates` 包**（见 ADR 0031 skill-templates-decoupling）。页面骨架按下列优先级生成：
-
 1. **首选** —— 读 `teamix-evo-design-uni-manager` skill 的 [`patterns/{list|detail|form|dashboard}-page.md`](../teamix-evo-design-uni-manager/patterns/)，按 Zone Map 与决策树用 ui 原子件 + biz-ui/uni-manager 实物件（`um-topbar`） + 概念占位拼装表**直接拼装**到 `src/pages/<id>/`
-2. **patterns/ 未覆盖时** —— 按业界流行的云管 / 控制台页面架构（antd Pro / aliyun-console / shadcn Examples 等）与用户描述自由实现，**不要回退到 templates 包**
-3. **`@teamix-evo/templates` 包与 CLI 命令仍保留**，但仅在用户**显式**要求时才走 `teamix-evo templates add`
+2. **patterns/ 未覆盖时** —— 按业界流行的云管 / 控制台页面架构（antd Pro / aliyun-console / shadcn Examples 等）与用户描述自由实现
 
 ### 决策表
 
 | 场景                                                 | 选择                                                           |
 | ---------------------------------------------------- | -------------------------------------------------------------- |
 | 列表页 / 详情页 / 表单页 / Console Home 骨架         | 读 design skill `patterns/*.md` → ui + biz-ui/uni-manager 拼装 |
-| “带筛选的资源表格”、“带审批流的工单卡片”             | 优先 `biz-ui`                                                  |
+| “带筛选的资源表格”、”带审批流的工单卡片”             | 优先 `biz-ui`                                                  |
 | 一次性的、强领域绑定的组合                           | 写在 `src/components/<domain>/` 里，**不要污染 biz-ui**        |
 | uni-manager 跨云专属（CloudBadge / OperationLog 等） | 走 §2 概念占位拼装表                                           |
-| patterns/ 未覆盖的特殊页面                           | 按业界流行架构 + 用户描述自由实现，**不调用 templates 包**     |
+| patterns/ 未覆盖的特殊页面                           | 按业界流行架构 + 用户描述自由实现                              |
 
 ---
 
@@ -135,7 +132,7 @@
 
 1. **本项目 grep**：
    ```bash
-   grep -rn "function <近义名>" src/utils/ src/lib/ src/hooks/
+   grep -rn "function <近义名>" src/utils/ src/lib/ src/features/
    ```
 2. **`@teamix-evo/*` 是否提供**（少数情况，如格式化、token 工具）
 3. **依赖里的成熟库** —— 例如：
@@ -167,7 +164,7 @@
 1. **命名要能让下次复用查得到** —— 起 `InstanceStatusBadge` 而不是 `MyBadge`；`useInstanceList` 而不是 `useList`
 2. **抽象层级别低于一次性页面** —— 跨页面会用的才放 `src/components/`，只在一个页面用的写在 `src/pages/<id>/_components/`
 3. **暴露面尽量窄** —— 默认只 `export` 这次需要的 API，别一次性 `export *`
-4. **写完登记** —— 在 PR 描述里明确“新增 `<path>`，因为 ui / biz-ui / patterns / 本项目均未提供 X 能力”（注：不再以 `templates` 包作为兑底依据，见 ADR 0031 skill-templates-decoupling）
+4. **写完登记** —— 在 PR 描述里明确”新增 `<path>`，因为 ui / biz-ui / patterns / 本项目均未提供 X 能力”
 5. **uni-manager 专属**：跨云 / 跨租户的 component 必须放 `src/components/cloud/` 或 `src/components/<domain>/`，方便后续抽到 biz-ui/uni-manager
 
 ---

package/src/teamix-evo-code-uni-manager/routing-and-codesplit.md

@@ -321,7 +321,7 @@ mutation.mutate(values, {
 | ---------- | --------------------------- | ---------------- | ------------------------------------ |
 | `?tenant=` | tenantId                    | um-topbar 切换时 | TenantContextGuard / TenantProvider  |
 | `?region=` | regionId                    | um-topbar 切换时 | TenantContextGuard / RegionProvider  |
-| `?cloud=`  | cloudProvider(aws/aliyun..) | 跨云页面 toolbar | 跨云 service hook(覆盖 active cloud) |
+| `?cloud=`  | cloudProvider(aws/aliyun..) | 跨云页面 toolbar | 跨云 api hook(覆盖 active cloud)     |
 
 ### um-topbar 集成示例
 

package/src/teamix-evo-code-uni-manager/testing.md

@@ -29,12 +29,12 @@ src/
 ├── utils/
 │   ├── format.ts
 │   └── format.test.ts                    # ← 紧邻
-├── services/
-│   ├── instance.ts
-│   └── instance.test.ts
-├── hooks/
-│   ├── useInstanceList.ts
-│   └── useInstanceList.test.ts
+├── features/
+│   └── instance/
+│       ├── api.ts
+│       ├── api.test.ts                   # ← 紧邻
+│       ├── hooks.ts
+│       └── hooks.test.tsx
 └── components/
     ├── InstanceStatusBadge.tsx
     └── InstanceStatusBadge.test.tsx
@@ -60,19 +60,19 @@ src/test/
 
 按 ROI 排序:
 
-| 优先级 | 类型                                    | 例子                                           | 必测?          |
-| ------ | --------------------------------------- | ---------------------------------------------- | -------------- |
-| P0     | 纯函数(`src/utils/`、`src/services/`)   | `formatMoney`、`isValidInstance`               | ✅ **必测**    |
-| P0     | zod schema                              | `CreateInstanceInputSchema.parse(...)`         | ✅ **必测**    |
-| P0     | 关键业务路径(创建实例 / 释放 / 切租户)  | E2E-style 组件测                               | ✅ **必测**    |
-| P0     | **interceptor / active-context 切换**   | 切租户后请求带新 X-Tenant-Id,旧缓存 invalidate | ✅ **必测**    |
-| P0     | **danger 流程(useDangerConfirm)**       | 输入正确名才 enable 按钮、关闭后状态重置       | ✅ **必测**    |
-| P1     | Hook(数据 hook + 自定义 UI hook)        | `useInstanceList`、`useDebounce`               | 推荐           |
-| P1     | 复用业务组件(`src/components/`)         | `CloudBadge` 各 cloud 渲染                     | 推荐           |
-| P2     | 页面组件                                | 用 RTL 渲染 + msw mock                         | 可选           |
-| ❌     | ui 包源码                               | 已在 `@teamix-evo/ui` 包内测过                 | **不要重复测** |
-| ❌     | biz-ui/uni-manager 包源码(如 um-topbar) | 已在 biz-ui 包内测过                           | **不要重复测** |
-| ❌     | 三方库                                  | `react-router`、`react-query`                  | **不要测**     |
+| 优先级 | 类型                                         | 例子                                           | 必测?          |
+| ------ | -------------------------------------------- | ---------------------------------------------- | -------------- |
+| P0     | 纯函数(`src/utils/`、`features/*/api.ts`)    | `formatMoney`、`isValidInstance`               | ✅ **必测**    |
+| P0     | zod schema                                   | `CreateInstanceInputSchema.parse(...)`         | ✅ **必测**    |
+| P0     | 关键业务路径(创建实例 / 释放 / 切租户)       | E2E-style 组件测                               | ✅ **必测**    |
+| P0     | **interceptor / active-context 切换**        | 切租户后请求带新 X-Tenant-Id,旧缓存 invalidate | ✅ **必测**    |
+| P0     | **danger 流程(useDangerConfirm)**            | 输入正确名才 enable 按钮、关闭后状态重置       | ✅ **必测**    |
+| P1     | Hook(数据 hook + 自定义 UI hook)             | `useInstanceList`、`useDebounce`               | 推荐           |
+| P1     | 复用业务组件(`src/components/`)              | `CloudBadge` 各 cloud 渲染                     | 推荐           |
+| P2     | 页面组件                                     | 用 RTL 渲染 + msw mock                         | 可选           |
+| ❌     | ui 包源码                                    | 已在 `@teamix-evo/ui` 包内测过                 | **不要重复测** |
+| ❌     | biz-ui/uni-manager 包源码(如 um-topbar)      | 已在 biz-ui 包内测过                           | **不要重复测** |
+| ❌     | 三方库                                       | `react-router`、`react-query`                  | **不要测**     |
 
 **红线**:不要为了凑覆盖率数字测 `Button` 能不能渲染、`React.useState` 能不能用。
 
@@ -161,9 +161,9 @@ beforeEach(() => {
 ```
 
 ```ts
-// src/services/instance.test.ts
+// src/features/instance/api.test.ts
 import { describe, it, expect } from 'vitest';
-import { listInstances } from './instance';
+import { listInstances } from './api';
 import { setActiveTenant } from '@/lib/active-context';
 
 describe('listInstances', () => {
@@ -224,10 +224,10 @@ export function renderHookWithProviders<R, P>(
 ```
 
 ```tsx
-// src/hooks/useInstanceList.test.tsx
+// src/features/instance/hooks.test.tsx
 import { waitFor } from '@testing-library/react';
 import { renderHookWithProviders } from '@/test/render';
-import { useInstanceList } from './useInstanceList';
+import { useInstanceList } from './hooks';
 
 it('加载实例列表(queryKey 含 tenantId)', async () => {
   const { result } = renderHookWithProviders(() =>
@@ -320,18 +320,18 @@ it('切换租户:invalidate 旧 query + 新请求带新 tenantId', async () => {
 
 ## §5 · 反模式速查
 
-| 反模式                                   | 为什么禁                          | 应该                                            |
-| ---------------------------------------- | --------------------------------- | ----------------------------------------------- |
-| 测 `setState` 是否被调用                 | 测了实现,重构即崩                 | 测渲染结果 / 用户行为                           |
-| `getByTestId` 当默认查询                 | data-testid 跟可访问性绑不上      | `getByRole` / `getByLabelText` 优先             |
-| 一个 it 里 expect 10 次无关断言          | 失败定位难                        | 拆多个 it                                       |
-| mock 整个 hook(`vi.mock('@/hooks/...')`) | 失去集成价值                      | msw mock 后端,hook 真跑                         |
-| 自己 mock fetch / axios                  | 与生产代码路径不一致              | 用 msw                                          |
-| msw handler 不校验 X-Tenant-Id           | interceptor 失效不会被发现        | 每个 handler `assertTenantHeader(request)`      |
-| 测试间不重置 active-context              | 上一 test 污染下一 test 的 tenant | `beforeEach` 重置                               |
-| 测试里写 `setTimeout(..., 1000)` 等异步  | 慢且不稳定                        | `await waitFor` / `findBy*`                     |
-| 全局 mock console.error 静默             | 错过真实告警                      | 让测试输出 console.error,但 setup 里 fail on it |
-| 追求 80% 覆盖率刷数字                    | 测了没价值的代码                  | 按"优先级表"测,不看覆盖率盲冲                   |
+| 反模式                                        | 为什么禁                          | 应该                                            |
+| --------------------------------------------- | --------------------------------- | ----------------------------------------------- |
+| 测 `setState` 是否被调用                      | 测了实现,重构即崩                 | 测渲染结果 / 用户行为                           |
+| `getByTestId` 当默认查询                      | data-testid 跟可访问性绑不上      | `getByRole` / `getByLabelText` 优先             |
+| 一个 it 里 expect 10 次无关断言               | 失败定位难                        | 拆多个 it                                       |
+| mock 整个 hook(`vi.mock('@/features/...')`)   | 失去集成价值                      | msw mock 后端,hook 真跑                         |
+| 自己 mock fetch / axios                       | 与生产代码路径不一致              | 用 msw                                          |
+| msw handler 不校验 X-Tenant-Id                | interceptor 失效不会被发现        | 每个 handler `assertTenantHeader(request)`      |
+| 测试间不重置 active-context                   | 上一 test 污染下一 test 的 tenant | `beforeEach` 重置                               |
+| 测试里写 `setTimeout(..., 1000)` 等异步       | 慢且不稳定                        | `await waitFor` / `findBy*`                     |
+| 全局 mock console.error 静默                  | 错过真实告警                      | 让测试输出 console.error,但 setup 里 fail on it |
+| 追求 80% 覆盖率刷数字                         | 测了没价值的代码                  | 按"优先级表"测,不看覆盖率盲冲                   |
 
 ---
 
@@ -388,8 +388,8 @@ pnpm exec msw init public/ --save  # 浏览器 worker
 ## 测试覆盖
 
 - 新增 src/utils/cloud.ts → 同目录 cloud.test.ts(formatCloudProvider 4 case)
-- 新增 src/services/instance.ts:releaseInstance → instance.test.ts(成功 / 422 / tenant header 校验)
-- 新增 src/hooks/useReleaseInstance.ts → useReleaseInstance.test.tsx(success / error / 未确认 dangerName 不调 mutate)
+- 新增 src/features/instance/api.ts:releaseInstance → api.test.ts(成功 / 422 / tenant header 校验)
+- 新增 src/features/instance/hooks.ts:useReleaseInstance → hooks.test.tsx(success / error / 未确认 dangerName 不调 mutate)
 - 复用 src/components/CloudBadge.tsx → 已有 test 覆盖 aws/aliyun/azure,无需补
 - 切租户集成测试: ✅ TenantContext.test.tsx(invalidate + 新 tenantId header)
 - 跳过测: src/pages/instances/new/index.tsx(纯组合,关键逻辑已在 hook / form 层测)