@teamix-evo/skills 0.3.0 → 0.4.0

package/src/teamix-evo-design-uni-manager/rules/README.md

@@ -0,0 +1,49 @@
+# rules/ — boundaries.md ↔ eslint-config 元数据桥（uni-manager）
+
+本目录是 **结构化元数据**，不是规则实现。它把：
+
+1. `boundaries.md` 中的 41 条人类可读硬约束（F/FF/S/C/I 五组共 38 条 + uni-manager 专属 UM1/UM2/UM3 三条）
+2. `packages/eslint-config/src/rules/` 中的 9 条已实现 lint 规则
+3. AI 在生成代码时可读的 JSON 索引
+
+用一张表对齐起来，防止三者飘移。
+
+## boundaries.rules.json
+
+每条规则包含：
+
+| 字段             | 说明                                                                             |
+| ---------------- | -------------------------------------------------------------------------------- |
+| `id`             | 在 boundaries.md 中的编号（F1-F10 / FF1-FF4 / S1-S8 / C1-C12 / I1-I4 / UM1-UM3） |
+| `group`          | `forbidden` / `form` / `style` / `component` / `icon` / `uni-manager`            |
+| `rule`           | 一句话规则陈述（与 boundaries.md 章节标题保持一致）                              |
+| `severity`       | `ERROR` 必须修复 / `WARN` 建议修复                                               |
+| `scope`          | `global` 或具体组件名（如 `Dialog`、`Button`、`um-topbar`）                      |
+| `lintRule`       | 对应的 eslint 规则名（`teamix-evo/<name>`）；`null` 表示无 lint 覆盖，靠人工评审 |
+| `boundaryAnchor` | 指向 boundaries.md 章节锚点；validate-skills 会校验存在性                        |
+| `status`         | `active` / `deprecated`                                                          |
+
+## 双向校验（由 `pnpm validate` 触发）
+
+`scripts/validate-skills.ts` 在校验 manifest 之后会额外检查：
+
+1. **JSON schema 合法** — 每条 rule 满足上表必填字段
+2. **boundaryAnchor 存在性** — 每条 rule 的 `boundaryAnchor` 必须能在 `boundaries.md` 中 grep 到对应的章节
+3. **eslint 双向对齐** — `packages/eslint-config/src/rules/` 中每条已实现的 rule 必须在本 JSON 中有 `lintRule: "teamix-evo/<name>"` 的条目；反过来，JSON 中每条 `lintRule != null` 的条目必须能在 eslint-config 中找到对应文件
+
+## 新增 boundary 规则的工序
+
+1. 在 `boundaries.md` 中加章节（`[ERROR]` / `[WARN]` 前缀 + 编号）
+2. 在 `boundaries.rules.json` 加对应条目
+3. 如需 lint 自动化：在 `packages/eslint-config/src/rules/` 加 ts 实现；`lintRule` 填规则名
+4. 跑 `pnpm --filter @teamix-evo/skills validate` 通过
+
+## uni-manager 专属约束（UM 组）
+
+UM1 / UM2 / UM3 是 uni-manager **独有的硬约束**，对应"一致性三件套"：
+
+- **UM1** — 全局 topbar 必须使用 `um-topbar` 实物，禁止自建
+- **UM2** — PageHeader 必须保持一致性结构（标题 24px / 面包屑紧贴 / 操作右对齐）
+- **UM3** — 跨云资源列表与详情必须标注 CloudBadge
+
+它们通过 `scope: "uni-manager"` 与基础 38 条解耦，复制到 OpenTrek 时自动失效。

package/src/teamix-evo-design-uni-manager/rules/boundaries.rules.json

@@ -0,0 +1,418 @@
+{
+  "$schema": "./rules.schema.json",
+  "version": "1.0.0",
+  "source": "boundaries.md",
+  "variant": "uni-manager",
+  "rules": [
+    {
+      "id": "F1",
+      "group": "forbidden",
+      "rule": "禁止硬编码色值",
+      "severity": "ERROR",
+      "scope": "global",
+      "lintRule": "teamix-evo/no-color-literal",
+      "boundaryAnchor": "boundaries.md#error-f1--禁止硬编码色值",
+      "status": "active"
+    },
+    {
+      "id": "F2",
+      "group": "forbidden",
+      "rule": "禁止硬编码尺寸",
+      "severity": "ERROR",
+      "scope": "global",
+      "lintRule": "teamix-evo/no-arbitrary-tw-value",
+      "boundaryAnchor": "boundaries.md#error-f2--禁止硬编码尺寸",
+      "status": "active"
+    },
+    {
+      "id": "F3",
+      "group": "forbidden",
+      "rule": "禁止按组件新增重复语义变量",
+      "severity": "ERROR",
+      "scope": "global",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#error-f3--禁止按组件新增重复语义变量",
+      "status": "active"
+    },
+    {
+      "id": "F4",
+      "group": "forbidden",
+      "rule": "禁止页头添加底色或下边框",
+      "severity": "ERROR",
+      "scope": "PageHeader",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#error-f4--禁止页头添加底色或下边框--scope-pageheader",
+      "status": "active"
+    },
+    {
+      "id": "F5",
+      "group": "forbidden",
+      "rule": "outline 按钮禁止使用 border-input",
+      "severity": "ERROR",
+      "scope": "Button",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#error-f5--outline-按钮禁止使用-border-input--scope-button",
+      "status": "active"
+    },
+    {
+      "id": "F6",
+      "group": "forbidden",
+      "rule": "禁止直接写 font-size: 12px",
+      "severity": "ERROR",
+      "scope": "global",
+      "lintRule": "teamix-evo/no-arbitrary-tw-value",
+      "boundaryAnchor": "boundaries.md#error-f6--禁止直接写-font-size-12px",
+      "status": "active"
+    },
+    {
+      "id": "F7",
+      "group": "forbidden",
+      "rule": "语义间距必须走 CSS 变量",
+      "severity": "ERROR",
+      "scope": "global",
+      "lintRule": "teamix-evo/no-arbitrary-tw-value",
+      "boundaryAnchor": "boundaries.md#error-f7--语义间距必须走-css-变量",
+      "status": "active"
+    },
+    {
+      "id": "F8",
+      "group": "forbidden",
+      "rule": "禁止在 DialogTitle 中加图标",
+      "severity": "ERROR",
+      "scope": "Dialog",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#error-f8--禁止在-dialogtitle-中加图标--scope-dialog",
+      "status": "active"
+    },
+    {
+      "id": "F9",
+      "group": "forbidden",
+      "rule": "弹窗确定按钮禁止加 disabled 禁用态",
+      "severity": "ERROR",
+      "scope": "Dialog",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#error-f9--弹窗确定按钮禁止加-disabled-禁用态--scope-dialog",
+      "status": "active"
+    },
+    {
+      "id": "F10",
+      "group": "forbidden",
+      "rule": "hover 时禁止将 boxShadow 设为 undefined",
+      "severity": "WARN",
+      "scope": "HoverCard",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#warn-f10--hover-时禁止将-boxshadow-设为-undefined--scope-hovercard",
+      "status": "active"
+    },
+    {
+      "id": "FF1",
+      "group": "form",
+      "rule": "禁止用色块表达表单状态",
+      "severity": "ERROR",
+      "scope": "Form",
+      "lintRule": "teamix-evo/no-raw-color-scale",
+      "boundaryAnchor": "boundaries.md#error-ff1--禁止用色块表达表单状态--scope-form",
+      "status": "active"
+    },
+    {
+      "id": "FF2",
+      "group": "form",
+      "rule": "Card 不嵌套 Card",
+      "severity": "WARN",
+      "scope": "Form",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#warn-ff2--card-不嵌套-card--scope-form",
+      "status": "active"
+    },
+    {
+      "id": "FF3",
+      "group": "form",
+      "rule": "错误信息禁止暴露技术栈痕迹",
+      "severity": "ERROR",
+      "scope": "Form",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#error-ff3--错误信息禁止暴露技术栈痕迹--scope-form",
+      "status": "active"
+    },
+    {
+      "id": "FF4",
+      "group": "form",
+      "rule": "必填用红色 * 星号,放标签后空格",
+      "severity": "WARN",
+      "scope": "Form",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#warn-ff4--必填用红色--星号放标签后空格--scope-form",
+      "status": "active"
+    },
+    {
+      "id": "S1",
+      "group": "style",
+      "rule": "className 仅用于布局,不用于覆盖组件颜色/字体",
+      "severity": "ERROR",
+      "scope": "global",
+      "lintRule": "teamix-evo/no-color-literal",
+      "boundaryAnchor": "boundaries.md#error-s1--classname-仅用于布局不用于覆盖组件颜色--字体",
+      "status": "active"
+    },
+    {
+      "id": "S2",
+      "group": "style",
+      "rule": "不用 space-x-* / space-y-*,改用 flex + gap-*",
+      "severity": "ERROR",
+      "scope": "global",
+      "lintRule": "teamix-evo/prefer-gap-over-space",
+      "boundaryAnchor": "boundaries.md#error-s2--不用-space-x---space-y--改用-flex--gap-",
+      "status": "active"
+    },
+    {
+      "id": "S3",
+      "group": "style",
+      "rule": "等宽高用 size-*,不用 w-* h-*",
+      "severity": "WARN",
+      "scope": "global",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#warn-s3--等宽高用-size-不用-w--h-",
+      "status": "active"
+    },
+    {
+      "id": "S4",
+      "group": "style",
+      "rule": "用 truncate 简写文本截断",
+      "severity": "WARN",
+      "scope": "global",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#warn-s4--用-truncate-简写文本截断",
+      "status": "active"
+    },
+    {
+      "id": "S5",
+      "group": "style",
+      "rule": "不用手动 dark: 颜色覆盖,用语义 token",
+      "severity": "ERROR",
+      "scope": "global",
+      "lintRule": "teamix-evo/no-manual-dark-classnames",
+      "boundaryAnchor": "boundaries.md#error-s5--不用手动-dark-颜色覆盖用语义-token",
+      "status": "active"
+    },
+    {
+      "id": "S6",
+      "group": "style",
+      "rule": "用 cn() 处理条件类名,不用模板字符串三元",
+      "severity": "ERROR",
+      "scope": "global",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#error-s6--用-cn-处理条件类名不用模板字符串三元",
+      "status": "active"
+    },
+    {
+      "id": "S7",
+      "group": "style",
+      "rule": "overlay 组件不手动设置 z-index",
+      "severity": "ERROR",
+      "scope": "global",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#error-s7--overlay-组件不手动设置-z-index",
+      "status": "active"
+    },
+    {
+      "id": "S8",
+      "group": "style",
+      "rule": "不用原始色值表示状态",
+      "severity": "ERROR",
+      "scope": "global",
+      "lintRule": "teamix-evo/no-raw-color-scale",
+      "boundaryAnchor": "boundaries.md#error-s8--不用原始色值表示状态",
+      "status": "active"
+    },
+    {
+      "id": "C1",
+      "group": "component",
+      "rule": "Item 必须在 Group 内",
+      "severity": "ERROR",
+      "scope": "Select|DropdownMenu|Command|Menubar|ContextMenu",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#error-c1--item-必须在-group-内",
+      "status": "active"
+    },
+    {
+      "id": "C2",
+      "group": "component",
+      "rule": "Dialog / Sheet / Drawer 必须有 Title",
+      "severity": "ERROR",
+      "scope": "Dialog|Sheet|Drawer",
+      "lintRule": "teamix-evo/dialog-must-have-title",
+      "boundaryAnchor": "boundaries.md#error-c2--dialog--sheet--drawer-必须有-title",
+      "status": "active"
+    },
+    {
+      "id": "C3",
+      "group": "component",
+      "rule": "Card 用完整结构",
+      "severity": "WARN",
+      "scope": "Card",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#warn-c3--card-用完整结构",
+      "status": "active"
+    },
+    {
+      "id": "C4",
+      "group": "component",
+      "rule": "Button 用 Spinner + disabled 组合表达 loading",
+      "severity": "ERROR",
+      "scope": "Button",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#error-c4--button-用-spinner--disabled-组合表达-loading",
+      "status": "active"
+    },
+    {
+      "id": "C5",
+      "group": "component",
+      "rule": "TabsTrigger 必须在 TabsList 内",
+      "severity": "ERROR",
+      "scope": "Tabs",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#error-c5--tabstrigger-必须在-tabslist-内",
+      "status": "active"
+    },
+    {
+      "id": "C6",
+      "group": "component",
+      "rule": "Avatar 必须有 AvatarFallback",
+      "severity": "WARN",
+      "scope": "Avatar",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#warn-c6--avatar-必须有-avatarfallback",
+      "status": "active"
+    },
+    {
+      "id": "C7",
+      "group": "component",
+      "rule": "提示用 Alert,不用自定义 div",
+      "severity": "WARN",
+      "scope": "global",
+      "lintRule": "teamix-evo/no-raw-color-scale",
+      "boundaryAnchor": "boundaries.md#warn-c7--提示用-alert不用自定义-div",
+      "status": "active"
+    },
+    {
+      "id": "C8",
+      "group": "component",
+      "rule": "空状态用 Empty 组件",
+      "severity": "WARN",
+      "scope": "global",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#warn-c8--空状态用-empty-组件",
+      "status": "active"
+    },
+    {
+      "id": "C9",
+      "group": "component",
+      "rule": "Toast 用 sonner",
+      "severity": "WARN",
+      "scope": "global",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#warn-c9--toast-用-sonner",
+      "status": "active"
+    },
+    {
+      "id": "C10",
+      "group": "component",
+      "rule": "分隔线用 Separator",
+      "severity": "WARN",
+      "scope": "global",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#warn-c10--分隔线用-separator",
+      "status": "active"
+    },
+    {
+      "id": "C11",
+      "group": "component",
+      "rule": "加载占位用 Skeleton",
+      "severity": "WARN",
+      "scope": "global",
+      "lintRule": "teamix-evo/no-raw-color-scale",
+      "boundaryAnchor": "boundaries.md#warn-c11--加载占位用-skeleton",
+      "status": "active"
+    },
+    {
+      "id": "C12",
+      "group": "component",
+      "rule": "标签/状态用 Badge",
+      "severity": "WARN",
+      "scope": "global",
+      "lintRule": "teamix-evo/no-raw-color-scale",
+      "boundaryAnchor": "boundaries.md#warn-c12--标签--状态用-badge",
+      "status": "active"
+    },
+    {
+      "id": "I1",
+      "group": "icon",
+      "rule": "按钮内图标用 data-icon 属性定位",
+      "severity": "ERROR",
+      "scope": "Button",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#error-i1--按钮内图标用-data-icon-属性定位",
+      "status": "active"
+    },
+    {
+      "id": "I2",
+      "group": "icon",
+      "rule": "组件内图标不设尺寸类",
+      "severity": "ERROR",
+      "scope": "Button|DropdownMenuItem|Alert|Sidebar",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#error-i2--组件内图标不设尺寸类",
+      "status": "active"
+    },
+    {
+      "id": "I3",
+      "group": "icon",
+      "rule": "图标作为组件对象传递",
+      "severity": "ERROR",
+      "scope": "global",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#error-i3--图标作为组件对象传递",
+      "status": "active"
+    },
+    {
+      "id": "I4",
+      "group": "icon",
+      "rule": "按项目配置的 iconLibrary 导入",
+      "severity": "ERROR",
+      "scope": "global",
+      "lintRule": "teamix-evo/icon-from-lucide",
+      "boundaryAnchor": "boundaries.md#error-i4--按项目配置的-iconlibrary-导入",
+      "status": "active"
+    },
+    {
+      "id": "UM1",
+      "group": "component",
+      "rule": "全局 topbar 必须使用 um-topbar 实物",
+      "severity": "ERROR",
+      "scope": "uni-manager",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#error-um1--全局-topbar-必须使用-um-topbar-实物--scope-uni-manager",
+      "status": "active"
+    },
+    {
+      "id": "UM2",
+      "group": "component",
+      "rule": "PageHeader 必须保持一致性结构",
+      "severity": "ERROR",
+      "scope": "uni-manager",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#error-um2--pageheader-必须保持一致性结构--scope-uni-manager",
+      "status": "active"
+    },
+    {
+      "id": "UM3",
+      "group": "component",
+      "rule": "跨云资源列表与详情必须标注 CloudBadge",
+      "severity": "ERROR",
+      "scope": "uni-manager",
+      "lintRule": null,
+      "boundaryAnchor": "boundaries.md#error-um3--跨云资源列表与详情必须标注-cloudbadge--scope-uni-manager",
+      "status": "active"
+    }
+  ]
+}