weaver-e10-builder 1.1.2 → 1.1.5

package/skill-docs/references/common/guide-plan-template.md

@@ -1,201 +1,219 @@
-# 搭建计划模板（plan.md 强制格式）
-
-> 这是 `plan.md` 的**强制模板**。写 plan.md 必须照此格式逐项梳理资源与规则，**禁止自创格式、禁止预勾 `[x]`**。
-> `[ ]` = 待办；执行阶段做完一项、验证通过，才改 `[x]` 并填实际 ID。全部 `[x]` 才算完工。
-
-## 使用方法
-
-1. 复制下方「plan.md 骨架」到工作区 `plan.md`
-2. 按需求逐项填实（应用/表单/流程/出口条件清单/菜单/页面/必做项）
-3. 规划阶段全部留 `[ ]`，拿给用户确认（此阶段不调 e10-cli 写命令，可 list/read 查现状）
-4. 用户确认后逐项执行，每做完一项、验证通过，改 `[x]` 并填 ID——完成一条打勾一条
-5. **执行每项前，先按 SKILL.md 决策树读对应 `references` 指南**——命令的完整参数/边界/坑/示例都在指南里，认真阅读再动手，不要凭印象直接调命令
-
----
-
-## plan.md 骨架
-
-```md
-## 搭建计划
-
-> ⚠️ `[ ]` 是待办，不是"已规划"。规划阶段全部留 `[ ]`；执行阶段做完一项、验证通过，才改 `[x]` 并填 ID。**完成一条打勾一条**，全部 `[x]` 才算完工。**禁止预勾 `[x]`**（=谎报完成）。勿依赖平台默认值——平台默认值≠方案要求。
-> **来源标注**：每张表/每个流程/每个节点用分组头声明（名称+ID 占位），其下 `[ ]` 项的来源即该分组；跨表的项内联标「来源: <表单/流程>」。
-
-### 0. 环境
-- [ ] 鉴权 `e10-cli auth status`（profile 切换 `auth profile use` / 新环境 `auth set --eteamsid --base-url`）
-
-### 1. 应用
-- [ ] <应用名> | `app create` | ID: 待创建
-  > 一份需求只建这一个应用，所有表单/流程/菜单都在它下面。不要按功能点拆应用；确需多应用（分属不同业务系统）先跟用户确认。
-
-### 2. 角色（来源: 全应用）
-- [ ] <角色名> | `role create` + `role add-member <roleId> <keyword>` | 方案要求的每个角色都要建，不会自动有
-
----
-
-### 3. 表单（每张表一组，逐张复制此分组）
-
-#### ▼ 表单：<表单名A> | objId: 待创建
-
-##### 3.1 字段定义（建表时一次性，`form create --fields` --layout FLOW|EXCEL）
-- [ ] <表单名> | ID: 待创建
-  布局: FLOW（流式）/ EXCEL（表格，缺省）
-  字段:
-    1. 名称(Text, 必填)
-    2. 金额(Money, precision=2, 只读)
-    3. 备注(TextArea, 独占一行)
-    4. 客户名称(Text, group=基本信息, 必填)
-    5. 联系电话(Phone, group=基本信息)
-    6. 明细表(DetailTable, formFields:[...])
-    7. 关联客户(EBuilder, sformId+dataTitle)
-    8. 关联流程(Flow, sformId=<流程绑定的表单objId>)  ← sformId 指向哪个流程表单，浏览时就只选该表单绑定的流程数据，创建时自动绑定
-  - 选项/编号/默认值/精度/百分比/maxLen 建表时写全；单位无独立属性，**写进字段名**如 `工时单价(元)`
-  - **布局与显示属性**：方案文档明确要求的必填(`required`)、只读(`readOnly`)、隐藏(`hidden`)、独占一行(`singleRow`)、分组(`group`)、字段顺序——全部标在字段清单里，建表时 fields.json 一并带上，勿留建后补。方案未提到的用默认（EXCEL 两列、不分组、不必填）
-  - 公式/值带出可 inline：`formula` / `relateFrom`
-  - **Flow 字段**：`sformId` 是流程表单 objId（不是 workflowId），建表时写进 fields.json 即自动绑定——关联到哪个流程表单就只能选该范围的流程数据，无需单独配数据范围
-  > 不要先建空表再 add-field——add-field/edit-field 只是**罕见补救手段**
-
-##### 3.2 表单级配置（来源: 本表单 <表单名A>；建表后逐项配齐，缺一项这张表不算完成）
-- [ ] 复杂编号 | `form serial-mark set <objId> <appId> <fieldId> --segments @json`（纯建模表：fixed/year/serial/field/system/date+代字；⚠ 绑流程表无效→走 `workflow numbering`）
-- [ ] 值带出（关联表） | `form relate <appId> <objId> <目标字段> --from <Employee/Department源字段>`（换申请人→填邮箱/工号/部门；HRM属性带出，简单单源）
-- [ ] 值带出（跨表/多跳） | `form field-linkage add <appId> <objId> --trigger <触发字段> --target <目标字段> --hops "<源表objId:带出字段,源表objId:带出字段,...>"`（跨表查询带出，支持多跳链式中转；Text 字段必须多跳到名称表取名称不能直接赋 ID）
-- [ ] 关联显示列 | `form ebuilder-columns <objId> <appId> <fieldId> [字段名...]`（先不带参数看业务字段候选清单，去系统字段）
-- [ ] 关联数据范围 | `form ebuilder-scope set <objId> <appId> <fieldId> --rules '[...]'`（如客户状态=启用才可选）
-- [ ] 字段公式 | `form formula set --expression "DAYS({主表.开始},{主表.结束})" --target <fieldId>`（或 fields.json inline）
-- [ ] 查重校验 | `form validate add <objId> <appId> <字段名...>`（项目名称重名/工时日期重复）
-- [ ] 显隐联动 | `form linkage add <appId> <objId> <名> --config @json`（prop: hide/show/edit/readonly/required/hideLine）
-- [ ] 字段分组 | `form group <objId> <appId> --groups '{"基本信息":[...]}'`（建表时已用 group 则跳过）
-- [ ] 表单权限 | `form permission add <objId> <appId> --org-type <all/role/dept/...> --right-type <0/1/2/3>`（勿默认所有人）
-- [ ] 表单按钮 | `form button add <objId> <appId> <名> --url <url> --open-type <1/2/3>`
-
-##### 3.3 台账/视图配置（来源: 本表单 <表单名A> 的台账；无需求标「— 无」）
-- [ ] 显示列批量设置 | `form list-columns <objId> <appId> <listId> --set @columns.json`（[指南](../form/guide-list-columns.md)）
-- [ ] 列单位 | `form list-unit <objId> <appId> <listId> <fieldId> "（元）"`
-- [ ] 列格式 | `form list-format <objId> <appId> <listId> <fieldId> [--thousandths] [--decimal <n>]`
-- [ ] 字段事件（列点击跳转） | `form list-click <objId> <appId> <listId> <fieldId> [--target <objId>]`
-- [ ] 搜索条件 | `form list-search <objId> <appId> <listId> [--add <f>] [--quick <f>]`
-- [ ] 排序 | `form list-sort <objId> <appId> <listId> [--field <f>] [--order ASC|DESC]`
-- [ ] 顶部统计（主表/明细） | `form list-stats <objId> <appId> <listId> --add @json`（[指南](../form/guide-list-stats.md)）
-- [ ] 视图数据条件 | `form list-filter <objId> <appId> <listId> --add '{"conditions":[...]}'`
-- [ ] 关联页签及目标视图 | `form association create <objId> <appId> <名> --view <viewId> --permissions @json`（[指南](../form/guide-form-association.md)）
-- [ ] 关联页签布局与终端 | `form association update <objId> <appId> <associationId> --layouts 显示 --terminals PC MOBILE`（[指南](../form/guide-form-association.md)）
-- [ ] 关联页签数据筛选 | `form association set-filter <objId> <appId> <associationId> --mappings @json`（[指南](../form/guide-form-association.md)）
-- [ ] 视图按钮显示位置 | `form button position <objId> <appId> <buttonId> --view <listId> --position 行上`（[指南](../form/guide-form-button.md)）
-- [ ] 行事件（整行点击） | `form list-event <objId> <appId> <listId> --add-page '{...}'`
-- [ ] 视图启用分组 | `form list-group <objId> <appId> <listId> --enable --group-field <fieldId>`（[指南](../form/guide-form-view.md)）
-- [ ] 主表合并行 | `form list-merge <objId> <appId> <listId>`
-- [ ] 台账视图权限 | `form list-permission <objId> <appId> <listId> [--add-all|--add-user <id> --name <n>]`
-- [ ] 分类搜索 | `form list-search-group <objId> <appId> <listId> [--add <选项fieldId>]`
-- [ ] 自定义视图 | `form view create <objId> <appId> <名> --type kanbanView|calendarView|mindMapView|multiView` + `form view populate`
-- [ ] 表格视图 | 默认复用台账，记录实际名称/listId；额外新建才用 `form table-view create <objId> <appId> <名>`（[指南](../form/guide-form-view.md)）
-  > 表单自带台账（搜索/筛选/导出/批量）。本节只列有需求的项；无需求标「— 无」
-
-#### ▼ 表单：<表单名B> | objId: 待创建
-（同上 3.1/3.2/3.3 复制）
-
----
-
-### 4. 流程（每个流程一组，逐个复制此分组）
-
-#### ▼ 流程：<流程名A> | workflowId: 待创建
-
-##### 4.1 创建
-- [ ] 创建 | `workflow create <appId> <formObjId> <名>`（默认不加菜单；确认需要发起入口时 `--menu` 加）
-  > ⚠️ **流程级必做**：① 流程编号（`workflow numbering`）；② 出口名称（`workflow link-rename`，改业务人话）；③ 出口条件清单（见 4.3，先列全表再逐条创建，勿凭印象跳步）
-
-##### 4.2 节点与连线（来源: 本流程 <流程名A>；每节点一行）
-> ⚠️ 操作者按需求语义用对应 `--type`（role/dept/position/superior/initiator/form/matrix/free/all），**禁止兜底成具体人员顶替**；名称解析不到先停下确认。
-- [ ] 节点1 | 操作者: 创建人
-- [ ] 节点2 | 操作者: 区域经理+部门领导(竞签)  ← 「A或B审批」=一节点多人+竞签/非会签，不拆节点
-- [ ] 节点3 | 条件: <字段>=<值> 才走到，否则跳过/直达<节点>
-- [ ] 节点4 | 操作者: 角色X ｜ 动作流: → <目标表>(add/update/delete, 映射: 源→目标)
-- [ ] 连线 | `workflow add-link/add-links <wf> <from> <to> <label>` [--reject 退回] [--default 默认]
-
-##### 4.3 出口条件清单（来源: 本流程 <流程名A>；必填，动手前逐条列出，防遗漏）
-段② 执行到条件时，先按此表列出所有连线的完整条件，逐条确认后再 `workflow condition add`：
-
-| 来源节点 | 目标节点 | 连线名 | 条件 | 来源 | 操作 | 值/右字段 | 明细量词 | 备注 |
-|---|---|---|---|---|---|---|---|---|
-| 发起 | 初审 | 部门初审 | 所属部门=财务部 | form:所属部门 | 等于 | 财务部 | — | |
-| 发起 | 初审 | 部门初审 | 报销金额5k~10k | form:报销金额 | 范围 | 5000:10000 | — | 数值范围 |
-| 发起 | 初审 | 部门初审 | 发起时间≥报销日期 | system:发起时间 | 大于等于 | field:报销日期 | — | 变量模式 |
-| 发起 | 初审 | 部门初审 | 报销类型∈{差旅,住宿} | form:报销类型 | 属于 | 差旅费,住宿费 | 任一 | 与下行OR |
-| 发起 | 初审 | 部门初审 | 同上OR组 | form:发票编号 | 包含 | FP | 任一 | 接上行OR |
-
-要点：每行一条原子条件，OR 组拆多行备注"与下行OR"；操作列 等于/大于/小于/范围/属于/包含/为空/不为空/field(变量模式)；值列字面值直接写、`field:`前缀引用另一字段；明细量词 任一(任一行)/所有(所有行)/—(主表)；创建完 `workflow condition list <wf>` 回读核对总数一致
-
-- [ ] 出口名 | `workflow link-rename <wf> <linkId> <业务人话>`（分支连线尤其要改）
-
-##### 4.4 节点级配置（每个审批节点一组，逐个复制）
-###### ▶ 节点：<节点名> | nodeId: 待创建
-- [ ] 操作者 | `workflow set-operator <wf> <node> [keyword] --type <user/role/dept/position/all/free/superior/initiator/prev-node/form/matrix> --sign-order <会签/竞签/依次/抄送>`（`--append` 多组叠加）
-- [ ] 提交校验 | `workflow node validate <wf> <node> --rule "字段 操作 值"`（跨表用"明细表名.字段"，如 `行程明细.开始时间 等于 出差开始日期`）
-- [ ] 签字意见必填 | `workflow node sign <wf> <node> --select "退回"`（退回等操作类型必填意见）
-- [ ] 节点菜单 | `workflow node menu <wf> <node> --toggle <menuId>`
-- [ ] 退回设置 | `workflow node reject <wf> <node>`
-- [ ] 超时处理 | `workflow node timeout <wf> <node>`
-- [ ] 字段权限 | `workflow node field-permission set <wf> <node> --hide <字段...>`
-
-##### 4.5 流程级设置（来源: 本流程 <流程名A>）
-- [ ] 流程编号 | `workflow numbering set <wf> --prefix LC --serial 4 --no-year`（REQUEST_NO，绑流程表必走）
-- [ ] 流程标题 | `workflow setting title <wf> --rule "发起人|提交日期|客户名称"`（标题=流程名+系统字段则跳过）
-- [ ] 提交确认 | `workflow setting submit <wf>`
-- [ ] 签字意见 | `workflow setting sign <wf>`
-- [ ] 评论 | `workflow setting comment <wf> --enable`
-- [ ] 批量操作 | `workflow setting batch <wf>`
-- [ ] 自动处理 | `workflow setting auto <wf>`
-- [ ] 其他 | `workflow setting other <wf>`
-- [ ] 存档 | `workflow advanced doc <wf>`
-- [ ] 定时触发 | `workflow advanced schedule <wf>` + `schedule-range <wf>`（人员范围）
-- [ ] 消息提醒 | `workflow message create`（IM 提醒动作流）
-
-##### 4.6 动作流（跨表写入/自动化）
-- [ ] 动作流生成 | `actionflow generate '{"planFile":"@plan.json",...}'`（来源: 本流程触发 → 目标: <目标表单>）
-- [ ] 节点字段赋值 | `workflow save-action @action.json`（来源: 本流程 <节点名>）
-- [ ] 数据来源落点 | 目标台账建 Flow 字段 `form add-field <目标台账objId> <app> "数据来源" Flow --sform-id <本流程表单objId>`（来源: 本流程 → 落点: <目标台账表单名>），add 时 `--sysvar` 写 requestId，**update/delete 也靠它定位**
-
-#### ▼ 流程：<流程名B> | workflowId: 待创建
-（同上 4.1-4.6 复制）
-
----
-
-### 5. 菜单（来源: 应用）
-- [ ] 台账菜单 | `menu add-table <appId> <objId>`（来源: <表单名>；form create 已自动加，补加用此）
-- [ ] 发起菜单 | `menu add-start <appId> <formObjId>`（来源: <流程名>绑定的表单；workflow create 已自动加）
-- [ ] 自定义菜单 | `menu add <名> <path> <appId>`（LINK，ecode 页面）
-- [ ] 菜单权限 | `menu permission`（岗位/角色/部门/人员可见）
-
-### 6. 页面（定制）
-- [ ] 无定制 | 标「### 页面（无需，表单自带台账）」
-- [ ] 定制页面 | Ecode `project create/import` + 页面编码（图表/跨表聚合/特殊交互）
-
-### 7. 矩阵（HRM，按需）
-- [ ] <矩阵名> | `matrix create` + `config-edit` + `enable` + `data`（来源: 被 <流程名> 的 `set-operator --type matrix` 引用）
-
-## 执行分段（最多三段，每段完成停下来让用户确认，确认后才进下一段）
-- 段① 应用+角色+全部表单（建表 + 3.2 表内项配齐，**缺一项这张表不算完成**）→ 确认字段设计 → 段② 流程（先列出口条件清单→逐条 `condition add`→`condition list` 回读核对）→ 确认流程 → 段③ 菜单+页面
-- 简单单步需求（改字段、查数据）不分段，直接执行
-> **表单是流程的地基**：流程绑定表单、条件/动作流/操作者都引用字段，字段设计错了流程全返工——表单段必须确认后再进流程
-
-## 规则备忘
-- **执行前读指南**：每个命令的完整参数/边界/示例在对应 `references` 文档（SKILL.md 决策树按关键词路由），动手前先读，勿凭印象调命令出错
-- Plan 阶段不调 e10-cli 写命令（可 list/read 查现状）；必须写 plan.md 落地，不要只在对话里列方案
-- 应用数量：默认全需求只建 1 个应用，不按功能点拆；确需多应用先跟用户确认
-- 流程按节点逐行，操作者含签署方式/条件/动作流挂节点；**「A 或 B 审批」= 一节点多人 + 竞签/非会签，不拆节点**
-- 台账页面不用写，表单自带台账（搜索/筛选/导出/批量）
-- 表单字段一次性建好（`form create --fields`），singleRow/group 建表时定，勿留建后补
-```
-
----
-
-## 来源标注方式
-
-| 配置项类型 | 来源标注方式 |
-|----------|------------|
-| 表单级配置（3.2/3.3） | 分组头 `▼ 表单：<表单名A> | objId: 待创建`，其下项来源=该表单 |
-| 流程级配置（4.2/4.3/4.5） | 分组头 `▼ 流程：<流程名A> | workflowId: 待创建`，其下项来源=该流程 |
-| 节点级配置（4.4） | 子分组头 `▶ 节点：<节点名> | nodeId: 待创建`，其下项来源=该节点 |
-| 跨表项（动作流落点） | 内联标 `来源: 本流程 → 落点: <目标台账表单名>` |
-| 菜单/矩阵 | 内联标 `来源: <表单名>` / `被 <流程名> 引用` |
-
-多张表/多个流程时，复制对应 `▼` 分组（每张表/每个流程一组），来源即分组头声明。每个 `[ ]` 都能看清属于哪个表单/流程/节点，不会把 A 表的配置错配到 B 表。
+# 搭建计划模板（plan.md 强制格式）
+
+> 这是 `plan.md` 的**强制模板**。写 plan.md 必须照此格式逐项梳理资源与规则，**禁止自创格式、禁止预勾 `[x]`**。
+> `[ ]` = 待办；执行阶段做完一项、验证通过，才改 `[x]` 并填实际 ID。全部 `[x]` 才算完工。
+
+## 使用方法
+
+1. 复制下方「plan.md 骨架」到工作区 `plan.md`
+2. 按需求逐项填实（应用/表单/流程/出口条件清单/菜单/页面/必做项）
+3. 规划阶段全部留 `[ ]`，拿给用户确认（此阶段不调 e10-cli 写命令，可 list/read 查现状）
+4. 用户确认后逐项执行，每做完一项、验证通过，改 `[x]` 并填 ID——完成一条打勾一条
+5. **执行每项前，先按 SKILL.md 决策树读对应 `references` 指南**——命令的完整参数/边界/坑/示例都在指南里，认真阅读再动手，不要凭印象直接调命令
+
+---
+
+## plan.md 骨架
+
+```md
+## 搭建计划
+
+> ⚠️ `[ ]` 是待办，不是"已规划"。规划阶段全部留 `[ ]`；执行阶段做完一项、验证通过，才改 `[x]` 并填 ID。**完成一条打勾一条**，全部 `[x]` 才算完工。**禁止预勾 `[x]`**（=谎报完成）。勿依赖平台默认值——平台默认值≠方案要求。
+> **来源标注**：每张表/每个流程/每个节点用分组头声明（名称+ID 占位），其下 `[ ]` 项的来源即该分组；跨表的项内联标「来源: <表单/流程>」。
+
+### 0. 环境
+- [ ] 鉴权 `e10-cli auth status`（profile 切换 `auth profile use` / 新环境 `auth set --eteamsid --base-url`）
+
+### 1. 应用
+- [ ] <应用名> | `app create` | ID: 待创建
+  > 默认一份完整业务方案落在一个主应用；需求明确指定已有应用、跨应用资源或独立业务边界时，按实际范围处理，并标明每项资源归属。
+
+### 2. 角色（来源: 全应用）
+- [ ] <角色名> | `role create` + `role add-member <roleId> <keyword>` | 方案要求的每个角色都要建，不会自动有
+
+---
+
+### 3. 表单（每张表一组，逐张复制此分组）
+
+#### ▼ 表单：<表单名A> | objId: 待创建
+
+##### 3.1 字段定义（建表时一次性，`form create --fields` --layout FLOW|EXCEL）
+- [ ] <表单名> | ID: 待创建
+  布局: FLOW（流式）/ EXCEL（表格，缺省）
+  字段:
+    1. 名称(Text, 必填)
+    2. 金额(Money, precision=2, 只读)
+    3. 备注(TextArea, 独占一行)
+    4. 客户名称(Text, group=基本信息, 必填)
+    5. 联系电话(Phone, group=基本信息)
+    6. 明细表(DetailTable, formFields:[...])
+    7. 关联客户(EBuilder, sformId+dataTitle)
+    8. 关联流程(Flow, sformId=<流程绑定的表单objId>)  ← sformId 指向哪个流程表单，浏览时就只选该表单绑定的流程数据，创建时自动绑定
+  - 选项/编号/默认值/精度/百分比/maxLen 建表时写全；单位无独立属性，**写进字段名**如 `工时单价(元)`
+  - **布局与显示属性**：方案文档明确要求的必填(`required`)、只读(`readOnly`)、隐藏(`hidden`)、独占一行(`singleRow`)、分组(`group`)、字段顺序——全部标在字段清单里，建表时 fields.json 一并带上，勿留建后补。方案未提到的用默认（EXCEL 两列、不分组、不必填）
+  - 公式/值带出可 inline：`formula` / `relateFrom`
+  - **Flow 字段**：`sformId` 是流程表单 objId（不是 workflowId），建表时写进 fields.json 即自动绑定——关联到哪个流程表单就只能选该范围的流程数据，无需单独配数据范围
+  > 不要先建空表再 add-field——add-field/edit-field 只是**罕见补救手段**
+
+##### 3.1.1 表单布局蓝图（需求提供完整布局样表时必填；否则标“— 未提供，使用默认布局”）
+- [ ] 布局类型：EXCEL / FLOW
+- [ ] 来源：<需求文档章节或表格标题>
+- [ ] 物理列结构：<如 4 列：标签｜字段｜标签｜字段>
+
+| 行 | 类型 | 左侧单元 | 右侧单元 | 跨列/占位 | 原文属性与说明 |
+|---|---|---|---|---|---|
+| 1 | 标题 | <表单标题> | — | 跨全部列 | |
+| 2 | 字段 | <标签> → [<字段名>] | 空 | 右侧留空 | 只读 |
+| 3 | 分组 | <分组名> | — | 跨全部列 | |
+| 4 | 字段 | <标签> → [<字段名>] | <标签> → [<字段名>] | 双字段 | 必填；只读 |
+
+  > 逐行保留标题、分组、字段同排关系、字段先后、空白占位和可确认的跨列信息。`group`、`singleRow`、字段数组顺序不能替代此蓝图。Markdown 无法确认合并范围时写“待确认”，不要猜测。
+  > 蓝图中的必填/只读/公式/校验/联动还必须同步进入字段定义或 3.2 表单级配置，不能只留在布局表中。
+  > 本蓝图仅用于保存需求和指导执行，不单独提交人工审核，也不增加确认步骤；它不是 CLI JSON 入参。执行时据此组织 `fields.json` 并用现有 EXCEL 初始化创建，创建后仅在实际需要时按当前布局逐项调整。
+
+##### 3.2 表单级配置（来源: 本表单 <表单名A>；建表后逐项配齐，缺一项这张表不算完成）
+- [ ] 复杂编号 | `form serial-mark set <objId> <appId> <fieldId> --segments @json`（纯建模表：fixed/year/serial/field/system/date+代字；⚠ 绑流程表无效→走 `workflow numbering`）
+- [ ] 值带出（关联表） | `form relate <appId> <objId> <目标字段> --from <Employee/Department源字段>`（换申请人→填邮箱/工号/部门；HRM属性带出，简单单源）
+- [ ] 值带出（跨表/多跳） | `form field-linkage add <appId> <objId> --trigger <触发字段> --target <目标字段> --hops "<源表objId:带出字段,源表objId:带出字段,...>"`（跨表查询带出，支持多跳链式中转；Text 字段必须多跳到名称表取名称不能直接赋 ID）
+- [ ] 关联显示列 | `form ebuilder-columns <objId> <appId> <fieldId> [字段名...]`（先不带参数看业务字段候选清单，去系统字段）
+- [ ] 关联数据范围 | `form ebuilder-scope set <objId> <appId> <fieldId> --rules '[...]'`（如客户状态=启用才可选）
+- [ ] 字段公式 | `form formula set --expression "DAYS({主表.开始},{主表.结束})" --target <fieldId>`（或 fields.json inline）
+- [ ] 查重校验 | `form validate add <objId> <appId> <字段名...>`（项目名称重名/工时日期重复）
+- [ ] 显隐联动 | `form linkage add <appId> <objId> <名> --config @json`（prop: hide/show/edit/readonly/required/hideLine）
+- [ ] 字段分组 | `form group <objId> <appId> --groups '{"基本信息":[...]}'`（建表时已用 group 则跳过）
+- [ ] 表单权限 | `form permission add <objId> <appId> --org-type <all/role/dept/...> --right-type <0/1/2/3>`（勿默认所有人）
+- [ ] 表单页按钮 | 名称/位置/来源页面/打开目标/字段映射 | `form button add`（固定URL、视图、布局或流程；[指南](../form/guide-form-button.md)）
+
+##### 3.3 台账/视图配置（来源: 本表单 <表单名A> 的台账；无需求标「— 无」）
+- [ ] 显示列批量设置 | `form list-columns <objId> <appId> <listId> --set @columns.json`（[指南](../form/guide-list-columns.md)）
+- [ ] 列单位 | `form list-unit <objId> <appId> <listId> <fieldId> "（元）"`
+- [ ] 列格式 | `form list-format <objId> <appId> <listId> <fieldId> [--thousandths] [--decimal <n>]`
+- [ ] 字段事件（列点击跳转） | `form list-click <objId> <appId> <listId> <fieldId> [--target <objId>]`
+- [ ] 搜索条件 | `form list-search <objId> <appId> <listId> [--add <f>] [--quick <f>]`
+- [ ] 排序 | `form list-sort <objId> <appId> <listId> [--field <f>] [--order ASC|DESC]`
+- [ ] 顶部统计（主表/明细） | `form list-stats <objId> <appId> <listId> --add @json`（[指南](../form/guide-list-stats.md)）
+- [ ] 视图数据条件 | `form list-filter <objId> <appId> <listId> --add '{"conditions":[...]}'`
+- [ ] 关联页签及目标视图 | `form association create <objId> <appId> <名> --view <viewId> --permissions @json`（[指南](../form/guide-form-association.md)）
+- [ ] 关联页签布局与终端 | `form association update <objId> <appId> <associationId> --layouts 显示 --terminals PC MOBILE`（[指南](../form/guide-form-association.md)）
+- [ ] 关联页签数据筛选 | `form association set-filter <objId> <appId> <associationId> --mappings @json`（[指南](../form/guide-form-association.md)）
+- [ ] 视图按钮 | 名称: <按钮名> | 来源视图: <名称/listId> | 位置: <行上/行末下拉/右上/右上下拉> | 动作: <打开视图/布局/流程/URL及目标ID> | 映射: <目标字段 ← 当前行来源字段；无则“无”> | `form button add` / `form button action-set`（[指南](../form/guide-form-button.md)）
+- [ ] 行事件（整行点击） | `form list-event <objId> <appId> <listId> --add-page '{...}'`
+- [ ] 视图启用分组 | `form list-group <objId> <appId> <listId> --enable --group-field <fieldId>`（[指南](../form/guide-form-view.md)）
+- [ ] 上下级树形展示 | `form list-hierarchy <objId> <appId> <listId> --enable --parent-field <自关联字段名或ID> --expand-level <层级>`（如根据“上级类型”展示；不同于普通字段分组，[指南](../form/guide-form-view.md)）
+- [ ] 主表合并行 | `form list-merge <objId> <appId> <listId>`
+- [ ] 台账视图权限 | `form list-permission <objId> <appId> <listId> [--add-all|--add-user <id> --name <n>]`
+- [ ] 分类搜索 | `form list-search-group <objId> <appId> <listId> [--add <选项fieldId>]`
+- [ ] 自定义视图 | `form view create <objId> <appId> <名> --type kanbanView|calendarView|mindMapView|multiView` + `form view populate`
+- [ ] 表格视图 | 默认复用台账，记录实际名称/listId；额外新建才用 `form table-view create <objId> <appId> <名>`（[指南](../form/guide-form-view.md)）
+  > 表单自带台账（搜索/筛选/导出/批量）。本节只列有需求的项；无需求标「— 无」
+
+#### ▼ 表单：<表单名B> | objId: 待创建
+（同上 3.1/3.2/3.3 复制）
+
+---
+
+### 4. 流程（每个流程一组，逐个复制此分组）
+
+#### ▼ 流程：<流程名A> | workflowId: 待创建
+
+##### 4.1 创建
+- [ ] 创建 | `workflow create <appId> <formObjId> <名>`（默认不加菜单；确认需要发起入口时 `--menu` 加）
+  > ⚠️ **流程级必做**：① 流程编号（`workflow numbering`）；② 出口名称（`workflow link-rename`，改业务人话）；③ 出口条件清单（见 4.3，先列全表再逐条创建，勿凭印象跳步）
+
+##### 4.2 节点与连线（来源: 本流程 <流程名A>；每节点一行）
+> ⚠️ 操作者按需求语义用对应 `--type`（role/dept/position/superior/initiator/form/matrix/free/all），**禁止兜底成具体人员顶替**；名称解析不到先停下确认。
+- [ ] 节点1 | 操作者: 创建人
+- [ ] 节点2 | 操作者: 区域经理+部门领导(竞签)  ← 「A或B审批」=一节点多人+竞签/非会签，不拆节点
+- [ ] 节点3 | 条件: <字段>=<值> 才走到，否则跳过/直达<节点>
+- [ ] 节点4 | 操作者: 角色X ｜ 动作流: → <目标表>(add/update/delete, 映射: 源→目标)
+- [ ] 连线 | `workflow add-link/add-links <wf> <from> <to> <label>` [--reject 退回] [--default 默认]
+
+##### 4.3 出口条件清单（来源: 本流程 <流程名A>；必填，动手前逐条列出，防遗漏）
+段② 执行到条件时，先按此表列出所有连线的完整条件，逐条确认后再 `workflow condition add`：
+
+| 来源节点 | 目标节点 | 连线名 | 条件 | 来源 | 操作 | 值/右字段 | 明细量词 | 备注 |
+|---|---|---|---|---|---|---|---|---|
+| 发起 | 初审 | 部门初审 | 所属部门=财务部 | form:所属部门 | 等于 | 财务部 | — | |
+| 发起 | 初审 | 部门初审 | 报销金额5k~10k | form:报销金额 | 范围 | 5000:10000 | — | 数值范围 |
+| 发起 | 初审 | 部门初审 | 发起时间≥报销日期 | system:发起时间 | 大于等于 | field:报销日期 | — | 变量模式 |
+| 发起 | 初审 | 部门初审 | 报销类型∈{差旅,住宿} | form:报销类型 | 属于 | 差旅费,住宿费 | 任一 | 与下行OR |
+| 发起 | 初审 | 部门初审 | 同上OR组 | form:发票编号 | 包含 | FP | 任一 | 接上行OR |
+
+要点：每行一条原子条件，OR 组拆多行备注"与下行OR"；操作列 等于/大于/小于/范围/属于/包含/为空/不为空/field(变量模式)；值列字面值直接写、`field:`前缀引用另一字段；明细量词 任一(任一行)/所有(所有行)/—(主表)；创建完 `workflow condition list <wf>` 回读核对总数一致
+
+- [ ] 出口名 | `workflow link-rename <wf> <linkId> <业务人话>`（分支连线尤其要改）
+
+##### 4.4 节点级配置（每个审批节点一组，逐个复制）
+###### ▶ 节点：<节点名> | nodeId: 待创建
+- [ ] 操作者 | `workflow set-operator <wf> <node> [keyword] --type <user/role/dept/position/all/free/superior/initiator/prev-node/form/matrix> --sign-order <会签/竞签/依次/抄送>`（`--append` 多组叠加）
+- [ ] 提交校验 | `workflow node validate <wf> <node> --rule "字段 操作 值"`（跨表用"明细表名.字段"，如 `行程明细.开始时间 等于 出差开始日期`）
+- [ ] 签字意见必填 | `workflow node sign <wf> <node> --select "退回"`（退回等操作类型必填意见）
+- [ ] 节点菜单 | `workflow node menu <wf> <node> --toggle <menuId>`
+- [ ] 退回设置 | `workflow node reject <wf> <node>`
+- [ ] 超时处理 | `workflow node timeout <wf> <node>`
+- [ ] 字段权限 | `workflow node field-permission set <wf> <node> --hide <字段...>`
+
+##### 4.5 流程级设置（来源: 本流程 <流程名A>）
+- [ ] 流程编号 | `workflow numbering set <wf> --prefix LC --serial 4 --no-year`（REQUEST_NO，绑流程表必走）
+- [ ] 流程标题 | `workflow setting title <wf> --rule "发起人|提交日期|客户名称"`（标题=流程名+系统字段则跳过）
+- [ ] 提交确认 | `workflow setting submit <wf>`
+- [ ] 签字意见 | `workflow setting sign <wf>`
+- [ ] 评论 | `workflow setting comment <wf> --enable`
+- [ ] 批量操作 | `workflow setting batch <wf>`
+- [ ] 自动处理 | `workflow setting auto <wf>`
+- [ ] 其他 | `workflow setting other <wf>`
+- [ ] 存档 | `workflow advanced doc <wf>`
+- [ ] 定时触发 | `workflow advanced schedule <wf>` + `schedule-range <wf>`（人员范围）
+- [ ] 消息提醒 | `workflow message create`（IM 提醒动作流）
+
+##### 4.6 动作流（跨表写入/自动化）
+- [ ] 动作流生成 | `actionflow generate '{"planFile":"@plan.json",...}'`（来源: 本流程触发 → 目标: <目标表单>）
+- [ ] 节点字段赋值 | `workflow save-action @action.json`（来源: 本流程 <节点名>）
+- [ ] 数据来源落点 | 目标台账建 Flow 字段 `form add-field <目标台账objId> <app> "数据来源" Flow --sform-id <本流程表单objId>`（来源: 本流程 → 落点: <目标台账表单名>），add 时 `--sysvar` 写 requestId，**update/delete 也靠它定位**
+
+#### ▼ 流程：<流程名B> | workflowId: 待创建
+（同上 4.1-4.6 复制）
+
+---
+
+### 5. 菜单（来源: 应用）
+- [ ] 台账菜单 | 建表时需要入口则使用 `form create --menu`；未生成入口时用 `menu add-table <appId> <objId>` 补加（默认台账视图存在不等于菜单入口存在）
+- [ ] 发起菜单 | `menu add-start <appId> <formObjId>`（来源: <流程名>绑定的表单；workflow create 已自动加）
+- [ ] 自定义菜单 | `menu add <名> <path> <appId>`（LINK，ecode 页面）
+- [ ] 菜单权限 | `menu permission`（岗位/角色/部门/人员可见）
+
+### 6. 页面（定制）
+- [ ] 无定制 | 标「### 页面（无需，表单自带台账）」
+- [ ] 定制页面 | Ecode `project create/import` + 页面编码（图表/跨表聚合/特殊交互）
+
+### 7. 矩阵（HRM，按需）
+- [ ] <矩阵名> | `matrix create` + `config-edit` + `enable` + `data`（来源: 被 <流程名> 的 `set-operator --type matrix` 引用）
+
+## 执行分段（最多三段，每段完成停下来让用户确认，确认后才进下一段）
+- 段① 应用+角色+全部表单（建表 + 3.2 表内项配齐，**缺一项这张表不算完成**）→ 确认字段设计 → 段② 流程（先列出口条件清单→逐条 `condition add`→`condition list` 回读核对）→ 确认流程 → 段③ 菜单+页面
+- 简单单步需求（改字段、查数据）不分段，直接执行
+> **表单是流程的地基**：流程绑定表单、条件/动作流/操作者都引用字段，字段设计错了流程全返工——表单段必须确认后再进流程
+
+## 规则备忘
+- **执行前读指南**：每个命令的完整参数/边界/示例在对应 `references` 文档（SKILL.md 决策树按关键词路由），动手前先读，勿凭印象调命令出错
+- Plan 阶段不调 e10-cli 写命令（可 list/read 查现状）；必须写 plan.md 落地，不要只在对话里列方案
+- 应用数量：默认全需求只建 1 个应用，不按功能点拆；确需多应用先跟用户确认
+- 流程按节点逐行，操作者含签署方式/条件/动作流挂节点；**「A 或 B 审批」= 一节点多人 + 竞签/非会签，不拆节点**
+- 台账页面不用写，表单自带台账（搜索/筛选/导出/批量）
+- 表单字段一次性建好（`form create --fields`），singleRow/group 建表时定，勿留建后补
+- 需求提供完整布局样表时，字段清单和“表单布局蓝图”必须同时存在：前者定义字段，后者保留空间结构；字段覆盖数、同排关系、分组顺序和原文说明应逐项对应
+```
+
+---
+
+## 来源标注方式
+
+| 配置项类型 | 来源标注方式 |
+|----------|------------|
+| 表单级配置（3.2/3.3） | 分组头 `▼ 表单：<表单名A> | objId: 待创建`，其下项来源=该表单 |
+| 流程级配置（4.2/4.3/4.5） | 分组头 `▼ 流程：<流程名A> | workflowId: 待创建`，其下项来源=该流程 |
+| 节点级配置（4.4） | 子分组头 `▶ 节点：<节点名> | nodeId: 待创建`，其下项来源=该节点 |
+| 跨表项（动作流落点） | 内联标 `来源: 本流程 → 落点: <目标台账表单名>` |
+| 菜单/矩阵 | 内联标 `来源: <表单名>` / `被 <流程名> 引用` |
+
+多张表/多个流程时，复制对应 `▼` 分组（每张表/每个流程一组），来源即分组头声明。每个 `[ ]` 都能看清属于哪个表单/流程/节点，不会把 A 表的配置错配到 B 表。