@teamix-evo/skills 0.12.0 → 0.13.0

package/src/teamix-evo-design-opentrek/{generation-flow.md → workflow.md}

@@ -1,6 +1,8 @@
-# 生成 / 翻新 / 验证流程
+# AI 页面任务工作流
 
-> ⚠️ **本文件是页面级任务的唯一执行路径。每一步都有 GATE 门禁和 MUST READ 文件清单。** > **跳步 = 产出不合规。AI 不得凭"已有知识"省略任何文件读取。**
+> ⚠️ **本文件是页面级任务的唯一执行路径。每一步都有 GATE 门禁和 MUST READ 文件清单。**
+>
+> **跳步 = 产出不合规。AI 不得凭"已有知识"省略任何文件读取。**
 
 ---
 
@@ -16,7 +18,7 @@ Step 7 自检    ← Step 6 视觉填充  ← Step 5 可用性校验 ← Step 4
 
 ### Step 1 · 最小 quorum + 默认值
 
-📖 **MUST READ**: [philosophy.md](./philosophy.md)（理解"为什么这么做" — 四大原则优先级）+ [brand.md](./brand.md)（视觉调性 + 文案语气基调）
+📖 **MUST READ**: [principles.md](./principles.md)（Part B 六条设计原则 + Part A 视觉调性/文案语气）
 
 **只有两个信息缺一不可**（最小 quorum，缺则反问）：
 
@@ -64,12 +66,12 @@ Step 7 自检    ← Step 6 视觉填充  ← Step 5 可用性校验 ← Step 4
 🚧 **GATE**: Step 2 必须已产出"页面类型 ID"
 
 📖 **MUST READ**（按顺序读取）:
+
 1. `./pages/{type}-page/SKILL.md` — 子技能入口（子类型列表 + 属性模型）
 2. `./pages/{type}-page/patterns/{subtype}.md` — 对应子类型的**完整布局结构**（骨架、DOM 顺序、CSS 约束、间距硬值）
-3. `./pages/{type}-page/_shared/search-combo-spec.md` — SearchCombo 硬约束（20px 间距、容器式 border、禁止嵌套规则）
+3. `./rules/common-components.json` → SearchCombo — 硬约束（20px 间距、容器式 border、禁止嵌套规则）
 4. `./pages/{type}-page/_shared/action-column-spec.md` — 操作列规范（≤3 直显、Dropdown 收纳）
-5. `./rules/page-frame.json` — L0/L1/L2 框架级别
-6. `./rules/layout-rules.json` — 布局模式
+5. `./rules/page-frame.json` — L0/L1/L2 框架级别 + 布局模式
 
 ⚠️ **禁止**：不要仅读 `patterns/{type}-page.md` 就开始生成。该文件是高阶索引，不包含布局细节。
 
@@ -87,48 +89,98 @@ Step 7 自检    ← Step 6 视觉填充  ← Step 5 可用性校验 ← Step 4
 
 🚧 **GATE**: Step 3 必须已产出"子类型 ID + 区域骨架"
 
-📖 **MUST READ**: [components.md](./components.md) §0 兗底铁律 + §1 双层架构 + §3 决策树 + §5 拼装配方
+📖 **MUST READ**: [components.md](./components.md) §0 兜底铁律 + §1 双层架构 + §3 决策树 + §5 拼装配方 + [rules/common-components.json](./rules/common-components.json) + [rules/component-specs.json](./rules/component-specs.json)
 
 读 [components.md](./components.md) §选型决策树确定组件集：
 
 1. 优先使用 `@teamix-evo/ui` 注册表中的稳定组件
-2. 通过 MCP `list_components(status: "stable")` 查可用列表
-3. 通过 MCP `get_component_meta(id)` 查具体 Props/Examples
+2. 读 `.teamix-evo/meta/ui/manifest.json` 查可用列表
+3. 读 `.teamix-evo/meta/ui/<id>.md` 查具体 Props/Examples
    - **Props**：确定必传 / 可选 / 默认值，明确接口契约
    - **Examples**：作为实现参考（含组合用法、常见模式、边界处理），优先复用示例中的写法而非自由发挥
 4. 复合场景按 [components.md](./components.md) §组合规则装配
 
-**输出**：组件清单 + 每个组件的关键 Props + 参考的 Example 片段（若有启发性写法）。
+#### 4.1 组件使用优先级（强制）
+
+选型时**必须**按以下优先级逐级降级：
+
+```text
+P0 主题业务组件（最高优先）
+│   OpSidebar / OpPageContainer / PageHeader / ItemCard /
+│   CardGrid / CardActionBar / ActionToolbar / FilterRow / ...
+│   → 直接使用，不得自建替代
+│
+P1 基础 UI 组件（@teamix-evo/ui 封装的 shadcn 原子组件）
+│   Button / Input / Select / Card / Badge / Tag / Dialog / ...
+│   → 通过 `@teamix-evo/ui` 包引入，严禁从 shadcn 裸包引入
+│
+P2 原子件拼装（兜底）
+    → 仅当 P0/P1 均无合适组件时允许
+    → 拼装必须遵循 boundaries.md C1-C12 复合结构规则
+    → 代码中必须加注释：// {Concept} 暂未实物化 → ui 原子件拼装
+```
+
+> ⛔ **禁止**：跳过 P0/P1 直接用原生 HTML 标签实现已有组件的功能。
+> ⛔ **禁止**：直接 `import { Button } from "shadcn/ui"` —— 必须走 `@teamix-evo/ui`。
+
+#### 4.2 复合组件缺失处理
+
+当区域骨架中需要的复合组件在注册表中不存在时：
+
+1. 使用 P1 基础组件拼装组合
+2. 拼装必须遵循 [rules/common-components.json](./rules/common-components.json) 中的组件定义和 props 规范
+3. 遵守 [boundaries.md](./boundaries.md) 中的 C1-C12 复合结构规则
+4. 遵循 [rules/component-specs.json](./rules/component-specs.json) 中的具体组件规格（尺寸/圆角/间距等）
+5. **每个拼装处必须标注注释**：
 
-### Step 5 · 组件可用性校验（新增 gate）
+```tsx
+{/* SearchCombo 暂未实物化 → ui 原子件拼装 */}
+<div className="flex h-8 items-center rounded-md border border-border ...">
+  <Input ... />
+  <Button variant="ghost" size="icon-sm" ... />
+</div>
+```
+
+**输出**：组件清单 + 每个组件的关键 Props + 参考的 Example 片段（若有启发性写法）+ 拼装组件标注列表。
+
+### Step 5 · 组件可用性校验
 
 🚧 **GATE**: Step 4 必须已产出"组件清单 + 每个组件的关键 Props"
 
 > ❗ **此步是 Step 4 → Step 6 的强制闸门**。跳过会导致生成代码引用未安装组件而报错。
 
+📖 **MUST READ**: [boundaries.md](./boundaries.md) C1-C12 + [rules/component-specs.json](./rules/component-specs.json)
+
 对 Step 4 选定的每个组件，执行以下校验：
 
 ```text
-① MCP find_components(id) 查询注册表
+① grep <id> .teamix-evo/meta/ui/manifest.json 查询注册表
    ├─ 命中 entries(活跃) → ②
    ├─ 命中 deprecatedEntries 且有 replacedBy → 自动替换为 replacedBy 组件，回到 ①
-   ├─ 命中 deprecatedEntries 且无 replacedBy → 走 components.md §0 兔底铁律
-   └─ 未命中 → 走 components.md §0 兔底铁律（原子件拼装）
+   ├─ 命中 deprecatedEntries 且无 replacedBy → 走 components.md §0 兜底铁律
+   └─ 未命中 → 走 components.md §0 兜底铁律（原子件拼装）
 
 ② 检查目标项目是否已装机
-   ├─ 已装（grep src/components/ui/<id> 或查 manifest.lock.json）→ ✅ 继续
+   ├─ 已装（grep src/components/ui/<id> 或查 manifest.lock.json）→ ③
    └─ 未装 → 输出安装指令：
        「teamix-evo ui add <id>」
-       等待装机完成后再进入 Step 6
+       等待装机完成后再进入 ③
+
+③ 组件规格合规检查（对照 component-specs.json）
+   ├─ 尺寸：高度、宽度是否使用规范定义的 size token
+   ├─ 圆角：是否匹配 component-specs.json 中定义的 radius 值
+   │        （Button → rounded-md / Card → rounded-lg / 容器 → rounded-2xl）
+   ├─ 间距：padding/gap 是否遵循 4px 网格
+   └─ Props：必传属性是否齐备
 ```
 
-**输出**：校验后的最终组件清单（含替换记录）+ 待安装组件列表（若有）。
+**输出**：校验后的最终组件清单（含替换记录）+ 待安装组件列表（若有）+ 规格检查通过确认。
 
 ### Step 6 · 视觉填充（Token 绑定）
 
 🚧 **GATE**: Step 5 必须已产出"校验后的最终组件清单"
 
-📖 **MUST READ**: [foundations.md](./foundations.md) 全文 + [brand.md](./brand.md) §1 视觉五维（圆角/配色/密度/阴影/焦点风格对齐）+ [patterns/color-mapping.md](./patterns/color-mapping.md)（语义色映射表）
+📖 **MUST READ**: [foundations.md](./foundations.md) 全文 + [principles.md](./principles.md) §A1 视觉五维（圆角/配色/密度/阴影/焦点风格对齐）+ [patterns/color-mapping.md](./patterns/color-mapping.md)（语义色映射表）+ [rules/design-tokens.json](./rules/design-tokens.json)
 
 读 [foundations.md](./foundations.md)，所有色彩、间距、字号、圆角、阴影、动效**必须**使用 Token：
 
@@ -141,6 +193,27 @@ Step 7 自检    ← Step 6 视觉填充  ← Step 5 可用性校验 ← Step 4
 | 阴影 | `shadow-sm` / `shadow-md` / `shadow-lg`                                      |
 | 动效 | `duration-150` / `duration-300` / `transition-colors`                        |
 
+#### 6.1 颜色使用规范（强制校验）
+
+**唯一合法色值来源**：design-tokens.json 中定义的语义 token，在 Tailwind 中以 utility class 形式使用。
+
+```text
+✅ 合法示例：
+   text-foreground / text-muted-foreground / text-primary
+   bg-card / bg-primary / bg-muted / bg-destructive
+   border-border / border-input / border-primary
+   bg-success/10 / text-warning（带透明度的语义色允许）
+
+⛔ 非法示例（全部禁止）：
+   #333333 / #fff / rgb(0,0,0) / rgba(...)       ← 硬编码 hex/rgb
+   text-blue-500 / bg-gray-100 / border-slate-200 ← Tailwind 原始色板
+   text-emerald-600 / bg-indigo-50                ← Tailwind 原始色板
+   style={{ color: '#xxx' }}                      ← 内联样式硬编码
+   hsl(220, 15%, 30%)                             ← 裸 hsl 值
+```
+
+> 📌 **唯一例外**：`hsl(var(--xxx))` 引用 CSS 变量形式允许（如 `bg-[hsl(var(--sidebar))]`），因其本质是间接引用 token。
+
 **禁止**：硬编码 hex 色值、`#xxx` rgb()、内联 `style={{ ... }}`、`text-emerald-600` 等原始色。
 
 **输出**：含 Token 引用的可执行代码 / HTML。
@@ -149,11 +222,57 @@ Step 7 自检    ← Step 6 视觉填充  ← Step 5 可用性校验 ← Step 4
 
 🚧 **GATE**: Step 6 必须已产出"含 Token 引用的可执行代码"
 
-📖 **MUST READ**: [boundaries.md](./boundaries.md) 全文（38 条硬规则）+ [checklist.md](./checklist.md) 全文
+📖 **MUST READ**: [boundaries.md](./boundaries.md) 全文（38 条硬规则）+ [checklist.md](./checklist.md) 全文 + [rules/component-specs.json](./rules/component-specs.json)
+
+对照 [checklist.md](./checklist.md) 10 项逐项验证，**额外**执行以下组件合规自检：
+
+#### 7.1 组件来源合规检查
 
-对照 [checklist.md](./checklist.md) 10 项逐项验证：
+```text
+□ 页面中是否存在原生 HTML 标签替代已有组件的情况？
+  - <button> 替代 Button → ⛔ 违规
+  - <input> 替代 Input → ⛔ 违规
+  - <select> 替代 Select → ⛔ 违规
+  - <div role="dialog"> 替代 Dialog → ⛔ 违规
+
+□ 是否所有组件均通过 @teamix-evo/ui 引入？
+  - 存在 from "shadcn/ui" → ⛔ 违规
+  - 存在 from "@radix-ui/" 直接引入 → ⛔ 违规（应走封装层）
+
+□ P0 业务组件是否被正确使用（未被自建 div 替代）？
+  - 有 OpSidebar 但手写了 <aside> → ⛔ 违规
+  - 有 PageHeader 但手写了 <h1> 容器 → ⛔ 违规
+  - 有 ItemCard 但手写了 <article> 卡片 → ⛔ 违规
+```
+
+#### 7.2 组件规格合规检查
+
+```text
+□ Button 圆角是否为 rounded-md（8px）？
+□ Card/ItemCard 圆角是否为 rounded-lg（12px）？
+□ 白卡容器圆角是否为 rounded-2xl？
+□ Input/Select 高度是否为 h-8（32px）？
+□ Input/Select 圆角是否为 rounded-md（8px）？
+□ 组件间距是否遵循 4px 网格？
+```
+
+#### 7.3 颜色合规检查
+
+```text
+□ 是否存在硬编码色值（#xxx / rgb / rgba）？
+□ 是否存在 Tailwind 原始色板（blue-500 / gray-100 等）？
+□ 是否存在内联 style 设置颜色？
+□ 所有颜色是否均为语义 token（foreground / primary / muted 等）？
+```
+
+#### 7.4 拼装标注检查
+
+```text
+□ 所有非注册组件的拼装处是否标注了 // {Concept} 暂未实物化 → ui 原子件拼装？
+□ 拼装是否遵循 C1-C12 结构规则？
+```
 
-- 通过 → 输出最终代码
+- 全部通过 → 输出最终代码
 - 不通过 → 回到对应失败项的步骤修正后重新自检
 
 **输出**：合规代码 + 自检报告。
@@ -252,4 +371,4 @@ Step 7 自检    ← Step 6 视觉填充  ← Step 5 可用性校验 ← Step 4
 | API / services 层        | code（[api-layering.md](../teamix-evo-code-opentrek/api-layering.md)）                 |
 | 表单实现细节             | code（[forms-and-validation.md](../teamix-evo-code-opentrek/forms-and-validation.md)） |
 
-冲突时按 ADR 0018 AI 上下文路由约定：design 决定"做什么"，code 决定"怎么做"。
+冲突时按上下文路由约定：design 决定"做什么"，code 决定"怎么做"。

package/src/teamix-evo-design-uni-manager/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: teamix-evo-design-uni-manager
 description: |
-  Apply Uni-Manager design system rules (philosophy, patterns, page-types, brand tone/voice, visual foundations) when AI generates or reviews a full UI screen / page in a Uni-Manager-variant project (专有云 / 混合云 / 云管平台 / hybrid cloud console).
-  TRIGGER when: user asks to "新建 / 优化 / 重构 一个页面"、"做一个列表页 / 详情页 / 表单页 / 仪表盘 / 控制台首页"、"create / review / refactor a page、screen、dashboard、console、admin template"; intent involves layout structure, page-level information density, or multi-component composition for hybrid-cloud / multi-tenant / multi-region scenarios; file write under `src/pages/**` or `src/templates/**`.
-  SKIP: single-component edits like "加个按钮"、"改 input 的 label"; pure tokens/theme overrides; pure code refactor with no visual change; teamix-evo lifecycle commands (defer to teamix-evo-manage).
+  Apply Uni-Manager design system rules when AI generates or reviews a UI screen / page (专有云/混合云/云管).
+  TRIGGER when: user asks to 新建/优化/重构 页面/控制台/仪表盘, create/review/refactor a page/dashboard/console; intent involves layout or multi-component composition; file write under `src/pages/**`.
+  SKIP: single-component edits; pure tokens/theme overrides; pure code refactor with no visual change; lifecycle commands (→ teamix-evo-manage).
   Coordinates with: teamix-evo-code-uni-manager (run alongside when the screen also creates new files).
 ---
 
@@ -13,7 +13,7 @@ description: |
 > 高信息密度、强一致性、可枚举可审计；视觉以 hybridcloud 蓝（B50 #0064C8）+ 锐利圆角（2px / 4px）为锚。
 >
 > 本技能是 **完整自包含** 的 Uni-Manager 设计规则（非 overlay over OpenTrek）。
-> Token 具体值请参照 `@teamix-evo/tokens/variants/uni-manager/theme.css` 中的 CSS 变量，组件详细 API 通过 MCP `get_component_meta` 按需查询。
+> Token 具体值请参照 `@teamix-evo/tokens/variants/uni-manager/theme.css` 中的 CSS 变量，组件详细 API 通过读 `.teamix-evo/meta/ui/<id>.md` 按需查询。
 
 <!-- teamix-evo:managed:start id="core" -->
 
@@ -28,7 +28,7 @@ description: |
 | **生成** | "生成" / "创建" / "新建" / "设计一个" / "做一个" / "起一个控制台" | **必须完整执行** [generation-flow.md](./generation-flow.md) §1 六步门控 |
 | **翻新** | "改造" / "升级" / "翻新" / "对齐规范" / "重新生成"                | **必须完整执行** [generation-flow.md](./generation-flow.md) §2 翻新路径 |
 | **验证** | "检查" / "验证" / "评估" / "是否符合规范"                         | **必须完整执行** [generation-flow.md](./generation-flow.md) §3 验证路径 |
-| **查询** | "token" / "色值" / "间距" / "组件尺寸" / "圆角"                   | → [foundations.md](./foundations.md)（MCP `tokens_*` 工具规划中）       |
+| **查询** | "token" / "色值" / "间距" / "组件尺寸" / "圆角"                   | → [foundations.md](./foundations.md)（读 `.teamix-evo/meta/` 本地文件） |
 
 ### 不可跳过的前置读取
 
@@ -66,6 +66,30 @@ description: |
 - **默认规则**：无特殊说明时，所有组件一律使用 `default` 尺寸（不主动传 `size='sm'`）
 - **允许 sm 的场景**：仅当 `boundaries.md` 或子技能 patterns 文档中**显式指定**了 `size='sm'` 时才使用
 - **判定优先级**：boundaries.md 规则 > 页面子技能（patterns） > 默认（default）
-- **典型误用**：AI 不得因“看起来小一点”而自行决定用 `sm`；截图中的视觉尺寸通过 Token 与组件默认值对齐，不走 size prop 降级
+- **典型误用**：AI 不得因"看起来小一点"而自行决定用 `sm`；截图中的视觉尺寸通过 Token 与组件默认值对齐，不走 size prop 降级
+
+## Token 合规确认协议（最高优先级）
+
+当用户提供的设计数值（颜色、间距、圆角、阴影、字号等）不在当前 `@teamix-evo/tokens` 已注册的 token 中时，AI **禁止**直接使用该字面量或试图绕过 lint 规则。
+
+**正确流程**：
+
+1. **识别** — 发现用户给出的值不在 token 体系中
+2. **告知** — 明确告知用户"该值不在当前 token 中定义"
+3. **建议** — 列出最接近的已有 token 名称、值和用途
+4. **确认** — 让用户选择：
+   - A. 使用最接近的已有 token（告知具体 Tailwind class，如 `text-muted-foreground`）
+   - B. 在 `@teamix-evo/tokens` 中注册该新值（需确认语义命名和适用场景）
+5. **执行** — 按用户确认的方案执行
+
+**绝对禁止**：
+
+- ❌ 直接使用 hex/rgb 字面量（无论 className、style prop、color prop 还是 CSS 变量形式）
+- ❌ 用 `style={{ color: '#xxx' }}` 绕过 lint 检查
+- ❌ 添加 eslint-disable 注释绕过颜色/arbitrary-value 规则
+- ❌ 以"demo 文件"为借口跳过 token 合规
+- ❌ 不问用户就自行决定"接受 lint 警告"
+
+> 此规则适用于所有数值类型。只要不在 token 体系中注册的值，一律走确认流程。
 
 <!-- teamix-evo:managed:end -->

package/src/teamix-evo-design-uni-manager/boundaries.md

@@ -10,7 +10,7 @@
 > - **S1-S8**：样式规则（className 写法）
 > - **C1-C12**：组件结构规则（shadcn/ui 复合组件用法）
 > - **I1-I4**：图标规则
-> - **UM1-UM3**：Uni-Manager 专有云一致性硬约束（v0.1+，见 ADR 0030）
+> - **UM1-UM3**：Uni-Manager 专有云一致性硬约束
 >
 > 严重等级：`ERROR` 必须修复，`WARN` 建议修复。
 >
@@ -462,7 +462,7 @@ CSS 变量已在 dark 模式下自动切换（uni-manager `theme.css` 内置）
 
 ## UM1-UM4 · Uni-Manager 专有云一致性硬约束
 
-> 来自 ADR 0030 / Teamix-UI 规范 doc 15-16-20。这三条是 uni-manager 区别于 opentrek 的核心硬约束，与"一致性是云管平台生命线"的哲学主张呼应（philosophy.md §1）。
+> 来自 Teamix-UI 规范 doc 15-16-20。这三条是 uni-manager 区别于 opentrek 的核心硬约束，与"一致性是云管平台生命线"的哲学主张呼应（philosophy.md §1）。
 
 ### [ERROR] UM1 · 全局 topbar 必须使用 um-topbar 实物 · scope: uni-manager
 

package/src/teamix-evo-design-uni-manager/brand.md

@@ -50,7 +50,7 @@
 2. **PageHeader 一致**：标题字号 `text-2xl`、面包屑紧贴标题左侧、操作按钮组统一靠右
 3. **状态语义统一**：所有"运行中 / 已停止 / 异常 / 待处理"对应 success / muted / destructive / warning，不允许业务页自创状态色
 
-详见 ADR 0030 / boundaries.md UM1-UM3。
+详见 boundaries.md UM1-UM3。
 
 ### 3.3 跨云资源可枚举
 

package/src/teamix-evo-design-uni-manager/checklist.md

@@ -20,8 +20,8 @@
 | 8   | 不手动 z-index / dark: 覆盖 / focus:ring-\* | `className="z-50"` / `focus:ring-2 ring-primary`    | 让 scoped CSS 接管，不重复声明                                 | [S5][S7]        |
 | 9   | 条件类名用 cn()                             | `` `${active ? 'a' : 'b'}` ``                       | `cn('base', active ? 'a' : 'b')`                               | [S6]            |
 | 10  | 危险操作二次确认（含输入资源名称）          | `<Button onClick={delete}>删除</Button>`            | `<AlertDialog>` + 陈述句标题 + 影响列表（含云/区域）+ 输入名称 | P4 [philosophy] |
-| 11  | 可交互元素显式带手型                        | `<button onClick={...}>` 不带 `cursor-pointer`      | `cursor-pointer` + `disabled:cursor-not-allowed`               | ADR 0023        |
-| 12  | hover/focus 视觉反馈用 `enabled:` 前缀      | `hover:border-primary`（disabled 仍响应）           | `enabled:hover:border-primary`                                 | ADR 0024        |
+| 11  | 可交互元素显式带手型                        | `<button onClick={...}>` 不带 `cursor-pointer`      | `cursor-pointer` + `disabled:cursor-not-allowed`               | cursor 可达性   |
+| 12  | hover/focus 视觉反馈用 `enabled:` 前缀      | `hover:border-primary`（disabled 仍响应）           | `enabled:hover:border-primary`                                 | enabled 前缀    |
 
 [F1]: ./boundaries.md
 [S1]: ./boundaries.md

package/src/teamix-evo-design-uni-manager/components.md

@@ -4,7 +4,7 @@
 > 若未完成前置步骤，请先返回 [generation-flow.md](./generation-flow.md) 从 Step 1 开始。
 
 > **本文档只回答"用什么组件、怎么搭配"，不写具体 Props / Examples / import 路径。**
-> 组件 API、Props、示例代码通过 MCP `get_component_meta` 实时查询；可用列表通过 `list_components` / `find_components` 查询。
+> 组件 API、Props、示例代码通过读 `.teamix-evo/meta/ui/<id>.md` 查询；可用列表通过读 `.teamix-evo/meta/ui/manifest.json` 查询。
 
 ---
 
@@ -14,7 +14,7 @@
 
 ### 0.1 触发场景
 
-调用 `list_components` / `find_components` 命中失败、或本文件提到的组件名（例如 `SearchCombo` / `ContextSwitcher` / `ItemCard` / `CardGrid` / `CardActionBar` / `CloudBadge`）在 `@teamix-evo/biz-ui/uni-manager` 中无实物时。
+在 `.teamix-evo/meta/ui/manifest.json` 中搜索命中失败、或本文件提到的组件名（例如 `SearchCombo` / `ContextSwitcher` / `ItemCard` / `CardGrid` / `CardActionBar` / `CloudBadge`）在 `@teamix-evo/biz-ui/uni-manager` 中无实物时。
 
 ### 0.2 三步处置法
 
@@ -40,7 +40,7 @@ ui 原子组件最小拼装 (兜底)
 
 - 在 `src/components/` 下新增与 biz-ui 同名的"私有版本"
 - 用 antd / arco / chakra 等其它库填补缺口
-- 在 skill 响应中写"假设 biz-ui 有 X"而不实查 MCP
+- 在 skill 响应中写"假设 biz-ui 有 X"而不实查本地 meta
 
 ---
 
@@ -60,7 +60,7 @@ ui 原子组件最小拼装 (兜底)
 
 ### 1.2 实时校验
 
-任何组件名引用前必须用 `find_components(name)` 验证存在性，**不要相信本文档中"组件名"的存在性默认**（biz-ui 处于持续物化中）。
+任何组件名引用前必须在 `.teamix-evo/meta/ui/manifest.json` 中验证存在性，**不要相信本文档中"组件名"的存在性默认**（biz-ui 处于持续物化中）。
 
 ---
 
@@ -227,21 +227,21 @@ ui 原子组件最小拼装 (兜底)
 
 ---
 
-## 7. 与 MCP 工具的协作
+## 7. 与本地 meta 文件的协作
 
 ```text
 当 AI 决定使用某组件后：
-  ├── 通过 list_components({ status: "stable" }) 确认组件可用
-  ├── 通过 get_component_meta("dialog") 获取：
+  ├── 读 .teamix-evo/meta/ui/manifest.json 确认组件可用
+  ├── 读 .teamix-evo/meta/ui/<id>.md（如 dialog.md）获取：
   │     - Props 完整签名（required / optional / default）
   │     - 子组件层级（DialogHeader/Footer/Title/...）
   │     - 标准用法 Example
   │     - 常见错误（compositionPitfalls）
-  ├── 通过 find_components("filter") 模糊搜索（不确定名称时）
-  └── 通过 tokens_get() 获取最新 token 别名（颜色/间距/圆角）
+  ├── grep <关键词> .teamix-evo/meta/ui/manifest.json 模糊搜索（不确定名称时）
+  └── 读 .teamix-evo/tokens/ 下的 token 文件获取最新 token 别名（颜色/间距/圆角）
 ```
 
-**约束**：在 skill 中**不写**具体 import 路径与 Props 示例 —— 这些由 MCP runtime 提供。
+**约束**：在 skill 中**不写**具体 import 路径与 Props 示例 —— 这些由本地 meta 文件提供，`teamix-evo init/upgrade` 自动同步。
 
 ---
 
@@ -249,7 +249,7 @@ ui 原子组件最小拼装 (兜底)
 
 通用结构性规则 → 见 [checklist.md](./checklist.md)（C1-C12 / I1-I4 / UM1-UM3）。本文件特有的"选型决策"自检：
 
-- [ ] 已先用 `find_components` 验证组件存在性（不靠默认）
+- [ ] 已先在 `.teamix-evo/meta/ui/manifest.json` 中验证组件存在性（不靠默认）
 - [ ] biz-ui/uni-manager 命中失败 → 改用 ui 原子件，按 §5.2 配方拼装并加注释
 - [ ] 反馈 / 确认场景按容量选 Dialog / Sheet / Popover
 - [ ] 容器层级 ≤ 3，弹窗最多 2 级，超过则跳转全页面

package/src/teamix-evo-design-uni-manager/foundations.md

@@ -11,13 +11,13 @@
 
 ## 0. AI 实操路径（先做这步）
 
-写任何视觉之前先调 MCP `tokens_list`（group=uni-manager）拿当前真值，**不要凭记忆**：
+写任何视觉之前先读 `.teamix-evo/tokens/` 下的本地 token 文件拿当前真值，**不要凭记忆**：
 
-| 拿到结果 → 该做什么                  | 工具                                                      |
-| ------------------------------------ | --------------------------------------------------------- |
-| 列出可用语义槽 + 真值                | `tokens_list({ group: "uni-manager" })`                   |
-| 查某个槽位（如 `--shadow-md`）的值   | `tokens_list({ group: "uni-manager", filter: "shadow" })` |
-| 校验生成代码是否使用了未声明的 token | `validate_tokens(code)`（规划中）                         |
+| 拿到结果 → 该做什么 | 工具 |
+| --- | --- |
+| 列出可用语义槽 + 真值 | 读 `.teamix-evo/tokens/` 目录下的 token 文件 |
+| 查某个槽位（如 `--shadow-md`）的值 | `grep shadow .teamix-evo/tokens/base.tokens.json` |
+| 校验生成代码是否使用了未声明的 token | `validate_tokens(code)`（规划中） |
 
 > 圆角、阴影、字号是 uni-manager 与 opentrek 差异最大的三类 token。**禁止**直接套 opentrek 经验值。
 
@@ -174,7 +174,7 @@ hardcoded 数值                                ← 仅限 token 真空地带，
 | P4-P5 | 一般 / 中优     | warning                       |
 | P6-P7 | 低优 / 提示性   | info                          |
 
-> P 级映射到具体 token 在 ADR 0030 中定稿；当前阶段 AI 生成可暂用 destructive / warning / info 三档替代。
+> P 级映射到具体 token 尚在定稿中；当前阶段 AI 生成可暂用 destructive / warning / info 三档替代。
 
 ---
 

package/src/teamix-evo-design-uni-manager/generation-flow.md

@@ -87,8 +87,8 @@ Step 6 自检    ← Step 5 视觉填充  ← Step 4 组件挑选
 读 [components.md](./components.md) §选型决策树：
 
 1. 优先使用 `@teamix-evo/ui` 注册表中的稳定组件
-2. 通过 MCP `list_components(status: "stable")` 查可用列表
-3. 通过 MCP `get_component_meta(id)` 查具体 Props/Examples
+2. 读 `.teamix-evo/meta/ui/manifest.json` 查可用列表
+3. 读 `.teamix-evo/meta/ui/<id>.md` 查具体 Props/Examples
    - **Props**：确定必传 / 可选 / 默认值，明确接口契约
    - **Examples**：作为实现参考（含组合用法、常见模式、边界处理），优先复用示例中的写法而非自由发挥
 4. 复合场景按 [components.md](./components.md) §5.2 拼装配方装配（SearchCombo / ContextSwitcher / CardGrid 等概念占位）
@@ -229,4 +229,4 @@ Step 6 自检    ← Step 5 视觉填充  ← Step 4 组件挑选
 | API / services 层        | code（[api-layering.md](../teamix-evo-code-uni-manager/api-layering.md)）                 |
 | 表单实现细节             | code（[forms-and-validation.md](../teamix-evo-code-uni-manager/forms-and-validation.md)） |
 
-冲突时按 ADR 0018 AI 上下文路由约定：design 决定"做什么"，code 决定"怎么做"。
+冲突时按上下文路由约定：design 决定"做什么"，code 决定"怎么做"。