weaver-e10-builder 1.5.6 → 1.5.9

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

@@ -1,260 +1,164 @@
-# 搭建计划模板（plan.md 强制格式）
+# 搭建计划模板（按依赖与功能批次执行）
 
-> 这是 `plan.md` 的**强制模板**。写 plan.md 必须照此格式逐项梳理资源与规则，**禁止自创格式、禁止预勾 `[x]`**。
-> `[ ]` = 待办；执行阶段做完一项、验证通过，才改 `[x]` 并填实际 ID。全部 `[x]` 才算完工。
+使用本模板生成项目 `plan.md` 时，先读[规划能力地图](map.md)识别资源、配置和依赖；需要明确具体规则或能力边界时读对应专题指南，再填写实际涉及的条目。执行某项前仍须读取该项指南。
 
-## 使用方法
+规划阶段全部保持 `[ ]`。第一阶段先完成全部表单的字段、明细和布局，再以**功能项为外层、所有适用表单/视图为内层**组织配置：例如先完成所有表单的关联浏览数据范围，再处理所有表单的公式；视图也按显示列、搜索、排序等功能逐批覆盖。每进入一个功能项先读对应指南，确认方法、参数和边界；同一连续批次已读过的无需重复读取。每个对象及独立规则分别列项、核对、回填和销号；暂不能完成的保留 `[ ]` 并注明原因、已完成部分及所需条件，继续处理其他项目，不因步骤繁琐而省略。整个功能批次的覆盖对象处理完后进入下一批次，真实依赖优先于批次顺序。每段完成后停下让用户确认，确认后进入下一段。仅单步修改或查询不套用三段流程。
 
-1. 复制下方「plan.md 骨架」到工作区 `plan.md`
-2. 按需求逐项填实（应用/表单/流程/出口条件清单/菜单/页面/必做项）
-3. 规划阶段全部留 `[ ]`，拿给用户确认（此阶段不调 e10-cli 写命令，可 list/read 查现状）
-4. 用户确认后逐项执行，每做完一项、验证通过，改 `[x]` 并填 ID——完成一条打勾一条
-5. **执行每项前，先按 SKILL.md 决策树读对应 `references` 指南**——命令的完整参数/边界/坑/示例都在指南里，认真阅读再动手，不要凭印象直接调命令
+## plan.md 参考骨架
 
-流程明确使用权责表时，在对应流程下列明搭建方式、新建或复用的权责表、变量与字段映射，以及各分支的场景说明、条件、经过节点和顺序；详细配置读取 `references/workflow/guide-workflow-auth-resp.md`。
-
----
-
-## plan.md 骨架
+复制本节到项目工作区的 `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 字段定义（按[新建 EBuilder 表单](../form/guide-create-form.md)整理，建表时通过 `form create --fields` 一次创建）
-- [ ] <表单名> | ID: 待创建
-  类型: 普通 EB 表单 / 虚拟表（虚拟表按[虚拟表创建与维护](../form/guide-virtual-form.md)记录来源和字段映射）
-  布局: 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 两列、不分组、不必填）
-  - **日期区间**：字段本身包含起止含义时优先规划为 `DateRange`；明确分列或需独立参与公式、联动时再拆成两个日期字段
-  - **字段多语言**：需求写成 `中文/English` 时，字段清单保留两种名称并注明“多语言”；创建时字段名只用中文，建成取得 fieldId 后执行 `form field-lang set --zh <中文> --en <English>`，不可把斜杠名称原样落库
-  - 公式/值带出可 inline：`formula` / `relateFrom`
-  - **Flow 字段**：`sformId` 是流程表单 objId（不是 workflowId），建表时写进 fields.json 即自动绑定——关联到哪个流程表单就只能选该范围的流程数据，无需单独配数据范围
-  - **二级明细**：逐条列出“父明细 → 子明细”、父级行标识、子级文本行标识和是否默认展开；执行时先读取父明细的可选子明细，再按[二级明细表配置](../form/guide-form-sub-detail.md)创建并回读。
-  > **新建表单**时把字段一次规划全、随建表写进 `fields.json`，别先建空表再一个个补——补字段要重排布局，容易漏掉布局属性。
-  > 这句只针对「新建」。`add-field` / `edit-field` **是维护已有表的正常命令**，不是补救手段：
-  > - 给**已经存在**的表加字段 → `form add-field`
-  > - 改已有字段的类型 / 标题 / 必填 / 长度 / 描述 → `form edit-field`（**支持改类型**，走读-改-写，不用删字段重建，显示名 / 列名 / 位置都保留）
-
-虚拟表补充清单（普通 EB 表单删除本段）：
-- [ ] 数据源定位 | 来源类别: EB 表单 / 系统业务表 / 数据加工 | 名称/ID: <来源>
-- [ ] 数据源预检 | 稳定 ID 校验通过
-- [ ] 字段映射 | <来源字段(dataKey/sourceFieldType)> → <虚拟表字段及兼容展示类型>
-- [ ] 虚拟表创建 | `form virtual create` | objId/formId: 待回填
-
-##### 3.1.1 表单布局蓝图（按[表单布局规划](../form/guide-form-layout-planning.md)识别；需求提供完整布局样表时必填，否则标“— 未提供，使用默认布局”）
-- [ ] 布局类型：EXCEL / FLOW
-- [ ] 来源：<需求文档章节或表格标题>
-- [ ] 物理列结构：<如 4 列：标签｜字段｜标签｜字段>
+> `[ ]` 为未完成；写入且按该项风险完成必要核验后，才改 `[x]` 并填写真实 ID 或结果。尚待后续资源的项保留 `[ ]` 并写明依赖。
+> 来源可用需求文档章节、表格或图片标题。已有资源先只读盘点，记明复用/修改/新建及实际 ID。
+
+### 0. 环境与范围
+- 目标环境/profile：<名称与地址>；所属机构：<名称/ID>；主应用：<名称/ID>
+- 跨应用资源与范围：<无/资源及归属>
+- 待业务确认：<歧义及其影响；无则“无”>
+- 待环境核查：<资源或环境行为；无则“无”>
+
+### 1. 资源清单与依赖
+
+| 资源 | 决策与归属 | 来源及用途 | 前置依赖 | 实际 ID/结果 |
+|---|---|---|---|---|
+| 应用 <名称> | 新建/复用；机构 <名称> | <来源> | 环境 | 待回填 appId |
+| 角色 <名称> | 新建/复用 | <来源、成员类型与范围> | 机构 | 待回填 roleId |
+| 矩阵 <名称> | 新建/复用 | <来源、条件列/值列/行数据> | 机构、人员/部门 | 待回填 matrixId |
+| 表单 <名称> | EB/虚拟/原生流程表单；新建/复用；应用 <名称> | <来源、用途> | 应用、数据源 | 待回填 objId/formId |
+| 视图 <名称> | 默认台账改名/复用/新增；PC/MOBILE | <来源、用途> | 所属表单 | 待回填 listId/viewId |
+| 流程 <名称> | EB/原生；普通/公文；固定/自由；新建/复用 | <来源、业务流转> | 表单、角色/矩阵 | 待回填 workflowId |
+| 权责表 <名称> | 随流程新建/独立复用 | <来源、分支场景> | 流程/变量 | 待回填 authRespId |
+| 报表/数据集 <名称> | 新建/复用 | <来源、统计目标> | 来源字段 | 待回填 ID |
+| 菜单/页面 <名称> | 新建/复用 | <来源、入口及目标> | 视图/流程/页面 | 待回填 ID |
+
+> 角色和矩阵先用 `role list`、`matrix list` 只读盘点同名资源及归属、成员或数据行，记录候选 ID，并与用户逐项确认复用还是新建。复用但需补成员或数据行的，在对应功能批次单独列项；没有矩阵需求则不创建。
+
+#### 1.1 表单字段与布局蓝图（每张表单各一份）
+
+##### 表单：<名称>；资源决策：<新建/复用>；objId/formId：<待回填>；来源：<章节>
+- 布局：FLOW/EXCEL；已有表单改造时记录现有布局及保留要求。
+- 字段清单：逐字段写主表/明细表、名称、componentKey、选项、默认值、长度/精度、关联目标、公式及明确的必填/只读/隐藏/独占一行/分组。字段名含中英文时分别记录。
+- 明细表：<名称、字段、层级>；二级明细逐条记录父明细→子明细、父子行标识及默认展开要求。
+- 虚拟表：<来源类别与资源ID、稳定主键、来源字段→展示类型映射>。
+- 关联依赖：<字段→目标表/流程及 ID 待回填位置>。
+- 布局样表来源：<章节/图片/表格；无则“未提供，使用约定布局”>。
 
 | 行 | 类型 | 左侧单元 | 右侧单元 | 跨列/占位 | 原文属性与说明 |
 |---|---|---|---|---|---|
-| 1 | 标题 | <表单标题> | — | 跨全部列 | |
-| 2 | 字段 | <标签> → [<字段名>] | 空 | 右侧留空 | 只读 |
-| 3 | 分组 | <分组名> | — | 跨全部列 | |
-| 4 | 字段 | <标签> → [<字段名>] | <标签> → [<字段名>] | 双字段 | 必填；只读 |
-
-  > 逐行记录标题、分组、字段同排关系、字段先后、空白占位和可确认的跨列信息；合并范围暂时无法确认时标为“待确认”。
-  > 将蓝图中的必填、只读、公式、校验和联动同步写入字段定义或 3.2 表单级配置。
-  > 执行时根据蓝图组织 `fields.json`，使用 EXCEL 布局完成创建和初始化；创建后读取实际布局并按需求调整局部位置或显示属性。
-
-##### 3.2 表单级配置（来源: 本表单 <表单名A>；建表后逐项配齐，缺一项这张表不算完成）
-- [ ] 字段名称多语言 | `form field-lang set <objId> <appId> <fieldId> --zh <中文> --en <English>`（仅需求明确提供多语言名称时列出；先建中文字段再设置）
-- [ ] 复杂编号 | `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 formula-linkage add <appId> <objId> --event changeField --trigger <触发字段> --target <目标字段> --expression "VALUE({主表.数量})*VALUE({主表.单价})"`（本表字段间的公式赋值；表达式只给右侧。系统模块字段如 `{主表.当前日期}` 可作来源/触发，但不可作目标）
-- [ ] 关联显示列 | `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: 待创建
-
-- 流程体系：EB / 原生工作流程
-- 原生类型：普通 / 公文（EB 流程填“—”）
-- 流转模式：固定 / 自由
-- 表单来源：EB 表单 / 自建原生表单 / 已有原生 formId
-
-##### 4.1 创建
-- [ ] 创建 | `workflow create <appId> <formObjId> <名>`（默认不加菜单；确认需要发起入口时 `--menu` 加）
-  > 原生工作流程改用 `workflow create-workflow`；公文类型增加 `--odoc`。布局类型在表单来源后注明。
-  > ⚠️ **流程级必做**：① 流程编号（`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-links <wf> @links.json`（`reject`/`default` 逐条给；默认出口同源节点自动让位）
-- [ ] 结构改完补排版 | `workflow auto-layout <wf>`（**加/删节点、加/删连线之后必跑**；建流程时自动跑过的那一次不算）
-
-###### 权责表设计（搭建方式为权责表时填写，替代普通节点与连线清单）
-- [ ] 权责表来源 | 默认流程内新建；仅多重嵌套或明确复用时选择复用已有 | 权责表：<名称> | authRespId：待回填
-- [ ] 首尾设置 | 发起：<类型及操作者> | 结束：<类型及操作者>
-- [ ] 中间节点 | <节点名称、类型、操作者>
-- [ ] 分支路径 | <场景说明> | 条件：<条件> | 路径：<节点及顺序>
-- [ ] 嵌套权责表 | <适用分支> | 引用：<权责表及版本> | 顺序：<序号>
-- [ ] 条件字段来源 | 系统字段 / 当前流程表单字段 / 独立权责表变量
-- [ ] 变量映射 | <独立权责表变量（主表/明细）> → <当前流程实际表单字段（主表/明细）> / 随流程新建无需映射
-> 权责表方式流程的节点、分支条件和流转路径统一在权责表设计中维护；复用独立权责表时逐项列出变量映射。
-> 一般权责表流程使用 `auth-resp-flow create --new-table`，条件直接引用流程表单字段；多重嵌套或跨流程共享同一权责规则时，才规划独立权责表、嵌套引用及 `--reuse-table` 变量映射。
-
-##### 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>）
-- [ ] 公文设置 | 公文类型、正文、节点、附件、归档、签章、编号及 AI 等配置 | `workflow odoc setting set`（原生类型为公文时按实际需求填写）
-- [ ] 流程编号 | `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` 引用）
-
-## 执行分段（最多三段，每段完成停下来让用户确认，确认后才进下一段）
-以确认后的 `plan.md` 为执行清单，按资源依赖顺序逐项读取相关指南并完成配置；完成并核验一项，就立即勾选对应项并回填实际 ID 或结果。每段结束前检查本段应完成项是否全部销号，依赖后续资源的项目保留 `[ ]` 并注明依赖，不得提前勾选。
-
-- **段①：应用、角色、表单与视图。** 完成应用、角色、全部表单和表单布局，并配齐字段属性、关联、公式、联动、校验、权限、默认台账、新增视图、显示列、搜索排序、筛选统计、分组、上下级、按钮和关联页签等表单及视图相关配置。依赖流程 ID 的配置在 plan 中列明，待段②创建流程后回填。
-- **段②：流程与自动化。** 完成流程创建、节点连线、操作者、出口条件、节点配置、流程级设置、矩阵和动作流，并回填段①中依赖流程 ID 的表单字段、表单按钮和视图按钮。完成后**补跑一次 `workflow auto-layout`**，再确认流程结构及关键条件。
-- **段③：菜单与页面。** 完成台账、流程发起和自定义菜单，配置菜单权限，并按需求创建配置式页面或定制页面，绑定真实资源 ID 后完成保存、发布和整体收尾。
-- 简单单步需求（改字段、查数据）不分段，直接执行
-> **表单是流程的地基**：流程绑定表单、条件/动作流/操作者都引用字段，字段设计错了流程全返工——表单段必须确认后再进流程
-
-## 规则备忘
-- **改完流程结构要补排版**：`workflow auto-layout <wf>` 只在 `create`/`create-workflow` 建流程时自动跑过一次，**之后一律不会顺带重跑**（add-node/add-link/delete-node/delete-link 都不跑）。所以 4.2 的最后一项别省 —— 加完分支线不补，图上就留着交叉。两个边界：① 它是**整图重排**，人在浏览器里拖过的坐标会被覆盖；② **不保证消除交叉**，跨层连线仍可能穿过中间层节点，跑完看一眼流程图，有交叉手工调。
-- **执行前读指南**：每个命令的完整参数/边界/示例在对应 `references` 文档（SKILL.md 决策树按关键词路由），动手前先读，勿凭印象调命令出错
-- Plan 阶段不调 e10-cli 写命令（可 list/read 查现状）；必须写 plan.md 落地，不要只在对话里列方案
-- 应用数量：默认全需求只建 1 个应用，不按功能点拆；确需多应用先跟用户确认
-- 流程按节点逐行，操作者含签署方式/条件/动作流挂节点；**「A 或 B 审批」= 一节点多人 + 竞签/非会签，不拆节点**
-- 台账页面不用写，表单自带台账（搜索/筛选/导出/批量）
-- 表单字段一次性建好（`form create --fields`）；需求明确的 singleRow/group 建表时写入，字段参数按 `references/form/ref-form-fields.md` 确定
-- 需求提供完整布局样表时，字段清单和“表单布局蓝图”必须同时存在：前者定义字段，后者保留空间结构；字段覆盖数、同排关系、分组顺序和原文说明应逐项对应
+| 1 | 标题 | <标题> | — | 跨全部列 | <来源> |
+| 2 | 字段 | <标签>→[字段] | <标签>→[字段] | <同排/留空> | <必填/只读等> |
+| 3 | 分组 | <分组名> | — | 跨全部列 | <顺序> |
+
+> 样表有标题、分组、空白、字段同排或跨列时逐行保留，并与字段清单互相核对。缺少的合并范围标待确认。建新表时按蓝图准备 fields.json，按所选布局创建并初始化；公式、联动、校验等后续配置在功能批次单列。
+
+#### 1.2 视图与流程设计依据
+- 每张视图：所属表单、默认/新增、视图类型、终端、名称、数据范围及需要的显示列/交互要求。
+- 每个流程：表单来源、节点、操作者及签署方式、全部连线、默认出口、逐条条件、节点显示属性和动作流落点。普通流程和权责表流程分别按对应指南列出；权责表逐场景写说明、条件、经过节点及顺序，独立复用时写变量→主/明细字段映射。
+
+### 2. 第一阶段：应用、表单与视图
+
+#### 2.1 资源与字段布局批次
+- [ ] 应用 <名称> | 新建/复用 | appId：待回填 | 核验：<名称与归属>
+- [ ] 角色 <名称> | roleId：待回填 | 核验：<角色及成员；成员可另列项>
+- [ ] 表单 <名称> 的字段、明细及布局 | objId/formId：待回填 | 来源：1.1 <名称> | 核验：字段、布局及默认台账
+- [ ] 表单 <名称> 的字段、明细及布局 | objId/formId：待回填 | 来源：1.1 <名称> | 核验：字段、布局及默认台账
+
+> 先按跨表引用关系建立必要的表单骨架，再补关联目标；不为了凑齐所有表单而破坏实际依赖。新建 EB 表单尽量用 `form create --fields` 一次写入字段与布局属性。依赖流程 ID 的关联字段记录占位，流程建成后回填。
+
+#### 2.2 表单级功能批次（一个功能项覆盖全部相关表单）
+
+> 写实际 plan 时，按 `##### 功能批次：<功能名>｜覆盖表单：<A、B、...>` 分组；组内为每张表单的每条规则分别列 `[ ]`。例如“关联浏览数据范围”涉及客户表、合同表，就在同一批次下列两条，逐条配置并销号，再进入“字段公式”等下一批次。下列每行是应按需求展开的功能项示例，不代表只配置一张表单。
+
+##### 功能批次：关联浏览数据范围｜覆盖表单：<客户表、合同表>
+- [ ] 客户表 / 关联客户字段 | 条件：<规则> | 核验：可选记录
+- [ ] 合同表 / 关联项目字段 | 条件：<规则> | 核验：可选记录
+
+##### 功能批次：<从下列功能项选择一类>｜覆盖表单：<逐一列出>
+
+> 按需求复制此标题，每个标题只放同一功能的待办项，并把覆盖表单逐一展开；下列条目是可选的填写样式。
+- [ ] 关联字段及目标绑定 | 表单/字段：<名称> | 目标：<资源/ID> | 核验：选择范围
+- [ ] 关联浏览显示列 | 表单/字段：<名称> | 列：<字段及顺序> | 核验：弹窗显示
+- [ ] 二级明细关系 | 父表/子表：<名称> | 行标识：<字段> | 核验：逐父行归属
+- [ ] 字段多语言 | 表单/字段：<名称> | 中文/英文：<名称> | 核验：两种名称
+- [ ] 字段公式 | 表单/目标字段：<名称> | 表达式：<公式> | 核验：读回与样例值
+- [ ] 字段带出或函数联动 | 表单/规则：<名称> | 触发/来源/目标/表达式：<内容> | 核验：触发结果
+- [ ] 属性显隐联动 | 表单/规则：<名称> | 条件/目标/状态：<内容> | 核验：条件切换
+- [ ] 查重校验 | 表单/字段：<名称> | 行为：<提示/阻断> | 核验：重复样例
+- [ ] 编号规则 | 表单/字段：<名称> | 组成与位数：<内容> | 核验：生成值
+- [ ] 表单权限 | 表单/主体：<名称> | 新建/查看/编辑/删除范围：<内容> | 核验：授权结果
+- [ ] 表单页按钮 | 表单/页面/位置：<名称> | 目标与字段映射：<内容> | 核验：点击结果
+
+> 每个功能批次先核对覆盖表单清单，再逐表配置；同一表单有多条独立规则时继续拆行。建表时已配置并核验的分组、必填、只读、默认值等写在 2.1 的表单项结果中，不重复执行。
+
+#### 2.3 视图资源批次
+- [ ] 默认台账 <原名> 复用/改名为 <目标名> | 表单：<名称> | listId：待回填 | 核验：名称与类型
+- [ ] 新增视图 <名称> | 表单：<名称> | 类型/终端：<内容> | listId/viewId：待回填 | 核验：可打开且已填充
+
+#### 2.4 视图功能批次（一个功能项覆盖全部相关视图）
+
+> 沿用 2.2 的结构：`##### 功能批次：<功能名>｜覆盖视图：<视图A、视图B、...>`。例如“显示列”先列全部需配置的 PC/MOBILE 视图，每张视图及终端单独列项并完成；再处理搜索、排序等下一批次。以下为需要按需求展开的功能项示例。
+- [ ] 显示列 | 视图/终端：<名称/PC或MOBILE> | 字段/顺序/宽度：<内容> | 核验：列表显示
+- [ ] 列格式或单位 | 视图/字段：<名称> | 格式/单位：<内容> | 核验：展示值
+- [ ] 搜索与排序 | 视图：<名称> | 字段、入口与优先级：<内容> | 核验：查询及顺序
+- [ ] 筛选与顶部统计 | 视图：<名称> | 条件/函数：<内容> | 核验：记录及统计值
+- [ ] 普通分组或上下级 | 视图：<名称> | 分组/父级字段：<内容> | 核验：分组或层级
+- [ ] 视图权限 | 视图/主体：<名称> | 查看/操作范围：<内容> | 核验：权限读回
+- [ ] 行上或右上按钮 | 视图/位置：<名称> | 目标/当前行过滤/预填：<内容> | 核验：点击结果
+- [ ] 行点击或字段点击 | 视图/字段：<名称> | 打开目标和方式：<内容> | 核验：点击结果
+- [ ] 关联页签 | 表单/页签/目标视图：<名称> | 权限/布局/终端/筛选映射：<内容> | 核验：相关数据
+
+> 搜索、排序、筛选和统计若各有独立业务要求，分别建立功能批次和待办项。依赖第二阶段流程 ID 的按钮、流程关联字段等保留 `[ ]` 并注明依赖，在第二阶段回填后销号。第一阶段完成后请用户确认，再进入第二阶段。
+
+### 3. 第二阶段：流程与自动化
+
+#### 3.1 矩阵、权责表及流程资源
+- [ ] 矩阵 <名称> | 条件列/值列/行×列数据：<内容> | matrixId：待回填 | 核验：列、行和值
+- [ ] 流程 <名称> | EB/原生/公文，固定/自由，表单来源：<内容> | workflowId：待回填 | 核验：绑定表单
+- [ ] 本流程全部节点 | 节点名称、类型及顺序：<内容> | 核验：节点 ID 与清单一致
+- [ ] 本流程全部连线 | 源节点→目标节点、连线名称及默认出口：<内容> | 核验：完整拓扑
+- [ ] 本流程出口条件 <源节点→目标节点> | 字段来源、操作、值、AND/OR、明细量词：<内容> | 每条条件复制一项；核验：分支路由
+- [ ] 本流程节点操作者 <节点名> | 角色/矩阵/字段等来源及签署方式：<内容> | 每个节点复制一项；核验：人员范围
+- [ ] 本流程结构排版与核对 | 节点、连线、默认出口、条件及操作者：<内容> | 核验：流程图及配置读回
+- [ ] 权责表 <名称> | 随流程新建/独立复用 | authRespId：待回填 | 核验：场景与节点路径
+
+> 每个流程各复制一组“流程→节点→连线→条件→操作者→结构核对”，逐条流程完成核心流转；独立条件和操作者仍分别列项、分别销号。权责表流程的分支与经过节点按权责表指南在本流程下展开。实际配置按依赖进行，后续若有完整配置命令，可由同一组计划条目核对结果。
+
+#### 3.2 流程附加设置与功能批次
+- [ ] 节点字段权限或布局 | 流程/节点：<名称> | 字段/显示状态：<内容> | 核验：节点页面
+- [ ] 节点校验、退回、超时、菜单或其他行为 | 流程/节点：<名称> | 逐项写明：<内容> | 核验：配置读回
+- [ ] 流程编号、标题、提醒或流程级设置 | 流程：<名称> | 逐项写明：<内容> | 核验：配置读回
+- [ ] 公文专属设置 | 流程：<名称> | 按实际需求列出：<内容> | 核验：对应设置读回
+- [ ] 权责表场景/变量映射 | 权责表：<名称> | 场景条件、路径或变量→字段：<内容> | 核验：路径与映射
+- [ ] 动作流/节点字段赋值 | 触发流程/节点：<名称> | 目标、字段映射及定位：<内容> | 核验：绑定与结果
+- [ ] 回填第一阶段的流程依赖 | 表单字段/视图按钮：<名称> | workflowId/formId：<实际值> | 核验：选择或打开结果
+
+> 核心流转按 3.1 逐流程完成；本节的附加设置可按功能批次处理，但每条独立规则或动作流仍分别列项。第二阶段完成后请用户确认，再进入第三阶段。
+
+### 4. 第三阶段：报表、菜单与页面
+- [ ] 报表数据集 <名称> | 来源、字段、关联：<内容> | datasetId：待回填 | 核验：数据集字段
+- [ ] 报表 <名称> | 布局、查询及共享：<内容> | reportId：待回填 | 核验：展示与授权
+- [ ] 菜单 <名称> | 层级、目标资源及权限：<内容> | menuId：待回填 | 核验：入口与可见范围
+- [ ] 配置式或定制页面 <名称> | 终端、组件/交互、绑定资源：<内容> | pageId：待回填 | 核验：页面加载与业务结果
+
+### 5. 待确认、需补充及无法实现
+| 来源与原需求 | 状态 | 原因或缺失信息 | 影响与后续处理 |
+|---|---|---|---|
+| <章节及要求> | 待业务确认/待环境核查/需其他方式补充/已确认无法实现 | <内容> | <内容> |
+
+> 已确认无法实现的原需求项保持 `[ ]`，不得以替代配置冒充完成；在此说明原因和影响，交由用户决定。其他状态继续保留相应待办与依赖。
+
+### 6. 阶段验收与交付资源
+- 第一阶段：全部应建表单的字段、明细、布局和默认台账已核对；表单级与视图级需求逐项销号，后续流程依赖已标注。
+- 第二阶段：流程结构、关键条件、操作者及动作流已核对；第一阶段的流程依赖项已回填。
+- 第三阶段：报表、菜单和页面入口已核对；交付时列出应用→表单→视图、流程、矩阵、报表、页面的真实 ID 与未完成项。
 ```
 
----
-
-## 来源标注方式
-
-| 配置项类型 | 来源标注方式 |
-|----------|------------|
-| 表单级配置（3.2/3.3） | 分组头 `▼ 表单：<表单名A> | objId: 待创建`，其下项来源=该表单 |
-| 流程级配置（4.2/4.3/4.5） | 分组头 `▼ 流程：<流程名A> | workflowId: 待创建`，其下项来源=该流程 |
-| 节点级配置（4.4） | 子分组头 `▶ 节点：<节点名> | nodeId: 待创建`，其下项来源=该节点 |
-| 跨表项（动作流落点） | 内联标 `来源: 本流程 → 落点: <目标台账表单名>` |
-| 菜单/矩阵 | 内联标 `来源: <表单名>` / `被 <流程名> 引用` |
+## 使用边界
 
-多张表/多个流程时，复制对应 `▼` 分组（每张表/每个流程一组），来源即分组头声明。每个 `[ ]` 都能看清属于哪个表单/流程/节点，不会把 A 表的配置错配到 B 表。
+- 资源清单负责保存“建什么、复用什么、谁依赖谁”，功能批次负责“具体配置什么”；两处用资源名称或实际 ID 对应，不重复创建同一资源。
+- 字段和布局蓝图仍逐表保存，防止按功能批次执行时遗失字段顺序、分组和表格空间结构。
+- 功能批次只规定同类操作的优先处理顺序。出现跨表循环、流程 ID、目标页面等依赖时，按真实依赖先建立资源，再回到相应条目完成配置。
+- 最小核验与业务风险相称；仅在用户要求时进行实际环境测试。计划销号仍以配置完成及必要的结果核对为准。