weaver-e10-builder 1.5.15 → 1.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "weaver-e10-builder",
-  "version": "1.5.15",
+  "version": "1.6.0",
   "description": "Eteams/Ebuilder CLI — 泛微 OA 命令行工具",
   "type": "module",
   "files": [

package/skill-docs/SKILL.md

@@ -2,11 +2,11 @@
 name: weaver-e10-builder
 display_name: 泛微E10智能搭建Skill
 display_name_en: E10 Builder
-description: 泛微E10智能搭建skill v2（通用版），辅助编写泛微Ebuilder自定义应用，对应CLI版本1.5.15
-description_zh: 泛微Ebuilder低代码应用智能搭建工具 v2（通用版），辅助编写自定义应用（表单/流程/列表/动作流/权限/分组/编号等），与 e10-cli 配套使用，当前对应 CLI 版本 1.5.15。
-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.15.
+description: 泛微E10智能搭建skill v2（通用版），辅助编写泛微Ebuilder自定义应用，对应CLI版本1.6.0
+description_zh: 泛微Ebuilder低代码应用智能搭建工具 v2（通用版），辅助编写自定义应用（表单/流程/列表/动作流/权限/分组/编号等），与 e10-cli 配套使用，当前对应 CLI 版本 1.6.0。
+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.6.0.
 category: coding
-version: 1.5.15
+version: 1.6.0
 author: 泛微网络科技股份有限公司
 auto: true
 ---
@@ -49,16 +49,18 @@ auto: true
 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` 解析。
+   - 先写 **0.1 方案澄清与可行性预检**：需求理解、待确认项（问题/选项/建议/影响/决策）、可做/部分可做/做不到及证据等级、验收判据；按 `references/common/capability-boundaries.md` 判定，不得把「CLI 没暴露」写成「平台不支持」。
+   - 每张表单建表前确认初始布局类型 **FLOW / EXCEL**（该初始类型建后不可切换；已有表单可另建不同类型的视图布局）；出现布局样表时按 `references/form/layout/planning.md` 解析。
    - 按 `references/common/map.md` 识别资源与依赖，按 `references/common/guide-plan-template.md` 写 `plan.md`；每条要求有归属和来源，布局样表逐行保留，禁止预勾。
-   - 写完打开 `plan.md` 与用户确认（此时所有 `[ ]` 保持未勾）。
+   - 写完打开 `plan.md` 与用户**一次集中确认**（此时所有 `[ ]` 保持未勾；只有新的实质业务选择才再次询问）。
 3. **执行**：最多三段，每段结束停下确认。
    - 段① 应用、角色、表单与视图；段② 流程与自动化；段③ 报表、菜单与页面。
    - 以 plan 为唯一清单，按功能批次执行，逐项销号并回填真实 ID；无法完成的保留 `[ ]` 并注明原因。
-   - 布局样表：仍由 CLI 创建字段与初始布局；明确要求还原图片/XLSX 样式时读 `references/form/guide-form-layout-source.md`（先实际观察、经用户确认样式，再 compile/apply）。
+   - 0.1 中 P0/阻断项未解决、或用户未确认前不进入写入；执行中出现新的实质业务选择才再次确认。
+   - 布局样表：仍由 CLI 创建字段与初始布局；明确要求还原图片/XLSX 样式时读 `references/form/layout/source-restoration.md`（先实际观察、经用户确认样式，再 compile/apply）。
 
 **关键约束**
-- 配置必须通过当前 `e10-cli` 支持的命令完成；没有对应命令就如实告知，不得写临时 `.mjs` 脚本或让用户操作浏览器代做。能力边界见 `references/common/capability-boundaries.md`。
+- 配置必须通过当前 `e10-cli` 支持的命令完成；没有对应命令就如实告知，不得写临时 `.mjs` 脚本或让用户操作浏览器代做。能力边界见 `references/common/capability-boundaries.md`；结论必须带证据等级（实测/回读字段/命令表/未证实）。
 - Windows 环境，注意命令行兼容性；少说废话，直接干活。
 - 写代码按模板直接出完整代码，写完用 `e10-cli check` 验证。
 - 解析 Word 用 `e10-cli docx read`，禁止自写 python-docx；必须逐张 Read `_images/` 图片并写回 md，布局表格保留空白、同排与合并关系。
@@ -79,10 +81,10 @@ auto: true
 
 | 用户关键词 | 加载文档 |
 |-----------|---------|
-| 表单布局源码、表单级 ecode、表单 JS 代码块、JSSDK、代码校验、明细代码汇总、字段事件脚本、表单组件复写 | 先读 `references/code-block/guide-code-block.md` 选代码层级和 CLI 写入命令，再按效果读取该目录对应 JSSDK 专题；**布局源码 ecode 由 CLI 编码，不要手改 `sourceCode.ecode`；手工调接口必须用 `encodeURI`，不能用 `encodeURIComponent`（设计器用 `decodeURI` 读取）** |
-| 写plan、搭建计划、plan.md、资源梳理、搭建模板、必做项清单、完整实施方案、需求映射、能力地图、跨资源依赖、规划预检、平台架构、Ecode、Ebuilder应用、默认台账与菜单 | 先读 `references/common/map.md` 识别资源、配置与依赖；必要时读对应细节文档；再按 `references/common/guide-plan-template.md` 写资源清单与功能批次 plan |
+| 表单布局源码、表单级 ecode、表单 JS 代码块、JSSDK、代码校验、明细代码汇总、字段事件脚本、表单组件复写 | 先读 `references/form/layout/code-block/code-block-guide.md` 选代码层级和 CLI 写入命令，再按效果读取该目录对应 JSSDK 专题；**布局源码 ecode 由 CLI 编码，不要手改 `sourceCode.ecode`；手工调接口必须用 `encodeURI`，不能用 `encodeURIComponent`（设计器用 `decodeURI` 读取）** |
+| 写plan、搭建计划、plan.md、资源梳理、搭建模板、必做项清单、完整实施方案、需求映射、能力地图、跨资源依赖、**方案澄清、可行性预检、哪些做不到**、平台架构、Ecode、Ebuilder应用、默认台账与菜单 | 先读 `references/common/map.md` 识别资源、配置与依赖；做 0.1 方案澄清与可行性预检时同时读 `references/common/capability-boundaries.md`；再按 `references/common/guide-plan-template.md` 写资源清单与功能批次 plan |
 | 安装、升级、装不上、skill remove、skill sync、references 文档缺失、WorkBuddy | `references/common/guide-install.md` |
-| 支不支持、能不能做、能力边界、不支持的能力 | `references/common/capability-boundaries.md` |
+| 支不支持、能不能做、能力边界、不支持的能力、**证据等级、CLI 没暴露** | `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`（启用→发布→改发布信息→取消发布的先后关系 + 停用会收回发布态 + 多语言整份写回） |
 | 字段联动、字段值带出、HRM 属性带出、relateFrom、form relate、跨表带出赋值、FormDataLinkage、多跳带出、关联客户带出客户类型、field-linkage、Text字段赋值名称 | `references/form/guide-field-linkage.md`（按来源选择直接带出、HRM 带出或跨表查询赋值；含单跳/多跳与 --hops 格式） |
@@ -94,8 +96,11 @@ auto: true
 | 显示属性联动、显隐联动、条件显示、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` |
-| 还原图片样式、还原Excel样式、XLSX布局、源网格、pageLayouts、layout extract/compile/apply/verify/style-audit、已有字段位置匹配 | `references/form/guide-form-layout-source.md`（图片 imageStyles 三层投影与样式诊断；已有字段复用，纯布局编译、单次保存和独立回读） |
+| 表单布局、布局管理、初始化、编辑、模板、布局代码块、图片或 Excel 还原 | `references/form/layout/layout-overview.md`（先按任务选择独立能力） |
+| 流程表单多套布局、节点独立布局、布局绑定和回落默认 | `references/form/layout/workflow-layout.md`（表单布局与节点引用的关系；具体节点操作继续读流程指南） |
+| Excel样式、表格式布局、布局样表、布局蓝图、标签字段交替、合并单元格 | `references/form/layout/planning.md` |
+| 完整布局 JSON、布局文档导出、整体编辑差异预览、formLayout 大范围调整 | `references/form/layout/document.md`（导出底稿、预览完整差异、单次应用并回读） |
+| 还原图片样式、还原Excel样式、XLSX布局、源网格、pageLayouts、layout extract/compile/apply/verify/style-audit、已有字段位置匹配 | `references/form/layout/source-restoration.md`（图片 imageStyles 三层投影与样式诊断；已有字段复用，纯布局编译、单次保存和独立回读） |
 | 流程、审批、workflow、提交流程、预填 | `references/workflow/guide-workflow.md` |
 | 流程绑了哪张表、流程对应表单、workflow info、从流程找表单 | 命令速查 `references/common/ref-cli-commands.md` 的 `workflow info` 一行（**流程列表接口不含这个信息**；拿到的是 formId，不是 objId） |
 | 权责表、权责矩阵、权责表方式流程、分支场景、变量映射 | `references/workflow/guide-workflow-auth-resp.md`（操作者和条件同时遵循流程基础指南） |
@@ -115,11 +120,11 @@ auto: true
 | 新建视图、表格视图、看板、日历、思维导图、form view、台账显示列、显示列、list-columns、搜索条件、排序、list-sort、上下级、父级、树形展示、上级类型、list-hierarchy、视图数据条件、list-filter、日期占位符、{date}、{curryear}、动态日期 | `references/form/guide-form-view.md` |
 | 视图权限、查看布局、修改共享权限、view permission | `references/form/guide-form-view-permission.md` |
 | EBuilder关联、关联表单、数据过滤设置、ebuilder-filter、EBuilder显示列、ebuilder-columns、去掉系统字段、只留业务字段 | `references/form/guide-ebuilder-filter.md` |
-| 浏览数据定义、浏览弹窗高级搜索、浏览数据范围、浏览 Tab、可配置浏览字段 | `references/form/guide-browser-definition.md`；关联 EBuilder 字段的简便筛选命令另见 `references/form/guide-ebuilder-scope.md` |
-| 字段分组、分组容器、字段分段、基本信息/合同信息分段、Collapse、Fold、字段归组 | `references/form/guide-form-layout-planning.md`（**按需**：用户明确要求字段分组才在 fields.json 写 `group`，默认不加分组） |
-| 独占一行、整行显示、字段换行、singleRow、--single-row | `references/form/guide-form-layout-planning.md`（fields.json 字段写 `"singleRow":true`；add-field 用 `--single-row`） |
-| 布局样式模板分类、公共规则、layout init、style-template | `references/form/form-template/style-templates.md`（简易、高级、流式分别链接） |
-| 给已有表单加字段、改必填/只读、表单不是自己建的、--reinit、布局被重建、字段在布局里对不上、字段标题显示不出来 | `references/form/guide-form-layout-incremental.md`（**⚠ 不是自己建的表不要用 `--reinit`**；设必填是改布局组件，字段定义里没有 `required`） |
+| 浏览数据定义、浏览弹窗高级搜索、浏览数据范围、浏览 Tab、可配置浏览字段 | `references/form/guide-browser-definition.md`；包含高级搜索、数据范围、浏览 Tab 三部分，关联 EBuilder 字段的简便范围规则也在该指南中 |
+| 字段分组、分组容器、字段分段、基本信息/合同信息分段、Collapse、Fold、字段归组 | `references/form/layout/planning.md`（**按需**：用户明确要求字段分组才在 fields.json 写 `group`，默认不加分组） |
+| 独占一行、整行显示、字段换行、singleRow、--single-row | `references/form/layout/planning.md`（fields.json 字段写 `"singleRow":true`；add-field 用 `--single-row`） |
+| 布局样式模板分类、公共规则、layout init、style-template | `references/form/layout/template/template-guide.md`（简易、高级、流式分别链接） |
+| 给已有表单加字段、改必填/只读、表单不是自己建的、--reinit、布局被重建、字段在布局里对不上、字段标题显示不出来 | `references/form/layout/incremental.md`（**⚠ 不是自己建的表不要用 `--reinit`**；设必填是改布局组件，字段定义里没有 `required`） |
 | 字段类型、字段码表、日期区间、关联浏览、关联订单、关联合同、Order、Contract、字段多选、multiple、--multiple | `references/form/ref-form-fields.md` |
 | 表单复杂编号、serial-mark、流水号、年份编号、代字 | `references/form/guide-form-serial-mark.md` |
 | 函数公式、字段公式、formula、DAYS、日期差、expressId、公式绑定 | `references/form/guide-form-formula-functions.md`（219 个函数速查矩阵，写 `fields.json` 的 `formula` 或 `form formula set --expression` 时查函数格式/示例；**日期差用 `DAYS(开始,结束)`**） |
@@ -145,7 +150,7 @@ auto: true
 
 ## 能力边界
 
-> 不支持的能力、以及「CLI 没有命令时怎么办」的判定方式 → `references/common/capability-boundaries.md`。禁止声称平台/CLI 支持实际不支持的能力，禁止用临时脚本或浏览器操作绕行。
+> 不支持的能力、以及「CLI 没有命令时怎么办」的判定方式 → `references/common/capability-boundaries.md`。预检结论写进 `plan.md` 0.1，证据不足时标「待环境核查/未证实」；不得把「CLI 没暴露」写成「平台不支持」。禁止声称平台/CLI 支持实际不支持的能力，禁止用临时脚本或浏览器操作绕行。
 
 ---
 

package/skill-docs/_catalog.md

@@ -1,106 +1,108 @@
-# Skill Ebcoder 目录索引
-
-> 此文件列出所有子文档的加载条件，供 Agent 按需加载。不要一次性加载全部。
->
-> 以下所有路径统一写作 `references/...`：相对工作区根目录（`skill copy` 拷出的位置），或本机 skill 根目录（完整安装自带）。
-
-## Guides（编码指南）
-
-| 用户意图关键词 | 加载文档 |
-|---------------|---------|
-| 表单布局源码、布局 CSS、表单级 ecode、JSSDK、表单代码块、保存前代码校验、字段事件脚本、明细汇总脚本、字段组件局部复写 | `form code layout/read/set`、`wf-form code layout/read/set`、`form code ecode/list/add`、`wf-form code ecode/list/add`；先读 `references/code-block/guide-code-block.md`，布局 CSS 另读 `references/code-block/guide-layout-css.md`，再按效果读取 JSSDK 专题，不与页面 `entry.js` 编码混用；**布局源码 ecode 必须 `encodeURI`，不能用 `encodeURIComponent`** |
-| 表单CRUD、增删改查、getSimpleData、withDisplayNames、getFieldOptions、saveFormData、updateFormData、deleteFormData、字段类型 | `references/coding/guide-form-crud.md`（前端代码） |
-| 编辑、修改、回显、handleEdit、getAllData、rawData、selectedPerson、editForm、数据回填 | `references/coding/guide-edit-backfill.md`（前端代码） |
-| 显隐联动、条件显示、form linkage、为空/不为空条件、NULL 算子 | `references/form/guide-form-linkage.md` |
-| 浏览数据定义、浏览字段可配置能力、高级搜索默认条件、人员可选范围、浏览 Tab | `references/form/guide-browser-definition.md` |
-| 函数联动、本表字段公式赋值、赋值式公式、EXCEL 公式联动、字段自动计算、form formula-linkage、wf-form formula-linkage、流程表单函数联动、值改变时、载入时触发、当前工作流生效 | `references/form/guide-formula-linkage.md` |
-| 字段联动、跨表带出、field-linkage、多跳带出、带出字段赋值、Text 字段取名称 | `references/form/guide-field-linkage.md` |
-| 新建表单、form create、EB 表单标准创建流程 | `references/form/guide-create-form.md` |
-| 二级明细、子明细、父级行标识、子级行标识、多级明细 | `references/form/guide-form-sub-detail.md` |
-| 物理表、多物理表、附属物理表、saveFormTable、getFormAGroupList、字段管理其他页签、字段超过100、add-physical-table、add-physical-field | `references/form/guide-form-physical-table.md` |
-| 虚拟表、虚拟表单、数据源表单、业务表展示、数据加工结果 | `references/form/guide-virtual-form.md` |
-| 字段定义、字段类型、关联字段码表、DateRange、multiple | `references/form/ref-form-fields.md` |
-| FLOW/EXCEL、布局样表、布局蓝图、字段分组、singleRow | `references/form/guide-form-layout-planning.md` |
-| 布局样式模板总览、公共规则、form layout init | `references/form/form-template/style-templates.md`（分类入口） |
-| 表格式简易模板新增、编辑、预览 | `references/form/form-template/style-templates-easy.md` |
-| 表格式高级模板结构、重复规则、图片样式迁移 | `references/form/form-template/style-templates-advanced.md` |
-| 表格式高级模板 CSS、主题变量、明细表隔行、组件选择器 | `references/form/form-template/style-templates-advanced-css-guide.md` |
-| 流式布局模板 | `references/form/form-template/style-templates-flow.md` |
-| 图片/XLSX源样式还原、imageStyles、pageLayouts、已有字段绑定、字体字号颜色确认、style-review、layout extract/compile/apply/verify/style-audit | `references/form/guide-form-layout-source.md` |
-| 已有表单加字段、改必填/只读、布局被重建、add-field --reinit、别动别人的表、布局组件、associatedId、字段标题取不到 | `references/form/guide-form-layout-incremental.md` |
-| 表单复杂编号、serial-mark、流水号、代字 | `references/form/guide-form-serial-mark.md` |
-| 分类搜索、分类筛选、list-search-group、选项配置、日期粒度、选项排序 | `references/common/ref-cli-commands.md` |
-| 表单消息提醒、数据变动提醒、form message、提醒对象、推送渠道、IM提醒 | `references/form/guide-form-message.md` |
-| 表单数据读写、form data、写入数据、查询数据、删除数据 | `references/form/guide-form-data.md` |
-| 关联页签、关联视图、数据关联、association、页签显示布局、关联数据筛选、删除关联页签 | `references/form/guide-form-association.md` |
-| 流程归档权限、归档查看/编辑/删除、归档附件权限、form permission archive、创建人相关、字段相关、矩阵相关、归档卡片 | `references/form/guide-form-archive-permission.md` |
-| 列表自定义文本列、富文本列、列里插入字段、form nlist、列表式视图 | `references/form/guide-list-custom-text.md` |
-| 流程、审批、workflow、提交流程、flowpage、预填、URL传参、节点、操作者、审批人、连线 | `references/workflow/guide-workflow.md` |
-| 撤回管理、加审管理、减审管理、接收人范围、指定流转接收人范围、转发传阅抄送收回、功能管理 | `references/workflow/guide-function-management.md` |
-| 工作流基础设置、权限设置、auth-set、共享设置、share-set、按条件共享、共享字段权限、提醒设置、remind-set、指定节点提醒、邮件短信模板 | `references/workflow/guide-base-auth-share-remind.md` |
-| 拟签意见、draft-opinion、节点转发、forward-setting、节点签字意见、必须签批签名、隐藏意见输入框、意见显示类型 | `references/workflow/guide-opinion-settings.md` |
-| 流程绑的表、流程关联表单、workflow info、workflowId 查表单、formId 不是 objId | `references/common/ref-cli-commands.md`（`workflow info` 一行） |
-| 权责表、权责矩阵、权责表方式流程、分支场景、变量映射 | `references/workflow/guide-workflow-auth-resp.md` + `references/workflow/guide-workflow-condition.md` |
-| 公文流程、公文审批、收文、发文、公文设置、正文设置 | `references/workflow/guide-workflow-odoc.md` + `references/workflow/guide-workflow.md` |
-| 分支条件、出口条件、条件JSON、save-condition、连线条件、condition add | `references/workflow/guide-workflow-condition.md` |
-| 条件操作符编码、字段类型矩阵、关系符 | `references/workflow/operator-matrix.md` |
-| 动作流、跨表单、写入台账、ActionEbAdd/ActionEbUpdate/ActionEbDelete、提交事件、自定义事件触发、内置MQ监听/发送、HTTP/HTTPS、DML/数仓 | `references/workflow/guide-workflow-action.md`；复杂动作流组件契约按需读取 `actionflows/SKILL.md` 及其 `references/components/` |
-| 鉴权、登录、auth、ETEAMSID、多环境、profile、切换环境 | `references/auth/guide-auth.md` |
-| HRM矩阵、条件矩阵、部门矩阵、分部矩阵、matrix、映射表、行 id、rowId、syncType | `references/hrm/guide-matrix.md` |
-| 报表、设计器报表、EDC报表、新建报表、report build、数据集、报表列、父格、合并、冻结、tableName | `references/report/guide-report-build.md`（建表主干）· `guide-report-modify.md`（改已有）· `ref-report-pitfalls.md`（先扫坑） |
-| 报表查询条件、高级搜索、筛选、queryType、默认值三件套 | `references/report/guide-report-query.md`；细则 `query-condition-api-guide.md` |
-| 报表命令、report 子命令、report build/verify/fix/scope/snapshot | `references/report/ref-report-commands.md` |
-| 报表接口、saveReportDevInfo、addDataset、getReportDevInfo、报表落库流程 | `references/report/api-report-build-fast-path.md` · `report-config-schema.md`（配置结构） · `report-data-model.md`（枚举） |
-| 报表单元格模型、cellType、displayType、expandType、groupType、countType | `references/report/report-data-model.md` · `report-config-schema.md` |
-| 报表权限、共享范围、viewRight、权责矩阵 | `references/report/report-permission-guide.md` |
-| 报表版本、快照、生命周期、回收站、复制挂菜单 | `references/report/report-lifecycle-api-guide.md` |
-| 报表条件格式、数据条、图标集 | `references/report/condition-format-guide.md` |
-| 新页面、导出、路由、entry.js、regOvProps、regReactChildren、asyncImport、publicUrl、Suspense | `references/coding/guide-page-export.md`（前端代码） |
-| 写页面、页面代码、React编码、组件、entry.js模板 | `references/coding/guide-page-code.md`（前端代码） |
-| 页面设计器、配置式页面、仪表盘、看板页、designer、page create、comp-add、工厂模板、factory、组件模板、页面布局、designer layout/save、页面版本、version revert、发布页面菜单、publish-menu、自定义CSS、组件样式、选择器、DOM结构、样式不生效 | `references/ebuilder-designer/guide-designer.md`（布局层主干）· `guide-designer-components.md`（组件 config）· `guide-designer-factory.md`（工厂模板）· `guide-designer-version.md`（版本）· `guide-designer-css.md`（自定义 CSS 与 DOM 结构索引） |
-
-## Reference（参考手册）
-
-| 用户意图关键词 | 加载文档 |
-|---------------|---------|
-| 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 前预检、平台架构、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、菜单排序、菜单顺序、放第一个、menu order、showOrder、--first | `references/menu/system-menus.md` + `references/common/ref-cli-commands.md` |
-| 编译、语法、报错、不支持、babel、打包、var、const、let、es2015、stage-2 | `references/coding/ref-compile-rules.md`（前端代码） |
-
-## Components（组件文档）
-
-| 用户意图关键词 | 加载文档 |
-|---------------|---------|
-| Button、按钮 | `references/components/@weapp-Button.md` |
-| Table、表格 | `references/components/display-Table.md` |
-| List、列表 | `references/components/display-List.md` |
-| Pagination、分页 | `references/components/display-Pagination.md` |
-| Icon、图标 | `references/components/display-Icon.md` |
-| Avatar、头像 | `references/components/display-Avatar.md` |
-| EChart、图表、Echarts | `references/components/generic-Echarts.md` |
-| 文件预览、CorsComponent | `references/components/display-FilePreview.md` |
-| Input、输入框、文本框 | `references/components/form-Input.md` |
-| 人员选择、Browser Employee、resource | `references/components/form-EmployeeBrowser-api.md` |
-| 部门选择、Browser Department、department | `references/components/form-DepartmentBrowser-api.md` |
-| Upload、文件上传、附件、FileComponent | `references/components/form-Upload.md` |
-| Badge、徽标 | `references/components/base-Badge.md` |
-| Tag、标签 | `references/components/base-Tag.md` |
-
-## 组合场景
-
-| 场景 | 需加载的文档 |
-|------|-------------|
-| CRUD 列表页 | `references/coding/guide-form-crud.md`（前端代码） + `references/components/display-Table.md` + `references/components/display-Pagination.md` |
-| 表单新增/编辑弹窗 | `references/coding/guide-form-crud.md`（前端代码） + `references/coding/guide-edit-backfill.md` + 对应表单组件文档 |
-| 新建完整应用 | `references/common/ref-cli-commands.md` + `references/form/guide-create-form.md` + `references/coding/guide-page-export.md`（前端代码） |
-| 流程触发页面 | `references/workflow/guide-workflow.md` + `references/coding/guide-form-crud.md`（前端代码） |
-| 流程分支条件 | `references/workflow/guide-workflow.md` + `references/workflow/guide-workflow-condition.md` |
-| 跨表单动作流 | `references/workflow/guide-workflow.md` + `references/workflow/guide-workflow-action.md` |
-| 编译报错排查 | `references/coding/ref-compile-rules.md`（前端代码） |
-
-- 流程功能设置（batch-set/auto-approve/other-set/水印/导入/事项赋权/文档权限）：`references/workflow/guide-function-settings.md`
+# Skill Ebcoder 目录索引
+
+> 此文件列出所有子文档的加载条件，供 Agent 按需加载。不要一次性加载全部。
+>
+> 以下所有路径统一写作 `references/...`：相对工作区根目录（`skill copy` 拷出的位置），或本机 skill 根目录（完整安装自带）。
+
+## Guides（编码指南）
+
+| 用户意图关键词 | 加载文档 |
+|---------------|---------|
+| 表单布局源码、布局 CSS、表单级 ecode、JSSDK、表单代码块、保存前代码校验、字段事件脚本、明细汇总脚本、字段组件局部复写 | `form code layout/read/set`、`wf-form code layout/read/set`、`form code ecode/list/add`、`wf-form code ecode/list/add`；先读 `references/form/layout/code-block/code-block-guide.md`，布局 CSS 另读 `references/form/layout/code-block/layout-css.md`，再按效果读取 JSSDK 专题，不与页面 `entry.js` 编码混用；**布局源码 ecode 必须 `encodeURI`，不能用 `encodeURIComponent`** |
+| 表单CRUD、增删改查、getSimpleData、withDisplayNames、getFieldOptions、saveFormData、updateFormData、deleteFormData、字段类型 | `references/coding/guide-form-crud.md`（前端代码） |
+| 编辑、修改、回显、handleEdit、getAllData、rawData、selectedPerson、editForm、数据回填 | `references/coding/guide-edit-backfill.md`（前端代码） |
+| 显隐联动、条件显示、form linkage、为空/不为空条件、NULL 算子 | `references/form/guide-form-linkage.md` |
+| 浏览数据定义、浏览字段可配置能力、高级搜索默认条件、人员可选范围、浏览 Tab | `references/form/guide-browser-definition.md`（高级搜索、数据范围、浏览 Tab 三部分；含关联 EBuilder 简便规则） |
+| 函数联动、本表字段公式赋值、赋值式公式、EXCEL 公式联动、字段自动计算、form formula-linkage、wf-form formula-linkage、流程表单函数联动、值改变时、载入时触发、当前工作流生效 | `references/form/guide-formula-linkage.md` |
+| 字段联动、跨表带出、field-linkage、多跳带出、带出字段赋值、Text 字段取名称 | `references/form/guide-field-linkage.md` |
+| 新建表单、form create、EB 表单标准创建流程 | `references/form/guide-create-form.md` |
+| 二级明细、子明细、父级行标识、子级行标识、多级明细 | `references/form/guide-form-sub-detail.md` |
+| 物理表、多物理表、附属物理表、saveFormTable、getFormAGroupList、字段管理其他页签、字段超过100、add-physical-table、add-physical-field | `references/form/guide-form-physical-table.md` |
+| 虚拟表、虚拟表单、数据源表单、业务表展示、数据加工结果 | `references/form/guide-virtual-form.md` |
+| 字段定义、字段类型、关联字段码表、DateRange、multiple | `references/form/ref-form-fields.md` |
+| 表单布局管理、编辑、初始化、代码块、模板与源样式还原 | `references/form/layout/layout-overview.md`（统一入口） |
+| 流程表单多套布局、节点绑定、节点回落默认 | `references/form/layout/workflow-layout.md`（节点细节继续读流程指南） |
+| FLOW/EXCEL、布局样表、布局蓝图、字段分组、singleRow | `references/form/layout/planning.md` |
+| 布局样式模板总览、公共规则、form layout init | `references/form/layout/template/template-guide.md`（分类入口） |
+| 表格式简易模板新增、编辑、预览 | `references/form/layout/template/easy.md` |
+| 表格式高级模板结构、重复规则、图片样式迁移 | `references/form/layout/template/advanced.md` |
+| 表格式高级模板 CSS、主题变量、明细表隔行、组件选择器 | `references/form/layout/template/advanced-css.md` |
+| 流式布局模板 | `references/form/layout/template/flow.md` |
+| 图片/XLSX源样式还原、imageStyles、pageLayouts、已有字段绑定、字体字号颜色确认、style-review、layout extract/compile/apply/verify/style-audit | `references/form/layout/source-restoration.md` |
+| 已有表单加字段、改必填/只读、布局被重建、add-field --reinit、别动别人的表、布局组件、associatedId、字段标题取不到 | `references/form/layout/incremental.md` |
+| 表单复杂编号、serial-mark、流水号、代字 | `references/form/guide-form-serial-mark.md` |
+| 分类搜索、分类筛选、list-search-group、选项配置、日期粒度、选项排序 | `references/common/ref-cli-commands.md` |
+| 表单消息提醒、数据变动提醒、form message、提醒对象、推送渠道、IM提醒 | `references/form/guide-form-message.md` |
+| 表单数据读写、form data、写入数据、查询数据、删除数据 | `references/form/guide-form-data.md` |
+| 关联页签、关联视图、数据关联、association、页签显示布局、关联数据筛选、删除关联页签 | `references/form/guide-form-association.md` |
+| 流程归档权限、归档查看/编辑/删除、归档附件权限、form permission archive、创建人相关、字段相关、矩阵相关、归档卡片 | `references/form/guide-form-archive-permission.md` |
+| 列表自定义文本列、富文本列、列里插入字段、form nlist、列表式视图 | `references/form/guide-list-custom-text.md` |
+| 流程、审批、workflow、提交流程、flowpage、预填、URL传参、节点、操作者、审批人、连线 | `references/workflow/guide-workflow.md` |
+| 撤回管理、加审管理、减审管理、接收人范围、指定流转接收人范围、转发传阅抄送收回、功能管理 | `references/workflow/guide-function-management.md` |
+| 工作流基础设置、权限设置、auth-set、共享设置、share-set、按条件共享、共享字段权限、提醒设置、remind-set、指定节点提醒、邮件短信模板 | `references/workflow/guide-base-auth-share-remind.md` |
+| 拟签意见、draft-opinion、节点转发、forward-setting、节点签字意见、必须签批签名、隐藏意见输入框、意见显示类型 | `references/workflow/guide-opinion-settings.md` |
+| 流程绑的表、流程关联表单、workflow info、workflowId 查表单、formId 不是 objId | `references/common/ref-cli-commands.md`（`workflow info` 一行） |
+| 权责表、权责矩阵、权责表方式流程、分支场景、变量映射 | `references/workflow/guide-workflow-auth-resp.md` + `references/workflow/guide-workflow-condition.md` |
+| 公文流程、公文审批、收文、发文、公文设置、正文设置 | `references/workflow/guide-workflow-odoc.md` + `references/workflow/guide-workflow.md` |
+| 分支条件、出口条件、条件JSON、save-condition、连线条件、condition add | `references/workflow/guide-workflow-condition.md` |
+| 条件操作符编码、字段类型矩阵、关系符 | `references/workflow/operator-matrix.md` |
+| 动作流、跨表单、写入台账、ActionEbAdd/ActionEbUpdate/ActionEbDelete、提交事件、自定义事件触发、内置MQ监听/发送、HTTP/HTTPS、DML/数仓 | `references/workflow/guide-workflow-action.md`；复杂动作流组件契约按需读取 `actionflows/SKILL.md` 及其 `references/components/` |
+| 鉴权、登录、auth、ETEAMSID、多环境、profile、切换环境 | `references/auth/guide-auth.md` |
+| HRM矩阵、条件矩阵、部门矩阵、分部矩阵、matrix、映射表、行 id、rowId、syncType | `references/hrm/guide-matrix.md` |
+| 报表、设计器报表、EDC报表、新建报表、report build、数据集、报表列、父格、合并、冻结、tableName | `references/report/guide-report-build.md`（建表主干）· `guide-report-modify.md`（改已有）· `ref-report-pitfalls.md`（先扫坑） |
+| 报表查询条件、高级搜索、筛选、queryType、默认值三件套 | `references/report/guide-report-query.md`；细则 `query-condition-api-guide.md` |
+| 报表命令、report 子命令、report build/verify/fix/scope/snapshot | `references/report/ref-report-commands.md` |
+| 报表接口、saveReportDevInfo、addDataset、getReportDevInfo、报表落库流程 | `references/report/api-report-build-fast-path.md` · `report-config-schema.md`（配置结构） · `report-data-model.md`（枚举） |
+| 报表单元格模型、cellType、displayType、expandType、groupType、countType | `references/report/report-data-model.md` · `report-config-schema.md` |
+| 报表权限、共享范围、viewRight、权责矩阵 | `references/report/report-permission-guide.md` |
+| 报表版本、快照、生命周期、回收站、复制挂菜单 | `references/report/report-lifecycle-api-guide.md` |
+| 报表条件格式、数据条、图标集 | `references/report/condition-format-guide.md` |
+| 新页面、导出、路由、entry.js、regOvProps、regReactChildren、asyncImport、publicUrl、Suspense | `references/coding/guide-page-export.md`（前端代码） |
+| 写页面、页面代码、React编码、组件、entry.js模板 | `references/coding/guide-page-code.md`（前端代码） |
+| 页面设计器、配置式页面、仪表盘、看板页、designer、page create、comp-add、工厂模板、factory、组件模板、页面布局、designer layout/save、页面版本、version revert、发布页面菜单、publish-menu、自定义CSS、组件样式、选择器、DOM结构、样式不生效 | `references/ebuilder-designer/guide-designer.md`（布局层主干）· `guide-designer-components.md`（组件 config）· `guide-designer-factory.md`（工厂模板）· `guide-designer-version.md`（版本）· `guide-designer-css.md`（自定义 CSS 与 DOM 结构索引） |
+
+## Reference（参考手册）
+
+| 用户意图关键词 | 加载文档 |
+|---------------|---------|
+| 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 前预检、**方案澄清、可行性预检、哪些做不到**、平台架构、Ecode、默认台账与菜单 | `references/common/map.md`，随后使用 `references/common/guide-plan-template.md`（0.1 节）与 `references/common/capability-boundaries.md` |
+| 安装、升级、装不上、skill 重装、skill remove、skill sync、references 文档缺失、WorkBuddy | `references/common/guide-install.md` |
+| 能力边界、支不支持、能不能做、不支持的能力、**证据等级、CLI 没暴露** | `references/common/capability-boundaries.md`（命令表只能证明 CLI 没暴露，不能当平台不支持） |
+| 接口文档导入、Postman、系统接口、连接器接口、createSystemInterfaceByAi、接口批量创建 | `references/esb-interface/guide-import.md` |
+| 系统菜单、内置菜单、挂系统页面到菜单、menuUrl、pageType、工作流菜单、独立页面菜单、菜单改名、menu rename、重命名菜单、找不到菜单、二级菜单、子菜单、父菜单、菜单层级、menu add-table --parent、menu add-start --parent、菜单排序、菜单顺序、放第一个、menu order、showOrder、--first | `references/menu/system-menus.md` + `references/common/ref-cli-commands.md` |
+| 编译、语法、报错、不支持、babel、打包、var、const、let、es2015、stage-2 | `references/coding/ref-compile-rules.md`（前端代码） |
+
+## Components（组件文档）
+
+| 用户意图关键词 | 加载文档 |
+|---------------|---------|
+| Button、按钮 | `references/components/@weapp-Button.md` |
+| Table、表格 | `references/components/display-Table.md` |
+| List、列表 | `references/components/display-List.md` |
+| Pagination、分页 | `references/components/display-Pagination.md` |
+| Icon、图标 | `references/components/display-Icon.md` |
+| Avatar、头像 | `references/components/display-Avatar.md` |
+| EChart、图表、Echarts | `references/components/generic-Echarts.md` |
+| 文件预览、CorsComponent | `references/components/display-FilePreview.md` |
+| Input、输入框、文本框 | `references/components/form-Input.md` |
+| 人员选择、Browser Employee、resource | `references/components/form-EmployeeBrowser-api.md` |
+| 部门选择、Browser Department、department | `references/components/form-DepartmentBrowser-api.md` |
+| Upload、文件上传、附件、FileComponent | `references/components/form-Upload.md` |
+| Badge、徽标 | `references/components/base-Badge.md` |
+| Tag、标签 | `references/components/base-Tag.md` |
+
+## 组合场景
+
+| 场景 | 需加载的文档 |
+|------|-------------|
+| CRUD 列表页 | `references/coding/guide-form-crud.md`（前端代码） + `references/components/display-Table.md` + `references/components/display-Pagination.md` |
+| 表单新增/编辑弹窗 | `references/coding/guide-form-crud.md`（前端代码） + `references/coding/guide-edit-backfill.md` + 对应表单组件文档 |
+| 新建完整应用 | `references/common/ref-cli-commands.md` + `references/form/guide-create-form.md` + `references/coding/guide-page-export.md`（前端代码） |
+| 流程触发页面 | `references/workflow/guide-workflow.md` + `references/coding/guide-form-crud.md`（前端代码） |
+| 流程分支条件 | `references/workflow/guide-workflow.md` + `references/workflow/guide-workflow-condition.md` |
+| 跨表单动作流 | `references/workflow/guide-workflow.md` + `references/workflow/guide-workflow-action.md` |
+| 编译报错排查 | `references/coding/ref-compile-rules.md`（前端代码） |
+
+- 流程功能设置（batch-set/auto-approve/other-set/水印/导入/事项赋权/文档权限）：`references/workflow/guide-function-settings.md`

package/skill-docs/actionflows/references/components/ebuilder/ActionEbDelete.md

@@ -3,10 +3,13 @@
 ## 何时使用
 
 按筛选条件删除 e-builder 表单数据；还原已删除数据使用 `ActionEbRecover`。
+删除组件只允许“按条件删除”，CLI 不生成无条件删除节点。
 
 ## 先查询
 
-查询目标表单、条件字段和操作人。
+查询目标表单、目标表的数据源字段和操作人。前端 `ActionEbDelete` 使用
+`dataSource + ConditionSet`，后端保存字段为 `filterInput`；CLI 计划层使用
+`filterCondition`，由编译器转换为 `filterInput`。
 
 ## 不可猜测
 
@@ -14,10 +17,64 @@
 
 ## 最小计划
 
-`targetForm`、`person`、`filterCondition`。
+`targetForm`、`person`、`filterCondition`。`nullOpflag` 可选，默认 `false`，对应前端“传空值时执行”开关。
 
 ## filterCondition 格式
 
-**以 `references/condition_rules.md` 为准**：`{"field":{"id":"<目标字段id>","label":"<字段名>"},"operator":"eq","right":{...}}`。`field` 是 `{id,label}` 对象、`operator` 用英文操作符（`eq/neq/gt/lt/gte/lte/contains/uncontains/empty/nempty`）、右值键用 `right`。**勿用**废弃的 `value` 别名 / `=` / 裸字符串 `field`，否则编译报「左侧字段 id 不在目标表单实时字段列表中」。
+**以 `references/condition_rules.md` 为准**：`{"field":{"id":"<目标字段id>","label":"<字段名>"},"operator":"eq","right":{...}}`。`field` 是 `{id,label}` 对象、`operator` 用英文操作符（`eq/neq/gt/lt/gte/lte/contains/uncontains/empty/nempty`）、右值键用 `right`。**勿用**废弃的 `value` 别名 / `=` / 裸字符串 `field`，也不能省略或传空 `filterCondition`。
+
+条件左值必须来自目标表的 `/api/ebuilder/common/ds/fields` 实时字段接口，不能凭名称、旧缓存或 `getEbField` 结果拼接。右值支持固定值、系统值、上下文、变量和函数等条件规则中定义的类型。
+
+## 计划示例
+
+```json
+{
+  "type": "ActionEbDelete",
+  "params": {
+    "targetForm": {
+      "groupId": "<业务应用ID>",
+      "id": "<表单ID>",
+      "name": "<表单名称>"
+    },
+    "person": { "type": "role" },
+    "filterCondition": {
+      "field": { "id": "<实时字段ID>", "label": "状态" },
+      "operator": "eq",
+      "right": { "type": "fixed", "value": "D02", "label": "闲置" }
+    },
+    "nullOpflag": false
+  }
+}
+```
+
+## 与前端/后端 DTO 的对应关系
+
+前端 `ActionEbDelete` 提交的关键字段如下，CLI 不要求计划直接写这些平台字段：
+
+```json
+{
+  "type": "ActionEbDelete",
+  "targetForm": {
+    "groupId": "<业务应用ID>",
+    "id": "<表单ID>",
+    "text": "<表单名称>",
+    "type": "FORM"
+  },
+  "tableType": [{ "id": "<表单ID>", "name": "<表单名称>" }],
+  "appType": [{ "id": "<业务应用ID>", "name": "<应用名称>" }],
+  "person": "<操作人公式>",
+  "filterInput": {
+    "isNewFilter": true,
+    "isParent": true,
+    "relationship": "1",
+    "datas": ["<由 filterCondition 编译的条件项>"],
+    "parentNode": "",
+    "key": "<编译时生成>"
+  },
+  "nullOpflag": false
+}
+```
+
+`filterInput.datas[].conditions.esbAssign.wId` 必须指向当前删除组件节点，不能指向触发器节点。
 
 当条件左字段是「关联流程」Workflow 时，必须由 Skill 根据实时字段元数据和 `workflowPath.formIds` 反查真实流程表单对象；编译后的左值使用原始数字 `fieldName`、`fieldType:"String"`、顶层 `sformId` 和 `formInfo.formId/layoutId`，不得套用普通业务字段的 `field_` 前缀或把目标表单版本 ID写成 `sformId`。

package/skill-docs/actionflows/references/components/ebuilder/EventButton.md

@@ -1,33 +1,35 @@
-# e-builder 按钮触发（`EventButton`）
-
-## 何时使用
-
-需求明确为点击 e-builder 表单上的某个按钮时触发。它与 `EventFormData` 不同：后者只监听数据变动，不能识别是由哪个按钮触发。
-
-## 先查询
-
-1. 用 `form-search '{"keyword":"<表名>"}'` 按表名直接拿到表单 `objId` 与所属业务应用 `appId`（同名表多于一条时按 `appName` 收窄，应用名同名多命中或查无会直接报错并给候选，改用 `appId`）；只知道应用时用 `form-applications` → `form-list`。返回体 `truncated: true` 表示还有命中未返回，**据此判定表单不存在是错的**，应按 `appName` 收窄或传 `{"max":0}`。
-2. 用 `e10-cli actionflow form-buttons '{"tableId":"<表单ID>","appId":"<应用ID>"}'` 读取真实按钮 ID、名称与启用状态。
-
-不要按按钮名称猜测 ID，也不要创建按钮作为生成动作流的隐含步骤。
-
-## 最小计划
-
-```json
-{
-  "event": {
-    "type": "EventButton",
-    "params": {
-      "targetForm": {"groupId":"<应用ID>","id":"<表单ID>"},
-      "buttonType": [{"id":"<按钮ID>","name":"<按钮名称>","buttonLocation":"after"}],
-      "triggerType": "sequence"
-    }
-  }
-}
-```
-
-`buttonLocation` 只能是 `before`（按钮默认动作前）或 `after`（默认动作后）。多选记录场景的 `triggerType` 为 `sequence`、`merge` 或 `parallel`。需要异步时在对应按钮项写 `asyncExecution:true`。
-
-## 上下文
-
-触发后可引用 `FormData`、`FormField`、`FormButton`、`SettingInfo`、`accessId` 和 `monitorId`。先通过组件上下文预检获取当前租户的字段，禁止猜测字段路径。
+# e-builder 按钮触发（`EventButton`）
+
+## 何时使用
+
+需求明确为点击 e-builder 表单上的某个按钮时触发。它与 `EventFormData` 不同：后者只监听数据变动，不能识别是由哪个按钮触发。
+
+## 先查询
+
+1. 用 `form-search '{"keyword":"<表名>"}'` 按表名直接拿到表单 `objId` 与所属业务应用 `appId`（同名表多于一条时按 `appName` 收窄，应用名同名多命中或查无会直接报错并给候选，改用 `appId`）；只知道应用时用 `form-applications` → `form-list`。返回体 `truncated: true` 表示还有命中未返回，**据此判定表单不存在是错的**，应按 `appName` 收窄或传 `{"max":0}`。
+2. 用 `e10-cli actionflow form-buttons '{"tableId":"<表单ID>","appId":"<应用ID>"}'` 读取真实按钮 ID、名称与启用状态。
+
+不要按按钮名称猜测 ID，也不要创建按钮作为生成动作流的隐含步骤。
+
+## 最小计划
+
+```json
+{
+  "event": {
+    "type": "EventButton",
+    "params": {
+      "targetForm": {"groupId":"<应用ID>","id":"<表单ID>"},
+      "buttonType": [{"id":"<按钮ID>","name":"<按钮名称>","buttonLocation":"after"}],
+      "triggerType": "sequence"
+    }
+  }
+}
+```
+
+`buttonLocation` 只能是 `before`（按钮默认动作前）或 `after`（默认动作后）。多选记录场景的 `triggerType` 为 `sequence`、`merge` 或 `parallel`。需要异步时在对应按钮项写 `asyncExecution:true`。
+
+使用 `before` 时，CLI 会实时调用 `getButtonList`，并校验该按钮返回的 `needTriggerBefore`。只有前端允许“执行前”的按钮才能生成；不能仅凭按钮名称或手工传 `before` 绕过这个校验。按钮名称也会以当前租户实时返回值为准。
+
+## 上下文
+
+触发后可引用 `FormData`、`FormField`、`FormButton`、`SettingInfo`、`accessId` 和 `monitorId`。先通过组件上下文预检获取当前租户的字段，禁止猜测字段路径。

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

@@ -10,6 +10,25 @@
 
 1. 先查 `references/common/ref-cli-commands.md` 的对应命令与参数；
 2. 再跑 `e10-cli <命令> --help` 确认当前版本有没有该选项；
-3. 仍无法确认时，问用户或如实说明「当前版本没有对应命令」。
+3. 能只读验证的，做一次只读查询或回读并记录结果；
+4. 仍无法确认时，标「待环境核查」或「未证实」，不要猜；必要时问用户；
+5. 已确认做不到或只能部分做到时，写进 `plan.md` 的 0.1 和「待确认、需补充及无法实现」一节，保持 `[ ]`。
 
 **禁止绕行**：不要为了完成配置临时编写 `.mjs` 脚本调用内部接口，也不要让用户直接操作浏览器或设计器代替命令；确认没有命令时，保留该项未完成状态并说明影响。
+
+## 证据等级（写预检结论 / 边界表时必填）
+
+| 等级 | 含义 | 能否对外说「不支持」 |
+|---|---|---|
+| 实测 | 有平台原始回执，或写后有独立回读 | 可以，注明环境和日期 |
+| 回读字段 | 平台返回体里确有该字段，语义未必实测 | 不能直接判「不支持」 |
+| 命令表 | 只能证明**当前 CLI 没暴露** | **不能**；命令没暴露不等于平台不支持 |
+| 未证实 | 有结论、无证据 | **不能**对外宣称 |
+
+> 「选项表/命令表」只证明执行器没暴露，不能升级成「平台不提供」。需要平台结论时，先补实测或回读证据；没有证据就写「待环境核查」。
+
+## 边界记录格式
+
+| 需求 | 结论 | 证据等级 | 依据 | 影响与处理 |
+|---|---|---|---|---|
+| <需求项> | 可做 / 部分可做 / 做不到 / 待环境核查 | 实测 / 回读字段 / 命令表 / 未证实 | <具体命令、回执或文档> | <保留未完成、替代方式或需用户决定> |