openyida 2026.7.8 → 2026.7.10

package/yida-skills/skills/large-file-write/references/write-patterns.md

@@ -6,10 +6,10 @@
 
 适用于一次性写入大块内容（>100 行）。
 
-### Step 1：用 `create_file` 工具创建临时内容脚本
+### Step 1：用结构化文件写入工具创建临时内容脚本
 
 ```js
-// /tmp/content-payload.js
+// <projectRoot>/.cache/openyida/<任务名>/scripts/content-payload.js
 const fs = require('fs');
 const content = `
 // 这里放你要写入的大块内容
@@ -25,7 +25,7 @@ console.log('写入完成，行数：', content.split('\n').length);
 ### Step 2：执行脚本
 
 ```bash
-node /tmp/content-payload.js
+node .cache/openyida/<任务名>/scripts/content-payload.js
 ```
 
 ### Step 3：验证写入结果
@@ -42,7 +42,7 @@ tail -5 /path/to/target.js
 适用于向已有文件末尾追加大块内容。
 
 ```js
-// /tmp/append-payload.js
+// <projectRoot>/.cache/openyida/<任务名>/scripts/append-payload.js
 const fs = require('fs');
 const appendContent = `
 // 追加的内容
@@ -57,22 +57,23 @@ console.log('追加完成');
 执行：
 
 ```bash
-node /tmp/append-payload.js
+node .cache/openyida/<任务名>/scripts/append-payload.js
 ```
 
 ---
 
-## 模式三：使用通用写入脚本（stdin 模式）
+## 模式三：使用通用写入脚本（content-file 模式）
 
-适用于通过管道传入内容的场景。
+适用于内容已经由结构化文件写入工具保存为独立文件的场景。
 
 ```bash
 node ~/.agents/skills/large-file-write/scripts/write.js \
   --file /path/to/target.js \
+  --content-file .cache/openyida/<任务名>/scripts/content.txt \
   --mode write   # 或 append
 ```
 
-然后通过 stdin 输入内容（Ctrl+D 结束）。
+不要通过 shell 管道、heredoc 或重定向临时生成 `content.txt`；先使用 create_file / Write / file edit tool 创建它。
 
 ---
 
@@ -80,10 +81,7 @@ node ~/.agents/skills/large-file-write/scripts/write.js \
 
 **不要**用 PowerShell 把大 JSX/JS 文件转成 JSON patch：
 
-```powershell
-# 禁止：会把整个文件读入内存并生成转义后的大字符串
-Get-Content -Raw project\pages\src\vendor-section.oyd.jsx | ConvertTo-Json > vendor-patch.json
-```
+禁止把整个文件读入内存再重定向成 JSON patch，例如 `Get-Content -Raw ... | ConvertTo-Json` 这类流程会制造巨大中间数据，也违反“命令输入文件由结构化写入工具创建”的约定。
 
 这种写法会同时持有原始源码、JSON 转义字符串、管道对象和输出缓冲。对包含 vendor、base64、压缩代码的 `.oyd.jsx` 文件，内存可能被放大到数十 GB。
 
@@ -106,7 +104,7 @@ fs.writeFileSync(target, next, 'utf8');
 当单次内容超过 300 行时，拆分为多个脚本分段写入：
 
 ```js
-// /tmp/part1-payload.js — 写入第一段（文件头 + 前半部分）
+// <projectRoot>/.cache/openyida/<任务名>/scripts/part1-payload.js — 写入第一段（文件头 + 前半部分）
 const fs = require('fs');
 const part1 = `
 // === 第一段内容 ===
@@ -118,7 +116,7 @@ console.log('第一段写入完成');
 ```
 
 ```js
-// /tmp/part2-payload.js — 追加第二段
+// <projectRoot>/.cache/openyida/<任务名>/scripts/part2-payload.js — 追加第二段
 const fs = require('fs');
 const part2 = `
 // === 第二段内容 ===
@@ -145,5 +143,5 @@ tail -5 /path/to/target.js
 |---------|------|---------|
 | 文件为空 | 模板字符串反引号未闭合 | 检查 `` ` `` 是否成对，特殊字符是否转义 |
 | 内容截断 | 单次 create_file 超过 token 限制 | 拆分为多个脚本分段写入 |
-| 权限拒绝 | 目标路径无写权限 | 改用 `/tmp/` 路径，或检查目录权限 |
+| 权限拒绝 | 目标路径无写权限 | 检查目标目录权限；OpenYida 业务文件仍应留在 project 工作目录内 |
 | node 命令未找到 | Node.js 未安装 | 先安装 Node.js ≥ 16 |

package/yida-skills/skills/large-file-write/scripts/write.js

@@ -8,9 +8,9 @@
  *   node write.js --file <目标文件路径> [--mode write|append] [--encoding utf8]
  *
  * 内容来源（三选一）：
- *   1. stdin：echo "content" | node write.js --file out.js
- *   2. --content-file <临时内容文件>：node write.js --file out.js --content-file /tmp/content.txt
- *   3. --payload <JS文件>：node write.js --payload /tmp/payload.js（payload 文件自行调用 fs 写入）
+ *   1. stdin：交互式输入或由调用方传入标准输入
+ *   2. --content-file <内容文件>：node write.js --file out.js --content-file .cache/openyida/task/content.txt
+ *   3. --payload <JS文件>：node write.js --payload .cache/openyida/task/payload.js（payload 文件自行调用 fs 写入）
  */
 
 const fs = require('fs');
@@ -53,15 +53,15 @@ large-file-write - 大文件可靠写入工具
   --help                 显示帮助
 
 示例：
-  # 从 stdin 写入
-  echo "hello world" | node write.js --file /tmp/out.txt
+	  # 从 stdin 写入
+	  node write.js --file .cache/openyida/task/out.txt
 
-  # 从内容文件写入
-  node write.js --file /tmp/out.js --content-file /tmp/content.txt --verify
+	  # 从内容文件写入
+	  node write.js --file .cache/openyida/task/out.js --content-file .cache/openyida/task/content.txt --verify
 
-  # 执行自包含 payload 脚本
-  node write.js --payload /tmp/my-payload.js
-`);
+	  # 执行自包含 payload 脚本
+	  node write.js --payload .cache/openyida/task/my-payload.js
+	`);
   process.exit(0);
 }
 

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

@@ -6,13 +6,17 @@ 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 命令输入文件
 
 ## 严格要求 (MUST DO)
 
@@ -20,11 +24,27 @@ description: 宜搭完整应用开发技能。从零到一搭建完整宜搭应
 - 按照本文档的流程编排顺序执行，不要跳步
 - 每个关键 ID 创建后立即记录到 `.cache/<项目名>-schema.json`
 - 业务需求记录到 `prd/<项目名>.md`
-- 临时字段配置、流程配置、报表配置、导入数据和一次性执行脚本统一写入 `.cache/openyida/`，不要写到仓库根目录
+- 临时字段配置、流程配置、报表配置、连接器配置、导入数据和一次性执行脚本统一用结构化文件写入工具创建到 `<projectRoot>/.cache/openyida/<项目名或任务名>/`；从 workspace 根执行命令时传 `project/.cache/...`，从 OpenYida project 工作目录执行时传 `.cache/...`；不要写到仓库根目录或系统临时目录
 - 首次生成完整应用后，必须基于业务信息架构整理导航顺序：面向决策者的总览/驾驶舱看板作为门面靠前，数据录入/明细表单在后；同级多个专题看板按业务优先级排，不要把所有自定义页面无脑堆最前
 - 导航整理完成后，若应用含表单，默认向核心表单灌入 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 可视化页面")`。
+
 ## 适用场景
 
 用户说"帮我搭建一个完整应用"、"从零开始创建系统"、"一句话生成应用"时使用。
@@ -47,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 技能选择合适的信息密度）
@@ -70,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`。
 
 ### 使用模板文件确保一次性成功
 
@@ -84,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。
 
 **代码生成前必须**：
 
@@ -101,9 +126,9 @@ description: 宜搭完整应用开发技能。从零到一搭建完整宜搭应
 ```
 用户需求
     │
-    ├── 纯展示 / 静态内容 → 跳过 Step 5（无需创建表单）
+    ├── 纯展示 / 静态内容 → 跳过 Step 3（无需创建表单）
     │
-    └── 需要收集 / 存储数据 → Step 5 创建表单
+    └── 需要收集 / 存储数据 → Step 3 创建表单
 ```
 
 ### 决策 2：是否需要审批流程？
@@ -111,9 +136,9 @@ description: 宜搭完整应用开发技能。从零到一搭建完整宜搭应
 ```
 表单创建后
     │
-    ├── 无审批需求 → 直接进入 Step 6 编写代码
+    ├── 无审批需求 → 直接进入 Step 4 创建页面 / Step 6 编写代码
     │
-    └── 有审批需求 → 调用 yida-create-process 配置流程后再编写代码
+    └── 有审批需求 → 加载 yida-create-process 配置流程后再编写代码
 ```
 
 ### 决策 3：是否需要数据可视化报表？
@@ -121,9 +146,9 @@ description: 宜搭完整应用开发技能。从零到一搭建完整宜搭应
 ```
 应用功能需求
     │
-    ├── 标准统计报表 → 调用 yida-report 创建原生报表
+    ├── 标准统计报表 → 加载 yida-report 创建原生报表
     │
-    └── 高级 ECharts 大屏 → 先 yida-report 创建数据源，再 yida-chart 创建可视化页面
+    └── 高级 ECharts 大屏 → 先加载 yida-report 创建数据源，再加载 yida-chart 创建可视化页面
 ```
 
 ### 决策 4：corpId 一致性检查（创建页面前必须执行）
@@ -146,7 +171,7 @@ description: 宜搭完整应用开发技能。从零到一搭建完整宜搭应
 
 ### Step 1：创建应用
 
-调用 `yida-create-app` 技能，创建宜搭应用并获取 `appType`：
+进入本阶段前调用 `use_skill("yida-create-app", "创建应用并获取 appType")`，创建宜搭应用并获取 `appType`：
 
 ```bash
 openyida create-app "<应用名称>" "[描述]"
@@ -154,8 +179,6 @@ openyida create-app "<应用名称>" "[描述]"
 
 **输出**：`appType`（如 `APP_XXXXXX`），自动写入 prd 文档的应用配置表。
 
-> 📖 详见 [`skills/yida-create-app/SKILL.md`](../yida-create-app/SKILL.md)
-
 ---
 
 ### Step 2：需求分析 → 写入 prd 文档
@@ -258,25 +281,13 @@ 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 3：创建表单（按需）
 
-### Step 4：创建表单（按需）
+**当页面需要收集/存储数据时**，进入本阶段前调用 `use_skill("yida-create-form-page", "设计并创建表单字段结构")`。
 
-**当页面需要收集/存储数据时**，调用 `yida-create-form-page` 技能。
+#### 3.1 定义字段，写入 `<projectRoot>/.cache/openyida/<项目名或任务名>/xxx-fields.json`
 
-#### 4.1 定义字段，写入 `.cache/openyida/<项目名>/xxx-fields.json`
+使用 create_file / Write / file edit tool 创建字段定义文件；不要用 shell heredoc 或重定向写 JSON。若从 workspace 根执行命令，路径写作 `project/.cache/openyida/<项目名或任务名>/xxx-fields.json`。
 
 ```json
 [
@@ -287,15 +298,15 @@ openyida create-page <appType> "<页面名称>" [--mode dashboard]
 ]
 ```
 
-#### 4.2 创建表单
+#### 3.2 创建表单
 
 ```bash
-openyida create-form create <appType> "<表单名称>" .cache/openyida/<项目名>/xxx-fields.json
+openyida create-form create <appType> "<表单名称>" .cache/openyida/<项目名或任务名>/xxx-fields.json
 ```
 
 **输出**：`formUuid` 和各字段的 `fieldId`（如 `textField_xxxxxxxx`）。
 
-#### 4.3 将 Schema ID 写入 `.cache/<项目名>-schema.json`
+#### 3.3 将 Schema ID 写入 `.cache/<项目名>-schema.json`
 
 ```json
 {
@@ -317,26 +328,37 @@ 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> <流程定义文件>
+openyida create-process <appType> --formUuid <formUuid> .cache/openyida/<项目名或任务名>/process-definition.json
 ```
 
-> 📖 详见 [`skills/yida-create-process/SKILL.md`](../yida-create-process/SKILL.md)
+流程定义文件先用结构化文件写入工具创建；从 workspace 根执行命令时路径加 `project/` 前缀。
 
 ---
 
 ### 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
 
@@ -360,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]
@@ -374,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> <总览看板> <专题看板...> <核心表单...>
@@ -388,26 +406,23 @@ 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-json '{"selectField_xxx":"双11","dateField_xxx":1730995200000,"numberField_xxx":1200000}'
+openyida data create form <appType> <formUuid> --data-file .cache/openyida/<项目名或任务名>/data-import/sample-record-1.json
 ```
 
 **要点**：
+- 示例数据 JSON 先用结构化文件写入工具创建到 `<projectRoot>/.cache/openyida/<项目名或任务名>/data-import/`；从 workspace 根执行命令时路径加 `project/` 前缀。
 - `DateField`/`CascadeDateField` 必须用 13 位毫秒时间戳，不要传 `YYYY-MM-DD`。
 - 字段 ID 从 `.cache/<项目名>-schema.json` 或 `openyida get-schema` 获取，不能猜。
 - 灌完执行 `openyida data query form <appType> <formUuid>` 抽查至少 1 条，确认 `formData` 字段有实际值。
 - 用户明确说"不要示例数据 / 不要 mock 数据"时才跳过。
 
-> 📖 详见 [`skills/yida-data-management/SKILL.md`](../yida-data-management/SKILL.md)
-
 ---
 
 ### Step 10：输出访问链接并用系统浏览器打开
@@ -421,8 +436,8 @@ openyida data create form <appType> <formUuid> --data-json '{"selectField_xxx":"
 | 步骤 | 产出 | 用途 |
 |------|------|------|
 | create-app | `appType` | 所有后续命令的必填参数 |
-| create-page | `pageId` (即 `formUuid`) | 发布自定义页面时指定目标页面 |
 | create-form | `formUuid` + `fieldId` | 自定义页面代码中调用表单 API |
+| create-page | `pageId` (即 `formUuid`) | 发布自定义页面时指定目标页面 |
 | get-schema | `fieldId` 列表 | 公式字段、权限配置、数据查询时引用 |
 
 **存储约定**：
@@ -431,7 +446,7 @@ openyida data create form <appType> <formUuid> --data-json '{"selectField_xxx":"
 
 **测试数据/修数脚本约定**：
 - 一次性造数、旧数据修正、字段迁移可以使用 Python 或 JS，选择更快更清晰的实现即可；不要求为了“宜搭”强行写 JS。
-- 脚本放在 `.cache/openyida/scripts/` 下，导入数据放在 `.cache/openyida/data-import/` 下；执行前先 `openyida get-schema` / `openyida data query` 确认字段和记录，批量更新单次不超过 30 条。
+- 脚本放在 `<projectRoot>/.cache/openyida/<项目名或任务名>/scripts/` 下，导入数据放在 `<projectRoot>/.cache/openyida/<项目名或任务名>/data-import/` 下，均由结构化文件写入工具创建；执行前先 `openyida get-schema` / `openyida data query` 确认字段和记录，批量更新单次不超过 30 条。
 - 脚本可以通过 `openyida data ...` 命令或宜搭官方接口执行，但字段 ID、formInstId、appType 必须来自真实查询结果，不能猜。
 
 ---
@@ -441,39 +456,39 @@ openyida data create form <appType> <formUuid> --data-json '{"selectField_xxx":"
 ### 场景 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` 把品牌色解析成真实色值再喂进去。** 语义色（成功/警告/错误）保持固定，不随主题变。
 
@@ -87,9 +87,11 @@ openyida publish project/pages/src/<页面名>.canvas.jsx <appType> <formUuid>
 #    扩展名不规范但确为 Canvas 源码时，显式加 --canvas。
 
 # 6. 发布后回读 Schema 验收：确认组件树存在 YidaCodeCanvas，且 runtimeCode 非空
-openyida get-schema <appType> <formUuid> > .cache/openyida/<页面名>-schema.json
+openyida get-schema <appType> <formUuid>
 ```
 
+如需保存完整 Schema，使用 create_file / Write / file edit tool 创建 `<projectRoot>/.cache/openyida/<页面名或任务名>/<页面名>-schema.json`；从 workspace 根执行后续命令时路径加 `project/` 前缀。不要把 `openyida` stdout 通过 shell 重定向保存成 JSON。
+
 ## 与其他技能分工
 
 | 需求 | 使用 |

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-canvas-upgrade/SKILL.md

@@ -20,7 +20,7 @@ description: 将 OpenYida 原普通自定义页面链路升级/迁移为宜搭 C
 | --- | --- |
 | 登录态只读验证 | `openyida env --json` + `openyida login --check-only --json` |
 | 原页面源码 | 找到 `.oyd.jsx` / `.jsx` 源文件；不要只看 dist 编译产物 |
-| 目标页面 Schema | `openyida get-schema <appType> <formUuid> > .cache/openyida/canvas-upgrade/<name>-schema.json` |
+| 目标页面 Schema | 先执行 `openyida get-schema <appType> <formUuid>`，再用 create_file / Write / file edit tool 按需保存到 `<projectRoot>/.cache/openyida/canvas-upgrade/<name>-schema.json`；不要用 shell 重定向 |
 | Code Canvas 发布能力 | 已内置：产出的 `.canvas.jsx` 用 `openyida publish <源文件> <appType> <formUuid>` 即自动走 Canvas 链路（`.canvas.jsx` 扩展名识别，CLI 本地用 Babel 编译出 `runtimeCode` + `importedModules` 并写 `YidaCodeCanvas` Schema），无需设计器手工添加 |
 | 原页面数据依赖 | 列出 `this.utils.yida.*`、`this.dataSourceMap.*`、连接器、外部脚本、全局变量 |
 

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

@@ -60,8 +60,8 @@ openyida login --check-only --json
 # Step 2: 准备原生报表数据源
 # 无原生报表时先使用 yida-report 创建；已有 URL 时解析 appType/formUuid
 
-# Step 3: 获取报表 Schema，输出到文件避免终端截断
-openyida get-schema <appType> <reportFormUuid> > .cache/report-schema-output.txt 2>&1
+# Step 3: 获取报表 Schema；需要文件时用 CLI 输出目录或结构化文件写入工具保存 stdout
+openyida get-schema <appType> --all --keyword <报表名称> --output-dir .cache/openyida/<项目名或任务名>/schemas
 
 # Step 4: 解析 cid / className / dataSetKey / filterKey / cname
 
@@ -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 时必须读取本文档。
 
 ---
 
@@ -25,7 +25,7 @@ Step 1: 从 URL 中解析 appType 和 formUuid
 Step 2: 执行 openyida env 检测环境和登录态
     ↓
 Step 3: 执行 openyida get-schema <appType> <formUuid> 获取现有报表 Schema
-    ↓  命令：openyida get-schema <appType> <formUuid> > .cache/report-schema-output.txt 2>&1
+    ↓  需要文件时，使用结构化文件写入工具保存 stdout，或用 --all --keyword --output-dir 输出到 project .cache
     ↓
 Step 4: 解析 Schema，提取每个图表组件的 5 个核心参数
     ↓  详见下方「Schema 解析规范」
@@ -58,15 +58,14 @@ Step 11: 输出 ECharts 自定义页面访问链接
 
 ## Schema 获取注意事项
 
-1. **必须将输出重定向到文件**：报表 Schema 通常非常大（数千行），终端输出会被截断
+1. **不要用 shell 重定向保存 Schema**：报表 Schema 通常非常大（数千行），需要文件时用 CLI 自带输出目录或 agent 结构化文件写入工具
    ```bash
-   openyida get-schema <appType> <formUuid> > .cache/report-schema-output.txt 2>&1
+   openyida get-schema <appType> --all --keyword <报表名称> --output-dir .cache/openyida/<项目名或任务名>/schemas
    ```
 
-2. **提取 JSON 部分**：输出文件包含前缀日志信息，需要从 `{` 开始的行提取纯 JSON
+2. **单表回读时保存 stdout**：如必须按 `formUuid` 回读，先执行命令，再用 create_file / Write / file edit tool 保存纯 JSON 到 `<projectRoot>/.cache/openyida/<项目名或任务名>/report-schema.json`
    ```bash
-   grep -n "^{" .cache/report-schema-output.txt
-   tail -n +<行号> .cache/report-schema-output.txt > .cache/report-schema.json
+   openyida get-schema <appType> <formUuid> --json
    ```
 
 ---

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 页面样式时参考本文档。
 
 ---