weaver-e10-builder 1.5.15 → 1.6.0

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

@@ -1,6 +1,6 @@
 # 搭建计划模板（按依赖与功能批次执行）
 
-使用本模板生成项目 `plan.md` 时，先读[规划能力地图](map.md)识别资源、配置和依赖；需要明确具体规则或能力边界时读对应专题指南，再填写实际涉及的条目。执行某项前仍须读取该项指南。
+使用本模板生成项目 `plan.md` 时，先读[规划能力地图](map.md)识别资源、配置和依赖；需要明确具体规则或能力边界时读对应专题指南，再填写实际涉及的条目。**先完成 0.1 方案澄清与可行性预检，并与用户集中确认一次。** 执行某项前仍须读取该项指南。
 
 规划阶段全部保持 `[ ]`。第一阶段先完成全部表单的字段、明细和布局，再以**功能项为外层、所有适用表单/视图为内层**组织配置：例如先完成所有表单的关联浏览数据范围，再处理所有表单的公式；视图也按显示列、搜索、排序等功能逐批覆盖。每进入一个功能项先读对应指南，确认方法、参数和边界；同一连续批次已读过的无需重复读取。每个对象及独立规则分别列项、核对、回填和销号；暂不能完成的保留 `[ ]` 并注明原因、已完成部分及所需条件，继续处理其他项目，不因步骤繁琐而省略。整个功能批次的覆盖对象处理完后进入下一批次，真实依赖优先于批次顺序。每段完成后停下让用户确认，确认后进入下一段。仅单步修改或查询不套用三段流程。
 
@@ -20,6 +20,31 @@
 - 待业务确认：<歧义及其影响；无则“无”>
 - 待环境核查：<资源或环境行为；无则“无”>
 
+### 0.1 方案澄清与可行性预检（执行前先看）
+
+> 先完成本节并与用户**集中确认一次**；确认前不写任何数据。执行中出现新的实质业务选择才再次询问，不为平台默认值制造确认。
+
+- 需求理解：<一句话说明本次范围；明确不做什么>
+- 关键假设：<只在必要时列；无则“无”>
+- 验收判据：<每条关键需求一个可观察结果；详细用例可另附>
+
+#### 待确认项
+
+| # | 级别 | 问题 | 选项 | 建议 | 影响 | 决策 |
+|---|---|---|---|---|---|---|
+| 1 | P0/P1/P2/P3 | <需要用户决定的事项> | <A / B / 其他> | <推荐及理由> | <会改变哪些字段、权限或路由> | 待确认 / 已确认：<内容> |
+
+> 级别：P0=阻断（未解决不执行）/ P1=高 / P2=中 / P3=低。
+
+#### 可行性 / 边界
+
+| 需求 | 结论 | 依据与证据等级 | 影响与处理 |
+|---|---|---|---|
+| <需求项> | 可做 / 部分可做 / 做不到 / 待环境核查 | 实测 / 回读字段 / 命令表 / 未证实 + <具体依据> | <保留未完成、替代方式或需用户决定> |
+
+> 证据等级：**实测**=有平台回执或回读；**回读字段**=返回体确有该字段但语义未实测；**命令表**=只能证明当前 CLI 没暴露，**不能**证明平台不支持；**未证实**=有结论无证据，不得对外宣称。
+> P0 或阻断项未解决前不进入执行；已确认做不到或部分做不到的需求保持 `[ ]`，不用替代配置冒充完成。
+
 ### 1. 资源清单与依赖
 
 | 资源 | 决策与归属 | 来源及用途 | 前置依赖 | 实际 ID/结果 |
@@ -54,7 +79,7 @@
 
 > 样表有标题、分组、空白、字段同排或跨列时逐行保留，并与字段清单互相核对。缺少的合并范围标待确认。建新表时按蓝图准备 fields.json，按所选布局创建并初始化；公式、联动、校验等后续配置在功能批次单列。
 
-- 明确还原图片/XLSX源样式时，另记录源哈希、LayoutSpec、已有字段绑定、编译产物和独立回读结果。字段创建完成与布局还原通过分别勾选；未匹配、未支持项不能合并销号。相关指南为 `form/guide-form-layout-source.md`，精确保存晚于字段补写和归组重排。
+- 明确还原图片/XLSX源样式时，另记录源哈希、LayoutSpec、已有字段绑定、编译产物和独立回读结果。字段创建完成与布局还原通过分别勾选；未匹配、未支持项不能合并销号。相关指南为 `form/layout/source-restoration.md`，精确保存晚于字段补写和归组重排。
 
 #### 1.2 视图与流程设计依据
 - 每张视图：所属表单、默认/新增、视图类型、终端、名称、数据范围及需要的显示列/交互要求。
@@ -92,7 +117,7 @@
 - [ ] 编号规则 | 表单/字段：<名称> | 组成与位数：<内容> | 核验：生成值
 - [ ] 表单权限 | 表单/主体：<名称> | 新建/查看/编辑/删除范围：<内容> | 核验：授权结果
 - [ ] 表单页按钮 | 表单/页面/位置：<名称> | 目标与字段映射：<内容> | 核验：点击结果
-- [ ] 表单代码块 | 表单/布局/终端/代码层级：<名称> | 触发时机、字段/明细 Key、预期效果：<内容> | 方法参考：`code-block/guide-code-block.md` | 核验：读回与运行场景；无受支持写入命令时保持未完成并说明影响
+- [ ] 表单代码块 | 表单/布局/终端/代码层级：<名称> | 触发时机、字段/明细 Key、预期效果：<内容> | 方法参考：`form/layout/code-block/code-block-guide.md` | 核验：读回与运行场景；无受支持写入命令时保持未完成并说明影响
 
 > 每个功能批次先核对覆盖表单清单，再逐表配置；同一表单有多条独立规则时继续拆行。建表时已配置并核验的分组、必填、只读、默认值等写在 2.1 的表单项结果中，不重复执行。
 
@@ -151,6 +176,7 @@
 |---|---|---|---|
 | <章节及要求> | 待业务确认/待环境核查/需其他方式补充/已确认无法实现 | <内容> | <内容> |
 
+> 0.1 是执行前的集中确认；本节保留执行过程中新增的待确认/缺失/无法实现项，新增项同样保持 `[ ]`。
 > 当前 CLI 暂不支持的配置项保持 `[ ]`，在此说明能力缺口及影响；不得用临时脚本、内部接口或浏览器操作代做，也不得以替代配置冒充完成。其他状态继续保留相应待办与依赖。
 
 ### 6. 阶段验收与交付资源

package/skill-docs/references/common/map.md

@@ -5,7 +5,7 @@
 ## 使用方法与状态
 
 1. 逐段阅读正文、表格和图片，将每条业务要求映射到资源与配置项，记录原文来源、所属应用/表单/视图/流程、前置依赖及可观察结果。已有资源先只读盘点，再决定复用、修改或新建。
-2. 需求含完整布局样表时，按[布局规划](../form/guide-form-layout-planning.md)保留标题、分组、同排、空白与字段顺序，并同时写入字段清单和布局蓝图。每张表单创建前确认 FLOW 或 EXCEL。
+2. 需求含完整布局样表时，按[布局规划](../form/layout/planning.md)保留标题、分组、同排、空白与字段顺序，并同时写入字段清单和布局蓝图。每张表单创建前确认 FLOW 或 EXCEL。
 3. 规划状态区分：**待业务确认**（语义或取值有歧义）、**待环境核查**（资源、权限或环境行为未证实）、**需其他方式补充**（现有 CLI 只能完成一部分）、**已确认无法实现**（核实无可行路径）。只有最后一种写入 plan 的“无法实现的项”，原需求项保持未完成。
 4. 按资源依赖组织 plan；关键配置写明读回点和最小业务验收点。接口保存、配置读回与页面实际生效是不同层次，按风险选择必要的检查。
 
@@ -28,7 +28,7 @@
 | EB 表单 | 持久化业务记录和默认台账 | 写应用、字段、类型、布局及关联对象 | 验收 objId/formId、字段及默认台账 | [创建表单](../form/guide-create-form.md) |
 | 明细表 | 承载一对多业务行 | 写所属主表、明细字段和层级 | 二级明细另写父子行标识；验收结构及挂载 | [二级明细](../form/guide-form-sub-detail.md) |
 | 虚拟表 | 展示已有来源的组合数据 | 写数据来源、主键、来源字段和展示类型映射 | 先验证稳定主键和字段兼容；验收数据展示 | [虚拟表](../form/guide-virtual-form.md) |
-| 表单布局 | 控制新建/显示页面的字段排布 | 写 FLOW/EXCEL、字段顺序、分组和布局样表 | 建表前确定类型；验收实际字段与位置 | [布局规划](../form/guide-form-layout-planning.md) |
+| 表单布局 | 控制新建/显示页面的字段排布 | 写 FLOW/EXCEL、字段顺序、分组和布局样表 | 建表前确定类型；验收实际字段与位置 | [布局规划](../form/layout/planning.md) |
 | 表单视图与台账 | 按业务场景展示、检索记录 | 写默认视图复用/改名及额外视图类型 | PC/MOBILE 分别核对；视图不等于菜单入口 | [视图](../form/guide-form-view.md) |
 | EB 流程 | 应用内审批，默认流程路径 | 先有 EB 表单；写节点、出口及操作者 | 验收完整拓扑和关键条件 | [流程](../workflow/guide-workflow.md) |
 | 原生工作流程 | 流程中心或明确要求原生表单的审批 | 写自建/绑定表单、固定/自由模式和 formId | 与 EB 资源 ID 分开；验收流程与绑定表单 | [流程](../workflow/guide-workflow.md) |
@@ -55,9 +55,9 @@
 | 字段类型 | 选择文本、金额、日期、组织、关联等录入组件 | 表单；逐字段写主/明细位置、类型与来源 | 按对象类型选原生字段；验收读回类型 | [字段码表](../form/ref-form-fields.md) |
 | 选项与默认值 | 限定可选值或预置新记录内容 | 字段；写选项、默认值及触发时机 | 选项模板与字段内选项分别记录；验收新建页面 | [字段码表](../form/ref-form-fields.md) |
 | 字段多语言 | 同一字段显示中英文名称 | 字段；写中文、英文及目标 fieldId | 建字段后配置；验收两种语言读回 | [创建表单](../form/guide-create-form.md) |
-| 字段显示属性 | 控制必填、只读、隐藏及独占一行 | 布局；逐字段写目标状态 | 字段定义与布局呈现分别核对 | [布局规划](../form/guide-form-layout-planning.md) |
-| 布局样表 | 从完整表格提取空间排布 | 写 FLOW/EXCEL、标题、行列、同排、空白和合并 | 字段清单与布局蓝图同时保留；验收实际位置 | [布局规划](../form/guide-form-layout-planning.md) |
-| 字段分组 | 将业务字段归入折叠分段 | 写分组名称、顺序及成员字段 | 需求明确时配置；验收字段归属 | [布局规划](../form/guide-form-layout-planning.md) |
+| 字段显示属性 | 控制必填、只读、隐藏及独占一行 | 布局；逐字段写目标状态 | 字段定义与布局呈现分别核对 | [布局规划](../form/layout/planning.md) |
+| 布局样表 | 从完整表格提取空间排布 | 写 FLOW/EXCEL、标题、行列、同排、空白和合并 | 字段清单与布局蓝图同时保留；验收实际位置 | [布局规划](../form/layout/planning.md) |
+| 字段分组 | 将业务字段归入折叠分段 | 写分组名称、顺序及成员字段 | 需求明确时配置；验收字段归属 | [布局规划](../form/layout/planning.md) |
 | 关联字段 | 选择客户、合同、流程等原生业务对象 | 写字段子类、目标对象、单/多选 | 关联对象与通用浏览来源分别选型；验收选择范围 | [字段码表](../form/ref-form-fields.md) |
 | 浏览数据定义 | 限定浏览可选数据、默认搜索及弹窗 Tab | 先查可配置字段，再查各字段开放的配置项与候选值 | 按浏览来源适配；验收实际可选数据、搜索与 Tab | [浏览数据定义](../form/guide-browser-definition.md) |
 | 二级明细 | 父级每行挂载子级明细记录 | 主/子明细表；写父子行标识与层级 | 子表归属需按行核对 | [二级明细](../form/guide-form-sub-detail.md) |
@@ -130,7 +130,7 @@
 | 点击按钮打开关联任务或发起流程 | 视图按钮或表单按钮，逐项写目标、当前行过滤与预填映射 |
 | 复杂自动写入其他表 | 动作流，写清触发、字段映射及目标记录定位；单纯本表计算选公式/联动 |
 | 标准配置无法表达的页面交互 | 明确目标范围后规划配置式页面或定制页面，并单列发布和交互验收 |
-| 当前表单布局中的字段、明细或交互需用 JS 实现 | 规划布局源码或表单级 ecode：写目标表单、布局/终端、触发事件、字段 Key、效果和运行检查；按[代码块指南](../code-block/guide-code-block.md)选 CLI 写入入口和对应 JSSDK 方法 |
+| 当前表单布局中的字段、明细或交互需用 JS 实现 | 规划布局源码或表单级 ecode：写目标表单、布局/终端、触发事件、字段 Key、效果和运行检查；按[代码块指南](../form/layout/code-block/code-block-guide.md)选 CLI 写入入口和对应 JSSDK 方法 |
 
 ## 四、常见依赖与计划顺序
 
@@ -160,4 +160,8 @@
 | 已确认无法实现 | 原需求项保持 `[ ]`，在 plan 第 8 节记录原因、影响及待用户决定的处理 |
 | 验收标准不足 | 给关键配置写读回字段与一个典型页面/业务结果，避免只凭保存成功销号 |
 
-规划结果应能回答：要建或复用哪些资源、每条需求落在哪个配置项、依赖顺序是什么、哪些信息须确认、哪些需环境核查、哪些只能部分实现，以及如何判断关键结果生效。最终清单与逐项销号使用[计划模板](guide-plan-template.md)。
+规划结果应能回答：要建或复用哪些资源、每条需求落在哪个配置项、依赖顺序是什么、哪些信息须确认、哪些需环境核查、哪些只能部分实现，以及如何判断关键结果生效。
+
+> 预检结论写入 `plan.md` 的 **0.1 方案澄清与可行性预检**，与用户集中确认一次后再执行；做不到/部分做到项保持 `[ ]`。证据等级与判定方式见[能力边界](capability-boundaries.md)。
+
+最终清单与逐项销号使用[计划模板](guide-plan-template.md)。