@teamix-evo/skills 0.11.1 → 0.12.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.
package/package.json
CHANGED
|
@@ -34,13 +34,13 @@ description: |
|
|
|
34
34
|
|
|
35
35
|
## 2. 页面类型索引
|
|
36
36
|
|
|
37
|
-
| 类型ID
|
|
38
|
-
|
|
39
|
-
| ListPage
|
|
40
|
-
| DetailPage
|
|
41
|
-
| FormPage
|
|
42
|
-
| Dashboard
|
|
43
|
-
| WizardPage / ResultPage / ExceptionPage / WorkspacePage / KanbanPage / WelcomePage / OverviewPage | —
|
|
37
|
+
| 类型 ID | 中文名 | 核心特征 | 子技能目录 | 状态 |
|
|
38
|
+
| ------------------------------------------------------------------------------------------------- | ------ | -------------------------------------- | ------------------------- | ------ |
|
|
39
|
+
| ListPage | 列表页 | 多条结构化数据 + 搜索/筛选 + 分页 | `./pages/list-page/` | 已就绪 |
|
|
40
|
+
| DetailPage | 详情页 | 单条记录只读展示 + 描述列表 + 操作按钮 | `./pages/detail-page/` | 已就绪 |
|
|
41
|
+
| FormPage | 表单页 | 用户输入数据 + 字段校验 + 提交 | `./pages/form-page/` | 已就绪 |
|
|
42
|
+
| Dashboard | 仪表板 | 数据可视化 / 统计聚合 | `./pages/dashboard-page/` | 已就绪 |
|
|
43
|
+
| WizardPage / ResultPage / ExceptionPage / WorkspacePage / KanbanPage / WelcomePage / OverviewPage | — | 见 patterns/page-types.md | — | 待开发 |
|
|
44
44
|
|
|
45
45
|
> 决策树、Zone Map、易混点速查、子类型识别详见 [patterns/page-types.md](./patterns/page-types.md)。
|
|
46
46
|
|
|
@@ -50,22 +50,22 @@ description: |
|
|
|
50
50
|
|
|
51
51
|
> 📖 **读取顺序**：生成/翻新页面时，**主入口 = `./pages/{type}-page/`**（完整规范与布局硬约束）；`./patterns/{type}-page.md` 仅作为**索引概览**用于快速判断子类型。
|
|
52
52
|
|
|
53
|
-
| 子技能ID
|
|
54
|
-
|
|
55
|
-
| list-page
|
|
56
|
-
| detail-page
|
|
57
|
-
| form-page
|
|
58
|
-
| dashboard-page | 仪表板技能 | 3
|
|
53
|
+
| 子技能 ID | 名称 | 子类型数 | 入口文件 |
|
|
54
|
+
| -------------- | ---------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
55
|
+
| list-page | 列表页技能 | 6 | **生成入口**：[`./pages/list-page/`](./pages/list-page/) ← 完整规范 ｜ 索引概览：[`./patterns/list-page.md`](./patterns/list-page.md) |
|
|
56
|
+
| detail-page | 详情页技能 | 2 | **生成入口**：[`./pages/detail-page/`](./pages/detail-page/) ← 完整规范 ｜ 索引概览：[`./patterns/detail-page.md`](./patterns/detail-page.md) |
|
|
57
|
+
| form-page | 表单页技能 | 3 | **生成入口**：[`./pages/form-page/`](./pages/form-page/) ← 完整规范 ｜ 索引概览：[`./patterns/form-page.md`](./patterns/form-page.md) |
|
|
58
|
+
| dashboard-page | 仪表板技能 | 3 | **生成入口**：[`./pages/dashboard-page/`](./pages/dashboard-page/) ← 完整规范 ｜ 索引概览：[`./patterns/dashboard.md`](./patterns/dashboard.md) |
|
|
59
59
|
|
|
60
60
|
### 关键词 → 子技能路由
|
|
61
61
|
|
|
62
|
-
| 关键词
|
|
63
|
-
|
|
64
|
-
| "列表"/"表格"/"查询"/"检索"/"数据列表"
|
|
65
|
-
| "详情"/"查看"/"信息"/"配置详情"
|
|
66
|
-
| "表单"/"创建"/"编辑"/"填写"/"新建"
|
|
62
|
+
| 关键词 | 路由到 |
|
|
63
|
+
| -------------------------------------------------- | -------------------------------------------------------------------- |
|
|
64
|
+
| "列表"/"表格"/"查询"/"检索"/"数据列表" | → `./pages/list-page/` |
|
|
65
|
+
| "详情"/"查看"/"信息"/"配置详情" | → `./pages/detail-page/` |
|
|
66
|
+
| "表单"/"创建"/"编辑"/"填写"/"新建" | → `./pages/form-page/` |
|
|
67
67
|
| "仪表板"/"统计"/"分析"/"指标"/"监控"/"概览"/"观测" | → [`./pages/dashboard-page/`](./pages/dashboard-page/)（完整子技能） |
|
|
68
|
-
| 其他通用问题
|
|
68
|
+
| 其他通用问题 | 根技能 + `./rules/` 索引 |
|
|
69
69
|
|
|
70
70
|
### 高频业务场景速查
|
|
71
71
|
|
|
@@ -221,6 +221,13 @@ description: |
|
|
|
221
221
|
4. **语义清晰**：使用 @teamix-evo/ui 的 variant 体系
|
|
222
222
|
5. **可追溯**：HTML 注释中标注拼装来源和决策原因
|
|
223
223
|
|
|
224
|
+
### 6.6 组件尺寸策略
|
|
225
|
+
|
|
226
|
+
- **默认规则**：无特殊说明时，所有组件一律使用 `default` 尺寸（不主动传 `size='sm'`）
|
|
227
|
+
- **允许 sm 的场景**：仅当 `component-specs.json` 或子技能 patterns 文档中**显式指定**了 `size='sm'` 时才使用（如 Pagination 的 SelectTrigger、Dashboard 工具栏按钮、卡片内 Tag）
|
|
228
|
+
- **判定优先级**：组件文档（component-specs.json） > 页面子技能（patterns） > 默认（default）
|
|
229
|
+
- **典型误用**：AI 不得因“看起来小一点”而自行决定用 `sm`；截图中的视觉尺寸通过 Token 与组件默认值对齐，不走 size prop 降级
|
|
230
|
+
|
|
224
231
|
---
|
|
225
232
|
|
|
226
233
|
## 7. 与 code-opentrek skill 协作
|
|
@@ -61,4 +61,11 @@ description: |
|
|
|
61
61
|
| [rules/README.md](./rules/README.md) | boundaries.md ↔ eslint-config 元数据桥说明 |
|
|
62
62
|
| [rules/boundaries.rules.json](./rules/boundaries.rules.json) | 41+ 条规则的结构化索引 |
|
|
63
63
|
|
|
64
|
+
## 组件尺寸策略
|
|
65
|
+
|
|
66
|
+
- **默认规则**：无特殊说明时，所有组件一律使用 `default` 尺寸（不主动传 `size='sm'`）
|
|
67
|
+
- **允许 sm 的场景**：仅当 `boundaries.md` 或子技能 patterns 文档中**显式指定**了 `size='sm'` 时才使用
|
|
68
|
+
- **判定优先级**：boundaries.md 规则 > 页面子技能（patterns） > 默认（default）
|
|
69
|
+
- **典型误用**：AI 不得因“看起来小一点”而自行决定用 `sm`；截图中的视觉尺寸通过 Token 与组件默认值对齐，不走 size prop 降级
|
|
70
|
+
|
|
64
71
|
<!-- teamix-evo:managed:end -->
|
|
@@ -573,7 +573,13 @@ npx teamix-evo ui promote-to-biz --staging-dir <path> # 指定 staging 目录
|
|
|
573
573
|
## ❗ 执行规则（每次读取本文件时必须重新确认）
|
|
574
574
|
|
|
575
575
|
1. **Token 映射查表** — 每迁移一个页面前，必须先读取 `.teamix-evo/migrate-token-mapping.md`，所有旧项目 CSS 变量按实际像素值映射为新项目 Tailwind class。禁止根据变量名称“猜测”对应关系。
|
|
576
|
-
2.
|
|
576
|
+
2. **组件与代码规范**（摘自 design-{variant} + code-{variant} skill，完整规则见关键文件索引）
|
|
577
|
+
- **组件选用优先级（不得跳级）**：`./rules/` 已定义组件 → `@teamix-evo/ui` 原子组件拼装 → 自定义实现（需 `<!-- CUSTOM: 原因 -->` 标注）
|
|
578
|
+
- **组件尺寸**：无特殊说明时一律使用 default 尺寸，不主动用 sm
|
|
579
|
+
- **核心 UI 组件速查**：Card / Table / Badge / Separator / Tabs / ToggleGroup / Button / Tag / Dialog / Sheet / Select / Input / Empty / Spinner / Tooltip
|
|
580
|
+
- **Token 引用**：所有视觉属性必须引用 Token，禁止硬编码色值 / 间距 / 字号
|
|
581
|
+
- **代码分层**：pages（页面组件）→ hooks（数据逻辑）→ services（API 封装）→ types（类型定义）
|
|
582
|
+
- **reuse-first**：优先复用 `@teamix-evo/ui` 已有组件，禁止重复造轮子
|
|
577
583
|
3. **三轨齐备** — 进入任何页面实现前必须源码 + repo-wiki + 截图全部确认就绪（截图由用户预先准备，AI 只做确认）。
|
|
578
584
|
4. **Token 合法性自检** — 写完代码后扫描所有 Tailwind class，确认在新项目有效。
|
|
579
585
|
5. **新架构骨架层检查** — 迁移不仅是“翻译旧代码”，还必须“适配新架构的标准模式”。新架构有一套完整的页面骨架层级（`PageShell → OpPageContainer → PageHeader → 内容`），这些组件在旧项目中完全不存在（旧项目用自定义 `<h1>`、内联样式或散落 CSS 实现），三轨对照不会发现它们。必须主动查阅 design skill 和 biz-ui 组件的 JSDoc 获取标准骨架用法：
|
|
@@ -586,10 +592,11 @@ npx teamix-evo ui promote-to-biz --staging-dir <path> # 指定 staging 目录
|
|
|
586
592
|
|
|
587
593
|
1. 读取本文件 `.teamix-evo/migrate-plan.md` — 获取进度、元数据、执行规则
|
|
588
594
|
2. 读取 `.teamix-evo/migrate-token-mapping.md` — 加载 token 映射表
|
|
589
|
-
3.
|
|
590
|
-
- **
|
|
591
|
-
- **Code skill**
|
|
592
|
-
- **
|
|
595
|
+
3. **读取 skill 并提取页面级约束**（路径见下方「关键文件索引」）：
|
|
596
|
+
- 读取 **Design skill** → 重点关注 §6.1 组件选用优先级、§5 通用组件分层、§6.5 降级拼装规则
|
|
597
|
+
- 读取 **Code skill** → 重点关注 reuse-first.md、file-structure.md、api-layering.md
|
|
598
|
+
- 读取 **Manage skill** §场景 6 → 获取迁移执行协议的逐条步骤
|
|
599
|
+
- **提取原则**：每个待迁移页面的每个 UI 元素，先在 `@teamix-evo/ui` 组件库（`src/components/ui/`）中查找对应组件，找到则直接使用；找不到才允许自定义实现
|
|
593
600
|
4. 查看 Progress 区块 — 找到 **Current phase** 所指的 Phase，在该 Phase 中定位第一个未完成的 `[ ]` 条目（不要回头处理更早 Phase 中被 pilot 模式有意推迟的条目）
|
|
594
601
|
5. 确认三轨材料 — 对当前页面确认源码 + repo-wiki + 截图三轨就绪（截图目录见 Metadata → Screenshots dir）
|
|
595
602
|
6. 开始实现 — 从第一个未完成条目继续
|
|
@@ -692,7 +699,7 @@ npx teamix-evo ui promote-to-biz --staging-dir <path> # 指定 staging 目录
|
|
|
692
699
|
|
|
693
700
|
## Phase 1: <页面名> (complexity: <simple|medium|complex>)
|
|
694
701
|
|
|
695
|
-
> ⚠️ 执行前检查：① 已读取 `migrate-token-mapping.md` ②
|
|
702
|
+
> ⚠️ 执行前检查：① 已读取 `migrate-token-mapping.md` ② 已确认§2 组件与代码规范（组件优先级 / 尺寸 / reuse-first） ③ 三轨已采集
|
|
696
703
|
|
|
697
704
|
- Route: `<路由路径>`
|
|
698
705
|
- [ ] **<子任务>** — <描述> (<使用组件>)
|
|
@@ -759,7 +766,7 @@ npx teamix-evo ui promote-to-biz --staging-dir <path> # 指定 staging 目录
|
|
|
759
766
|
|
|
760
767
|
11. **逐条实现** — 对每个 checklist 条目：
|
|
761
768
|
a. 通过 MCP `find_components` / `get_component_meta` 查询可用组件
|
|
762
|
-
b.
|
|
769
|
+
b. **读取 code/design skill 并确认关键约束** — 必须先读取 `teamix-evo-code-{variant}` 和 `teamix-evo-design-{variant}` 的 SKILL.md，提取组件选用优先级（§6.1）、尺寸规范、reuse-first 等关键规则。**禁止未读取就开始写代码**。若当前会话已读取过且上下文未丢失，可跳过重复读取
|
|
763
770
|
c. 遵循 `teamix-evo-code-{variant}` skill 规范生成代码（reuse-first / file-structure / api-layering）
|
|
764
771
|
d. 遵循 `teamix-evo-design-{variant}` skill 规范处理页面布局，参照截图还原视觉
|
|
765
772
|
e. **Token 映射查表** — 写代码时遇到旧项目的 CSS 变量 / class，必须查询 `.teamix-evo/migrate-token-mapping.md` 确定正确的 Tailwind class，禁止凭名称直觉映射
|