[v1] improve(skills): oceanbase-design-usage skills (#1441)

* chore(skills): update design-skills doc, remove CHANGELOG and EVALUATION from skill

* improve(skills): oceanbase-design-usage skills

Author: dengfuping

docs/design/design-skills.md

@@ -4,45 +4,49 @@ order: 7
 group: 基础组件
 ---
 
-本仓库提供 **oceanbase-design-usage** Skill，用于在开发、Code Review、迁移时统一 OceanBase Design（OBUI）各包的使用方式，减少样式与代码差异。
+本仓库提供 **oceanbase-design-usage** Skill，用于在开发、Code Review、迁移时统一 **OceanBase Design** 各包（design、ui、icons、charts、util）的使用方式，减少样式与代码差异。适用于本仓库及引用上述包的业务项目；迁移场景覆盖 `@oceanbase/codemod` 与人工核对。
 
-## 在本仓库中使用
+## 在外部项目中使用
 
-本仓库根目录的 `AGENTS.md` 已注册 `oceanbase-design-usage`。在 Cursor、Claude Code 等支持 OpenSkills 的环境中：
+若业务项目使用 `@oceanbase/design` / `@oceanbase/ui`，希望 AI 按同一套规范辅助开发，可从 **GitHub** 直接安装本 Skill，无需先 clone 整个仓库。skills 不会作为 npm 包发布，也不会随 `@oceanbase/design` 一起发布。
 
-- Agent 会根据任务自动匹配并加载该 Skill。
-- 涉及「OceanBase Design」「OBUI」「Table」「Filter」「ConfigProvider」「迁移」「obToken」等关键词时，会优先参考 Skill 中的规范与 reference。
+### 安装
 
-无需额外配置，克隆仓库后即可在对话中依赖该 Skill 生成或审查与 design/ui/icons 相关的代码。
-
-## 在其它项目中使用
-
-若业务项目使用 `@oceanbase/design` / `@oceanbase/ui`，希望 AI 按同一套规范辅助开发，可安装本 Skill：
+在业务项目根目录执行（OpenSkills 会拉取仓库并只安装 skill 子目录）：
 
 ```bash
-# 从本仓库本地安装（开发/调试）
-npx openskills install ./path/to/oceanbase-design/skills/oceanbase-design-usage
-
-# 若已发布为 npm 包，可从包内安装
-npx openskills install ./node_modules/@oceanbase/design-skills/oceanbase-design-usage
+npx openskills install oceanbase/oceanbase-design/skills/oceanbase-design-usage
 ```
 
-安装后，在对应项目里使用 `npx openskills read oceanbase-design-usage` 可加载规范内容；支持 OpenSkills 的 AI 会在相关任务中自动引用。
-
-## Skill 内容结构
+安装后可执行 `npx openskills update oceanbase-design-usage` 更新为仓库最新版本。
 
-| 入口 | 说明 |
-|------|------|
-| **SKILL.md** | 包关系、包选择速查、最高优先级规则、快速规范、各包说明与链接 |
-| **references/design/** | 00 概述、01 主题与 Token、02～09 组件约束与示例 |
-| **references/ASSEMBLY.md** | 各模块关键约束一句话汇总 |
-| **rules/** | 原子化规则（ConfigProvider、图标来源、Card+Table、Filter 受控等），可做 CI/门禁 |
+### 安装后使用
 
-## 命名说明：oceanbase-design-usage vs oceanbase-design-using
+- 在项目中执行 `npx openskills read oceanbase-design-usage` 可加载规范内容。
+- 在 Cursor、Claude Code 等支持 OpenSkills 的环境中，Agent 会在涉及「OceanBase Design」「OBUI」「Table」「Filter」「ConfigProvider」「迁移」「obToken」等任务时自动引用该 Skill。
 
-| 名称 | 含义 | 适用场景 |
-|------|------|----------|
-| **oceanbase-design-usage**（当前） | **usage** = 使用方式、用法规范。名词，强调「如何使用」的指南与约定。 | 规范类、手册类 Skill，侧重「用法/规范」时更贴切。 |
-| **oceanbase-design-using** | **using** = 正在使用。偏进行时/动名词，常见于 "Using XXX" 文档标题。 | 若希望强调「使用 OceanBase Design 的实践指南」，也可用；与 "Using Ant Design" 等标题风格一致。 |
+## Skill 内容结构
 
-**选用建议**：当前 Skill 定位为**使用规范与约束**（如何正确用 design/ui/icons、ConfigProvider、obToken 等），**usage** 更贴近「用法/规范」的语义，因此保留 **oceanbase-design-usage**。若后续增加偏「上手指南」「实战教程」的 Skill，可考虑 **oceanbase-design-using** 或类似命名作为补充。
+```
+oceanbase-design-usage/
+├── SKILL.md                              # 入口与总览
+└── references/
+    ├── ASSEMBLY.md                       # 00～09 约束汇总
+    ├── design/                           # 基础组件
+    │   ├── README.md                     # 模块导航
+    │   ├── 00-overview.md                # 概述、ConfigProvider、约定（根节点必包）
+    │   ├── 01-theme-and-token.md         # 主题与 Token
+    │   ├── 02-basic.md                   # 基础组件
+    │   ├── 03-layout-card.md             # 布局与卡片
+    │   ├── 04-form.md                    # 表单
+    │   ├── 05-data-display.md            # 数据展示
+    │   ├── 06-feedback.md                # 反馈
+    │   ├── 07-navigation.md              # 导航
+    │   ├── 08-filter.md                  # 筛选（含受控约定）
+    │   └── 09-combo.md                   # 组合用法（含 Card+Table innerBordered）
+    ├── ui.md                             # 业务组件
+    ├── icons.md                          # 图标
+    ├── util.md                           # 工具
+    ├── charts.md                         # 图表
+    └── codemod.md                        # codemod 迁移
+```

skills/oceanbase-design-usage/CHANGELOG.md

@@ -7,7 +7,7 @@ description: Guide for using OceanBase Design (OBUI) packages—design, ui, icon
 
 ## 概述
 
-**OceanBase Design 即 OBUI**，包含 design、ui、icons、charts、util 等多个库。本 Skill 指导正确使用 `@oceanbase/design`、`@oceanbase/ui`、`@oceanbase/icons`、`@oceanbase/util`、`@oceanbase/charts`（适用于 oceanbase-design 仓库及引用上述包的业务项目）；并说明使用 `@oceanbase/codemod` 进行自动化迁移与升级。遵循推荐用法可减少差异、提升样式一致性和代码规范性。
+**OceanBase Design**，包含 design、ui、icons、charts、util 等多个库。本 Skill 指导正确使用 `@oceanbase/design`、`@oceanbase/ui`、`@oceanbase/icons`、`@oceanbase/util`、`@oceanbase/charts`（适用于 oceanbase-design 仓库及引用上述包的业务项目）；并说明使用 `@oceanbase/codemod` 进行自动化迁移与升级。遵循推荐用法可减少差异、提升样式一致性和代码规范性。
 
 ## 包关系与依赖
 
@@ -54,13 +54,13 @@ description: Guide for using OceanBase Design (OBUI) packages—design, ui, icon
 - **@oceanbase/charts**：见 [references/charts.md](references/charts.md)。
 - **@oceanbase/codemod**：自动化迁移工具，见 [references/codemod.md](references/codemod.md)。用于从 antd、obui、techui、pro-components 等迁移到 design/ui/util/charts，以及 Less/Sass 转 token 或 CSS 变量。执行时须指定版本 `@oceanbase/codemod@^1.0.0-alpha.0`。
 
-在修改或新增组件、做 Code Review、统一样式与导入方式时，按需查阅上述 reference 以保持与 design 及各包使用规范一致。存量项目迁移时先运行 codemod，再按 design 与各包规范做人工核对。本 skill 的 reference 位于 `references/`；design 细则入口为 [references/design/README.md](references/design/README.md)；**关键约束一句话汇编**见 [references/ASSEMBLY.md](references/ASSEMBLY.md)；**原子化规则**（可做 CI/门禁）见 [rules/README.md](rules/README.md)；变更见 [CHANGELOG.md](CHANGELOG.md)。
+在修改或新增组件、做 Code Review、统一样式与导入方式时，按需查阅上述 reference 以保持与 design 及各包使用规范一致。存量项目迁移时先运行 codemod，再按 design 与各包规范做人工核对。本 skill 的 reference 位于 `references/`；design 细则入口为 [references/design/README.md](references/design/README.md)；**关键约束一句话汇编**见 [references/ASSEMBLY.md](references/ASSEMBLY.md)。高价值约定（ConfigProvider 必包、图标来源、Card+Table innerBordered、Filter 受控）已融入各相关 reference。
 
 ## 何时不用 / 例外
 
-- **不接入 OBUI 的项目**：若业务明确只使用 antd、不引入 OceanBase Design，则无需遵循本 skill；一旦引入 design/ui/icons 任一包，即应按本 skill 统一来源与用法。
+- **不接入的项目**：若业务明确只使用 antd、不引入 OceanBase Design，则无需遵循本 skill；一旦引入 design/ui/icons 任一包，即应按本 skill 统一来源与用法。
 - **临时原型或一次性脚本**：可放宽（如暂不 ConfigProvider），但上线前需补齐根节点 ConfigProvider 与图标来源。
 - **与第三方库强绑定**：若某第三方组件强制依赖 @ant-design/icons 或 antd 的 useToken，可在该局部保留，其余业务代码仍应使用 @oceanbase/icons 与 obToken。
 - **例外必须说明**：未遵循某条约定时，在注释或 PR 中写明原因（如「此处因 xxx 暂未使用 innerBordered」），便于后续收敛。
 
-**使用本 Skill 生成或修改代码时**：请遵循对应 reference 中的约束与示例；若未遵循某条约定（如 Card+Table 未设 innerBordered），请在注释或 PR 中简要说明原因；迁移场景请注明是否已用或拟用 codemod。高价值可检测约定见 [rules/](rules/) 原子化规则。
+**使用本 Skill 生成或修改代码时**：请遵循对应 reference 中的约束与示例；若未遵循某条约定（如 Card+Table 未设 innerBordered），请在注释或 PR 中简要说明原因；迁移场景请注明是否已用或拟用 codemod。高价值约定已融入 00-overview、icons、09-combo、08-filter 等 reference。

skills/oceanbase-design-usage/EVALUATION.md

@@ -15,6 +15,4 @@
 | **筛选** | 优先 design Filter；Filter.Input/Switch 有 inputProps/switchProps；受控必传 value+onChange；trigger、placement | [08-filter](design/08-filter.md) |
 | **组合** | Card/ProCard+Table 无内边距时 Table innerBordered；Table+批量操作 toolOptionsRender；ConfigProvider 全局配置；Filter+Table、Form+Modal 用 confirmLoading | [09-combo](design/09-combo.md) |
 
-**通用**：组件与图标从 `@oceanbase/design`、`@oceanbase/icons` 引入；迁移先跑 `@oceanbase/codemod` 再人工核对。
-
-**原子化规则**（可做 CI/门禁）：[config-provider-required](../rules/config-provider-required.md)、[icons-from-oceanbase](../rules/icons-from-oceanbase.md)、[card-table-innerBordered](../rules/card-table-innerBordered.md)、[filter-controlled](../rules/filter-controlled.md)。
+**通用**：组件与图标从 `@oceanbase/design`、`@oceanbase/icons` 引入；迁移先跑 `@oceanbase/codemod` 再人工核对。高价值约定（ConfigProvider 必包、图标来源、Card+Table innerBordered、Filter 受控）已融入 [00-overview](design/00-overview.md)、[icons](../icons.md)、[09-combo](design/09-combo.md)、[08-filter](design/08-filter.md)。