weaver-e10-builder 1.5.12 → 1.5.13

package/skill-docs/SKILL.md

@@ -2,66 +2,23 @@
 name: weaver-e10-builder
 display_name: 泛微E10智能搭建Skill
 display_name_en: E10 Builder
-description: 泛微E10智能搭建skill v2（通用版），辅助编写泛微Ebuilder自定义应用，对应CLI版本1.5.12
-description_zh: 泛微Ebuilder低代码应用智能搭建工具 v2（通用版），辅助编写自定义应用（表单/流程/列表/动作流/权限/分组/编号等），与 e10-cli 配套使用，当前对应 CLI 版本 1.5.12。
-description_en: E10 Ebuilder low-code app builder skill v2 (general) — helps build Weaver E10 custom apps (forms/workflows/lists/actionflows/permissions/groups/numbering) via e10-cli, currently paired with CLI 1.5.12.
+description: 泛微E10智能搭建skill v2（通用版），辅助编写泛微Ebuilder自定义应用，对应CLI版本1.5.13
+description_zh: 泛微Ebuilder低代码应用智能搭建工具 v2（通用版），辅助编写自定义应用（表单/流程/列表/动作流/权限/分组/编号等），与 e10-cli 配套使用，当前对应 CLI 版本 1.5.13。
+description_en: E10 Ebuilder low-code app builder skill v2 (general) — helps build Weaver E10 custom apps (forms/workflows/lists/actionflows/permissions/groups/numbering) via e10-cli, currently paired with CLI 1.5.13.
 category: coding
-version: 1.5.12
+version: 1.5.13
 author: 泛微网络科技股份有限公司
 auto: true
 ---
 
 # Ebuilder 智能搭建 Skill
 
-## 安装与升级
+## 使用前提
 
-本 skill 需与 CLI **版本匹配**（当前对应 CLI `1.5.12`）。版本不一致时命令/文档/选项可能对不上——升级前先对齐：
-
-```shell
-e10-cli --version          # 查 CLI 版本，应与上方 description 标注一致
-
-# CLI 从 npm 装（升级先卸旧包 e10-cli，避免 bin 残留冲突）：
-** 注意 如果你使用的是workbuddy **
-先用 bash 直接删掉旧包目录（不走 npm 的删除），再让 npm 纯安装，必须指定一个有权限的工作目录作为缓存地址
-
-其他工具可以使用 npm rm -g weaver-e10-builder
-
-npm install -g weaver-e10-builder
-
-# skill 升级：先卸旧（旧名 skill-e10-cli；删掉的命令文档/actionflows 不会自动清，是"删不干净"主因），再装新
-npx -y skills remove skill-e10-cli
-npx -y skills add ./weaver-e10-builder.zip --skill -y
-```
-
-> 若 `skills remove` 无效，手动删后再 add，安装位置按工具区分：
-> - Claude Code：`rm -rf ~/.claude/skills/skill-e10-cli` → 新 skill 装到 `~/.claude/skills/weaver-e10-builder`
-> - WorkBuddy：`rm -rf ~/.workbuddy/skills/skill-e10-cli` → 新 skill 装到 `~/.workbuddy/skills/weaver-e10-builder`
-
-> 📌 **1.1.0 起发布的 skill 都是「薄指令层」扁平简化版**：只带 SKILL.md / _catalog / actionflows 指令层 / scripts（不含深目录文档树，适配 marketplace 两级目录限制）。**完整文档（references 等）随配套 CLI 的 skill-docs 分发**——npm 安装 CLI 时 postinstall 会自动同步，或装完跑一次 `e10-cli auth status` 触发同步。**因此装完 skill 后，看到目录里多出/更新 references 文档、或旧文档被清理，都是正常的同步现象**，不是装错或重复安装。
-
-## 文档与模板取用
-
-**skill 只带指令层；文档/模板随配套 CLI 包发布**（marketplace skill 包限两级目录，深目录文档树走 npm）。
-
-**文档通常已就位，无需手动拷贝**：
-- 每次会话跑 `e10-cli auth status` 时，CLI 自动探测本机已装 skill（`~/.claude/skills`、`~/.workbuddy/skills`、`~/.codex/skills`），把文档树同步进对应 skill 目录（SKILL.md 版本一致则跳过）。装好 skill 后第一次 `auth status` 即可。
-- 手动刷新：`e10-cli skill sync`（可 `--target <安装根目录>` 指定其他工具目录）。
-
-**读取**：文档在 **skill 目录内**（如 `~/.claude/skills/weaver-e10-builder/`），`references/...`、`actionflows/...`、`assets/...` 均相对该目录。按需读取对应文件（决策树命中哪个读哪个，不要一次性全部读入）。
-
-**模板拷贝**：页面模板（assets/sample）用 `e10-cli skill copy [目录]` 拷到工作区（默认当前目录，直接放出 `references/`、`actionflows/`、`assets/`）。
-
-> **读 `references/...` 提示文件不存在** → 本机 skill 文档还没同步 → 先 `e10-cli skill sync`，或确认 skill 已装后重跑 `e10-cli auth status`。
-
-> 文档版本 = CLI 版本（`e10-cli --version`）。升级 CLI 后跑一次 `skill sync`（或 auth status）即可带新文档。
-
-## 图片布局还原要求
-
-图片搭建先实际查看原图，并读取 references/form/guide-form-layout-source.md。使用 image-context 获取真实像素尺寸，imageStyles.geometry 记录实际边界及完整区域，不照抄示例列宽和行高。compile 后使用 form layout preview 实际核对原图与结构，再保存；API 回读 VERIFIED 不能作为与原图一致的结论。
-
-图片观察完成后，必须主动向用户展示主标题、字段标题、内容的字体类型、字号及 px/pt 单位、颜色、粗细、水平/垂直对齐；相同配置可合并列出，不同配置单列。字体和字号标为视觉估计，未知项明确说明，不能猜测。每个字段标题单独观察对齐：原图居中应记录 textAlign:center、verticalAlign:middle，不能仅记录主标题居中或遗漏字段标题。先执行 form layout style-review 输出复核报告，再等待用户确认或明确修改指令。用户自然语言修改由 Agent 定位到字段/单元格，交给 --overrides 逐项转换；有效项采用用户值，无法转换的单项保留图片识别值并告知，不得整组回退。只有用户已确认最终样式（或明确给出修改指令）才使用 --confirm 并重新 compile；不能代用户确认，新图片未确认不能 apply。识别结果缺少对齐时先重新查看原图，不能把平台默认左对齐当成图片识别结果。
-
-表格边线单独识别：必须记录 imageStyles.tableBorders 的正文范围及 top/right/bottom/left。存在的边线写明颜色、线宽、线型；明确无边线填 none，未识别填 unknown。原图贴边的边线也不能遗漏，左右 4% 留白不承接外框。不得把所有线默认写成 1px；分别展示外框、内部横线/竖线的粗细，按真实图片尺寸和缩放估计，让用户确认。用户明确要求表格线加粗/改色时，可用 style-review --overrides 的 gridBorderStyle 修改已声明表格内的现有线条，不改控件输入框和标题区，不凭此新增未知边线。没有表格时才可写 tableBorders:[]。缺少外框观察的新图片只能生成待审草稿，不能确认或保存。
+- **版本必须匹配**：`e10-cli --version` 应与 frontmatter 的 `version` 一致；不一致时命令/选项/文档可能对不上。
+- **鉴权**：仅在即将远程查询或写入前运行 `e10-cli auth status`；同一连续阶段不重复检查，切换系统地址、profile 或凭证后必须重新确认。
+- **文档随 CLI 分发**：读 `references/...` 提示文件不存在时，跑 `e10-cli skill sync` 或重跑 `e10-cli auth status`。
+- 安装/升级、skill 重装、WorkBuddy 注意事项 → `references/common/guide-install.md`。
 
 ## 核心理念
 
@@ -81,55 +38,30 @@ npx -y skills add ./weaver-e10-builder.zip --skill -y
 
 ## 流程类型与默认路径
 
-默认使用 **EB 表单**及应用内流程。只有需求明确要求原生流程表单、工作流程或流程中心建流程时，才切换到 `wf-form` / `workflow create-workflow` 路径。不确定且选择会改变资源归属时，再向用户确认。具体规则读取 `references/workflow/guide-workflow.md`；公文流程创建读取 `references/workflow/guide-workflow-odoc.md`，公文专属设置读取 `references/workflow/guide-workflow-odoc-setting.md`。
-
-流程体系分为 **EB 流程**和**原生工作流程**，两者的表单、资源 ID 与接口不可混用；公文流程是原生工作流程的特殊类型。固定/自由是各类流程的流转模式。
+默认使用 **EB 表单**及应用内流程。只有需求明确要求原生流程表单、工作流程或流程中心建流程时，才切换到 `wf-form` / `workflow create-workflow`；不确定且选择会改变资源归属时，先向用户确认。EB 流程与原生工作流程的表单、资源 ID、接口不可混用；公文流程是原生工作流程的特殊类型。详见 `references/workflow/guide-workflow.md`。
 
 ---
 
-## 面向人群
-
-- 本 skill 面向非编程人员。用户不懂技术，不会描述字段类型、数据关系。
-- 你要主动引导，把模糊需求翻译成精确的平台资源设计。
+## 执行流程
 
-### 工作流
-
-```
-0. 远程操作前确认环境
-   a. 仅在即将执行远程查询或写入前运行 `e10-cli auth status`；纯文档、代码、日志分析及本地 CLI 修改不鉴权
-   b. 同一连续执行阶段已确认当前环境时不重复检查；切换系统地址、profile 或凭证后必须重新确认
-   c. 需要读取配套文档但 skill 目录内不存在 `references/` 时，执行 `e10-cli skill sync`
-   d. 用户提到不同系统地址（如"在 xxx 搭建"）→ 必须切换鉴权：
-      - 已有 profile（凭证已存）：e10-cli auth profile use <name>（直接切，无需重新登录）
-      - 新环境：e10-cli auth set --eteamsid "<ETEAMSID>" --base-url <url>
-        （ETEAMSID 从浏览器 DevTools → Application → Cookies 复制；浏览器 OIDC 登录暂未实现，不要用 auth login）
+面向非编程用户：主动把模糊需求翻译成精确的资源设计。
 
-1. 判断需求复杂度
-   ├─ 涉及 2+ 模块（应用/表单/流程/页面）→ 进入步骤 2
-   └─ 简单单步操作（改字段、查数据）→ 直接执行
+0. **环境**：仅在即将远程查询/写入前跑 `e10-cli auth status`；切已有环境用 `auth profile use <name>`，新环境用 `auth set --eteamsid "<ETEAMSID>" --base-url <url>`（ETEAMSID 从浏览器 Cookies 复制，不走 `auth login`）。
+1. **判断复杂度**：涉及 2+ 模块（应用/表单/流程/页面）→ 进入规划；单步改字段、查数据 → 直接执行。
+2. **规划**（复杂需求必经）：
+   - 每张表单建表前确认布局类型 **FLOW / EXCEL**（建后不可切换）；出现布局样表时按 `references/form/guide-form-layout-planning.md` 解析。
+   - 按 `references/common/map.md` 识别资源与依赖，按 `references/common/guide-plan-template.md` 写 `plan.md`；每条要求有归属和来源，布局样表逐行保留，禁止预勾。
+   - 写完打开 `plan.md` 与用户确认（此时所有 `[ ]` 保持未勾）。
+3. **执行**：最多三段，每段结束停下确认。
+   - 段① 应用、角色、表单与视图；段② 流程与自动化；段③ 报表、菜单与页面。
+   - 以 plan 为唯一清单，按功能批次执行，逐项销号并回填真实 ID；无法完成的保留 `[ ]` 并注明原因。
+   - 布局样表：仍由 CLI 创建字段与初始布局；明确要求还原图片/XLSX 样式时读 `references/form/guide-form-layout-source.md`（先实际观察、经用户确认样式，再 compile/apply）。
 
-2. 全局资源设计（复杂需求必经）
-   a. 理解需求，不够清楚的地方反问用户
-   b. 写 plan 前扫描需求中的布局章节和表格。**每张表单建表前先向用户确认布局类型：流式(FLOW)还是表格式(EXCEL)**——平台建表后不可切换，需求没明说就不要默认。出现“表格式布局/Excel样式/按照如下布局”、`[字段名]`、标签与字段交替、分组标题或有意义的空白单元格时，按“布局样表”解析；识别方法读取 `references/form/guide-form-layout-planning.md`
-   c. 在本地写 `plan.md`：**认真阅读用户提供的实施方案/需求文档**，先参考 `references/common/map.md` 逐项识别资源、配置和依赖；遇到具体配置规则或能力边界需要明确时，再读取对应的细节文档；最后按照 `references/common/guide-plan-template.md` 写资源清单、逐表字段与布局蓝图、按功能归类的配置条目和分段销号清单。每条要求须有明确归属与来源，禁止预勾。布局样表必须逐行保存，不得仅压缩成 `group`、`singleRow` 或字段顺序
-   d. **编写完成后打开 `plan.md` 和用户确认**（此阶段 plan 里所有 `[ ]` 保持未勾——是待办清单，不是完成清单）
-   e. 用户确认后按资源依赖和功能批次**逐项执行、逐项打勾**：同类配置可连续处理多张表单或视图；每做完并核验一项，才把所属条目 `[ ]` 改 `[x]` 并填入实际 ID 或结果。**完成一条打勾一条**，禁止预勾或合并销号。
-
-3. 执行搭建（**最多分三段，每段完成停下来让用户确认，确认后才进下一段**）
-   - 以用户确认的 `plan.md` 作为唯一执行清单。资源清单保存归属与依赖；表单级、视图级配置以**功能项为外层批次、所有涉及的表单或视图为内层对象**：同一功能在全部适用对象上逐项完成后，再进入下一功能批次。按依赖解锁；每进入一个功能项，先按决策树阅读对应指南，确认方法、参数和边界，同一连续批次已读过的无需重复读取。每项完成并核对后立即回填实际 ID 或结果、销号；暂时无法完成的保留 `[ ]`，注明原因、已完成部分和所需条件，继续处理不受影响的项目。不得因操作繁琐、命令不熟悉或已有近似效果而省略配置、预勾或合并销号；每段结束前核对全部条目的处理状态。
-   - **段①：应用、角色、表单与视图。** 先建立应用和角色；按依赖完成全部表单的字段、明细与布局，读回资源及字段 ID；再按功能批次处理各表单的关联与范围、带出、公式、联动、校验、编号和权限；随后建立全部视图，按功能批次配置显示列、搜索排序、筛选统计、分组、上下级、权限、按钮和关联页签。建表时已完成的字段显示属性不重复写入。依赖流程 ID 的配置先列待办，段②回填。
-   - **段②：流程与自动化。** 按依赖准备矩阵或权责表；每个流程建立后，依次完成该流程的节点、连线、出口条件、操作者及结构排版，核对核心流转后再处理下一流程。其余节点与流程级设置、动作流可按功能批次完成，并回填段①中依赖流程 ID 的表单字段和按钮。
-   - **段③：报表、菜单与页面。** 按需求完成报表与数据集；将台账、流程发起和页面绑定到菜单并配置权限；创建配置式页面或定制页面，使用真实资源 ID 保存、发布并完成整体收尾。分批细节见 `references/common/guide-plan-template.md`。
-   - 布局样表已进入 plan 时，据蓝图组织 `fields.json`，仍由 CLI 创建字段与初始布局。普通布局沿用原路径；明确要求还原图片/XLSX 样式时，读取 `references/form/guide-form-layout-source.md`，通过源证据和 LayoutSpec 执行 `form layout extract/compile/preview/apply/verify`。布局模块只绑定已有字段，不创建或修改业务字段。字段属性、公式及归组重排全部结束后才精确保存；不在源布局保存后自动执行 initLayout。图片必须实际查看，由 Agent 输出可审阅观察，并经样式与外框确认；有未闭合映射或不支持结构时报告差异，不退回默认布局。
-   - 简单单步需求（改字段、查数据）不分段，直接执行。
-```
-
-**关键约束**：
-- plan.md 按 `references/common/guide-plan-template.md` 组织；规划阶段不调写命令，按资源依赖与功能批次执行并逐项销号；每段结束让用户确认。
-- 本服务运行于 Windows 环境，注意命令行兼容性
-- 不要多说废话，直接干活。用户等的是结果。
-- **写代码不要犹豫**，按模板直接出完整代码，写完用 `e10-cli check` 验证。错了报错再改。
-- **解析 Word 文档**：用 `e10-cli docx read <文件>` 一键转 markdown + 提取图片，**禁止自己写 python-docx 脚本**。读取后必须逐张 Read `_images/` 目录里的图片做多模态理解，**把分析结果写回 md**（替换图片占位符为实际描述，让文档完整可读）。表格若承载表单布局，还要按布局样表规则保留空白、同排和分组关系；Markdown 无法确定合并范围时才查看原 DOCX 对应页面或表格结构。
+**关键约束**
+- 配置必须通过当前 `e10-cli` 支持的命令完成；没有对应命令就如实告知，不得写临时 `.mjs` 脚本或让用户操作浏览器代做。能力边界见 `references/common/capability-boundaries.md`。
+- Windows 环境，注意命令行兼容性；少说废话，直接干活。
+- 写代码按模板直接出完整代码，写完用 `e10-cli check` 验证。
+- 解析 Word 用 `e10-cli docx read`，禁止自写 python-docx；必须逐张 Read `_images/` 图片并写回 md，布局表格保留空白、同排与合并关系。
 
 ---
 
@@ -147,16 +79,18 @@ npx -y skills add ./weaver-e10-builder.zip --skill -y
 
 | 用户关键词 | 加载文档 |
 |-----------|---------|
-| 写plan、搭建计划、plan.md、资源梳理、搭建模板、必做项清单、完整实施方案、需求映射、能力地图、跨资源依赖、规划预检 | 先读 `references/common/map.md` 识别资源、配置与依赖；必要时读对应细节文档；再按 `references/common/guide-plan-template.md` 写资源清单与功能批次 plan |
+| 写plan、搭建计划、plan.md、资源梳理、搭建模板、必做项清单、完整实施方案、需求映射、能力地图、跨资源依赖、规划预检、平台架构、Ecode、Ebuilder应用、默认台账与菜单 | 先读 `references/common/map.md` 识别资源、配置与依赖；必要时读对应细节文档；再按 `references/common/guide-plan-template.md` 写资源清单与功能批次 plan |
+| 安装、升级、装不上、skill remove、skill sync、references 文档缺失、WorkBuddy | `references/common/guide-install.md` |
+| 支不支持、能不能做、能力边界、不支持的能力 | `references/common/capability-boundaries.md` |
 | 建应用、创建应用、app、应用列表、应用详情、应用目录、app read/list/folder/edit/delete | `references/common/ref-cli-commands.md` |
 | 启用应用、停用应用、发布到前台、发布应用、取消发布、应用发布信息、前台入口、应用名多语言、应用英文名、app enable/disable/publish/unpublish/publish-info、app lang | `references/app/guide-app-publish.md`（启用→发布→改发布信息→取消发布的先后关系 + 停用会收回发布态 + 多语言整份写回） |
-| 字段联动、跨表带出赋值、FormDataLinkage、多跳带出、关联客户带出客户类型、field-linkage、Text字段赋值名称 | `references/form/guide-field-linkage.md`（三种联动对比 + 单跳/多跳 + --hops 格式 + Text 字段必须多跳取名称） |
+| 字段联动、字段值带出、HRM 属性带出、relateFrom、form relate、跨表带出赋值、FormDataLinkage、多跳带出、关联客户带出客户类型、field-linkage、Text字段赋值名称 | `references/form/guide-field-linkage.md`（按来源选择直接带出、HRM 带出或跨表查询赋值；含单跳/多跳与 --hops 格式） |
 | 函数联动、本表字段间公式赋值、赋值式公式、EXCEL 公式联动、字段自动计算、form formula-linkage、wf-form formula-linkage、流程表单函数联动、触发事件、模块字段不能作目标 | `references/form/guide-formula-linkage.md`（四套联动对比 + 赋值式语法 + 触发事件表 + 模块字段 + 流程表单那条路由 + 常见报错） |
 | 鉴权、登录、ETEAMSID、多环境、profile、切换环境 | `references/auth/guide-auth.md` |
 | 表单数据读写、getSimpleData、withDisplayNames、getFieldOptions、saveFormData、updateFormData | `references/coding/guide-form-crud.md`（前端代码） |
 | form data add、form data list、form data delete、写入数据、查询数据、删除数据 | `references/form/guide-form-data.md` |
 | 编辑回显、handleEdit、getAllData、数据回填 | `references/coding/guide-edit-backfill.md`（前端代码） |
-| 字段联动、显隐联动、条件显示、form linkage、为空/不为空条件、NULL 算子 | `references/form/guide-form-linkage.md` |
+| 显示属性联动、显隐联动、条件显示、form linkage、为空/不为空条件、NULL 算子 | `references/form/guide-form-linkage.md` |
 | 新建表单、form create、EB表单创建流程、fields.json | `references/form/guide-create-form.md`；确定具体字段参数时再读 `references/form/ref-form-fields.md` |
 | 虚拟表、虚拟表单、绑定数据源、业务表展示、数据加工结果 | `references/form/guide-virtual-form.md`；字段类型按来源映射，不按普通字段重新猜测 |
 | Excel样式、表格式布局、布局样表、布局蓝图、标签字段交替、合并单元格 | `references/form/guide-form-layout-planning.md` |
@@ -168,11 +102,9 @@ npx -y skills add ./weaver-e10-builder.zip --skill -y
 | 公文设置、正文设置、痕迹、套红、排版、文号、附件区、归档、智能助手 | `references/workflow/guide-workflow-odoc-setting.md` |
 | 流程节点、操作者、审批人、连线、添加节点、删除连线、删除节点、delete-node、节点操作者、set-operator、出口名称、link-rename、节点字段权限、field-permission | `references/workflow/guide-workflow.md` |
 | 节点独立布局、节点换布局、node layout、节点用哪套布局、流程布局、流式/表格式布局、引用节点、updateQuoteNode | `references/workflow/guide-workflow-node-layout.md` |
-| 节点校验、提交校验、node validate、智能审批规则、字面值校验、禁止提交 | `references/common/ref-cli-commands.md` |
 | 分支条件、出口条件、条件JSON、save-condition、连线条件 | `references/workflow/guide-workflow-condition.md` |
 | 动作流、跨表单、写入台账、ActionEbAdd/ActionEbUpdate/ActionEbDelete、提交事件、数据来源、requestId、按流程定位、回写数据ID、HTTP/HTTPS、DML/数仓、自定义事件、内置 MQ | `references/workflow/guide-workflow-action.md`（动作流生成走 `e10-cli actionflow generate`；`workflow action` 仅查/清/删/禁用；本表字段赋值走 `save-action`；复杂组件契约按需读取 `actionflows/SKILL.md` 及其 `references/components/`） |
 | 菜单、导航、左侧菜单、系统页面、待办、已办、流程监控、菜单改名、重命名菜单 | `references/menu/system-menus.md` |
-| 角色、角色管理、权限、成员 | `references/common/ref-cli-commands.md` |
 | 新页面、导出、路由、entry.js、asyncImport | `references/coding/guide-page-export.md`（前端代码） |
 | 写页面、页面代码、React编码、组件、entry.js模板 | `references/coding/guide-page-code.md`（前端代码） |
 | CLI命令、打包、build、import、创建应用/表单/菜单 | `references/common/ref-cli-commands.md` |
@@ -192,26 +124,12 @@ npx -y skills add ./weaver-e10-builder.zip --skill -y
 | 函数公式、字段公式、formula、DAYS、日期差、expressId、公式绑定 | `references/form/guide-form-formula-functions.md`（219 个函数速查矩阵，写 `fields.json` 的 `formula` 或 `form formula set --expression` 时查函数格式/示例；**日期差用 `DAYS(开始,结束)`**） |
 | 显示列批量设置、批量加列、列宽、列顺序、list-columns --set | `references/form/guide-list-columns.md` |
 | 顶部统计、明细统计、付款记录数、list-stats、子表计数 | `references/form/guide-list-stats.md` |
-| 分类搜索、分类筛选、按字段分类、list-search-group、选项配置、日期粒度、选项排序、统计数字 | `references/common/ref-cli-commands.md`（四类字段：选项 / 浏览框 / 日期 / 系统字段） |
 | 关联页签、关联视图、association、页签显示布局、关联数据筛选、set-filter | `references/form/guide-form-association.md` |
 | 表单按钮、button、自定义按钮、视图按钮、行上、行末下拉、右上、打开视图、打开布局、发起流程、按钮预填、按钮字段映射、action-set | `references/form/guide-form-button.md`；`references/common/ref-cli-commands.md` |
-| 表单权限、permission、数据权限 | `references/common/ref-cli-commands.md` |
 | 表单消息提醒、消息提醒、表单数据提醒、数据变动提醒、新增数据提醒、form message、提醒对象、推送渠道、IM提醒、云桥、短信提醒 | `references/form/guide-form-message.md`（表单数据新建/修改/删除时提醒人；列表是应用级、`--obj-id` 本地收口；提醒对象四类写法与同名歧义处理） |
-| 流程消息、节点消息、workflow message、消息动作流 | `references/common/ref-cli-commands.md` |
-| 编号规则、serial-mark、自动编号、流水号、年份编号、流程编号、numbering、停用编号、禁用编号、启用编号、解除编号 | `references/common/ref-cli-commands.md` |
-| 超时处理、节点超时、超时提醒、node-overtime、node timeout | `references/common/ref-cli-commands.md` |
-| 退回设置、退回方式、退回范围、node-reject、node reject | `references/common/ref-cli-commands.md` |
-| 指定流转、开一窗流转、选择下一节点、node-assign-flow | `references/common/ref-cli-commands.md` |
-| 投票、投票节点、通过率、一票否决、node vote | `references/common/ref-cli-commands.md` |
+| 流程消息、编号规则、超时处理、退回设置、指定流转、投票、机器人节点、公用流转片段、子流程、人员范围、节点菜单、流程设置、流程存档、节点校验、提交校验、角色/权限/成员 | `references/common/ref-cli-commands.md` |
 | 签署顺序、会签、非会签、竞签、或签、依次处理、抄送、operator-sign | `references/workflow/guide-workflow.md`；命令速查 `references/common/ref-cli-commands.md` |
-| 机器人节点、等待节点、流程机器人、node-robot、处理间隔 | `references/common/ref-cli-commands.md` |
-| 公用流转片段、流转片段、片段引用、segment、embed、权责表片段 | `references/common/ref-cli-commands.md` |
-| 子流程、调用子流程、主子流程、字段映射、sub-process | `references/common/ref-cli-commands.md` |
-| 人员范围、定时触发范围、plan-range、schedule-range | `references/common/ref-cli-commands.md` |
-| 节点菜单、node menu、节点操作菜单 | `references/common/ref-cli-commands.md` |
-| 流程设置、提交确认、签字意见、批量操作、setting | `references/common/ref-cli-commands.md` |
-| 流程存档、定时触发、高级设置、advanced | `references/common/ref-cli-commands.md` |
-| 编译、build、compile、代码质量检查、check、skill 文档、skill sync/copy/root | `references/common/ref-cli-commands.md` |
+| 分类搜索、表单权限、编译/build/compile/check、skill 文档/skill sync/copy/root、CLI 命令速查 | `references/common/ref-cli-commands.md`（分类搜索四类字段：选项 / 浏览框 / 日期 / 系统字段） |
 | 页面设计器、配置式页面、仪表盘、看板页、designer、page create、comp-add、工厂模板、factory、组件模板、页面布局、designer layout/save、页面版本、version revert、发布页面菜单、publish-menu、**自定义CSS、组件样式、改样式、选择器、DOM结构、样式不生效、designer css、designer dom** | `references/ebuilder-designer/guide-designer.md`（布局层）；组件配置见 `guide-designer-components.md`，**自定义 CSS 与 DOM 结构索引见 `guide-designer-css.md`**，工厂模板见 `guide-designer-factory.md`，版本见 `guide-designer-version.md`，命令速查见 `references/common/ref-cli-commands.md`「页面 & 设计器」节 |
 | HRM、矩阵、条件矩阵、部门矩阵、分部矩阵、matrix、映射表、行 id、rowId | `references/hrm/guide-matrix.md` |
 | 报表、设计器报表、EDC 报表、report build、新建报表、数据集、报表列、报表查询条件、报表权限、报表快照、report | `references/report/guide-report-build.md`（建表主干）；改已有报表见 `guide-report-modify.md`，查询条件见 `guide-report-query.md`，命令速查见 `ref-report-commands.md`；踩坑先扫 `ref-report-pitfalls.md` |
@@ -224,67 +142,13 @@ npx -y skills add ./weaver-e10-builder.zip --skill -y
 
 ---
 
-## 平台架构
-
-- **Ecode** — 存放和运行代码的平台，自定义页面在这里编码、构建、运行
-- **Ebuilder 应用** — 独立的概念，包含表单、流程等元素（与 Ecode 项目不同）
-- **默认台账与菜单入口是两件事** — 表单创建后会生成默认台账/列表视图，但当前 CLI 的 `form create` 默认不添加应用菜单；需求需要入口时使用 `--menu`，或建表后执行 `menu add-table`。不要因默认台账已存在而假定菜单入口也存在。只有图表仪表盘、跨表单聚合视图、特殊交互流程、对外公开页面等场景才需要自定义页面。
-- 所有系统交互命令均通过 `e10-cli` 执行（已全局 link）。auth 文件自动查找，也可 `--auth <path>` 指定。
-- 用户的 userId 是固定的变量 `TEAMS.currentUser.id`，系统里已支持，js 代码里可以直接写。
-
----
-
-## 平台能力边界（禁止编造）
-
-> **以下能力 CLI 不支持、平台也不支持，AI 禁止声称可以做、禁止输出操作步骤。**
-
-| 不支持的能力 | 说明 |
-|-------------|------|
-| **H5/移动端菜单** | 移动端是独立体系（不同 URL + 不同 pageId），尚未整理，禁止编造 |
-
-> 遇到用户要求以上不支持的能力时，必须明确告知"当前平台/CLI 不支持"，不要给出虚假操作步骤。
-
----
-
-## 关键数据操作速查
-
-### 表单数据 API
-
-| API | 用途 | 返回内容 |
-|-----|------|---------|
-| `getSimpleData(objId, userId)` | 读 ID、写回 formToSave | 所有特殊字段统一返回 `fieldOptionId`（纯数字串） |
-| `getAllData(objId, userId)` | 提取名称、编辑回显 | 含 `fieldOptionName`，mainTable key 是随机哈希 |
-| `withDisplayNames(rows, map)` | 表格展示：ID → 名称 | 把 Select 的 `valueKey` 映射为中文名 |
-| `getFieldOptions(fieldId, objId)` | 拿下拉选项 | `[{valueKey, name}]` |
-
-### 不同字段类型，名称来源不同
-
-| 字段类型 | getSimpleData 返回 | 展示时名称来源 |
-|---------|-------------------|--------------|
-| Text / Number / Date | `"值"` / `123` / `"2026-01-01"` | 直接展示 |
-| Select / RadioBox / CheckBox | `"1283421826353889337"`（选项 ID） | `getFieldOptions` → `withDisplayNames` 映射 |
-| **Employee** | `"2765550234448235905"`（用户 ID） | `getAllData` 的 `fieldOptionName`，**不是** getFieldOptions |
-| **Department** | `"2765550234448235905"`（部门 ID） | 同上 |
-| FileComponent | `"fileid1,fileid2"`（文件 ID 串） | 上传组件的 `name` |
+## 能力边界
 
-> 完整数据读写指南见 `references/coding/guide-form-crud.md`（前端代码），编辑回显见 `references/coding/guide-edit-backfill.md`（前端代码）。
+> 不支持的能力、以及「CLI 没有命令时怎么办」的判定方式 → `references/common/capability-boundaries.md`。禁止声称平台/CLI 支持实际不支持的能力，禁止用临时脚本或浏览器操作绕行。
 
 ---
 
 ## 页面编码
 
-> **页面是搭建流程的最后一步。** 写页面代码前，确保应用、表单、流程都已建好。
-
-**应用内建页优先用设计器 Ebuilder 页面（配置式）**——`page create` → `designer comp-add --template`（28 个内置工厂模板）→ 绑数据 → `designer save` → `designer unlock` → `page publish-menu`，全程不写前端代码；详见 `references/ebuilder-designer/guide-designer.md`。**只有设计器组件无法满足的深度定制交互（特殊交互逻辑、复杂跨表联动 UI）才用 Ecode React 编码**。
-
-页面编码规范、entry.js 模板、@weapp/ui 组件清单、编译规则、代码质量检查清单 → 详见 `references/coding/guide-page-code.md`（前端代码）。
-
----
-
-## 快速参考
+页面是搭建的最后一步，动手前确保应用、表单、流程已建好。优先用设计器配置式页面（`page create` → `designer comp-add --template` → 绑数据 → `designer save` → `page publish-menu`），详见 `references/ebuilder-designer/guide-designer.md`；只有设计器无法满足的深度定制才用 Ecode React，编码规范与模板见 `references/coding/guide-page-code.md`。
 
-- 入口注册 + 新页面导出 → `references/coding/guide-page-export.md`（前端代码）
-- 流程 URL 透传、预填 → `references/workflow/guide-workflow.md`
-- 编译约束（var 声明、不支持的语法）→ `references/coding/ref-compile-rules.md`（前端代码）
-- CLI 命令速查 → `references/common/ref-cli-commands.md`
-- 组件完整索引 → `_catalog.md`

package/skill-docs/_catalog.md

@@ -58,7 +58,9 @@
 |---------------|---------|
 | CLI、命令、打包、build、import、创建应用、创建表单、菜单、project、form create、app create、matrix | `references/common/ref-cli-commands.md` |
 | 应用发布、启用应用、停用应用、发布到前台、取消发布、应用发布信息、前台入口、应用名多语言、app enable/disable/publish/unpublish/publish-info、app lang | `references/app/guide-app-publish.md` |
-| 完整实施方案、规划能力地图、资源依赖、需求映射、plan 前预检 | `references/common/map.md`，随后使用 `references/common/guide-plan-template.md` |
+| 完整实施方案、规划能力地图、资源依赖、需求映射、plan 前预检、平台架构、Ecode、默认台账与菜单 | `references/common/map.md`，随后使用 `references/common/guide-plan-template.md` |
+| 安装、升级、装不上、skill 重装、skill remove、skill sync、references 文档缺失、WorkBuddy | `references/common/guide-install.md` |
+| 能力边界、支不支持、能不能做、不支持的能力 | `references/common/capability-boundaries.md` |
 | 接口文档导入、Postman、系统接口、连接器接口、createSystemInterfaceByAi、接口批量创建 | `references/esb-interface/guide-import.md` |
 | 系统菜单、内置菜单、挂系统页面到菜单、menuUrl、pageType、工作流菜单、独立页面菜单、菜单改名、menu rename、重命名菜单、找不到菜单、二级菜单、子菜单、父菜单、菜单层级、menu add-table --parent、menu add-start --parent | `references/menu/system-menus.md` + `references/common/ref-cli-commands.md` |
 | 编译、语法、报错、不支持、babel、打包、var、const、let、es2015、stage-2 | `references/coding/ref-compile-rules.md`（前端代码） |

package/skill-docs/references/coding/guide-page-code.md

@@ -217,6 +217,8 @@ if (editingId) {
 | **资源统一用 `${appRes}/相对路径`**（如 `${appRes}/logo.png`） | `${appRes}` 是平台模板变量，导入后自动替换成正式静态地址。**禁止**写 `./resources/...`、`../resources/...`、`/resources/...`，发布后必 404。 |
 | **禁止在线资源** | 不要 `loadjs('http(s)://...')`、CDN、外链脚本——平台不加载外网资源。确需第三方脚本：先下载进项目，再按上一条 `${appRes}` 引用。 |
 | **禁止在 JS 里 `import` CSS** | ecode 没有 CSS 模块解析，`import './x.css'` 不会生效，样式静默丢失。少量样式用内联 style；独立 CSS 文件的打包规则见 `ref-compile-rules.md`「E10 打包与平台加载规则」。 |
+| **HTML 原型：样式严格 100% 还原** | 用户提供 HTML 原型时，页面样式必须与原型严格一致（布局、间距、字号、颜色、圆角、边框、层级），不得用平台默认样式近似代替；交付前逐项对照原型自检。 |
+| **HTML 复刻：样式写进代码，不建独立 CSS 文件** | 用户提供 HTML/设计稿并要求完整复刻时，样式全部写在组件代码里（内联 `style` / 代码内样式对象），**不要生成独立 `.css` 文件**——拆出去不保证被加载，复刻会静默丢样式。 |
 | **全部用 ESM `import` / `export`，禁止 `module.exports`** | 平台按模块加载，CommonJS 导出解析不到。 |
 | **只用白名单组件及其文档化 props** | 拿不准的组件 / prop / 图标名，先查 `references/components/`，不要凭记忆从 `@weapp/ui` 编造。 |
 | **不碰平台组件内部** | 不读 `props.children[...]`（含可选链写法）、不依赖内部 class / `weId` 段、不做全局无条件 `regOvComponent` 复写——内部结构不是稳定 API，平台升级即坏。 |

package/skill-docs/references/coding/ref-compile-rules.md

@@ -112,6 +112,8 @@ e10-cli project import <projectId> .target/xxx.zip --main-url /sp/custom/...
 ### CSS 规则
 
 - **禁止在 JS 里 `import` CSS**：ecode 无 CSS 模块解析，写了必丢、发布后无样式。
+- **用户提供 HTML 原型时，页面样式严格 100% 还原**（布局、间距、字号、颜色、圆角、边框、层级），不用平台默认样式近似代替。
+- **完整复刻用户提供的 HTML 时，样式一律内联进代码**（内联 style / 代码内样式对象），不要拆成独立 `.css` 文件：拆出去既不保证加载，也容易与页面结构脱节，复刻效果走样。
 - 少量页面样式用内联 style；确需独立 `.css` 文件时，确认它在 `build.json` 的 codes 里（首次自动生成时 `.css` 会登记为 `y`；文件是后加的要自行补登记），否则平台不合并加载。
 - 业务 CSS 选择器挂在页面根容器下，避免裸 `.类名`、`body`、`:root` 或平台内部 class 污染全局。
 

package/skill-docs/references/common/capability-boundaries.md

@@ -0,0 +1,15 @@
+# 平台与 CLI 能力边界
+
+> 下列能力 **CLI 不支持、平台也不支持**。不要声称可以做，也不要输出操作步骤；直接告知用户「当前平台/CLI 不支持」。
+
+| 不支持的能力 | 说明 |
+|---|---|
+| H5 / 移动端菜单 | 移动端是独立体系（不同 URL + 不同 pageId），尚未整理，禁止编造 |
+
+## 判断「CLI 支不支持」的正确方式
+
+1. 先查 `references/common/ref-cli-commands.md` 的对应命令与参数；
+2. 再跑 `e10-cli <命令> --help` 确认当前版本有没有该选项；
+3. 仍无法确认时，问用户或如实说明「当前版本没有对应命令」。
+
+**禁止绕行**：不要为了完成配置临时编写 `.mjs` 脚本调用内部接口，也不要让用户直接操作浏览器或设计器代替命令；确认没有命令时，保留该项未完成状态并说明影响。

package/skill-docs/references/common/guide-install.md

@@ -0,0 +1,44 @@
+# 安装、升级与文档同步
+
+## 版本必须匹配
+
+skill 与 CLI 的版本要一致（见 SKILL.md frontmatter 的 `version`）。版本不一致时，命令、选项和文档可能对不上。
+
+```bash
+e10-cli --version          # 应与 SKILL.md 标注的版本一致
+npm install -g weaver-e10-builder
+```
+
+## CLI 升级
+
+- 一般工具：先 `npm rm -g weaver-e10-builder` 卸掉旧包，再重新安装，避免 bin 残留冲突。
+- WorkBuddy：先直接用 bash 删除旧包目录（不走 npm 删除），再用 npm 纯安装，并指定一个有权限的工作目录作为缓存地址。
+
+## skill 安装 / 升级
+
+先卸旧（旧名 `skill-e10-cli`），再装新：
+
+```bash
+npx -y skills remove skill-e10-cli
+npx -y skills add ./weaver-e10-builder.zip --skill -y
+```
+
+`skills remove` 无效时手动删除后再 add：
+
+- Claude Code：`rm -rf ~/.claude/skills/skill-e10-cli` → 新 skill 装到 `~/.claude/skills/weaver-e10-builder`
+- WorkBuddy：`rm -rf ~/.workbuddy/skills/skill-e10-cli` → 新 skill 装到 `~/.workbuddy/skills/weaver-e10-builder`
+
+## 文档树同步
+
+1.1.0 起发布的 skill 是**薄指令层**：只带 SKILL.md、`_catalog.md`、actionflows 指令层和 scripts，不含深目录文档树（适配 marketplace 两级目录限制）。完整文档随配套 CLI 的 `skill-docs` 分发。
+
+- 每次 `e10-cli auth status` 会自动探测本机已装 skill（`~/.claude/skills`、`~/.workbuddy/skills`、`~/.codex/skills`）并同步文档；版本一致则跳过。
+- 手动刷新：`e10-cli skill sync`；可 `--target <安装根目录>` 指定其他工具目录。
+- 装完 skill 后看到 references 文档多出/更新、旧文档被清理，都是正常的同步现象，不是装错或重复安装。
+- 读 `references/...` 提示文件不存在 → 先 `e10-cli skill sync`，或确认 skill 已装后重跑 `e10-cli auth status`。
+
+## 文档读取与模板拷贝
+
+- 文档在 skill 目录内（如 `~/.claude/skills/weaver-e10-builder/`），`references/...`、`actionflows/...`、`assets/...` 均相对该目录。
+- 按决策树命中哪个读哪个，不要一次性全部读入。
+- 页面模板用 `e10-cli skill copy [目录]` 拷到工作区（默认当前目录，放出 `references/`、`actionflows/`、`assets/`）。