npm - @teamix-evo/skills - Versions diffs - 0.8.1 → 0.9.0 - Mend

@teamix-evo/skills 0.8.1 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/manifest.json +2 -2
package/package.json +11 -11
package/src/teamix-evo-manage/SKILL.md +253 -165
package/LICENSE +0 -21

package/manifest.json CHANGED Viewed

@@ -10,8 +10,8 @@
     {
       "id": "teamix-evo-manage",
       "name": "teamix-evo-manage",
-      "description": "Single entry point for the teamix-evo lifecycle: scaffold a new project, install the AI coding system into an existing repo, run / update / inspect / remove any teamix-evo package, and drive the placeholder→real UI migration loop after `npm create teamix-evo`.\nTRIGGER when: (CLI) user runs or asks about `teamix-evo init` / `teamix-evo update` / `teamix-evo tokens ...` / `teamix-evo skills ...` / `teamix-evo ui ...` / `teamix-evo biz-ui ...` / `teamix-evo templates ...` / `teamix-evo lint ...` / `teamix-evo logs ...` / `teamix-evo restore ...` / `teamix-evo switch ...`, or `npm create teamix-evo` / `pnpm create teamix-evo`; (模糊初始化) \"初始化一个项目\"、\"初始化一个工程\"、\"初始化一个 teamix-evo 工程\"、\"初始化一个 Teamix Evo 项目\"、\"create a teamix-evo project\"、\"set up teamix-evo from scratch\"、\"new teamix-evo app\"; (具名变体初始化) \"初始化一个 opentrek 工程 / op 工程 / OpenTrek 项目 / 探索者项目\"、\"初始化一个云管 / 云管控制台 / 云管项目 / uni-manager 工程 / 云管工程\"、\"new opentrek/uni-manager project\"; (AI coding 接入) \"给现有仓库装 teamix-evo\"、\"现有项目装一下 skills + ui\"、\"接入 AI coding 体系\"、\"装 teamix-evo 进这个项目\"、\"add teamix-evo to existing repo\"、\"install AI coding system\"、\"接入 opentrek 研发体系\"、\"接入 op 研发体系\"、\"接入 OpenTrek 研发体系\"、\"接入 opentrek 研发系统\"、\"接入 op 研发系统\"、\"接入云管研发体系\"、\"接入云管研发系统\"、\"接入 uni-manager 研发体系\"、\"接入 uni-manager 研发系统\"、\"接入统一管理研发体系\"; (更新检测) \"升级 teamix-evo\"、\"看看哪些要升级\"、\"update teamix-evo\"、\"check what needs updating\"、\"refresh installed teamix-evo packages\"; (组件源码升级 — ADR 0040) \"升级 ui\"、\"升级业务组件\"、\"升级 button\"、\"生成 ui staging\"、\"生成 biz-ui staging\"、\"upgrade ui\"、\"upgrade biz-ui\"、\"upgrade ui component\"、\"stage ui upgrade\"、\"teamix-evo ui upgrade\"、\"teamix-evo biz-ui upgrade\"; (卸载 / 清单) \"卸载 teamix-evo\"、\"看看装了哪些 teamix-evo 资源\"、\"remove the design system\"、\"list installed\"; (placeholder→real 升级) \"升级 UI\"、\"接入真组件\"、\"替换 placeholder\"、\"upgrade UI\"、\"replace placeholders\"、\"swap in real components\"、\"make the UI real\", or user opens / edits `src/components/_placeholder/**`, project contains `.teamix-evo/create/pending-ui.json`, literal `@teamix-evo:placeholder` tag in code; (状态文件) user touches `.teamix-evo/config.json`、`.teamix-evo/manifest.json`、`.teamix-evo/create/pending-ui.json`.\nSKIP: any content task — generating components, pages, services, or reviewing screens; changes to `src/` files outside the migration loop, design tokens, or business logic. Those go to teamix-evo-code-opentrek or teamix-evo-design-opentrek. SKIP if the user is mid-flow inside an already-initialized project asking to \"新增页面 / 加按钮 / 调接口\" — that's coding work, not lifecycle. SKIP pure styling / token tweaks — those go to ESLint + `tokens.overrides.css`.\nCoordinates with: teamix-evo-design-opentrek (visual side after a screen is generated)、teamix-evo-code-opentrek (file placement / reuse rules) — manage is the entry point and precedes content skills, never co-triggers.",
-      "version": "0.3.0",
+      "description": "Single entry point for the teamix-evo lifecycle: scaffold a new project, install the AI coding system into an existing repo, run / update / inspect / remove any teamix-evo package, and drive the placeholder→real UI migration loop after `npm create teamix-evo`.\nTRIGGER when: (CLI) user runs or asks about `teamix-evo init` / `teamix-evo update` / `teamix-evo tokens ...` / `teamix-evo skills ...` / `teamix-evo ui ...` / `teamix-evo biz-ui ...` / `teamix-evo templates ...` / `teamix-evo lint ...` / `teamix-evo logs ...` / `teamix-evo restore ...` / `teamix-evo switch ...`, or `npm create teamix-evo` / `pnpm create teamix-evo`; (模糊初始化) \"初始化一个项目\"、\"初始化一个工程\"、\"初始化一个 teamix-evo 工程\"、\"初始化一个 Teamix Evo 项目\"、\"create a teamix-evo project\"、\"set up teamix-evo from scratch\"、\"new teamix-evo app\"; (具名变体初始化) \"初始化一个 opentrek 工程 / op 工程 / OpenTrek 项目 / 探索者项目\"、\"初始化一个云管 / 云管控制台 / 云管项目 / uni-manager 工程 / 云管工程\"、\"new opentrek/uni-manager project\"; (AI coding 接入) \"给现有仓库装 teamix-evo\"、\"现有项目装一下 skills + ui\"、\"接入 AI coding 体系\"、\"装 teamix-evo 进这个项目\"、\"add teamix-evo to existing repo\"、\"install AI coding system\"、\"接入 opentrek 研发体系\"、\"接入 op 研发体系\"、\"接入 OpenTrek 研发体系\"、\"接入 opentrek 研发系统\"、\"接入 op 研发系统\"、\"接入云管研发体系\"、\"接入云管研发系统\"、\"接入 uni-manager 研发体系\"、\"接入 uni-manager 研发系统\"、\"接入统一管理研发体系\"; (更新检测) \"升级 teamix-evo\"、\"看看哪些要升级\"、\"update teamix-evo\"、\"check what needs updating\"、\"refresh installed teamix-evo packages\"; (组件源码升级 — ADR 0040) \"升级 ui\"、\"升级业务组件\"、\"升级 button\"、\"生成 ui staging\"、\"生成 biz-ui staging\"、\"upgrade ui\"、\"upgrade biz-ui\"、\"upgrade ui component\"、\"stage ui upgrade\"、\"teamix-evo ui upgrade\"、\"teamix-evo biz-ui upgrade\"; (卸载 / 清单) \"卸载 teamix-evo\"、\"看看装了哪些 teamix-evo 资源\"、\"remove the design system\"、\"list installed\"; (placeholder→real 升级) \"升级 UI\"、\"接入真组件\"、\"替换 placeholder\"、\"upgrade UI\"、\"replace placeholders\"、\"swap in real components\"、\"make the UI real\", or user opens / edits `src/components/_placeholder/**`, project contains `.teamix-evo/create/pending-ui.json`, literal `@teamix-evo:placeholder` tag in code; (旧工程迁移) \"迁移旧项目\"、\"重建老工程\"、\"把旧项目搬过来\"、\"旧项目分析\"、\"旧系统翻新\"、\"legacy migration\"、\"migrate old project\"、\"rebuild from existing\"、\"refactor from old codebase\"、\"从旧项目迁移过来\"、\"用旧项目做参考重建\"、\"分析旧项目并迁移\"; (状态文件) user touches `.teamix-evo/config.json`、`.teamix-evo/manifest.json`、`.teamix-evo/create/pending-ui.json`.\nSKIP: any content task — generating components, pages, services, or reviewing screens; changes to `src/` files outside the migration loop, design tokens, or business logic. Those go to teamix-evo-code-opentrek or teamix-evo-design-opentrek. SKIP if the user is mid-flow inside an already-initialized project asking to \"新增页面 / 加按钮 / 调接口\" — that's coding work, not lifecycle. SKIP pure styling / token tweaks — those go to ESLint + `tokens.overrides.css`.\nCoordinates with: teamix-evo-design-opentrek (visual side after a screen is generated)、teamix-evo-code-opentrek (file placement / reuse rules) — manage is the entry point and precedes content skills, never co-triggers.",
+      "version": "0.4.0",
       "source": "src/teamix-evo-manage",
       "ides": ["qoder", "claude"],
       "updateStrategy": "managed",

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@teamix-evo/skills",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "description": "Skills (AI IDE capabilities) for Teamix Evo",
   "type": "module",
   "files": [
@@ -9,15 +9,6 @@
     "src",
     "_template"
   ],
-  "devDependencies": {
-    "@clack/prompts": "^0.8.0",
-    "tsx": "^4.0.0",
-    "@teamix-evo/registry": "0.9.0"
-  },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
   "scripts": {
     "validate": "tsx scripts/validate-skills.ts",
     "scaffold:skill": "tsx scripts/scaffold-skill.ts",
@@ -25,5 +16,14 @@
     "typecheck": "echo 'no ts source'",
     "lint": "echo 'no ts source'",
     "build": "echo 'pure resource package, no build needed'"
+  },
+  "devDependencies": {
+    "@teamix-evo/registry": "workspace:*",
+    "@clack/prompts": "^0.8.0",
+    "tsx": "^4.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
   }
-}
+}

package/src/teamix-evo-manage/SKILL.md CHANGED Viewed

@@ -1,24 +1,24 @@
 ---
 name: teamix-evo-manage
 description: |
-  Single entry point for the teamix-evo lifecycle: scaffold a new project, install the AI coding system into an existing repo, run / update / inspect / remove any teamix-evo package, and drive the placeholder→real UI migration loop after `npm create teamix-evo`.
-  TRIGGER when: (CLI) user runs or asks about `teamix-evo init` / `teamix-evo update` / `teamix-evo tokens ...` / `teamix-evo skills ...` / `teamix-evo ui ...` / `teamix-evo biz-ui ...` / `teamix-evo templates ...` / `teamix-evo lint ...` / `teamix-evo logs ...` / `teamix-evo restore ...` / `teamix-evo switch ...`, or `npm create teamix-evo` / `pnpm create teamix-evo`; (模糊初始化) "初始化一个项目"、"初始化一个工程"、"初始化一个 teamix-evo 工程"、"初始化一个 Teamix Evo 项目"、"create a teamix-evo project"、"set up teamix-evo from scratch"、"new teamix-evo app"; (具名变体初始化) "初始化一个 opentrek 工程 / op 工程 / OpenTrek 项目 / 探索者项目"、"初始化一个云管 / 云管控制台 / 云管项目 / uni-manager 工程 / 云管工程"、"new opentrek/uni-manager project"; (AI coding 接入) "给现有仓库装 teamix-evo"、"现有项目装一下 skills + ui"、"接入 AI coding 体系"、"装 teamix-evo 进这个项目"、"add teamix-evo to existing repo"、"install AI coding system"、"接入 opentrek 研发体系"、"接入 op 研发体系"、"接入 OpenTrek 研发体系"、"接入 opentrek 研发系统"、"接入 op 研发系统"、"接入云管研发体系"、"接入云管研发系统"、"接入 uni-manager 研发体系"、"接入 uni-manager 研发系统"、"接入统一管理研发体系"; (更新检测) "升级 teamix-evo"、"看看哪些要升级"、"update teamix-evo"、"check what needs updating"、"refresh installed teamix-evo packages"; (组件源码升级 — ADR 0040) "升级 ui"、"升级业务组件"、"升级 button"、"生成 ui staging"、"生成 biz-ui staging"、"upgrade ui"、"upgrade biz-ui"、"upgrade ui component"、"stage ui upgrade"、"teamix-evo ui upgrade"、"teamix-evo biz-ui upgrade"; (卸载 / 清单) "卸载 teamix-evo"、"看看装了哪些 teamix-evo 资源"、"remove the design system"、"list installed"; (placeholder→real 升级) "升级 UI"、"接入真组件"、"替换 placeholder"、"upgrade UI"、"replace placeholders"、"swap in real components"、"make the UI real", or user opens / edits `src/components/_placeholder/**`, project contains `.teamix-evo/create/pending-ui.json`, literal `@teamix-evo:placeholder` tag in code; (状态文件) user touches `.teamix-evo/config.json`、`.teamix-evo/manifest.json`、`.teamix-evo/create/pending-ui.json`.
-  SKIP: any content task — generating components, pages, services, or reviewing screens; changes to `src/` files outside the migration loop, design tokens, or business logic. Those go to teamix-evo-code-opentrek or teamix-evo-design-opentrek. SKIP if the user is mid-flow inside an already-initialized project asking to "新增页面 / 加按钮 / 调接口" — that's coding work, not lifecycle. SKIP pure styling / token tweaks — those go to ESLint + `tokens.overrides.css`.
+  Single entry point for the teamix-evo lifecycle: scaffold a new project skeleton, install the AI coding system into an existing repo via `teamix-evo init`, inspect / remove any teamix-evo package, manage component-source upgrades, and drive old-project migration/rebuild.
+  TRIGGER when: (CLI) user runs or asks about `teamix-evo init` / `teamix-evo tokens ...` / `teamix-evo skills ...` / `teamix-evo ui ...` / `teamix-evo biz-ui ...` / `teamix-evo blocks ...` / `teamix-evo lint ...` / `teamix-evo logs ...` / `teamix-evo restore ...` / `teamix-evo switch ...`, or `npm create teamix-evo` / `pnpm create teamix-evo`; (模糊初始化) "初始化一个项目"、"初始化一个工程"、"初始化一个 teamix-evo 工程"、"初始化一个 Teamix Evo 项目"、"create a teamix-evo project"、"set up teamix-evo from scratch"、"new teamix-evo app"; (具名变体初始化) "初始化一个 opentrek 工程 / op 工程 / OpenTrek 项目 / 探索者项目"、"初始化一个云管 / 云管控制台 / 云管项目 / uni-manager 工程 / 云管工程"、"new opentrek/uni-manager project"; (AI coding 接入) "给现有仓库装 teamix-evo"、"现有项目装一下 skills + ui"、"接入 AI coding 体系"、"装 teamix-evo 进这个项目"、"add teamix-evo to existing repo"、"install AI coding system"、"接入 opentrek 研发体系"、"接入 op 研发体系"、"接入 OpenTrek 研发体系"、"接入 opentrek 研发系统"、"接入 op 研发系统"、"接入云管研发体系"、"接入云管研发系统"、"接入 uni-manager 研发体系"、"接入 uni-manager 研发系统"、"接入统一管理研发体系"; (组件源码升级 — ADR 0040) "升级 ui"、"升级业务组件"、"升级 button"、"生成 ui staging"、"生成 biz-ui staging"、"upgrade ui"、"upgrade biz-ui"、"upgrade ui component"、"stage ui upgrade"、"teamix-evo ui upgrade"、"teamix-evo biz-ui upgrade"; (卸载 / 清单) "卸载 teamix-evo"、"看看装了哪些 teamix-evo 资源"、"remove the design system"、"list installed"; (旧工程迁移) "迁移旧项目"、"重建老工程"、"把旧项目搬过来"、"旧项目分析"、"旧系统翻新"、"legacy migration"、"migrate old project"、"rebuild from existing"、"refactor from old codebase"、"从旧项目迁移过来"、"用旧项目做参考重建"、"分析旧项目并迁移"; (状态文件) user touches `.teamix-evo/config.json`、`.teamix-evo/manifest.json`.
+  SKIP: any content task — generating components, pages, services, or reviewing screens; changes to `src/` files outside the component upgrade flow, design tokens, or business logic. Those go to teamix-evo-code-opentrek or teamix-evo-design-opentrek. SKIP if the user is mid-flow inside an already-initialized project asking to "新增页面 / 加按钮 / 调接口" — that's coding work, not lifecycle. SKIP pure styling / token tweaks — those go to ESLint + `tokens.overrides.css`.
   Coordinates with: teamix-evo-design-opentrek (visual side after a screen is generated)、teamix-evo-code-opentrek (file placement / reuse rules) — manage is the entry point and precedes content skills, never co-triggers.
 ---
 # teamix-evo-manage
-> **📋 重要提示**：若项目已跑过 `teamix-evo init`，请先读 `.teamix-evo/init-checklist.md`（CLI 自动生成）。该文件记录了 Phase A（CLI 步骤）和 Phase B（6 步 AI 串场）的完成状态。按 checklist 顺序继续执行，不要跳步。
 Single entry skill for the **teamix-evo** toolkit lifecycle. Covers six scenarios:
 1. Fuzzy init → ask user to pick a tokens variant.
-2. Named-variant init → infer variant from business name, run scaffold directly.
+2. Named-variant init → infer variant from business name, run scaffold + init directly.
 3. Adopt teamix-evo into an existing npm repo via `teamix-evo init` (普通版接入, no scaffold step).
-4. Update detection — only refresh what's already installed, including 4e component-source upgrade staging（`ui upgrade` / `biz-ui upgrade`）.
+4. Component-source upgrade (组件源码升级 — ADR 0040).
 5. Uninstall.
-6. Placeholder → real UI migration loop (post-`npm create teamix-evo`).
+6. Old-project migration (旧工程迁移重建) → analyze old project via repo-wiki + source reading, generate phased migration plan, AI-driven page-by-page rebuild in the new project.
+> **Note**: The top-level `teamix-evo update` command has been removed (ADR 0043). For tokens/skills updates, use `teamix-evo tokens update` / `teamix-evo skills update` directly. For component-source upgrades, use `teamix-evo ui upgrade` / `teamix-evo biz-ui upgrade`.
 ## 安装方式
@@ -50,28 +50,21 @@ npx teamix-evo@latest skills update --dry-run             # 预览,不写盘
 <!-- teamix-evo:managed:start id="core" -->
-## HARD GATE 协议
-> 本 skill 中标注 `⚠️ HARD GATE` 的步骤是**强制执行点**，客户侧 AI **必须**在该步骤执行完毕并得到用户确认后才能继续。
->
-> - **不得跳过**：即使用户说"全部跳过"，也必须逐项告知 HARD GATE 步骤的存在并征得显式确认
-> - **不得合并**：多个 HARD GATE 步骤不得合并为一次性批量执行
-> - **不得软化**：不能将"必须"改述为"建议"或"按需"
-> - **事实留痕**：每个 HARD GATE 步骤完成后，必须更新 `.teamix-evo/init-checklist.md` 对应项的状态
 ## 决策树(动手前必看)
 ```text
 用户的指令命中本 skill
   ├── 目录里有 `.teamix-evo/`?
-  │     是 ──▶ 4 (更新) / 5 (卸载)
+  │     是 ──▶ 用户提到「迁移 / 重建 / migrate / 旧项目 / legacy」?
+  │     │       是 ──▶ 6 (旧工程迁移重建)
+  │     │       否 ──▶ 4 (组件升级) / 5 (卸载) / 各子命令按需调用
   │     否 ──▶ 继续
   ├── 用户说出业务名 / variant?
   │     是 ──▶ 2 (具名变体初始化) — 用「业务名→variant 映射表」推断
   │     否 ──▶ 继续
   ├── 目录是空的(或只有 .git / README.md)?
   │     是 ──▶ 1 (模糊初始化) — 询问 variant 后转 2
-  │     否 ──▶ 3 (普通版接入) — `teamix-evo init` 一键检测 + wizard + 6 类冲突 + 静默落地
+  │     否 ──▶ 3 (普通版接入) — `teamix-evo init` 8 步流水线 + 薄版冲突检测
 ```
 ## 业务名 → variant 映射
@@ -92,9 +85,8 @@ CLI 二进制名 `teamix-evo`（+ 脚手架独立二进制 `create-teamix-evo`
 | Group         | Verb                                                  | 用途                                                                                                                                                                |
 | ------------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **create**    | `npm create teamix-evo [dir] [-y]`                    | 一站式脚手架：scaffold + tokens + skills + ui + lint（`-y` 跳过交互走推荐默认）                                                                                     |
-| **init**      | `init [-y] [--dry-run] [--variant <v>] [--cwd <dir>]` | 普通版接入：把 teamix-evo 注入已有 npm 工程（三分支决策树 + 6 类冲突检测 + wizard）                                                                                 |
-| **update**    | `update [--dry-run] [--cwd <dir>]`                    | 套件级升级 orchestrator：tokens → skills（ADR 0019）                                                                                                                |
+| **create**    | `npm create teamix-evo [dir] [-y]`                    | 骨架脚手架：模板 + variant overlay + package.json merge + .mcp.json + 依赖安装 + git init（`-y` 跳过交互走推荐默认）；完成后需跑 `teamix-evo init` 装入 AI 套件     |
+| **init**      | `init [-y] [--dry-run] [--variant <v>] [--cwd <dir>]` | 8 步流水线：tokens → skills → agents-md → ui-init → ui-add → biz-ui-add → lint → gitignore（8 类冲突检测 + `--force` 跳过）                                         |
 | **switch**    | `switch <new-variant> [--apply] [-y] [--cwd <dir>]`   | 切到目标 variant：dry-run 默认，`--apply` 才真写；自动 snapshot + token rename hint                                                                                 |
 | **restore**   | `restore [<ts>] [--list] [-y] [--cwd <dir>]`          | 失败回滚：从 snapshot 还原 `.teamix-evo/`，pre-restore 自身可逆（ADR 0019 §2）                                                                                      |
 | **tokens**    | `init <variant>`                                      | 初始化指定变体的 design tokens（`<variant>` 必填）                                                                                                                  |
@@ -123,16 +115,17 @@ CLI 二进制名 `teamix-evo`（+ 脚手架独立二进制 `create-teamix-evo`
 |               | `list`                                                | 列出变体下的业务组件                                                                                                                                                |
 |               | `list-variants`                                       | 列出可用业务组件变体                                                                                                                                                |
 |               | `upgrade [id...]`                                     | 生成 biz-ui 升级 staging（变体感知，ADR 0040；skill 应用）                                                                                                          |
-| **templates** | `add <id...>`                                         | 安装页面模板（`--variant` 必填）⚠️ AI 默认不主动调用（ADR 0031）                                                                                                    |
-|               | `list`                                                | 列出变体下的模板                                                                                                                                                    |
-|               | `list-variants`                                       | 列出可用模板变体                                                                                                                                                    |
+| **blocks**    | `add <id...>`                                         | 安装 marketing block（Hero / Features / CTA 等落地页区块，ADR 0044）                                                                                                |
+|               | `list`                                                | 列出可用 blocks（`--installed` 仅已装；`--json` 机器可读）                                                                                                          |
+|               | `upgrade [id...]`                                     | 生成 blocks 升级 staging（ADR 0040；通过 teamix-evo-upgrade skill 应用）                                                                                            |
+| **templates** | ~~`add` / `list` / `list-variants`~~                  | ⚠️ 已废弃，请改用 `teamix-evo blocks`（ADR 0044）                                                                                                                   |
 | **lint**      | `init`                                                | 初始化 ESLint + Stylelint token-discipline 规则                                                                                                                     |
 | **logs**      | `analyze`                                             | 汇总 vibe-logger JSONL（tool / tag / MCP 频次）                                                                                                                     |
 |               | `trace`                                               | 会话级调用链回溯（按 prompt / session 过滤）                                                                                                                        |
 > **脚注**
 >
-> - `tokens` / `biz-ui` / `templates` 共享 variant 名空间（ADR 0014），与 `tokens init` 选定 variant 一致。
+> - `tokens` / `biz-ui` 共享 variant 名空间（ADR 0014），与 `tokens init` 选定 variant 一致。`blocks` 是 token-driven、variant 无关的独立包（ADR 0044）。
 > - `skills init` vs `add`：init 无 ids = 自举全部匹配 skill；add 必填 ids = 增量（ADR 0034）。
 > - 源镜像模型（ADR 0013）：规范副本在 `.teamix-evo/skills-source/`，IDE 镜像在 `.qoder/skills/` 与 `.claude/skills/`。
@@ -152,6 +145,8 @@ npx create-teamix-evo --help                # 脚手架帮助
 | ------------------------ | ------------------------------------- |
 | UI 组件列表 / 搜索       | `list_components` / `find_components` |
 | 组件详情（props / deps） | `get_component_meta`                  |
+| Blocks 列表 / 搜索       | `blocks_list` / `blocks_find`         |
+| Block 详情               | `blocks_get`                          |
 | Skill 列表 / 搜索        | `skills_list` / `skills_find`         |
 | Skill 详情               | `skills_get`                          |
 | Design tokens            | `tokens_list` / `tokens_search`       |
@@ -173,7 +168,7 @@ npx create-teamix-evo --help                # 脚手架帮助
 **触发**:用户在「业务名 → variant 映射」中能锁定 variant,或场景 1 询问后得到答复。
-**唯一命令**:
+### 第一步：生成骨架
 ```bash
 npm create teamix-evo@latest <dir> --variant <name> -y
@@ -182,23 +177,35 @@ npm create teamix-evo@latest <dir> --variant <name> -y
 > `-y` 跳过包管理器 / git init 等交互，全部走推荐默认值（pm=auto、git=true）。
-`create-teamix-evo` 的 `console` preset(默认且当前唯一)会自动一站式落地:
+`create-teamix-evo` 的 `console` preset(默认且当前唯一)只做骨架生成：
-| 阶段 | 产物                                                                                                       |
-| ---- | ---------------------------------------------------------------------------------------------------------- |
-| 1    | Vite + React + TS scaffold(`src/`、`vite.config.ts` 等)                                                    |
-| 2    | `tokens init <variant>` → 根 `tokens/` 目录(`tokens.theme.css` / `tokens.overrides.css`)                   |
-| 3    | `skills add design-<variant> code-<variant>` → 项目级装 2 个 variant 内容 skill(manage 不在内,见 ADR 0033) |
-| 4    | `ui init` → `.teamix-evo/config.json`                                                                      |
-| 5    | `ui add` → 真组件源码(button / card / input / form / table 等)                                             |
-| 6    | `lint init` → ESLint + Stylelint 配置                                                                      |
+| 阶段 | 产物                                             |
+| ---- | ------------------------------------------------ |
+| 1    | Vite + React + TS scaffold（base template 复制） |
+| 2    | variant overlay（变体专属配置覆盖）              |
+| 3    | package.json merge（合并依赖）                   |
+| 4    | `.mcp.json` 写入                                 |
+| 5    | 依赖安装（`pnpm install` / `npm install`）       |
+| 6    | git init                                         |
-> 提示:`teamix-evo-manage` 是 entry skill,推荐**全局**装一次(`npx teamix-evo skills add teamix-evo-manage --scope global`)。create CLI 不会装它到 project,scaffold 完成后的 next-steps 会提示用户。
+> **注意**：`create` 不再调用 `teamix-evo/core` 的任何函数（ADR 0043），它只生成纯静态骨架。
-**完成后告知用户**:
+### 第二步：装入 AI 套件
+骨架完成后，`create` 的 next-steps 会提示用户跑：
 ```bash
 cd <dir>
+npx teamix-evo init --variant <name> -y
+```
+该命令走场景 3 的 8 步流水线，装入 tokens / skills / ui 组件 / lint 等全套资产。
+> 提示:`teamix-evo-manage` 是 entry skill,推荐**全局**装一次(`npx teamix-evo skills add teamix-evo-manage --scope global`)。create CLI 不会装它到 project,scaffold 完成后的 next-steps 会提示用户。
+**全部完成后告知用户**:
+```bash
 pnpm dev          # 立刻可跑
 pnpm typecheck    # 验证零类型错误
 ```
@@ -218,34 +225,40 @@ npx teamix-evo init [-y] [--dry-run] [--variant <name>] [--cwd <dir>]
 | 当前目录状态                          | init 反应                                           |
 | ------------------------------------- | --------------------------------------------------- |
 | 空目录 / 仅含 `.git` 等可忽略文件     | ⚠ 提示改用 `npm create teamix-evo@latest`（场景 2） |
-| 已有 `.teamix-evo/`                   | ⚠ 提示改用 `update` / `doctor`（场景 4）            |
+| 已有 `.teamix-evo/`                   | ✓ 已初始化，每步幂等短路自动跳过已完成步骤          |
 | 有 `package.json` 但无 `.teamix-evo/` | ✓ 走主路径                                          |
-### 主路径六步流水线
+### 主路径八步流水线
-| #   | 步骤      | 关键 | 行为                                                                                   |
-| --- | --------- | ---- | -------------------------------------------------------------------------------------- |
-| 1   | tokens    | ✓    | 写 `tokens/`，顺带装 design skill；旧路径单文件命中 `migrate` 策略时自动提层迁移       |
-| 2   | skills    | ✓    | 项目级装 `teamix-evo-code-<variant>`（manage 全局装一次，design 由 1 顺带 — ADR 0033） |
-| 3   | agents-md | –    | 生成根 `AGENTS.md`，managed-region 可重生（ADR 0038）                                  |
-| 4   | ui-init   | ✓    | 写 `components.json` + `packages.ui` 配置                                              |
-| 5   | ui-add    | –    | 装基线 13 个组件（`uiSelection='all'` 则装全集）                                       |
-| 6   | lint      | –    | `runLintInit`（ESLint + Stylelint）                                                    |
+| #   | 步骤       | 关键 | 行为                                                                                   |
+| --- | ---------- | ---- | -------------------------------------------------------------------------------------- |
+| 1   | tokens     | ✓    | 写 `tokens/`，顺带装 design skill；旧路径单文件命中 `migrate` 策略时自动提层迁移       |
+| 2   | skills     | ✓    | 项目级装 `teamix-evo-code-<variant>`（manage 全局装一次，design 由 1 顺带 — ADR 0033） |
+| 3   | agents-md  | –    | 生成根 `AGENTS.md`，managed-region 可重生（ADR 0038）                                  |
+| 4   | ui-init    | ✓    | 写 `components.json` + `packages.ui` 配置                                              |
+| 5   | ui-add     | –    | 装全量 UI 组件源码（overwrite 模式）                                                   |
+| 6   | biz-ui-add | –    | 装当前 variant 下全量业务组件（无可用则 skip）                                         |
+| 7   | lint       | –    | `runLintInit`（ESLint + Stylelint）                                                    |
+| 8   | gitignore  | –    | 追加 teamix-evo runtime 规则到 `.gitignore`                                            |
 > 关键步骤失败 → 后续关键步骤短路成 `skip(aborted)`；非关键步骤失败不阻断整体。
-### 6 类冲突（wizard 逐项询问策略）
+### 8 类冲突（薄版检测 — ADR 0043 §3）
-| 冲突键            | 已实现策略                                        |
-| ----------------- | ------------------------------------------------- |
-| `tokens`          | `migrate` / `overwrite` / `skip`                  |
-| `agents-md`       | `merge-managed` / `overwrite` / `skip`            |
-| `components-json` | `overwrite` / `skip`                              |
-| `shadcn-source`   | `overwrite` / `skip-existing` / `skip`            |
-| `tailwind-config` | 仅 `skip`（其它策略待批次 4 managed-region 引擎） |
-| `index-css`       | 仅 `skip`（其它策略待批次 4 managed-region 引擎） |
+init 前自动 `detectConflicts(cwd)` 扫描，产出结构化报告；发现冲突时终止并输出，由 AI 层决策下一步。`--force` 跳过全部检测。
-> wizard 给每项一个推荐策略；`-y` 全走推荐默认值；`--dry-run` 只打印计划不写文件。
+| 冲突键             | 检测对象                                |
+| ------------------ | --------------------------------------- |
+| `tokens`           | `tokens/` 目录已存在                    |
+| `agents-md`        | 根 `AGENTS.md` 已存在                   |
+| `components-json`  | `.teamix-evo/config.json` 已存在        |
+| `shadcn-source`    | `src/components/ui/` 下已有组件文件     |
+| `tailwind-config`  | `tailwind.config.*` 已存在              |
+| `index-css`        | `src/index.css` 含现有 token import     |
+| `eslint-config`    | `.eslintrc*` / `eslint.config.*` 已存在 |
+| `stylelint-config` | `.stylelintrc*` 已存在                  |
+> `--force` 跳过全部冲突检测，overwrite 所有已有文件；`--dry-run` 只打印计划不写文件。
 #### tokens `migrate` 策略（W1.4 提层兼容）
@@ -267,99 +280,11 @@ CLI 在 partial 状态会打印“恢复指引”面板：失败步骤名、错
 - `pendingConflictWork`（如有）：批次 4 上线后用 `teamix-evo conflict resolve` 收尾。
 - 全局 entry skill：若 `~/.qoder/skills/teamix-evo-manage` 不存在，补一句 `npx teamix-evo skills add teamix-evo-manage --scope global -y`（ADR 0033）。
-### Post-init AI 串场（6 步闭环）
-> CLI `init` 完成后，末尾会打印 Next Steps 板块，并提示「让 AI 接力」。当用户在 IDE 内触发本 skill 接力时，按以下 6 步顺序走完闭环；每步执行前先告知用户即将做什么，执行后回报关键统计。
->
-> **前置**：开始前先读 `.teamix-evo/init-checklist.md`（CLI init 自动生成），确认 Phase A（CLI 步骤）已全部 `[x]`，再开始 Phase B。
-| #   | 步骤            | GATE | 命令 / 操作                                                                                                                    | 目的                                                                                                                                             | 何时跳过                      |
-| --- | --------------- | ---- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------- |
-| 1   | adopt           | ⚠️   | `npx teamix-evo ui add --adopt --dry-run` → 确认后去 dry-run                                                                   | 把项目里现有的 `src/components/{ui,business}/**` + hooks/utils 全量纳管到 manifest（strategy=frozen，标 `sourceLineage=detected`），不动文件内容 | 项目无 `src/components/`      |
-| 2   | upgrade staging | ⚠️   | `npx teamix-evo ui upgrade`（再 `biz-ui upgrade`）                                                                             | 生成 `.upgrade-staging/`，每条目带 `featureVector` + `recommendedModes` + `confidence`（ADR 0040）                                               | adopt 0 件 / 全部 frozen 一致 |
-| 3   | tokens audit    | ⚠️   | `npx teamix-evo tokens audit`                                                                                                  | 4 类输出：冗余删除 / 有效保留 / 推荐迁移 / 项目特有；与 `theme.css` 做 v3↔v4 语义比较                                                            | overrides 0 变量              |
-| 4   | AGENTS.md 回填  | –    | 读根 `AGENTS.md` managed 区域之外的内容，按 heading 归类（UI 设计 / 代码研发 / 项目特有），把项目特有规则塞回 managed 区域之前 | 让用户私有规范与 Skills 注入区共存，不被 `init --merge-managed` 覆盖                                                                             | 用户文件全为 managed-only     |
-| 5   | lint            | –    | `npx teamix-evo lint init -y`（如未跑）+ `pnpm lint`                                                                           | token-discipline 兜底；error 数内嵌报告                                                                                                          | 已跑过且 0 error              |
-| 6   | token 治理      | ⚠️   | 触发 [`teamix-evo-upgrade`](../teamix-evo-upgrade/SKILL.md) skill Part C（Token treatment pipeline）                           | 跑 `tokens diagnose` → 按 treatment-plan 逐批 `tokens treat` → 锁基线                                                                            | diagnose 报告 0 违规          |
-> **GATE 列**：`⚠️` = HARD GATE 步骤（见顶部 HARD GATE 协议），必须逐步执行并征得用户确认后才能继续。`–` = 常规步骤，仍需告知用户但可按用户意愿跳过。
-执行约定：
-- **每步前**先用一句话告诉用户「即将做什么 + 命令是什么」，等用户回 `OK / 跳过` 再动手；不要批量静默连发。
-- ⚠️ HARD GATE：**HARD GATE 步骤不接受「跳过」**——必须执行或由用户明确说「本步不适用（并说明原因）」。
-- **每步后**汇总数字：`adopted=N foreign=M / staged=K / overrides 删 X 留 Y / AGENTS.md 增 Z 段 / lint error=E / token violations=V`。
-- **每步后必须更新 `.teamix-evo/init-checklist.md`**：把对应步骤从 `[ ]` 改为 `[x]`，附完成时间和关键统计。
-- **遇 ManualReview / foreign / 推荐迁移**：列出来交给用户决策，不替用户改代码。
-- 6 步走完，输出一段 `done` 总结 + 后续可走的命令（`ui promote-to-biz` / `restore` / `update` / `tokens treat`）。
-#### 第 4 步 AGENTS.md 回填 — 三类分类标准
-读根 `AGENTS.md` 中 managed 区段 **之外** 的用户手写内容（heading + body），逐段按以下三类归类：
-| 类别                 | 判定条件                                                                                            | 处理                                                                        |
-| -------------------- | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
-| **A · skill 已覆盖** | 内容与 managed 区段中 skill 注入的段落语义重复（如 UI 组件领地约束、lint 规则说明、触发兜底规则等） | 告知用户「此段已被 skill 覆盖，建议移除以避免冲突」，**需用户确认后才删除** |
-| **B · 业务特有**     | 与 skill 无重叠的项目私有规范（如业务命名约定、API 规范、目录结构约束、团队 code review 规则等）    | 保留在 managed 区段 **之前**，确保 `init --merge-managed` 不会覆盖          |
-| **C · 不确定**       | 无法判断归属，或内容与 skill 部分重叠但有额外信息                                                   | 列出给用户，让用户选择：保留（归 B）/ 移除（归 A）/ 合并进 managed          |
-**操作原则**：
-- 只移动段落位置（managed 前 vs 后），**不改写用户段落内容**
-- 分类结果逐段告知用户，不要批量静默处理
-- 最终输出统计：`skill 已覆盖=N（已移除 M）/ 业务特有=K（已保留）/ 待决策=J`
 ## 场景 4 · 升级
-> **概念区分**："升级 teamix-evo"= 升级**整个 AI 套件**（所有已装包）；"升级 manage skill / 升级某个 skill"= 只升级指定的 skill。根据用户表述判断走哪条路径。
-### 4a · 套件级升级（"升级 teamix-evo / update teamix-evo"）
-**触发**:用户说"升级 teamix-evo / 看看哪些要升级 / update teamix-evo / 升级套件 / refresh installed teamix-evo packages"。
-**一行命令**:
-```bash
-npx teamix-evo@latest update            # 实际执行 tokens → skills 升级
-npx teamix-evo@latest update --dry-run   # 只看升级计划,不写任何文件
-```
-**orchestrator 两步管线**（ADR 0003 三态 + ADR 0035 短路）:
-| 步骤 | 包     | 语义                             | 失败后果                           |
-| ---- | ------ | -------------------------------- | ---------------------------------- |
-| 1    | tokens | regenerable 覆盖 + frozen 保留   | **关键步骤**：失败时中止后续       |
-| 2    | skills | lock ∩ scope ∩ version-diff 短路 | 非关键：记录失败但不中止已完成步骤 |
-> ui / biz-ui / templates 是 frozen（ADR 0019）— 不参与 bulk update。如用户想覆盖单个组件,引导用 `ui add <id> --overwrite`。
-**AI 引导决策树**:
-1. **先推荐 dry-run**：执行 `npx teamix-evo@latest update --dry-run`。
-2. 根据输出告知用户：
-   - `dry-run` 步骤全 `·` up-to-date → 「已是最新版本，无需升级」。
-   - 有版本 bump 计划 → 确认后去掉 `--dry-run` 执行。
-3. 执行后根据 CLI 输出的 STEP_ICON 反馈：
-   - 全 `✔` → 告知升级完成 + 版本变化。
-   - 含 `✖`（partial）→ CLI 已打印「恢复指引」面板，复述给用户：
-     - 哪个步骤失败 + 错误信息
-     - 建议修复后重跑 `teamix-evo update`（每步幂等，version-diff 短路自动跳过已完成步骤）
-   - 全 `⊘` skip → 告知相应包未安装,如需添加走场景 3。
-**不要**给未安装的包做 install — 那是场景 2/3 的事。
-**不要**手动拼 `tokens update` + `skills update` — 统一用 `teamix-evo update`。
-#### Token rename 收尾（可选，仅当 CLI 输出 `💡 token rename hint:` 时）
+> **注意**：顶层 `teamix-evo update` 命令已移除（ADR 0043）。tokens / skills 升级请直接使用对应子命令（`tokens update` / `skills update`）。组件源码升级走 `ui upgrade` / `biz-ui upgrade`。
-`tokens update` / `switch --apply` 跳过了 rename 节点时，CLI 会在 `.teamix-evo/.upgrade-hints/tokens-<ts>.json` 写一份改名索引。这是**被动提示** — CLI 永远不会自动改写 `src/**`（frozen 边界，ADR 0019 §D4）。
-要项：
-- 告诉用户 hint 文件路径；
-- 引导用户调 [`teamix-evo-upgrade`](../teamix-evo-upgrade/SKILL.md) skill 处理 codemod（扫描 `src/**` + `tokens/tokens.overrides.css`，逐文件 diff 征同意后才修改）；
-- 未检测到 hint 时则安静跳过，不要装作有 codemod 要跑。
-### 4b · 单 skill 升级（"升级 manage skill / 升级 design skill"）
+### 4a · 单 skill 升级（“升级 manage skill / 升级 design skill”）
 **触发**:用户明确指定要升级某个 skill(如"升级 teamix-evo-manage / 更新 design skill / update manage skill")。
@@ -370,7 +295,7 @@ npx teamix-evo@latest skills update <skill-id>           # 指定 skill
 npx teamix-evo@latest skills update <skill-id> --dry-run  # 先预览
 ```
-### 4c · variant 切换（`teamix-evo switch` — ADR 0019 task #7）
+### 4b · variant 切换（`teamix-evo switch` — ADR 0019 task #7）
 **触发**：用户表达“切到 uni-manager / 切到云管 / 换个 variant / switch 到 opentrek / 迁到探索者体系 / variant migration”。
@@ -399,7 +324,7 @@ npx teamix-evo@latest switch <new-variant> --apply -y # 跳二次确认（destru
 4. 成功后：
    - CLI 输出 `priorVariant: <old>` / `variant: <new>`，`config.json` 已记录备查；
    - 若 CLI 输出 `💡 token rename hint:` — 引导用户走 [`teamix-evo-upgrade`](../teamix-evo-upgrade/SKILL.md) skill 扫 `src/**` 与 `tokens.overrides.css`。
-5. 失败：switch 执行前会自动 `reason="switch"` snapshot，`partial` 状态可走场景 4d `restore`。
+5. 失败：switch 执行前会自动 `reason="switch"` snapshot，`partial` 状态可走场景 4c `restore`。
 **不要**：
@@ -407,9 +332,9 @@ npx teamix-evo@latest switch <new-variant> --apply -y # 跳二次确认（destru
 - 不要为了“保留用户业务代码”去手动改 `src/**`：frozen 资源完全交给 codemod skill，CLI 仓抱不越界。
 - 不要把 `switch` 当作“调个 token 样式”的快捷手段 — 它是跨 variant 迁移，仅在业务名变更 / 双 variant 互迁时使用。
-### 4d · 失败回滚（`teamix-evo restore` — ADR 0019 §2）
+### 4c · 失败回滚（`teamix-evo restore` — ADR 0019 §2）
-**触发**:`init` / `update` 出现 `partial` 状态后用户希望**完全回退**到执行前的 `.teamix-evo/` 状态(而不是修原因后续跑)。
+**触发**:`init` / `switch` 出现 `partial` 状态后用户希望**完全回退**到执行前的 `.teamix-evo/` 状态(而不是修原因后续跑)。
 **两步**:
@@ -418,21 +343,21 @@ npx teamix-evo restore --list           # 列出可用 snapshot(最新在前)
 npx teamix-evo restore <ts>             # 回滚到指定 snapshot(默认带二次确认,-y 跳过)
 ```
-snapshot 由 `init` / `update` / `variant switch` 在执行前**自动**生成,默认保留最近 5 个;reason 字段标识来源(`init` / `update` / `switch` / `restore` / `manual`)。
+snapshot 由 `init` / `switch` 在执行前**自动**生成,默认保留最近 5 个;reason 字段标识来源(`init` / `switch` / `restore` / `manual`)。
 **关键性质 — restore 自身可逆**:`restore <ts>` 在覆盖前会再做一次 `reason="restore"` 的安全 snapshot,所以即便回滚错版本也可以再 `restore --list` 找回前一个状态。
 **AI 引导**:
-- 优先推荐 `修因 + 重跑 init/update`(`partial` 状态恢复的常规路径) — 每步幂等,version-diff 短路。
+- 优先推荐 `修因 + 重跑 init`(`partial` 状态恢复的常规路径) — 每步幂等,version-diff 短路。
 - 仅当用户明确表达"恢复到执行前 / 撤销这次升级 / 全部退回"时才走 `restore`。
 - 回滚后告知用户:已执行 `restore <ts>`,本次操作前的状态已存为新 `reason=restore` snapshot 备查。
-### 4e · 组件源码升级（`teamix-evo ui upgrade` / `teamix-evo biz-ui upgrade` — ADR 0040）
+### 4d · 组件源码升级（`teamix-evo ui upgrade` / `teamix-evo biz-ui upgrade` — ADR 0040）
 **触发**：用户表达“升级 ui / 升级业务组件 / 升级 button / 看看哪些组件有新版 / upgrade ui / upgrade biz-ui / stage ui upgrade”等关键词。
-> 这里是**版本演进**（installed 资源 → 上游新版 → staging → 逐个 apply），与场景 6 “placeholder→real 首次填充”是两条路：场景 6 是初体验起点（`pending-ui.json`），这里是安装完成后跟随上游发布。
+> 这里是**版本演进**（installed 资源 → 上游新版 → staging → 逐个 apply），是安装完成后跟随上游发布的升级流程。
 **一行命令**：
@@ -443,7 +368,7 @@ npx teamix-evo biz-ui upgrade              # 变体感知的 biz-ui staging
 npx teamix-evo biz-ui upgrade --apply      # 错误：CLI 不写 src，guidance 走 teamix-evo-upgrade skill
 ```
-运行 `teamix-evo update` 时，orchestrator 中也会自动跳过一次 `ui:planned` / `biz-ui:planned`，产出同样的 staging 目录。
+运行 `teamix-evo ui upgrade` 时，也会自动跳过一次 `ui:planned` / `biz-ui:planned`，产出同样的 staging 目录。
 **lineage 分三档**（CLI 只在前两者上产出 staging）：
@@ -456,7 +381,7 @@ npx teamix-evo biz-ui upgrade --apply      # 错误：CLI 不写 src，guidance
 **AI 引导决策树**：
-1. **先识别 lineage**：`teamix-evo update` 的 step detail / `ui upgrade` 的输出都会带 `lineage=...`。根据表选开场白。
+1. **先识别 lineage**：`ui upgrade` 的输出会带 `lineage=...`。根据表选开场白。
 2. **路径 A（`teamix-evo` / `mixed`）**：
    - CLI 生成 staging 后会输出 `staging at .teamix-evo/.upgrade-staging/<dir>` + risk 汇总。复述给用户。
    - **应用 staging 交给 [`teamix-evo-upgrade`](../teamix-evo-upgrade/SKILL.md) skill** — 它会逐个展示 diff，按 risk 分批让用户确认后才复制 incoming.tsx 到 src（逐文件 hard gate）。
@@ -477,11 +402,11 @@ npx teamix-evo biz-ui upgrade --apply      # 错误：CLI 不写 src，guidance
 - 不要听到“升级 ui”就打 `ui add` — `add` 是装进去，`upgrade` 是已装后追上上游。
 - 不要在 `shadcn-native` lineage 强行跳 staging；CLI 跳过是预期行为。
-### 4f · 组件源码 promotion（`teamix-evo ui promote-to-biz` — Init 落地计划 §C.3 / §C.4）
+### 4e · 组件源码 promotion（`teamix-evo ui promote-to-biz` — Init 落地计划 §C.3 / §C.4）
-**触发**：用户表达“把 ui 组件融进 biz-ui / 把 button 提级成业务组件 / promote ui to business / 把 staging 里的差异融合到 business 层 / 多模式融合 / wrapper + preset 叠加 / 双轨 coexist / 把上游版和自家版同时保留”等关键词；或在场景 4e 走完 staging 后用户问“能不能直接生成业务包装组件”。
+**触发**：用户表达“把 ui 组件融进 biz-ui / 把 button 提级成业务组件 / promote ui to business / 把 staging 里的差异融合到 business 层 / 多模式融合 / wrapper + preset 叠加 / 双轨 coexist / 把上游版和自家版同时保留”等关键词；或在场景 4d 走完 staging 后用户问“能不能直接生成业务包装组件”。
-> 这是 §4e 的**下游**：4e 只生成 `.upgrade-staging/`，4f 才把条目按 AI 推荐的 `recommendedModes` 真正落地到 `src/components/business/` 并维护 manifest。**条目的 8 模式判定全部由 staging meta 给出**，本 skill 只做分组、确认、转发命令。
+> 这是 §4d 的**下游**：4d 只生成 `.upgrade-staging/`，4e 才把条目按 AI 推荐的 `recommendedModes` 真正落地到 `src/components/business/` 并维护 manifest。**条目的 8 模式判定全部由 staging meta 给出**，本 skill 只做分组、确认、转发命令。
 **一行命令**：
@@ -524,7 +449,7 @@ npx teamix-evo ui promote-to-biz --staging-dir <path>  # 指定 staging 目录
 4. **逐组调 promote-to-biz** —— 每组一次命令调用，传该组所有 id；先 `--dry-run` 看 FileChange 四桶（new/modified/deleted/backed-up），用户 OK 后去 dry-run 真写。
 5. **收尾输出未处理 + import skipped 清单** —— 命令结束后复述：
    - `manualReview: [...]` 让用户人工抉择（看 diff 或拆 family）
-   - `tokenOnly: [...]` 引导走场景 6 / `tokens audit`
+   - `tokenOnly: [...]` 引导走 `tokens audit`
    - `importRewrite.skipped: [{file, line, reason}]` 列出动态 import / 别名 export / 模板字符串这些 regex 重写不到的位置，让用户人工处理
    - `failed: [...]`（如果有）逐条说明失败原因
@@ -532,7 +457,7 @@ npx teamix-evo ui promote-to-biz --staging-dir <path>  # 指定 staging 目录
 - **CLI（`ui promote-to-biz`）**：执行备份、写 `business/`、回填 `ui/`、按 spec 重写 `src/**` 静态 import、改 manifest（promoted 资源记入虚拟包 `@teamix-evo/biz-ui-promoted`）。
 - **AI（本 skill）**：读 meta、分组、展示 diff、征用户同意、转命令；**不**自己写文件、**不**自己改 import。
-- **`teamix-evo-upgrade` skill**：管 §4e staging → src 的 1:1 替换；**不**做模式分流，本场景才做。
+- **`teamix-evo-upgrade` skill**：管 §4d staging → src 的 1:1 替换；**不**做模式分流，本场景才做。
 **不要**：
@@ -553,6 +478,169 @@ npx teamix-evo ui promote-to-biz --staging-dir <path>  # 指定 staging 目录
 `tokens uninstall` 默认保留 `managed` 文件以保护用户编辑;`--keep-files` 完全保留物理文件,只清 manifest。
+## 场景 6 · 旧工程迁移重建（Old-Project Migration）
+**触发**：用户在已初始化的 teamix-evo 项目中说"迁移旧项目 / 重建老工程 / 把旧项目搬过来 / 旧项目分析 / 旧系统翻新 / legacy migration / migrate old project / rebuild from existing project / refactor from old codebase / 从旧项目迁移过来 / 用旧项目做参考重建 / 分析旧项目并迁移"。
+> **前提**：当前目录已有 `.teamix-evo/config.json`（即已走完场景 1/2/3 的初始化）。若当前目录未初始化，先引导用户完成初始化再回到本场景。
+### AI 行为协议（三阶段闭环）
+#### Phase A · 信息收集
+1. **询问旧项目路径** — 向用户索取旧项目的**绝对路径**（`<old-path>`）。可选附加：旧项目运行后的可访问 URL（用于后续截图 / 功能比对）。
+2. **检测 repo-wiki** — 检查 `<old-path>/.qoder/repowiki/` 是否存在且非空：
+   - 存在 → 进入步骤 3。
+   - 不存在 → 告知用户："旧项目尚未生成 repo-wiki，请先在旧项目目录使用 Qoder 生成 repo-wiki，完成后告诉我。"等待用户确认后重检。
+3. **读取 repo-wiki** — 增量读取 `<old-path>/.qoder/repowiki/` 目录内容。优先读中文版（`repowiki/zh/`），其次英文版（`repowiki/en/`）。按文件名语义识别：
+   - 项目总览 / 概述
+   - 目录结构 / 模块划分
+   - 页面 / 路由清单
+   - API 端点清单
+   - 数据模型 / 类型定义
+   - 依赖清单
+   > 不一次性读完全部内容（token 预算有限）。先读概览 + 路由，后续按需深入。
+4. **补充读取**（若 repo-wiki 不完整）— 直接读旧项目的：
+   - `package.json`（依赖 / scripts）
+   - 路由配置文件（`src/routes/`、`src/router/`、`pages/` 目录等）
+   - 目录结构（`ls src/`）
+5. **识别旧项目技术栈** — 从依赖和代码判断，记录以下维度：
+   - UI 框架（antd / element-ui / arco-design / mui / naive-ui / 自研）
+   - 路由方案（react-router / vue-router / next.js / umi）
+   - 状态管理（redux / mobx / zustand / pinia / vuex）
+   - HTTP 客户端（axios / fetch / umi-request / swr / react-query）
+   - 构建工具（webpack / vite / umi / next / create-react-app）
+#### Phase B · 计划生成
+6. **生成迁移计划文件** — 写入 `.teamix-evo/migrate-plan.md`，格式如下：
+```markdown
+# Migration Plan
+## Progress
+- **Status**: in-progress
+- **Completed**: 0 / <总条目数>
+- **Current phase**: Phase 0 — Global Infrastructure
+- **Last updated**: <ISO 时间戳>
+## Metadata
+- **Source**: <旧项目绝对路径>
+- **Target variant**: <当前项目 variant>
+- **Generated**: <ISO 时间戳>
+- **Old stack**: <框架> + <UI 库> + <路由> + <HTTP 客户端> + <状态管理>
+- **Source URL**: <用户提供的运行地址，可选>
+## Component Mapping (AI via MCP find_components 动态生成)
+| Old | New (teamix-evo) | Notes |
+|-----|-------------------|-------|
+| ... | ...               | ...   |
+## Phase 0: Global Infrastructure
+- [ ] **Routing** — 路由结构搭建
+- [ ] **API client** — HTTP 客户端 + 拦截器
+- [ ] **Auth** — 鉴权流程
+- [ ] **Layout** — 全局壳（导航 / 侧边栏 / 面包屑）
+- [ ] **Global state** — 全局状态管理
+- [ ] **Theme** — 主题对齐（tokens.overrides.css）
+## Phase 1: <页面名> (complexity: <simple|medium|complex>)
+- Route: `<路由路径>`
+- [ ] **<子任务>** — <描述> (<使用组件>)
+- [ ] **API integration** — <接口列表>
+## Phase N: ...
+```
+   **组件映射生成规则**：通过 MCP `find_components` / `list_components` 查询 teamix-evo 注册表，逐个匹配旧项目使用的 UI 组件，动态填写映射表。
+7. **展示计划摘要** — 向用户复述：
+   - 总页面数
+   - 按复杂度分布（简单 / 中等 / 复杂）
+   - 建议执行顺序
+   - 询问用户是否调整顺序、跳过某些页面、或补充遗漏页面
+   > Phase B → Phase C 之间**必须**有用户的明确确认（go-ahead）。
+#### Phase C · 执行
+8. **读取当前进度** — 读 `.teamix-evo/migrate-plan.md` 顶部 Progress 区块。若 Status 为 `done` → 告知用户迁移已全部完成。否则找到第一个未完成（`[ ]`）的条目。
+9. **三轨采集（每页开发前必做）** — 进入一个页面的开发前，必须先收集三轨信息：
+   a. **Wiki 轨**：读旧项目 repo-wiki 中该页面相关的描述（功能说明、业务规则、数据流）
+   b. **源码轨**：读旧项目该页面的全部源文件（页面组件 + 子组件 + 页面内弹窗 Dialog / 抽屉 Drawer / 确认框等）
+   c. **截图轨**：通过浏览器访问旧项目运行地址，对该页面进行截图。截图范围须覆盖：
+      - 页面默认态（列表 / 表单 / 详情等主视图）
+      - 页面内所有弹窗（Dialog / Modal）的打开态
+      - 页面内所有抽屉（Drawer / Sheet）的打开态
+      - 关键交互状态（空态 / 加载态 / 错误态，若能触发）
+   > 三轨齐备后，向用户确认："已采集完 <页面名> 的 wiki、源码、截图，开始实现？"用户确认后才动手。若截图不可用（旧项目未运行），告知用户并以 wiki + 源码两轨继续，标注"无截图参考，视觉还原需用户人工校对"。
+10. **逐条实现** — 对每个 checklist 条目：
+    a. 通过 MCP `find_components` / `get_component_meta` 查询可用组件
+    b. 遵循 `teamix-evo-code-<variant>` skill 规范生成代码（reuse-first / file-structure / api-layering）
+    c. 遵循 `teamix-evo-design-<variant>` skill 规范处理页面布局，参照截图还原视觉
+    d. 完成后更新 `.teamix-evo/migrate-plan.md`：将对应条目标记为 `[x]`，同步更新顶部 Progress（Completed 计数 + Current phase + Last updated）
+    e. 向用户汇报进度，格式：`✅ <条目名> 完成（<已完成数>/<总数>）| 当前阶段：<Phase 名>`
+11. **验证** — 每完成一个页面后：
+    - 列出该页面的功能检查点（从旧代码提取的关键交互：CRUD / 筛选 / 分页 / 权限 / 弹窗流程等）
+    - 若有截图，建议用户对比新旧页面视觉差异
+    - 跑 `pnpm typecheck` 确认零类型错误
+#### Phase D · 全量 Review
+12. **全部页面完成后** — 当 Progress 中 Completed 等于总条目数时：
+    - 将 Status 更新为 `review`
+    - 向用户提示："所有页面已迁移完成，建议进行一轮整体 review。是否现在开始？"
+    - 用户确认后，逐页面列出 review 检查点：
+      - 功能完整性（对照旧项目关键流程）
+      - 视觉还原度（对照截图）
+      - 路由可达性（所有页面是否串通）
+      - 全局一致性（Layout / 导航 / 权限守卫是否统一）
+    - review 全部通过后，将 Status 更新为 `done`
+13. **会话恢复** — 若 AI 进入新会话：
+    - 读 `.teamix-evo/migrate-plan.md` 顶部 Progress 区块快速获取整体进度（Status / Completed / Current phase）
+    - `in-progress` → 定位第一个 `[ ]` 条目，从断点处继续
+    - `review` → 进入 Phase D review 流程
+    - `done` → 告知用户迁移已完成
+### 身份划分清单
+- **AI（本 skill — manage）**：询问路径 → 检测 repo-wiki → 生成/管理 `migrate-plan.md` → 进度追踪 → 会话恢复定位。
+- **AI（`teamix-evo-code-<variant>`）**：生成每页实际代码时遵循 reuse-first / file-structure / api-layering 规范。Phase C 执行时自动应用。
+- **AI（`teamix-evo-design-<variant>`）**：页面级布局 / 视觉设计决策。迁移新页面时并行参考。
+- **用户**：提供旧项目路径 / 确认 repo-wiki 已生成 / 审核迁移计划 / 可选提供运行 URL / 确认每页实现结果。
+- **CLI**：无新命令。执行阶段复用 `teamix-evo ui add <id>`（若发现有未安装的 UI 组件需要补装）。
+### 边缘情况
+| 情况 | 处理 |
+| ---- | ---- |
+| repo-wiki 不存在 | 提示用户先在旧项目执行 repo-wiki 生成命令 |
+| repo-wiki 不完整（缺路由/API 等） | 直接读旧项目源码补充（路由配置 / package.json / 目录结构） |
+| 旧项目是 Vue / Angular（非 React） | 正常分析，概念映射无框架壁垒（路由→路由、组件→组件），新项目统一生成 React |
+| 旧项目是 monorepo | 让用户指定具体 package 路径作为 `<old-path>` |
+| 页面极复杂（>500 行、多子路由） | 拆为多个 checklist 子条目，标记 complexity: complex |
+| `.teamix-evo/migrate-plan.md` 已存在 | 询问用户三选一：(a) 恢复进度继续、(b) 重新生成（覆盖）、(c) 查看当前计划 |
+| 新项目已有部分页面 | 跳过已存在的页面，或标记为 verify-only |
+| token 预算不足以完成全部分析 | 停止读取，基于已有信息生成部分计划，标注"后续会话补充" |
+### 不要
+- **不要**在无 repo-wiki 且源码量大时一次性读完全部文件 — 分批按需读取。
+- **不要**跳过 Phase B 直接写代码 — 必须先生成 `migrate-plan.md` 让用户审核确认。
+- **不要**复制旧项目的组件源码到新项目 — 走 reuse-first 查 `@teamix-evo/ui` 注册表匹配。
+- **不要**搬迁旧项目的样式体系（CSS-in-JS / less / sass / antd theme） — 新项目用 design tokens + Tailwind v4。
+- **不要**原样搬入旧 node_modules 依赖 — 仅迁移业务必需的第三方库（如图表库、富文本编辑器）。
+- **不要**在用户未确认计划前开始实现。
+- **不要**试图单次会话完成全部迁移 — 大项目分多次会话，每次完成若干页面后让用户验证。
+- **不要**破坏 `migrate-plan.md` 的 `- [ ]` / `- [x]` 格式 — 后续会话靠它恢复进度。
+- **不要**修改旧项目的任何文件 — 旧项目只读。
 ## 配置文件(信息性)
 | 路径                          | 所有者 | 说明                                    |
@@ -568,11 +656,11 @@ npx teamix-evo ui promote-to-biz --staging-dir <path>  # 指定 staging 目录
 | 症状                                               | 原因                                                   | 恢复路径                                                                                               |
 | -------------------------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ |
 | `Unknown tokens variant "..."`                     | 拼写错误或上游未发布该 variant                         | `npx teamix-evo tokens list-variants` 列出当前可用                                                     |
-| `Target directory already contains a .teamix-evo/` | 误用 `npm create teamix-evo` 进已装目录                | 改走场景 4(更新)或场景 3(增量装)                                                                       |
+| `Target directory already contains a .teamix-evo/` | 误用 `npm create teamix-evo` 进已装目录                | init 每步幂等短路，直接重跑 `teamix-evo init` 即可                                                     |
 | `UI not initialized`(跑 `ui add` 时)               | 未先跑 `ui init`                                       | `npx teamix-evo ui init -y` 然后再 `ui add`                                                            |
 | Vite/Tailwind 跑起来没样式                         | `src/index.css` 缺少 tokens / Tailwind 导入            | 检查 `src/index.css` 的 `@import` 顺序                                                                 |
 | Skills 在 IDE 不触发                               | `.qoder/skills/` 或 `.claude/skills/` 漂移             | `npx teamix-evo skills doctor` 然后 `skills sync`                                                      |
-| 想完全回退 `init` / `update` 这次执行              | partial / 升级后想撤销到执行前状态                     | `teamix-evo restore --list` 看可用 snapshot,然后 `teamix-evo restore <ts>`(回滚自身可逆 — ADR 0019 §2) |
+| 想完全回退 `init` / `switch` 这次执行              | partial / 升级后想撤销到执行前状态                     | `teamix-evo restore --list` 看可用 snapshot,然后 `teamix-evo restore <ts>`(回滚自身可逆 — ADR 0019 §2) |
 | `init` 卡在多选 IDE / wizard 环节                  | @clack multiselect 交互不熟悉(空格=切换选中,回车=提交) | 命令加 `-y` 跳过全部交互（推荐）；或在 multiselect 界面用 `空格` 切换选项、`回车` 提交                 |
 <!-- teamix-evo:managed:end id="core" -->

package/LICENSE DELETED Viewed

@@ -1,21 +0,0 @@
-MIT License
-Copyright (c) 2026 Teamix Evo Contributors
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.