openyida 2026.7.9 → 2026.7.10

package/yida-skills/skills/yida-app/SKILL.md

@@ -6,12 +6,15 @@ description: 宜搭完整应用开发技能。从零到一搭建完整宜搭应
 # yida-app — 宜搭完整应用开发编排技能
 
 > 本文档是**流程编排层**，描述各子技能的调用时机、决策逻辑和数据流转。
-> 各子技能的详细参数和示例请查阅对应的子技能文档（见主 `SKILL.md` 索引表）。
+> 在支持 `use_skill` 的宿主中，只在进入对应阶段前调用 `use_skill("<技能名>", "<本阶段目的>")` 加载该阶段子技能；不要预读未来阶段技能。
+> 如果宿主没有 `use_skill` / `search_skills`，按根技能路由表逐阶段定位子技能，并只读取当前阶段唯一必要的子技能文档；`skills-index.json` 不是普通宿主的运行前置条件。
 
 ## 严格禁止 (NEVER DO)
 
 - 不要跳过 `openyida env` 环境检测直接开始开发
-- 不要在未读取各子技能 SKILL.md 的情况下执行对应操作
+- 不要在未加载对应阶段子技能的情况下执行该阶段操作
+- 不要用 `Read` / `read_file` / `cat` 读取子技能 `SKILL.md` 路径；支持 `use_skill` 时必须走 `use_skill`
+- 不要在开头预读未来阶段技能，也不要并发批量加载多个子技能
 - 不要编造任何 ID（appType/formUuid/fieldId），必须从命令返回中提取
 - 不要用 shell heredoc、`cat`/`echo`/`printf`/`tee` 或重定向生成 OpenYida 命令输入文件
 
@@ -26,6 +29,22 @@ description: 宜搭完整应用开发技能。从零到一搭建完整宜搭应
 - 导航整理完成后，若应用含表单，默认向核心表单灌入 2-3 条覆盖关键维度的示例数据，让看板首屏有真实聚合效果；`DateField`/`CascadeDateField` 用 13 位毫秒时间戳，灌后 `openyida data query` 抽查至少 1 条确认字段值非空（用户明确说"不要示例数据"时才跳过）
 - **本技能不读写 memory**：所有关键 ID（appType、formUuid 等）通过 `.cache/<项目名>-schema.json` 持久化，不依赖跨会话的 memory 状态
 
+## 阶段式子技能加载
+
+完整应用搭建时，开头只加载 `yida-app` 本编排技能。进入下列阶段前，再加载该阶段唯一必要的子技能：
+
+| 阶段 | 加载方式 |
+|------|----------|
+| 创建应用 | `use_skill("yida-create-app", "创建应用并获取 appType")` |
+| 创建表单 | `use_skill("yida-create-form-page", "设计并创建表单字段结构")` |
+| 创建页面 | `use_skill("yida-create-page", "创建自定义页面容器并获取 formUuid")` |
+| 编写页面 | `use_skill("yida-custom-page", "编写宜搭自定义页面 JSX")` |
+| 发布页面 | `use_skill("yida-publish-page", "编译并发布自定义页面")` |
+| 整理导航 | `use_skill("yida-nav-group", "整理应用导航顺序")` |
+| 示例数据 | `use_skill("yida-data-management", "写入和抽查示例数据")` |
+
+按需阶段也遵守同一规则：需要流程时再调用 `use_skill("yida-create-process", "创建或配置流程表单")`；需要视觉方向时再调用 `use_skill("yida-page-uiux", "确定自定义页面视觉方向")`；需要报表或图表时，分别在进入报表阶段前调用 `use_skill("yida-report", "创建原生报表")` 或 `use_skill("yida-chart", "创建 ECharts 可视化页面")`。
+
 ## 适用场景
 
 用户说"帮我搭建一个完整应用"、"从零开始创建系统"、"一句话生成应用"时使用。
@@ -48,14 +67,14 @@ description: 宜搭完整应用开发技能。从零到一搭建完整宜搭应
               ↓
 [Step 2] 需求分析 → 写入 prd/<项目名>.md
               ↓
-[Step 3] 创建自定义页面 → openyida create-page    → 获得 formUuid（自定义页面）
+[Step 3]（按需）创建/更新表单 → openyida create-form → 获得 formUuid + fieldId（表单）
               ↓
-[Step 4]（按需）创建/更新表单 → openyida create-form → 获得 formUuid（表单）
+[Step 4] 创建自定义页面 → openyida create-page    → 获得 formUuid（自定义页面）
               ↓
 [Step 5]（按需，需求含「审批」「流程」「申请」「审核」「工单」等关键词时必须执行）
-          配置流程 → 读取 skills/yida-create-process/SKILL.md → openyida create-process / configure-process
+          配置流程 → use_skill("yida-create-process", "创建或配置流程表单") → openyida create-process / configure-process
               ↓
-[Step 6] 编写自定义页面代码 → 先 yida-page-uiux 定视觉方向，再 yida-custom-page 落地 → pages/src/<项目名>.oyd.jsx
+[Step 6] 编写自定义页面代码 → use_skill("yida-custom-page", "编写宜搭自定义页面 JSX") → pages/src/<项目名>.oyd.jsx
               ↓  （首次生成必做：先用 yida-page-uiux 产出「视觉方向决策块」，避免统一灰白圆角的 AI 味模板脸）
               ↓  openyida check-page / compile 预检（.oyd.jsx 自动兼容构建）
               ↓  （列表/表格类页面：参考 yida-density 技能选择合适的信息密度）
@@ -71,9 +90,14 @@ description: 宜搭完整应用开发技能。从零到一搭建完整宜搭应
 [Step 10] 输出访问链接，用系统浏览器打开
 ```
 
-### 编写自定义页面代码前先读 `skills/yida-page-uiux/SKILL.md` 定视觉方向，再完整学习 `skills/yida-custom-page/SKILL.md`
+### 阶段加载提醒
 
-### 生成表单 schema 前必须完整学习 `skills/yida-create-form-page/SKILL.md`
+- 创建应用阶段：先加载 `yida-create-app`。
+- 生成表单 schema 阶段：先加载 `yida-create-form-page`。
+- 创建自定义页面阶段：先加载 `yida-create-page`。
+- 编写自定义页面代码阶段：先加载 `yida-custom-page`；首次生成面向用户页面时，再按需加载 `yida-page-uiux` 产出视觉方向决策块。
+- 发布阶段：先加载 `yida-publish-page`。
+- 导航和示例数据阶段：分别加载 `yida-nav-group`、`yida-data-management`。
 
 ### 使用模板文件确保一次性成功
 
@@ -85,7 +109,7 @@ description: 宜搭完整应用开发技能。从零到一搭建完整宜搭应
 | yida-data-management | `openyida sample yida-data-management form-field-template` | 表单字段定义和数据插入 |
 | yida-create-app | `openyida sample yida-create-app ipd-app-template` | 完整应用创建示例 |
 
-表单详情页视觉优化不走 `openyida publish`。当用户要求“详情页美化 / formDetail 样式优化”时，读取 `skills/yida-form-detail/SKILL.md`，通过表单 Schema 注入 Html 组件承载 CSS。
+表单详情页视觉优化不走 `openyida publish`。当用户要求“详情页美化 / formDetail 样式优化”时，调用 `use_skill("yida-form-detail", "通过表单 Schema 注入详情页 CSS")`，通过表单 Schema 注入 Html 组件承载 CSS。
 
 **代码生成前必须**：
 
@@ -102,9 +126,9 @@ description: 宜搭完整应用开发技能。从零到一搭建完整宜搭应
 ```
 用户需求
     │
-    ├── 纯展示 / 静态内容 → 跳过 Step 5（无需创建表单）
+    ├── 纯展示 / 静态内容 → 跳过 Step 3（无需创建表单）
     │
-    └── 需要收集 / 存储数据 → Step 5 创建表单
+    └── 需要收集 / 存储数据 → Step 3 创建表单
 ```
 
 ### 决策 2：是否需要审批流程？
@@ -112,9 +136,9 @@ description: 宜搭完整应用开发技能。从零到一搭建完整宜搭应
 ```
 表单创建后
     │
-    ├── 无审批需求 → 直接进入 Step 6 编写代码
+    ├── 无审批需求 → 直接进入 Step 4 创建页面 / Step 6 编写代码
     │
-    └── 有审批需求 → 调用 yida-create-process 配置流程后再编写代码
+    └── 有审批需求 → 加载 yida-create-process 配置流程后再编写代码
 ```
 
 ### 决策 3：是否需要数据可视化报表？
@@ -122,9 +146,9 @@ description: 宜搭完整应用开发技能。从零到一搭建完整宜搭应
 ```
 应用功能需求
     │
-    ├── 标准统计报表 → 调用 yida-report 创建原生报表
+    ├── 标准统计报表 → 加载 yida-report 创建原生报表
     │
-    └── 高级 ECharts 大屏 → 先 yida-report 创建数据源，再 yida-chart 创建可视化页面
+    └── 高级 ECharts 大屏 → 先加载 yida-report 创建数据源，再加载 yida-chart 创建可视化页面
 ```
 
 ### 决策 4：corpId 一致性检查（创建页面前必须执行）
@@ -147,7 +171,7 @@ description: 宜搭完整应用开发技能。从零到一搭建完整宜搭应
 
 ### Step 1：创建应用
 
-调用 `yida-create-app` 技能，创建宜搭应用并获取 `appType`：
+进入本阶段前调用 `use_skill("yida-create-app", "创建应用并获取 appType")`，创建宜搭应用并获取 `appType`：
 
 ```bash
 openyida create-app "<应用名称>" "[描述]"
@@ -155,8 +179,6 @@ openyida create-app "<应用名称>" "[描述]"
 
 **输出**：`appType`（如 `APP_XXXXXX`），自动写入 prd 文档的应用配置表。
 
-> 📖 详见 [`skills/yida-create-app/SKILL.md`](../yida-create-app/SKILL.md)
-
 ---
 
 ### Step 2：需求分析 → 写入 prd 文档
@@ -259,25 +281,11 @@ openyida create-app "<应用名称>" "[描述]"
 
 ---
 
-### Step 3：创建自定义页面
-
-确认 corpId 一致后，调用 `yida-create-page` 技能：
-
-```bash
-openyida create-page <appType> "<页面名称>" [--mode dashboard]
-```
-
-**输出**：`formUuid`（如 `FORM-XXXXXX`），写入 `.cache/<项目名>-schema.json`。
-
-> 📖 详见 [`skills/yida-create-page/SKILL.md`](../yida-create-page/SKILL.md)
-
----
-
-### Step 4：创建表单（按需）
+### Step 3：创建表单（按需）
 
-**当页面需要收集/存储数据时**，调用 `yida-create-form-page` 技能。
+**当页面需要收集/存储数据时**，进入本阶段前调用 `use_skill("yida-create-form-page", "设计并创建表单字段结构")`。
 
-#### 4.1 定义字段，写入 `<projectRoot>/.cache/openyida/<项目名或任务名>/xxx-fields.json`
+#### 3.1 定义字段，写入 `<projectRoot>/.cache/openyida/<项目名或任务名>/xxx-fields.json`
 
 使用 create_file / Write / file edit tool 创建字段定义文件；不要用 shell heredoc 或重定向写 JSON。若从 workspace 根执行命令，路径写作 `project/.cache/openyida/<项目名或任务名>/xxx-fields.json`。
 
@@ -290,7 +298,7 @@ openyida create-page <appType> "<页面名称>" [--mode dashboard]
 ]
 ```
 
-#### 4.2 创建表单
+#### 3.2 创建表单
 
 ```bash
 openyida create-form create <appType> "<表单名称>" .cache/openyida/<项目名或任务名>/xxx-fields.json
@@ -298,7 +306,7 @@ openyida create-form create <appType> "<表单名称>" .cache/openyida/<项目
 
 **输出**：`formUuid` 和各字段的 `fieldId`（如 `textField_xxxxxxxx`）。
 
-#### 4.3 将 Schema ID 写入 `.cache/<项目名>-schema.json`
+#### 3.3 将 Schema ID 写入 `.cache/<项目名>-schema.json`
 
 ```json
 {
@@ -320,13 +328,24 @@ openyida create-form create <appType> "<表单名称>" .cache/openyida/<项目
 }
 ```
 
-> 📖 详见 [`skills/yida-create-form-page/SKILL.md`](../yida-create-form-page/SKILL.md)
+---
+
+### Step 4：创建自定义页面
+
+确认 corpId 一致后，进入本阶段前调用 `use_skill("yida-create-page", "创建自定义页面容器并获取 formUuid")`：
+
+```bash
+openyida create-page <appType> "<页面名称>" [--mode dashboard]
+```
+
+**输出**：`formUuid`（如 `FORM-XXXXXX`），写入 `.cache/<项目名>-schema.json`。
 
 ---
 
 ### Step 5：配置流程（按需）
 
 **当需求含「审批」「流程」「申请」「审核」「工单」等关键词时必须执行**。
+进入本阶段前调用 `use_skill("yida-create-process", "创建或配置流程表单")`。
 
 ```bash
 openyida create-process <appType> --formUuid <formUuid> .cache/openyida/<项目名或任务名>/process-definition.json
@@ -334,14 +353,12 @@ openyida create-process <appType> --formUuid <formUuid> .cache/openyida/<项目
 
 流程定义文件先用结构化文件写入工具创建；从 workspace 根执行命令时路径加 `project/` 前缀。
 
-> 📖 详见 [`skills/yida-create-process/SKILL.md`](../yida-create-process/SKILL.md)
-
 ---
 
 ### Step 6：编写自定义页面代码
 
 **编写前必须**：
-1. 完整读取 [`skills/yida-custom-page/SKILL.md`](../yida-custom-page/SKILL.md)
+1. 调用 `use_skill("yida-custom-page", "编写宜搭自定义页面 JSX")`
 2. 执行 `openyida sample yida-custom-page custom-page-template` 获取模板，再用 `read_file` 读取 `.cache/samples/custom-page-template.js`
 3. 读取 prd 文档和 `.cache/<项目名>-schema.json` 获取所有 ID
 
@@ -365,13 +382,11 @@ openyida check-page pages/src/<项目名>.oyd.jsx
 openyida compile pages/src/<项目名>.oyd.jsx
 ```
 
-> 📖 详见 [`skills/yida-custom-page/SKILL.md`](../yida-custom-page/SKILL.md)
-
 ---
 
 ### Step 7：发布页面
 
-调用 `yida-publish-page` 技能，将源码编译并部署到宜搭平台：
+进入本阶段前调用 `use_skill("yida-publish-page", "编译并发布自定义页面")`，将源码编译并部署到宜搭平台：
 
 ```bash
 openyida publish <源文件路径> <appType> <formUuid> [--health-check]
@@ -379,13 +394,11 @@ openyida publish <源文件路径> <appType> <formUuid> [--health-check]
 
 **发布流程**：Babel 编译 JSX → ES5 → UglifyJS 压缩 → 调用 `saveFormSchema` 保存 Schema
 
-> 📖 详见 [`skills/yida-publish-page/SKILL.md`](../yida-publish-page/SKILL.md)
-
 ---
 
 ### Step 8：整理导航顺序（含看板/多页面时必做）
 
-首次生成完整应用后，导航是创建时的默认顺序（通常表单在前、看板在后），必须基于业务信息架构重排。调用 `yida-nav-group` 技能：
+首次生成完整应用后，导航是创建时的默认顺序（通常表单在前、看板在后），必须基于业务信息架构重排。进入本阶段前调用 `use_skill("yida-nav-group", "整理应用导航顺序")`：
 
 ```bash
 openyida nav-group order <appType> <总览看板> <专题看板...> <核心表单...>
@@ -393,13 +406,11 @@ openyida nav-group order <appType> <总览看板> <专题看板...> <核心表
 
 **默认原则**：面向决策者的**总览/驾驶舱看板作为应用门面靠前**，数据录入/明细表单在其后；同级多个专题看板按业务优先级排，不要把所有页面无脑堆最前。
 
-> 📖 详见 [`skills/yida-nav-group/SKILL.md`](../yida-nav-group/SKILL.md)
-
 ---
 
 ### Step 9：灌入示例数据（有表单时默认执行）
 
-新建应用的表单默认无数据，看板首屏会空。导航整理完成后，默认向核心表单灌入 **2-3 条**覆盖关键维度（不同活动/渠道/日期等）的示例记录，调用 `yida-data-management` 技能：
+新建应用的表单默认无数据，看板首屏会空。导航整理完成后，默认向核心表单灌入 **2-3 条**覆盖关键维度（不同活动/渠道/日期等）的示例记录。进入本阶段前调用 `use_skill("yida-data-management", "写入和抽查示例数据")`：
 
 ```bash
 openyida data create form <appType> <formUuid> --data-file .cache/openyida/<项目名或任务名>/data-import/sample-record-1.json
@@ -412,8 +423,6 @@ openyida data create form <appType> <formUuid> --data-file .cache/openyida/<项
 - 灌完执行 `openyida data query form <appType> <formUuid>` 抽查至少 1 条，确认 `formData` 字段有实际值。
 - 用户明确说"不要示例数据 / 不要 mock 数据"时才跳过。
 
-> 📖 详见 [`skills/yida-data-management/SKILL.md`](../yida-data-management/SKILL.md)
-
 ---
 
 ### Step 10：输出访问链接并用系统浏览器打开
@@ -427,8 +436,8 @@ openyida data create form <appType> <formUuid> --data-file .cache/openyida/<项
 | 步骤 | 产出 | 用途 |
 |------|------|------|
 | create-app | `appType` | 所有后续命令的必填参数 |
-| create-page | `pageId` (即 `formUuid`) | 发布自定义页面时指定目标页面 |
 | create-form | `formUuid` + `fieldId` | 自定义页面代码中调用表单 API |
+| create-page | `pageId` (即 `formUuid`) | 发布自定义页面时指定目标页面 |
 | get-schema | `fieldId` 列表 | 公式字段、权限配置、数据查询时引用 |
 
 **存储约定**：
@@ -447,39 +456,39 @@ openyida data create form <appType> <formUuid> --data-file .cache/openyida/<项
 ### 场景 1：一句话生成应用（如"生日祝福小游戏"）
 
 ```
-1. yida-create-app → 创建应用，获取 appType
+1. 加载子技能 `yida-create-app` → 创建应用，获取 appType
 2. 需求分析 → 写入 prd/birthday-game.md
-3. yida-create-page → 创建自定义页面，获取 pageId
-4. yida-create-form-page → 创建祝福记录表单，获取 formUuid + fieldId
-5. yida-custom-page → 编写游戏页面代码
-6. yida-publish-page → 发布，输出访问链接
-7. yida-nav-group → 按“游戏首页 → 祝福记录表”整理导航
-8. yida-data-management → 向祝福记录表灌 2-3 条示例数据
+3. 加载子技能 `yida-create-form-page` → 创建祝福记录表单，获取 formUuid + fieldId
+4. 加载子技能 `yida-create-page` → 创建自定义页面，获取 pageId
+5. 加载子技能 `yida-custom-page` → 编写游戏页面代码
+6. 加载子技能 `yida-publish-page` → 发布，输出访问链接
+7. 加载子技能 `yida-nav-group` → 按“游戏首页 → 祝福记录表”整理导航
+8. 加载子技能 `yida-data-management` → 向祝福记录表灌 2-3 条示例数据
 ```
 
 ### 场景 2：带审批的 CRM 系统
 
 ```
-1. yida-create-app → 创建 CRM 应用
+1. 加载子技能 `yida-create-app` → 创建 CRM 应用
 2. 需求分析 → 写入 prd/crm.md
-3. yida-create-form-page → 创建客户信息表、跟进记录表
-4. yida-create-process → 配置客户审批流程
-5. yida-report → 创建销售数据报表
-6. yida-create-page → 创建 CRM 首页
-7. yida-custom-page → 编写首页代码（集成表单 + 报表）
-8. yida-publish-page → 发布
-9. yida-nav-group → 按“CRM 首页/看板 → 客户信息表 → 跟进记录表 → 审批流程/报表”整理导航
-10. yida-data-management → 向客户信息表、跟进记录表灌 2-3 条示例数据
+3. 加载子技能 `yida-create-form-page` → 创建客户信息表、跟进记录表
+4. 加载子技能 `yida-create-process` → 配置客户审批流程
+5. 加载子技能 `yida-report` → 创建销售数据报表
+6. 加载子技能 `yida-create-page` → 创建 CRM 首页
+7. 加载子技能 `yida-custom-page` → 编写首页代码（集成表单 + 报表）
+8. 加载子技能 `yida-publish-page` → 发布
+9. 加载子技能 `yida-nav-group` → 按“CRM 首页/看板 → 客户信息表 → 跟进记录表 → 审批流程/报表”整理导航
+10. 加载子技能 `yida-data-management` → 向客户信息表、跟进记录表灌 2-3 条示例数据
 ```
 
 ### 场景 3：数据大屏（ECharts 可视化）
 
 ```
-1. yida-create-app → 创建应用
-2. yida-create-form-page → 创建数据录入表单
-3. yida-report → 创建原生报表（作为 ECharts 数据源）
-4. yida-chart → 创建 ECharts 自定义页面（引用原生报表数据）
-5. yida-publish-page → 发布
+1. 加载子技能 `yida-create-app` → 创建应用
+2. 加载子技能 `yida-create-form-page` → 创建数据录入表单
+3. 加载子技能 `yida-report` → 创建原生报表（作为 ECharts 数据源）
+4. 加载子技能 `yida-chart` → 创建 ECharts 自定义页面（引用原生报表数据）
+5. 加载子技能 `yida-publish-page` → 发布
 ```
 
 ---

package/yida-skills/skills/yida-canvas-custom-page/SKILL.md

@@ -47,7 +47,7 @@ OpenYida CLI 已支持发布 `YidaCodeCanvas` 页面：把 Code Canvas 源码写
 
 ## 视觉方向：先定方向，再写代码
 
-写页面前先定视觉方向，避免首次就生成「默认蓝 + 大圆角 + emoji」的 AI 味套版。视觉决策是**栈无关**的，与 native 链路共用决策层技能 `yida-page-uiux`：读它的 `SKILL.md` 按页面类型（工作台/仪表盘/列表/详情）做 5 维差异化、走去 AI 味清单、严禁 emoji。
+写页面前先定视觉方向，避免首次就生成「默认蓝 + 大圆角 + emoji」的 AI 味套版。视觉决策是**栈无关**的，与 native 链路共用决策层技能 `yida-page-uiux`：需要视觉方向时调用 `use_skill("yida-page-uiux", "确定 Code Canvas 页面的视觉方向")`，按页面类型（工作台/仪表盘/列表/详情）做 5 维差异化、走去 AI 味清单、严禁 emoji。
 
 Canvas 这套栈（React18 + antd + Tailwind）怎么把「主色跟随 App 品牌」落地由 [references/canvas-design-system.md](references/canvas-design-system.md) 负责。一句话记忆：**CSS 变量 `var(--color-brand1-*)` 对普通 DOM / Tailwind 直接可用（Canvas 跑在真 window、节点在宿主树内会级联）；antd token 和图表颜色是 JS 消费，需用 `getComputedStyle` 把品牌色解析成真实色值再喂进去。** 语义色（成功/警告/错误）保持固定，不随主题变。
 

package/yida-skills/skills/yida-canvas-custom-page/references/canvas-design-system.md

@@ -2,7 +2,7 @@
 
 本文件是 Code Canvas 页面的**实现层**引导：怎么让首次生成的页面跟随宿主 App 的品牌主题色，而不是永远一片 antd 默认蓝。视觉方向怎么定（页面类型、差异化、去 AI 味）是**栈无关**的，走共用的决策层技能 `yida-page-uiux`，本文件只讲 Canvas（React18 + antd + Tailwind）这套栈怎么把主色落地。
 
-> 决策层：读 `yida-page-uiux/SKILL.md` 定视觉方向（先做 Step 0 导航形态判定，再定工作台/仪表盘/列表/详情、5 维差异化、去 AI 味、禁 emoji）。
+> 决策层：需要视觉方向时调用 `use_skill("yida-page-uiux", "确定 Code Canvas 页面视觉方向")`（先做 Step 0 导航形态判定，再定工作台/仪表盘/列表/详情、5 维差异化、去 AI 味、禁 emoji）。
 > 实现层：本文件负责把「主色跟随 App 品牌」落到 antd token / Tailwind / 图表。
 
 > **前提是导航可见**：跟随品牌主色是为了跟应用框架融合。若页面隐藏了应用导航（`isRenderNav=false`，沉浸/独立/门户/大屏，由 `yida-page-uiux` Step 0 判定），主色相可自立、不必严格跟品牌——此时把下文 `readBrandColor` 的取值换成自定的主色即可（antd `colorPrimary` / 图表色都改喂自定色），**语义色仍固定、去 AI 味红线仍生效**。拿不准就按「跟随品牌」这个更安全的默认走。

package/yida-skills/skills/yida-chart/SKILL.md

@@ -156,5 +156,5 @@ A：更新 `_customState.filterValueMap`，重新调用报表数据请求函数
 | [ECharts 视觉规范](references/echarts-design-spec.md) | 默认风格、配色、卡片、图表模板、多端适配、表格样式 | 设计页面 UI 时必读 |
 | [已有报表绑定指南](references/echarts-bindding-guide.md) | 方案 C、Schema 解析、filterKey、数据源完整性校验 | 用户提供报表 URL 时必读 |
 | [示例](references/examples.md) | 命令示例、页面代码示例、常见图表实现 | 需要参考完整写法时阅读 |
-| [yida-report](../yida-report/SKILL.md) | 原生报表创建、追加图表、Schema 生成 | 需要先创建或补齐原生报表时阅读 |
-| [yida-custom-page](../yida-custom-page/SKILL.md) | 宜搭 React 16 自定义页面规则 | 不确定页面运行时限制时阅读 |
+| `yida-report` 子技能 | 原生报表创建、追加图表、Schema 生成 | 需要先创建或补齐原生报表时调用 `use_skill("yida-report", "创建或补齐原生报表")` |
+| `yida-custom-page` 子技能 | 宜搭 React 16 自定义页面规则 | 不确定页面运行时限制时调用 `use_skill("yida-custom-page", "确认宜搭自定义页面运行时限制")` |

package/yida-skills/skills/yida-chart/references/echarts-bindding-guide.md

@@ -1,7 +1,7 @@
 # 基于已有报表创建 ECharts 页面指南
 
 > 本文档包含方案 C 的完整执行流程、Schema 解析规范、filterKey 提取规则和数据源完整性校验。
-> 由 `yida-chart/SKILL.md` 拆分而来，执行方案 C 时必须读取本文档。
+> 由 `yida-chart` 主技能拆分而来，执行方案 C 时必须读取本文档。
 
 ---
 

package/yida-skills/skills/yida-chart/references/echarts-code-template.md

@@ -1,7 +1,7 @@
 # ECharts 页面代码模板
 
 > 本文档包含 ECharts 自定义页面的必备代码结构、数据请求函数模板、初始化流程等。
-> 由 `yida-chart/SKILL.md` 拆分而来，编写 ECharts 页面代码时必须读取本文档。
+> 由 `yida-chart` 主技能拆分而来，编写 ECharts 页面代码时必须读取本文档。
 
 ---
 

package/yida-skills/skills/yida-chart/references/echarts-design-spec.md

@@ -1,7 +1,7 @@
 # ECharts 报表视觉风格规范
 
 > 本文档包含 ECharts 报表页面的默认视觉风格、配色方案、图表配置模板等。
-> 由 `yida-chart/SKILL.md` 拆分而来，设计 ECharts 页面样式时参考本文档。
+> 由 `yida-chart` 主技能拆分而来，设计 ECharts 页面样式时参考本文档。
 
 ---
 

package/yida-skills/skills/yida-create-process/SKILL.md

@@ -90,7 +90,7 @@ openyida create-process "APP_XXX" --formUuid "FORM-YYY" .cache/openyida/order/pr
 2. **🔄 跳转规则**：存在回退/循环语义时，自动配置 `routeRules`
 3. **🔀 并行/办理/高级组件**：需要并行会审、办理节点或连接器/数据/消息等官方组件节点时，流程定义格式直接参考 `yida-process-rule`
 
-详见 `yida-process-rule` 的 SKILL.md。
+需要流程规则细节时，调用 `use_skill("yida-process-rule", "配置已有流程节点、分支和字段权限")`。
 
 ## 异常处理
 
@@ -98,7 +98,7 @@ openyida create-process "APP_XXX" --formUuid "FORM-YYY" .cache/openyida/order/pr
 |---------|----------|
 | 命令返回失败 | 检查 appType 和 formUuid 是否正确，确认登录态有效 |
 | processCode 获取失败 | 确认表单已成功转为流程表单类型，重新执行 |
-| 流程定义 JSON 格式错误 | 参考 `yida-process-rule` SKILL.md 中的 JSON 格式说明 |
+| 流程定义 JSON 格式错误 | 加载 `yida-process-rule` 子技能，按其中的 JSON 格式说明修正 |
 | 返回 JSON 中无 processCode | 不要猜测 processCode，重新执行命令获取 |
 | 流程发布失败 | 检查流程定义中的 fieldId 是否为真实 ID（先 get-schema 获取） |
 | 登录态失效 | 执行 `openyida login` 重新登录后再试 |

package/yida-skills/skills/yida-custom-page/SKILL.md

@@ -32,7 +32,7 @@ description: 宜搭 native 自定义页面 JSX 开发规范（React 16 宜搭原
 
 影响代码质量和用户体验：
 
-0. **写 UI 前先定视觉方向**：面向用户的页面在动手写 JSX 前，先读 `skills/yida-page-uiux/SKILL.md` 完成「视觉方向决策」（页面类型判定 + 差异化 + 去 AI 味自检），拿到「视觉方向决策块」后再按本技能 `references/design-system.md` 的 token/组件实现；不要直接套用统一灰白底 + 8px 圆角卡片网格的默认模板（那正是 AI 味来源）。
+0. **写 UI 前先定视觉方向**：面向用户的页面在动手写 JSX 前，调用 `use_skill("yida-page-uiux", "确定自定义页面视觉方向")` 完成「视觉方向决策」（页面类型判定 + 差异化 + 去 AI 味自检），拿到「视觉方向决策块」后再按本技能 `references/design-system.md` 的 token/组件实现；不要直接套用统一灰白底 + 8px 圆角卡片网格的默认模板（那正是 AI 味来源）。
 1. **代码生成前确认功能摘要**：详见 [编码指南 编注 0](references/coding-guide.md)
 2. **pageSize 推荐 50，最大 100**：列表/看板默认 `pageSize: 50`；分页接口 `searchFormDatas` 等的 `pageSize` 最大 100
 3. **didUnmount 清理定时器**：在 `didUnmount` 中清理所有 `setInterval`/`setTimeout`，防止内存泄漏
@@ -176,7 +176,7 @@ openyida check-page pages/src/home.oyd.jsx --json      # 输出机器可读的
 | 文档 | 覆盖范围 | 何时阅读 |
 |------|---------|---------|
 | **本技能文档** | | |
-| [视觉方向决策（去 AI 味）](../yida-page-uiux/SKILL.md) | 页面类型 playbook、5 维差异化引擎、去 AI 味黑名单/8 问自检、图标策略 | 实现面向用户的 UI 且要求好看/去 AI 味时，**先于写代码**阅读并产出决策块 |
+| `yida-page-uiux` 子技能 | 页面类型 playbook、5 维差异化引擎、去 AI 味黑名单/8 问自检、图标策略 | 实现面向用户的 UI 且要求好看/去 AI 味时，调用 `use_skill("yida-page-uiux", "确定自定义页面视觉方向")` 并产出决策块 |
 | [编码指南](references/coding-guide.md) | 文件结构模板、状态管理、生命周期、19 条编码规范 | 编写任何页面代码前必读 |
 | [运行时护栏](references/runtime-guardrails.md) | pageSize、loading 恢复、ECharts DOM 时序、setState 约束、check-page 规则映射 | 编写列表、看板、图表或接口页面前必读 |
 | [设计规范](references/design-system.md) | 色彩/圆角/字体/间距系统、7 类组件样式模板、8 条反模式 | 实现 UI 样式时必读 |

package/yida-skills/skills/yida-custom-page/references/coding-guide.md

@@ -526,7 +526,7 @@ setTimeout(function () {
 }, 100);
 ```
 
-> **适用场景**：ECharts 图表初始化、Canvas 绑定、第三方库挂载等需要操作 DOM 的场景。详见 [`yida-chart` 技能](../../yida-chart/SKILL.md)的「图表渲染时序」章节。
+> **适用场景**：ECharts 图表初始化、Canvas 绑定、第三方库挂载等需要操作 DOM 的场景。需要图表级渲染时序规则时，调用 `use_skill("yida-chart", "确认 ECharts 图表渲染时序")`。
 
 ### 15. 调试技巧
 

package/yida-skills/skills/yida-custom-page/references/design-system.md

@@ -1,6 +1,6 @@
 # 宜搭自定义页面设计规范
 
-> **本文件是 token / 组件实现层（数值层）**：提供色彩/圆角/字体/间距的具体值与组件模板。视觉**方向与差异化**（选哪种气质、如何偏离默认脸、去 AI 味）由 `../../yida-page-uiux/SKILL.md` 决定——**先定方向、再用本文件落地**。直接套用本文件的默认组合（灰白底 + 统一圆角卡片）而不先做方向决策，正是页面「有 AI 味」的根因。
+> **本文件是 token / 组件实现层（数值层）**：提供色彩/圆角/字体/间距的具体值与组件模板。视觉**方向与差异化**（选哪种气质、如何偏离默认脸、去 AI 味）由 `yida-page-uiux` 子技能决定——需要时调用 `use_skill("yida-page-uiux", "确定自定义页面视觉方向")`，**先定方向、再用本文件落地**。直接套用本文件的默认组合（灰白底 + 统一圆角卡片）而不先做方向决策，正是页面「有 AI 味」的根因。
 
 > 宜搭自定义页面默认使用 Tailwind utility `className` 组织视觉层，并保留内联 `style` 兜底。不能使用 CSS 文件、CSS Modules、shadcn/ui 或构建期样式方案。
 

package/yida-skills/skills/yida-dashboard/SKILL.md

@@ -169,7 +169,7 @@ metadata:
 
 ## 与 yida-chart 的协作边界
 
-当你在本技能里实现某个具体图表（比如地图、桑基图、雷达图）遇到**图表级技术问题**（渲染不出来、数据结构怎么映射到 series、setOption 闪烁）时，**读 yida-chart 的 SKILL.md**，不要重复造轮子。
+当你在本技能里实现某个具体图表（比如地图、桑基图、雷达图）遇到**图表级技术问题**（渲染不出来、数据结构怎么映射到 series、setOption 闪烁）时，调用 `use_skill("yida-chart", "解决具体 ECharts 图表实现问题")`，不要重复造轮子。
 
 本技能只负责：
 - 6 个图表应该画什么（区域营收 / 品牌矩阵 / 客群分布 / 渠道贡献 / NPS / 趋势）

package/yida-skills/skills/yida-integration/SKILL.md

@@ -7,7 +7,7 @@ description: 宜搭集成&自动化配置。支持创建、查询、开启、关
 
 ## 严格禁止 (NEVER DO)
 
-- 不要在未读取本 SKILL.md 的情况下编写逻辑流定义，节点格式复杂且易出错
+- 不要在未加载本技能内容的情况下编写逻辑流定义，节点格式复杂且易出错
 - 不要编造 formUuid 或 fieldId，必须从已有记录或 `yida-get-schema` 获取
 - 不要用此技能配置审批流程，应使用 `yida-process-rule`
 

package/yida-skills/skills/yida-page-uiux/SKILL.md

@@ -57,7 +57,7 @@ Step 0 导航形态判定 → Step 1 页面类型 → Step 2 意图解码 → St
 | 文档 | 覆盖范围 | 何时阅读 |
 |------|---------|---------|
 | [视觉决策引擎](references/visual-decision-engine.md) | 5 个风格意图 + 反默认组合表 + 5 个差异化维度 + 强制第二选择 + 差异化自检 | Step 4 做视觉决策时（所有场景共用） |
-| [页面内自绘导航壳（独立 skill）](../yida-nav-shell/SKILL.md) | 页面隐藏应用导航后用 JSX 自建侧边/顶部/混合/浮动/标签导航壳：选型表 + 骨架 + native/Canvas 代码 + 多视图切换 | Step 0 判定导航隐藏、需自建导航壳时 |
+| `yida-nav-shell` 子技能 | 页面隐藏应用导航后用 JSX 自建侧边/顶部/混合/浮动/标签导航壳：选型表 + 骨架 + native/Canvas 代码 + 多视图切换 | Step 0 判定导航隐藏、需自建导航壳时调用 `use_skill("yida-nav-shell", "设计页面内自绘导航壳")` |
 | [scene-workbench](references/scenes/workbench.md) | 工作台/门户首页的骨架/密度/焦点/组件套餐/去 AI 味要点 | 页面类型 = 工作台时 |
 | [scene-dashboard](references/scenes/dashboard.md) | 数据看板/驾驶舱 | 页面类型 = 看板时 |
 | [scene-list](references/scenes/list.md) | 列表/管理页 | 页面类型 = 列表时 |

package/yida-skills/skills/yida-page-uiux/workflow/step-0-nav-shape.md

@@ -26,9 +26,9 @@
 - **配置闭环**：只要页面内自绘应用级导航，发布后必须执行 `openyida update-form-config <appType> <formUuid> false "<页面标题>"` 隐藏宜搭原导航，并验证最终 URL 仍带 `isRenderNav=false`。
 - **移动端**：侧边栏在窄屏要能收起为抽屉/底部标签，仍走 `isMobile` 响应式。
 
-**导航壳形态选型**：侧边栏 / 顶部 / 顶部+侧边混合 / 浮动胶囊 / 标签页——按顶级模块数量和是否常驻选。选型表、每种形态的骨架、选中态、移动端收敛、native + Canvas 代码示例见独立 skill [yida-nav-shell](../../yida-nav-shell/SKILL.md)。
+**导航壳形态选型**：侧边栏 / 顶部 / 顶部+侧边混合 / 浮动胶囊 / 标签页——按顶级模块数量和是否常驻选。需要选型表、每种形态的骨架、选中态、移动端收敛、native + Canvas 代码示例时，调用 `use_skill("yida-nav-shell", "设计页面内自绘导航壳")`。
 
-> 导航壳的**视觉方向**仍走 Step 1–6（多为 workbench/门户形态）；导航壳的**形态与实现**（选型、多视图切换、URL 拼接）见独立 skill [yida-nav-shell](../../yida-nav-shell/SKILL.md)，交 `yida-custom-page` / `yida-canvas-custom-page` 落地。
+> 导航壳的**视觉方向**仍走 Step 1–6（多为 workbench/门户形态）；导航壳的**形态与实现**（选型、多视图切换、URL 拼接）需要调用 `use_skill("yida-nav-shell", "设计页面内自绘导航壳")`，再交 `yida-custom-page` / `yida-canvas-custom-page` 落地。
 
 ## 产出
 

package/yida-skills/skills/yida-ppt/SKILL.md

@@ -25,7 +25,7 @@ metadata:
 本技能只保留兼容入口。所有宜搭 PPT / 幻灯片 / 演示文稿开发都应改用：
 
 ```text
-../yida-ppt-slider/SKILL.md
+use_skill("yida-ppt-slider", "开发宜搭全屏幻灯片页面")
 ```
 
 ## 执行规则
@@ -43,4 +43,4 @@ metadata:
 yida-ppt 已合并到 yida-ppt-slider，我会使用新版 yida-ppt-slider 的对应主题来实现。
 ```
 
-然后读取 `../yida-ppt-slider/SKILL.md` 并继续。
+然后调用 `use_skill("yida-ppt-slider", "开发宜搭全屏幻灯片页面")` 并继续。

package/yida-skills/skills/yida-ppt-slider/SKILL.md

@@ -142,4 +142,4 @@ openyida update-form-config <appType> <formUuid> false "<页面名>"
 | [核心示例](references/examples.md) | SLIDES、状态、生命周期、渲染、导航、全屏、i18n、主题、hash | 编写页面代码前必读 |
 | [dark-tech 主题](references/dark-tech-theme.md) | CSS 动画库、转场配置、样式预设、Canvas 粒子、背景层、主框架 | 用户选择 `dark-tech` 时必读 |
 | [ECharts race 示例](references/echarts-race-example.md) | 动态柱状图完整实现、数据结构、插值动画、清理逻辑 | 需要 `echarts-race` 类型时必读 |
-| [自定义页面规范](../yida-custom-page/SKILL.md) | 宜搭 React 16 页面模式、编码限制、发布前检查 | 不确定页面运行时规则时阅读 |
+| `yida-custom-page` 子技能 | 宜搭 React 16 页面模式、编码限制、发布前检查 | 不确定页面运行时规则时调用 `use_skill("yida-custom-page", "确认宜搭自定义页面运行时规则")` |

package/yida-skills/skills/yida-ppt-slider/references/echarts-race-example.md

@@ -1,6 +1,6 @@
 # ECharts Bar Chart Race 动态柱状图示例
 
-> 完整的 Bar Chart Race 实现代码，从 `yida-ppt-slider/SKILL.md` 提取。
+> 完整的 Bar Chart Race 实现代码，从 `yida-ppt-slider` 主技能提取。
 > 用于在 PPT 幻灯片中集成 ECharts 动态柱状图，展示中国历代经济排名变化。
 
 ## SLIDES 数据结构

package/yida-skills/skills/yida-process-rule/SKILL.md

@@ -8,7 +8,7 @@ description: 为已有流程表单配置审批规则（审批/办理/抄送、
 ## 严格禁止 (NEVER DO)
 
 - 不要在流程定义中使用猜测的 fieldId，必须先用 `yida-get-schema` 获取
-- 不要在未读取本 SKILL.md 的情况下编写流程定义 JSON，格式复杂且易出错
+- 不要在未加载本技能内容的情况下编写流程定义 JSON，格式复杂且易出错
 - 不要用此技能创建流程表单，应使用 `yida-create-process`
 - 不要用 shell heredoc、`cat`/`echo`/`printf`/`tee` 或重定向生成流程定义 JSON
 

package/yida-skills/skills/yida-publish-page/SKILL.md

@@ -7,7 +7,7 @@ description: 将 JSX 源码编译发布到宜搭自定义页面。Babel 转 ES5
 
 ## 严格禁止 (NEVER DO)
 
-- 不要在未读取 `yida-custom-page` SKILL.md 的情况下编写 JSX 源码
+- 不要在未加载 `yida-custom-page` 子技能的情况下编写 JSX 源码
 - 不要把 AI 生成的普通 React 项目代码直接发布；源码应使用 OpenYida 页面源码格式（推荐 `.oyd.jsx`）并通过 `check-page` / `compile` 预检
 - 不要在宜搭原生 `export function renderJsx()` 页面里手写 Hooks；如确需 `useState/useEffect`，必须使用 `.oyd.jsx` 的 `export default function Page()` authoring 模式，让 OpenYida 兼容编译器降级
 - 不要编造 appType 和 formUuid，必须从已有记录或命令返回中获取
@@ -112,7 +112,7 @@ body { background-color: #f2f3f5; }
 
 - 发布目标地址由 `.cache/cookies.json` 中的 `base_url` 决定
 - 碰到组织 corpId 不匹配时，询问用户是否创建新应用发布
-- **编写源码前必须先读取 `yida-custom-page` 的 SKILL.md**；原生 `renderJsx` 写法不要使用 Hooks，现代 authoring 写法必须走 `.oyd.jsx` 兼容编译
+- **编写源码前必须先加载 `yida-custom-page` 子技能**：调用 `use_skill("yida-custom-page", "编写宜搭自定义页面 JSX")`；原生 `renderJsx` 写法不要使用 Hooks，现代 authoring 写法必须走 `.oyd.jsx` 兼容编译
 
 ## 异常处理
 

package/yida-skills/skills/yida-table-form/references/examples.md

@@ -39,7 +39,7 @@ var COLUMNS = [
 openyida create-page APP_XXX "员工批量录入"
 # 输出：formUuid = FORM-BATCHINPUT
 
-# Step 2：编写表格表单代码（参考 SKILL.md 完整示例代码）
+# Step 2：编写表格表单代码（参考 yida-table-form 主技能的完整示例代码）
 # 输出到 project/pages/src/employee-batch.js
 
 # Step 3：发布页面