weaver-work-cli 0.1.5 → 0.1.7

package/skills/weaver-e10-ebuilder-form/references/custom-api.md

@@ -0,0 +1,86 @@
+# 已发布自定义接口（按 interfacePk）
+
+## 何时使用
+
+用户明确指向「已发布的自定义接口」，并能提供 `interfacePk` 时使用。走 `getFormDataByPk` / `getFormDataList` / `getFormDataCount` / `saveFormData` / `updateFormData` / `deleteFormData` 一族。
+
+**与 OpenAPI 的区分**：有 `objId` 走 OpenAPI（见 [`openapi-read.md`](openapi-read.md)）；有 `interfacePk` 且用户明确是已发布自定义接口时走本族。两者同时出现且用户没指定时，先向用户消歧，不要两边试跑。
+
+## 请求头契约（CLI 注入，Agent 不手写）
+
+```text
+Cookie: <e10-login 返回的完整原始 Cookie 串>（禁止裁剪/去重/改写）
+eteamsid: <e10-login 返回的 ETEAMSID>
+User-Agent: AgentType=<agentType>,IsAgent=true
+```
+
+## operation
+
+| operation | risk | 必填 | 用途 |
+| --- | --- | --- | --- |
+| `ebuilder-form.custom.detail` | read | `interfacePk` + `dataId` | 按主键查详情 |
+| `ebuilder-form.custom.query` | read | `interfacePk` | 分页查询 |
+| `ebuilder-form.custom.count` | read | `interfacePk` | 查询总数 |
+| `ebuilder-form.custom.add.prepare` | read-before-write | `interfacePk` + `datas` | 准备新增，签发 continuation |
+| `ebuilder-form.custom.add.apply` | high-risk-write | `confirm` + `continuation` | 确认后执行新增 |
+| `ebuilder-form.custom.update.prepare` | read-before-write | `interfacePk` + `datas` | 准备修改，签发 continuation |
+| `ebuilder-form.custom.update.apply` | high-risk-write | `confirm` + `continuation` | 确认后执行修改 |
+| `ebuilder-form.custom.delete.prepare` | read-before-write | `interfacePk` + `dataIds` | 准备删除（批量，字符串数组），签发 continuation |
+| `ebuilder-form.custom.delete.apply` | high-risk-write | `confirm` + `continuation` | 确认后执行删除 |
+
+### 参数说明
+
+| 字段 | 说明 |
+| --- | --- |
+| `interfacePk` | 已发布自定义接口主键（必填）；由用户提供或从接口清单取得，**不要猜测** |
+| `dataId` / `dataIds` | 单条详情主键 / 批量删除主键数组 |
+| `datas` | 新增、修改的数据数组 |
+| `mainTable` | 查询条件对象 |
+| `pageNo` / `pageSize` | 分页 |
+| `operationinfo` | 操作备注（可选） |
+
+写操作同样遵循 prepare → 用户确认 → apply 两段式，continuation 有效期 10 分钟，规则与 [`openapi-write.md`](openapi-write.md) 一致。
+
+## 处理链
+
+1. 确认 `interfacePk`；拿不到就向用户索取，不要从接口名猜。
+2. 需要字段与选项时先 `fields.get` / `options.get`（见 [`fields-browser.md`](fields-browser.md)）。
+3. 读操作直接执行；写操作走 prepare → 确认 → apply。
+4. 摘要输出，不粘贴超长 JSON。
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json ebuilder-form run ebuilder-form.custom.count --input-json '{"interfacePk":"INTERFACE_PK","mainTable":{}}'
+weaver-work-cli --json ebuilder-form run ebuilder-form.custom.query --input-json '{"interfacePk":"INTERFACE_PK","mainTable":{},"pageNo":1,"pageSize":20}'
+weaver-work-cli --json ebuilder-form run ebuilder-form.custom.add.prepare --input-json '{"interfacePk":"INTERFACE_PK","datas":[{"name":"示例客户"}]}'
+weaver-work-cli --json ebuilder-form run ebuilder-form.custom.add.apply --input-json '{"continuation":"<prepare 返回的 continuation>","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json ebuilder-form run ebuilder-form.custom.query --input-json '{"interfacePk":"INTERFACE_PK","mainTable":{},"pageNo":1,"pageSize":20}'
+```
+
+## 失败处理
+
+| subtype | 含义 | 处置 |
+| --- | --- | --- |
+| `interface_pk_required` | 缺少 `interfacePk` | 向用户索取，不要猜 |
+| `confirmation` / `required` / `confirm_required` | 未显式确认 | 先向用户确认，再传 `confirm: true` |
+| `continuation_invalid` / `continuation_expired` / `continuation_mismatch` | continuation 失效 | 重新 prepare |
+| `continuation_actor_changed` | 登录身份变化 | 重新 prepare 并重新取得确认 |
+| `field_required` / `field_invalid` / `field_forbidden` | 字段问题 | 以 `fields.get` 为准修正，不绕过 |
+| `business_error` / `http_error` | 服务端或 HTTP 失败 | 保留业务消息，停止后续写入 |
+| `write_uncertain` | 结果未知 | 立即停止，禁止自动重放；先只读核验 |
+| `session_expired` | 登录态失效 | 恢复会话后重新 prepare |
+
+## 红线
+
+- 自定义接口的字段契约由发布方定义，缺失字段时向用户索取，禁止编造默认值。
+- 批量删除会一次删除 `dataIds` 全部目标，confirm 前必须把完整清单念给用户确认。
+- 自定义接口的返回字段取决于接口发布时的配置，**不能假设返回完整表单数据**；缺失字段按「接口未返回」处理，不要凭字段定义猜测。
+- `write_uncertain` 不重试。

package/skills/weaver-e10-ebuilder-form/references/disabled-capabilities.md

@@ -0,0 +1,50 @@
+# 能力边界与暂不可用项
+
+## 何时使用
+
+用户要求的能力不在 `ebuilder-form schema` 中，或命令返回 `operation_unknown` / `path_forbidden` 时读取本文件，用于**如实告知边界并给出替代路径**，而不是换接口硬试。
+
+## 当前不在 CLI 能力范围内
+
+| 能力 | 状态 | 替代路径 |
+| --- | --- | --- |
+| 新建/发布 eBuilder 应用、表单与自定义接口 | 未纳入 CLI | 在 E10 建模中心完成，CLI 只消费已发布产物 |
+| 修改 List/NList 页面布局、显示列、固定条件 | 未纳入 CLI | 页面配置在 E10 端完成；CLI 的 `list.config` / `nlist.config` 只读 |
+| 表单字段的新增、删除与元数据修改 | 未纳入 CLI | `fields.get` / `options.get` 只读 |
+| 附件上传下载、OCR、图片与本地文件解析 | 未纳入 CLI | 本模块不涉及；其它模块（如 `weaver-e10-yepiaotong`）处理文件类能力 |
+| 表单数据的批量导入/导出 | 未纳入 CLI | 只能逐条走 OpenAPI / 自定义接口写操作 |
+| 审批、流程流转、转办与加签 | 不属于本模块 | 走 `weaver-e10-workflow` |
+| 人员、部门、岗位与组织架构查询 | 不属于本模块 | 走 `weaver-e10-hrm` |
+| 未出现在 `ebuilder-form schema` 中的任何 operation | 一律不可用 | 先跑 `weaver-work-cli ebuilder-form schema` 核对 |
+
+## 硬边界（违反即失败）
+
+- 禁止绕过 `weaver-work-cli` 直接 `curl` / `fetch` 访问 E10 接口，禁止直连 `/api/bs/` 路径。
+- 禁止写死默认域名；系统地址由登录态决定。
+- 禁止从 `menuId`、`appId`、`listId`、`objId` 互相猜测。
+- 禁止手工构造 NList 的 `customConfig`（LZW 编码），必须用 `nlist.config` 的返回值。
+- 禁止手工构造或跨操作复用 continuation。
+- 禁止用字段显示名当写入键；`name == id` 的自定义字段必须改用 `config.dataKey`。
+- 查询全部页达到或超过 100 页预算时，请用户增加筛选条件，不得拆成多次单页查询规避。
+- 不得通过 `checkRight=false` 绕过数据创建、修改或删除的权限校验。
+- 写操作返回 `write_uncertain` 时立即停止，禁止自动重放。
+
+## 失败出口
+
+| 现象 | 处置 |
+| --- | --- |
+| `operation_unknown` | 该 operation 不在 schema 中，跑 `weaver-work-cli ebuilder-form schema` 核对可用清单 |
+| `path_forbidden` / `origin_invalid` | 触碰了地址或域名红线，停止并说明原因，不要改写路径绕过 |
+| `protocol` | 请求协议不被接受，检查是否为 CLI 未覆盖的地址形态，不要手工改协议 |
+| `session_expired` | 按 shared 规则恢复 E10 会话后从只读步骤重新开始 |
+
+## 自检命令
+
+遇到"不知道能不能做"时，先跑：
+
+```text
+weaver-work-cli ebuilder-form --help
+weaver-work-cli ebuilder-form schema
+```
+
+以 `schema` 为唯一事实来源：没有出现在 schema 中的能力，不要写成可执行步骤。

package/skills/weaver-e10-ebuilder-form/references/fields-browser.md

@@ -0,0 +1,100 @@
+# 字段、选项与浏览字段解析
+
+## 何时使用
+
+写入前确认真实字段名、取选择类字段的选项、确认主表/明细表标识映射、把人员/部门/流程等名称解析成 ID 时使用。
+
+**写入键的取值顺序**：字段定义里的 `text` 是显示名，**不能当写入键**；通常写入键用字段的 `name`；当 `name == id`（自定义字段常见）或目标接口明确要求组件数据键时，改用 `config.dataKey`。写入前一律用 `fields.get` 核对，不要凭用户叫法猜键名。
+
+## 请求头契约（CLI 注入，Agent 不手写）
+
+```text
+Cookie: <e10-login 返回的完整原始 Cookie 串>（禁止裁剪/去重/改写）
+eteamsid: <e10-login 返回的 ETEAMSID>
+User-Agent: AgentType=<agentType>,IsAgent=true
+```
+
+## operation
+
+| operation | risk | 必填 | 用途 |
+| --- | --- | --- | --- |
+| `ebuilder-form.fields.get` | read | 上下文 | 读 eBuilder 字段定义，返回主表与明细表字段、`config.dataKey`、`browserParams` 和组件类型 |
+| `ebuilder-form.options.get` | read | 上下文 + 字段标识 | 按字段元数据 ID 读选择类字段选项 |
+| `ebuilder-form.mapping.get` | read | `objId` | 读 `mainTable` / `detailN` 与主表、明细表标识映射 |
+| `ebuilder-form.browser.resolve` | read | `module` + `browserType` + `query` | 把名称解析为可选项 ID |
+
+### `fields.get` 参数
+
+| 字段 | 说明 |
+| --- | --- |
+| `groupId` | eBuilder 应用或分组标识。**优先用菜单/上下文解析返回的 `appId`**；没有可靠值时从当前应用上下文取得，不要猜测 |
+| `sourceId` | 来源对象 ID，通常传 `objId` |
+| `sourceType` | 数据来源类型，表单场景传 `FORM`（默认）；布局逻辑字段传 `LOGIC` |
+| `detailFieldsGroup` | 取明细表字段分组 |
+| `enableMerge` | 合并主表与明细表字段 |
+| `customParam` / `params` | 透传参数；一般不要手工构造 |
+
+### `options.get` 参数
+
+| 字段 | 说明 |
+| --- | --- |
+| `fieldName` / `fieldId` | **字段元数据 ID**（纯数字），取 `fields.get` 返回的 `fields[].id`，二选一。它不是字段显示文本，也不是字段对象的 `name` |
+| `sourceType` | 数据来源类型，默认 `FORM` |
+| `groupId` | 与 `fields.get` 使用时保持一致 |
+| `optionLevel` | 选项层级，默认 `1`；存在层级选项时按实际层级传入 |
+
+选项返回 `id`（选项 ID）与 `name`（选项名称）：**写入用 `id`，展示用 `name`**，层级选项按 `pid` 建立父子关系。
+
+### `browser.resolve` 参数
+
+| 字段 | 说明 |
+| --- | --- |
+| `module` | 浏览接口模块，例如 `hrm`、`workflow/core`、`doc`、`task` |
+| `browserType` | 浏览类型，例如 `resource`（人员）、`department`（部门）、`subcompany`（分部）、`wfcRequest`（流程） |
+| `query` | 要解析的业务名称（用户提供名称即可，不要求用户预先知道系统 ID） |
+| `multiple` | 是否允许多选 |
+| `limit` | 返回条数上限 |
+| `extra` | 模块要求的附加参数 |
+
+## 处理链
+
+1. `fields.get` 取真实字段定义，确认写入键（默认 `name`；`name == id` 时用 `config.dataKey`）。
+2. 选择类字段用 `options.get` 取选项，**传选项 `id`，不传中文名**。
+3. 需要写明细表时用 `mapping.get` 确认 `detail1` / `detail2` 对应的标识，**按接口返回关系使用，不能按名称或本地顺序自行编号**。
+4. 人员/部门/流程等关联字段用 `browser.resolve` 把名称解析为 ID；**多命中时必须让用户选**，不得自动取第一条，也不得要求用户先提供 ID。
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json ebuilder-form run ebuilder-form.fields.get --input-json '{"context":{"objId":"121000000000000001"}}'
+weaver-work-cli --json ebuilder-form run ebuilder-form.options.get --input-json '{"context":{"objId":"121000000000000001"},"fieldName":"customer_type"}'
+weaver-work-cli --json ebuilder-form run ebuilder-form.mapping.get --input-json '{"objId":"121000000000000001"}'
+weaver-work-cli --json ebuilder-form run ebuilder-form.browser.resolve --input-json '{"module":"hrm","browserType":"resource","query":"张三"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json ebuilder-form run ebuilder-form.browser.resolve --input-json '{"module":"hrm","browserType":"resource","query":"张三"}'
+```
+
+## 失败处理
+
+| subtype | 含义 | 处置 |
+| --- | --- | --- |
+| `field_required` | 未提供字段标识 | 补 `fieldName` 或 `fieldId` |
+| `field_invalid` | 字段标识非法或不存在 | 以 `fields.get` 返回的字段为准重新取值 |
+| `field_forbidden` | 该字段不允许写入或不允许该操作 | 停止写入并原样转达，不要换字段绕过 |
+| `obj_id_required` | 缺少 `objId` | 回 `context.resolve` 补齐 |
+| `query_required` | `browser.resolve` 缺少 `query` | 补名称关键词 |
+| `unknown_field` | 入参字段不在 schema 中 | 去掉该字段，不要猜参数 |
+| `session_expired` | 登录态失效 | 按 shared 规则恢复 E10 会话后从只读步骤重新开始 |
+
+## 红线
+
+- 禁止用字段显示名（`text`）当写入键；默认用 `name`，`name == id` 或接口要求组件键时才用 `config.dataKey`。
+- 选项一律传 `id`，不传中文名称；不要在调用方硬编码生产选项 ID 或名称。
+- 名称解析多命中时必须让用户选，禁止自动取第一条；也不要把「让用户提供 ID」当成解析手段。
+- 字段定义中的 `config.options` 已够用时可直接用，但要完整名称或最新选项时以 `options.get` 结果为准。

package/skills/weaver-e10-ebuilder-form/references/list-nlist.md

@@ -0,0 +1,91 @@
+# List / NList 列表查询
+
+## 何时使用
+
+用户要看某个 eBuilder 页面里的表格数据、分页结果、真实总数，或需要先知道有哪些可搜索字段/固定条件时使用。
+
+先按 [`context-routing.md`](context-routing.md) 拿到 `context`，再按 `context.listKind` 分流：**`List` 走 `list.*`，`NList` 走 `nlist.*`，两套接口不要互相试跑。**
+
+## 请求头契约（CLI 注入，Agent 不手写）
+
+```text
+Cookie: <e10-login 返回的完整原始 Cookie 串>（禁止裁剪/去重/改写）
+eteamsid: <e10-login 返回的 ETEAMSID>
+User-Agent: AgentType=<agentType>,IsAgent=true
+```
+
+## operation
+
+| operation | risk | 用途 |
+| --- | --- | --- |
+| `ebuilder-form.list.config` | read | 读传统表格 List 的基础设置、显示列、排序、搜索、统计和固定条件 |
+| `ebuilder-form.list.query` | read | 按 List 运行时接口查分页数据和真实总数 |
+| `ebuilder-form.nlist.config` | read | 读数据列表 NList 的页面、组件与 `comps[1].config` 运行时配置 |
+| `ebuilder-form.nlist.query` | read | 按 NList eblist 运行时接口查分页数据和真实总数 |
+
+四个 operation 都接受 `context`（推荐）或等价的定位字段（`appId` / `apiPrefix` / `objId` / `listId` / `hostPageId` / `listKind`）。
+
+### `list.query` 查询参数
+
+| 字段 | 说明 |
+| --- | --- |
+| `pageNo` / `pageSize` | 分页；默认小页读取，用户没要求全量时不要放大 |
+| `allPages` | 拉全部页；预计达到或超过 100 页时 CLI 会拒绝（见失败处理） |
+| `searchParamData` / `filterCondition` | 搜索与固定条件对象，结构以 `list.config` 返回为准 |
+| `orderParams` | 排序参数数组 |
+| `tableuid` | 每次查询生成的随机值，一般来自 `list.config`，不要手工构造 |
+| `passid` / `cid` | 默认取上下文的 `objId`；只有页面运行上下文明确给出其他值时才显式传 |
+
+### `nlist.query` 查询参数
+
+| 字段 | 说明 |
+| --- | --- |
+| `pageNo` / `pageSize` / `allPages` | 同上 |
+| `compId` | 目标组件 ID，来自 `nlist.config` |
+| `tableuid` / `refPluginPackageId` | 运行时透传标识 |
+| `customConfig` | NList 的 LZW 数字串编码配置对象，**必须用 `nlist.config` 的返回值，不要手工拼** |
+| `filter` / `fieldFilter` / `pageFilter` | 过滤条件，结构以 `nlist.config` 为准 |
+
+## 处理链
+
+1. `context.resolve` 拿 `context` 与 `listKind`。NList 的 `listId` 以配置 `comps[1].config.ebListId` 为准、`objId` 以该配置的 `objId` 为准；菜单 `pageId` 只用于取页面信息，不要拿它和 `ebListId` 反复匹配；`comps[1]`、`config`、`ebListId` 或 `objId` 缺失时停止并报告结构问题，不要扫描其他组件回退。
+2. 需要知道可搜索字段或固定条件时，先跑对应的 `config`（`list.config` / `nlist.config`）。
+3. 组装查询条件跑 `query`。
+4. 结果摘要给用户：条数、总数、是否还有更多。**不要原样粘贴超长 JSON。**
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json ebuilder-form run ebuilder-form.list.config --input-json '{"context":{"objId":"121000000000000001","listId":"1001","listKind":"List"}}'
+weaver-work-cli --json ebuilder-form run ebuilder-form.list.query --input-json '{"context":{"objId":"121000000000000001","listId":"1001","listKind":"List"},"pageNo":1,"pageSize":20}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json ebuilder-form run ebuilder-form.nlist.query --input-json '{"context":{"objId":"121000000000000001","listKind":"NList"},"pageNo":1,"pageSize":20}'
+```
+
+## 失败处理
+
+| subtype | 含义 | 处置 |
+| --- | --- | --- |
+| `list_context_invalid` | 上下文缺少 List 所需字段 | 重跑 `context.resolve`，不要手工补 `listId` |
+| `nlist_context_invalid` | 上下文缺少 NList 所需字段 | 同上 |
+| `list_kind_invalid` | `listKind` 不是 `List` / `NList` | 以 `context.resolve` 返回值为准 |
+| `list_id_required` / `host_page_id_required` | 缺少列表/页面标识 | 回 `context.resolve` 补齐 |
+| `nlist_config_missing` / `nlist_component_missing` | 拿不到 NList 组件配置 | 先跑 `nlist.config`；仍缺失说明该页面不是 NList，改用 `list.*` |
+| `nlist_config_invalid` / `custom_config_invalid` | `customConfig` 非法 | 用 `nlist.config` 返回值原样回传，不要手工改写 |
+| `page_size_too_large` | 单页条数超限 | 调小 `pageSize` 分页读取，不要一次拉全量 |
+| `page_type_invalid` / `page_response_invalid` | 分页响应异常 | 停止并原样反馈，不要换页重试 |
+| `too_many_pages` | 查询全部页达到或超过 100 页预算 | 请用户增加筛选条件；**不得**拆成多次单页查询规避预算 |
+| `count_invalid` | 总数不可用 | 如实说明总数未知，不要拿行数冒充总数 |
+| `session_expired` | 登录态失效 | 按 shared 规则恢复 E10 会话后从只读步骤重新开始 |
+
+## 红线
+
+- 单页大小受 CLI 限制，超限时按错误提示调小，不要绕过。
+- `customConfig` 是 CLI 内部编码，禁止自行构造或改写。
+- 明细展开会产生重复行，统计条数时以 `query` 返回的真实总数为准，不要自行去重。

package/skills/weaver-e10-ebuilder-form/references/openapi-read.md

@@ -0,0 +1,74 @@
+# OpenAPI 只读查询（按 objId）
+
+## 何时使用
+
+已知表单对象 `objId`，要查单条详情、按条件分页查表单数据或查总数时使用。走 E10 表单 OpenAPI（`getDataById` / `getAllData` / `getAllDataCount`）。
+
+若目标不是 OpenAPI 而是已发布的自定义接口（有 `interfacePk`），改走 [`custom-api.md`](custom-api.md)。两者同时出现且用户没指定时，先向用户消歧。
+
+## 请求头契约（CLI 注入，Agent 不手写）
+
+```text
+Cookie: <e10-login 返回的完整原始 Cookie 串>（禁止裁剪/去重/改写）
+eteamsid: <e10-login 返回的 ETEAMSID>
+User-Agent: AgentType=<agentType>,IsAgent=true
+```
+
+## operation
+
+| operation | risk | 必填 | 用途 |
+| --- | --- | --- | --- |
+| `ebuilder-form.openapi.detail` | read | `objId` + `dataId` | 按数据 ID 取单条详情 |
+| `ebuilder-form.openapi.query` | read | `objId` | 表单级分页查询 |
+| `ebuilder-form.openapi.count` | read | `objId` | 表单级总数查询 |
+
+### 公共参数
+
+| 字段 | 说明 |
+| --- | --- |
+| `objId` | 表单对象 ID（必填），来自 `context.resolve` |
+| `mainTable` | 主表查询条件对象；字段名以 [`fields-browser.md`](fields-browser.md) 取到的写入键为准 |
+| `pageNo` / `pageSize` | 分页（`query` 专用）；默认小页读取 |
+| `isReturnDetail` | 是否返回明细表数据 |
+| `fieldNoFindIgnore` | 字段不存在时忽略而非报错；**不要为了绕过报错而默认打开** |
+
+## 处理链
+
+1. `context.resolve` 拿 `objId`（必要时先 `menu.search`）。
+2. 需要条件字段时先 `fields.get` 确认写入键。
+3. `openapi.count` 确认量级 → `openapi.query` 小页读取 → 需要单条完整数据时 `openapi.detail`。
+4. 摘要给用户：命中数、已读页数、是否还有更多。**不要原样粘贴超长 JSON。**
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json ebuilder-form run ebuilder-form.openapi.count --input-json '{"objId":"121000000000000001","mainTable":{}}'
+weaver-work-cli --json ebuilder-form run ebuilder-form.openapi.query --input-json '{"objId":"121000000000000001","mainTable":{},"pageNo":1,"pageSize":20}'
+weaver-work-cli --json ebuilder-form run ebuilder-form.openapi.detail --input-json '{"objId":"121000000000000001","dataId":"1234567890123456789"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json ebuilder-form run ebuilder-form.openapi.query --input-json '{"objId":"121000000000000001","mainTable":{},"pageNo":1,"pageSize":20}'
+```
+
+## 失败处理
+
+| subtype | 含义 | 处置 |
+| --- | --- | --- |
+| `obj_id_required` | 缺少 `objId` | 回 `context.resolve` 补齐，不要从其它 ID 猜 |
+| `field_required` | 缺少必要字段 | 补字段后重试 |
+| `field_invalid` | 字段名不被接口接受 | 用 `fields.get` 的 `config.dataKey` 重新取值 |
+| `http_error` | HTTP 层失败 | 保留业务消息，停止后续步骤，不重试 |
+| `business_error` | 服务端业务失败 | 原样转达业务消息，不要改写或美化 |
+| `response_invalid` | 响应结构异常 | 停止并原样反馈，不要换接口重试 |
+| `session_expired` | 登录态失效 | 按 shared 规则恢复 E10 会话后从只读步骤重新开始 |
+
+## 红线
+
+- 长整型 `objId` / `dataId` 一律按字符串传递，避免精度丢失。
+- 不要把 `fieldNoFindIgnore` 当成绕过字段校验的开关。
+- 查询结果只是"当前页"，汇报总数时必须用 `count` 的返回值。

package/skills/weaver-e10-ebuilder-form/references/openapi-write.md

@@ -0,0 +1,86 @@
+# OpenAPI 写入（新增 / 修改 / 删除）
+
+## 何时使用
+
+按 `objId` 对 eBuilder 表单做新增、修改、删除时使用。**全部为高风险写操作，必须走 prepare → 用户确认 → apply 两段式。**
+
+写入前必须先用 [`fields-browser.md`](fields-browser.md) 确认真实字段名与选项值。
+
+## 请求头契约（CLI 注入，Agent 不手写）
+
+```text
+Cookie: <e10-login 返回的完整原始 Cookie 串>（禁止裁剪/去重/改写）
+eteamsid: <e10-login 返回的 ETEAMSID>
+User-Agent: AgentType=<agentType>,IsAgent=true
+```
+
+## operation
+
+| operation | risk | 必填 | 用途 |
+| --- | --- | --- | --- |
+| `ebuilder-form.openapi.add.prepare` | read-before-write | `objId` + `datas` | 准备新增，签发 continuation，**不写入** |
+| `ebuilder-form.openapi.add.apply` | high-risk-write | `confirm` + `continuation` | 确认后执行新增 |
+| `ebuilder-form.openapi.update.prepare` | read-before-write | `objId` + `datas` | 准备修改，签发 continuation |
+| `ebuilder-form.openapi.update.apply` | high-risk-write | `confirm` + `continuation` | 确认后执行修改 |
+| `ebuilder-form.openapi.delete.prepare` | read-before-write | `objId` + 删除条件 | 准备删除，签发 continuation |
+| `ebuilder-form.openapi.delete.apply` | high-risk-write | `confirm` + `continuation` | 确认后执行删除 |
+
+### prepare 参数
+
+| 字段 | 说明 |
+| --- | --- |
+| `objId` | 表单对象 ID（必填） |
+| `datas` | 数据数组（新增/修改必填）；每项为主表字段对象，明细表按 `mapping.get` 得到的 `detail1` / `detail2` 键组织 |
+| `dataId` | 删除时的数据 ID；与 `mainTable` 二选一 |
+| `mainTable` | 删除条件对象，按数据 ID 删除时传 `{"id":"..."}` |
+| `operationinfo` | 操作备注信息（可选） |
+
+### apply 参数
+
+`confirm` 必须显式为 `true`；`continuation` 必须原样回传 prepare 的返回值。continuation 有效期 **10 分钟**，绑定 operation 与提交内容。
+
+## 处理链（缺一步即失败）
+
+1. `context.resolve` 确认 `objId`。
+2. `fields.get` / `options.get` 确认写入键与选项值；关联字段用 `browser.resolve` 解析 ID。
+3. `*.prepare` → 拿 `requestPreview` 与 `continuation`；**此时未写入任何数据**。
+4. 向用户摘要：目标表单、动作、字段与值、影响条数、不可逆性，取得**明确确认**。
+5. `*.apply` 传 `confirm: true` 与 `continuation`。
+6. 需要时用 `openapi.detail` 只读回查确认结果。
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json ebuilder-form run ebuilder-form.openapi.add.prepare --input-json '{"objId":"121000000000000001","datas":[{"name":"示例客户"}]}'
+weaver-work-cli --json ebuilder-form run ebuilder-form.openapi.add.apply --input-json '{"continuation":"<prepare 返回的 continuation>","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json ebuilder-form run ebuilder-form.openapi.delete.prepare --input-json '{"objId":"121000000000000001","dataId":"1234567890123456789"}'
+weaver-work-cli --json ebuilder-form run ebuilder-form.openapi.delete.apply --input-json '{"continuation":"<prepare 返回的 continuation>","confirm":true}'
+```
+
+## 失败处理
+
+| subtype | 含义 | 处置 |
+| --- | --- | --- |
+| `confirmation` / `required` / `confirm_required` | 未显式确认 | 先向用户确认，再传 `confirm: true` |
+| `continuation_invalid` / `continuation_expired` / `continuation_mismatch` | continuation 无效、过期或不属于当前 operation | 重新执行 prepare，**不要复用旧 continuation** |
+| `continuation_actor_changed` | 当前 E10 登录身份与 prepare 时不一致 | 重新 prepare 并重新取得用户确认 |
+| `delete_target_required` | 删除未指定目标 | 补 `dataId` 或 `mainTable` |
+| `field_required` / `field_invalid` / `field_forbidden` | 字段缺失 / 非法 / 禁止写入 | 以 `fields.get` 为准修正；禁止换字段绕过 |
+| `business_error` / `http_error` | 服务端业务或 HTTP 失败 | 保留业务消息，停止后续写入 |
+| `write_uncertain` | 写请求结果未知 | **立即停止，禁止自动重放**；先做只读核验再向用户汇报 |
+| `session_expired` | 登录态失效 | 按 shared 规则恢复 E10 会话后**重新 prepare**（旧 continuation 作废） |
+
+## 红线
+
+- 禁止跳过 prepare 直接 apply，禁止手工构造或跨操作复用 continuation。
+- `write_uncertain` 不重试：重复提交会造成重复新增或覆盖用户刚改的数据。
+- 删除不可逆：目标不明确时先询问；即使用户已明确目标也必须走 continuation 校验。
+- 不得通过 `checkRight=false` 绕过权限校验。
+- 写接口返回业务 `status=false` 时，真实失败原因在 `data.datajson.message`，不要被外层 `message.msg=success` 覆盖；向用户转述前先读这一层。

package/skills/weaver-e10-ebuilder-form/references/source-manifest.json

@@ -0,0 +1,107 @@
+{
+  "schemaVersion": 1,
+  "generatedFrom": {
+    "path": "weaver-e10-ebuilder-form",
+    "skill": "weaver-e10-ebuilder-form",
+    "command": "ebuilder-form"
+  },
+  "sources": [
+    { "path": "SKILL.md", "sha256": "999172568786502cdd835a46a7f8905f11e12ab22f30c2b20c0fec7dfec1d5c9", "role": "existing-skill" },
+    { "path": "agents/openai.yaml", "sha256": "c64518022c780d6dc2ed615a03fe3ecade3fecfbc6132bd46061021a45437f58", "role": "requirement" },
+    { "path": "references/browser-fields.md", "sha256": "096002525c7719a5143e48b75e27cc51763ef013553998620ee8be0475d3b24e", "role": "api-doc" },
+    { "path": "references/catalog.md", "sha256": "bde8c90c4aa712b098716baa1010e9dbe6c7db69b5e6ed8dbd9de8e021b03499", "role": "api-doc" },
+    { "path": "references/cli.md", "sha256": "bd7c648a266b2378aecabf0923d47a21fd87c9f1d184ef4041416e95aa39e75f", "role": "api-doc" },
+    { "path": "references/deployment-routing.md", "sha256": "73b874f87c6de19027e812ffb5b3dddf9ed963ad75ddd675c0ec0d2d81a89197", "role": "api-doc" },
+    { "path": "references/ebuilder-customapi-formdata-add.md", "sha256": "dea6f1bddc7f544ad605a7aa0825f76882bf675f87228008fc4909b3b10c3390", "role": "api-doc" },
+    { "path": "references/ebuilder-customapi-formdata-count.md", "sha256": "097976303c0a97ce683d683d41b9bd7f33ae54e077d3a51b165778d889930a41", "role": "api-doc" },
+    { "path": "references/ebuilder-customapi-formdata-delete.md", "sha256": "a0a43bf2b8032dadb7c7db2abe82e092ecea2530989ca5591c9f9145908007f5", "role": "api-doc" },
+    { "path": "references/ebuilder-customapi-formdata-querybypk.md", "sha256": "1db36f3215908c48637814a99c6be58ef6968d58a5895b0154624c1905506f38", "role": "api-doc" },
+    { "path": "references/ebuilder-customapi-formdata-querypagedata.md", "sha256": "0c2ab32a1001fe73bc3984252207a4c60b411d77d244e3d9ea12e2db86893607", "role": "api-doc" },
+    { "path": "references/ebuilder-customapi-formdata-update.md", "sha256": "d132d8282099cb0067d824e4c89bbff97c131d1c7e392725f06ae79956821a82", "role": "api-doc" },
+    { "path": "references/ebuilder-openapi-common.md", "sha256": "4b5bb706583ad9a1ff1959b5e389906ce534ec8deeac4a97b20a5af135059b39", "role": "api-doc" },
+    { "path": "references/ebuilder-openapi-formdata-deletedata.md", "sha256": "3fed56e7247792753787df74ae6404c96c7bad56be4b325f4c79f8f61d9c33aa", "role": "api-doc" },
+    { "path": "references/ebuilder-openapi-formdata-getalldata.md", "sha256": "2b537026902c6eb9f56758f43fd904a5e96dc47d9a40eb1e6918bf0c084a4df3", "role": "api-doc" },
+    { "path": "references/ebuilder-openapi-formdata-getalldatacount.md", "sha256": "7a2ab547a8b0c142973ec2bd292b5e27956a4ab9816c0e5c0f85fb66ca39e49f", "role": "api-doc" },
+    { "path": "references/ebuilder-openapi-formdata-getdatabyid.md", "sha256": "5e000a15c9fbd3645f9fb61e6e076fc181c6f6bd07933c59a11be70d69226bb0", "role": "api-doc" },
+    { "path": "references/ebuilder-openapi-formdata-getfields.md", "sha256": "685b80d8334e0c27e41568a85bad5358f5996dbc336fb97b9e8fa4c092843039", "role": "api-doc" },
+    { "path": "references/ebuilder-openapi-formdata-getoptions.md", "sha256": "0f9543855762efad708b89d201234455b0d5ccba680c56a988164ebb849b0a68", "role": "api-doc" },
+    { "path": "references/ebuilder-openapi-formdata-gettablemapping.md", "sha256": "f26ab03139058968b0c2e04074399453c3faf4be6f996e9a267b1aab09926c01", "role": "api-doc" },
+    { "path": "references/ebuilder-openapi-formdata-saveformdata.md", "sha256": "9a743a4b3ff0dcde416626543e9f2f1b26f9100630d0897dc619aa32fbf94cce", "role": "api-doc" },
+    { "path": "references/ebuilder-openapi-formdata-updateformdata.md", "sha256": "18b2ebc58070f18893b82925a55b3a11596e1f12b80f4f26b9005f3d4a3d419e", "role": "api-doc" },
+    { "path": "references/list-pagination.md", "sha256": "1887fe99be73f1ddbe278daf4c89106c4d91414540bf03fc6355f669aa8533be", "role": "api-doc" },
+    { "path": "references/menu-listid-resolution.md", "sha256": "5e2970c5bb68998b345029cf16a5d661136e8a5a4a19c75680293def533eb2ba", "role": "api-doc" },
+    { "path": "references/menu-search.md", "sha256": "0f9565510ac4a024f1f527b643a4b846dfe456662afdd94a496d31dfd90bbf2d", "role": "api-doc" },
+    { "path": "references/nlist-config.md", "sha256": "597b3f88b4d8f3ce242766289fce30396158aa03fe779ba484b0d1b0f6afe92a", "role": "api-doc" },
+    { "path": "references/nlist-pagination.md", "sha256": "46360d753cd041f3db8cbd5d01ded465773855bd656519a253003a9ac0541592", "role": "api-doc" },
+    { "path": "references/routing.md", "sha256": "953a91e6ad074febdd6ccfc053838d0c686753f8edfcee4427395459c58e646b", "role": "api-doc" },
+    { "path": "references/runtime-routing.md", "sha256": "126cdc5a14ff31c7e26cb1356663ae0b5578a88bef0a96af788e88291b849e8e", "role": "api-doc" },
+    { "path": "references/session-and-routing.md", "sha256": "86b14140155c1026470d4fcc0a3070c0a0c8937adaa8890461a3a7de8cccc64e", "role": "api-doc" },
+    { "path": "references/table-config.md", "sha256": "489c1e9eeee3aa4e2b355833d55fba64bbd0c1beefccbe916da2ea7b60e42e0b", "role": "api-doc" },
+    { "path": "scripts/ebuilder_http.py", "sha256": "16c242d31a2ec61435182aaac8568d2f72877dc89352c00da1e269ceaf66a7a0", "role": "code" },
+    { "path": "scripts/form_data.py", "sha256": "ddd5f232e51c3967fb6bed165248483301bd1ae85576905d28325f01d642ecdd", "role": "code" },
+    { "path": "scripts/get_form_views.py", "sha256": "fd09b7b54b4f067a9f6a3b56765d59211fa5803b94389df802432818173fdbf5", "role": "code" },
+    { "path": "scripts/get_nlist_config.py", "sha256": "628bea6be2f786b9d27386ddc4caf1412bca3d2d55bc3ad4d4471d483570277a", "role": "code" },
+    { "path": "scripts/get_table_config.py", "sha256": "839e346596e22eefd0ad6d9d889c8d5aa67159a364a6fc6d272f14350cc09f2c", "role": "code" },
+    { "path": "scripts/query_browser_field.py", "sha256": "10ddf4cfff78e7f990eddab1eb24b842612fd214eaebd3d29c868f45c13a79fe", "role": "code" },
+    { "path": "scripts/query_list_data.py", "sha256": "70487ae1635104fcb0e54364a0c869612d3a6d05d62ed588e0e5395da0ff01c8", "role": "code" },
+    { "path": "scripts/query_nlist_data.py", "sha256": "b2eebc31f16ff26cd8465aa91d99ed22febaaecb9f9e87064393753246d4eaa3", "role": "code" }
+  ],
+  "sourceChunks": [
+    {
+      "id": "menu-search-and-context",
+      "sources": ["references/menu-search.md", "references/menu-listid-resolution.md", "references/deployment-routing.md", "references/runtime-routing.md", "references/session-and-routing.md", "scripts/form_data.py"],
+      "operations": ["ebuilder-form.menu.search", "ebuilder-form.context.resolve", "ebuilder-form.views.list"],
+      "references": ["context-routing.md"]
+    },
+    {
+      "id": "list-nlist-runtime",
+      "sources": ["references/table-config.md", "references/list-pagination.md", "references/nlist-config.md", "references/nlist-pagination.md", "scripts/get_table_config.py", "scripts/get_nlist_config.py", "scripts/query_list_data.py", "scripts/query_nlist_data.py"],
+      "operations": ["ebuilder-form.list.config", "ebuilder-form.list.query", "ebuilder-form.nlist.config", "ebuilder-form.nlist.query"],
+      "references": ["list-nlist.md"]
+    },
+    {
+      "id": "fields-options-browser",
+      "sources": ["references/browser-fields.md", "references/ebuilder-openapi-formdata-getfields.md", "references/ebuilder-openapi-formdata-getoptions.md", "references/ebuilder-openapi-formdata-gettablemapping.md", "scripts/query_browser_field.py"],
+      "operations": ["ebuilder-form.fields.get", "ebuilder-form.options.get", "ebuilder-form.mapping.get", "ebuilder-form.browser.resolve"],
+      "references": ["fields-browser.md"]
+    },
+    {
+      "id": "openapi-formdata",
+      "sources": ["references/ebuilder-openapi-common.md", "references/ebuilder-openapi-formdata-getdatabyid.md", "references/ebuilder-openapi-formdata-getalldata.md", "references/ebuilder-openapi-formdata-getalldatacount.md", "references/ebuilder-openapi-formdata-saveformdata.md", "references/ebuilder-openapi-formdata-updateformdata.md", "references/ebuilder-openapi-formdata-deletedata.md", "references/cli.md", "scripts/form_data.py"],
+      "operations": ["ebuilder-form.openapi.detail", "ebuilder-form.openapi.query", "ebuilder-form.openapi.count", "ebuilder-form.openapi.add.prepare", "ebuilder-form.openapi.add.apply", "ebuilder-form.openapi.update.prepare", "ebuilder-form.openapi.update.apply", "ebuilder-form.openapi.delete.prepare", "ebuilder-form.openapi.delete.apply"],
+      "references": ["openapi-read.md", "openapi-write.md"]
+    },
+    {
+      "id": "custom-formdata",
+      "sources": ["references/ebuilder-customapi-formdata-add.md", "references/ebuilder-customapi-formdata-update.md", "references/ebuilder-customapi-formdata-delete.md", "references/ebuilder-customapi-formdata-querybypk.md", "references/ebuilder-customapi-formdata-querypagedata.md", "references/ebuilder-customapi-formdata-count.md"],
+      "operations": ["ebuilder-form.custom.detail", "ebuilder-form.custom.query", "ebuilder-form.custom.count", "ebuilder-form.custom.add.prepare", "ebuilder-form.custom.add.apply", "ebuilder-form.custom.update.prepare", "ebuilder-form.custom.update.apply", "ebuilder-form.custom.delete.prepare", "ebuilder-form.custom.delete.apply"],
+      "references": ["custom-api.md"]
+    }
+  ],
+  "sourceCoverage": [
+    { "path": "SKILL.md", "status": "converted", "references": ["SKILL.md", "context-routing.md", "list-nlist.md", "openapi-write.md"] },
+    { "path": "agents/openai.yaml", "status": "converted", "references": ["SKILL.md"] },
+    { "path": "references/*.md", "status": "converted", "references": ["context-routing.md", "list-nlist.md", "fields-browser.md", "openapi-read.md", "openapi-write.md", "custom-api.md", "disabled-capabilities.md"] },
+    { "path": "scripts/*.py", "status": "converted", "operations": ["ebuilder-form.context.resolve", "ebuilder-form.nlist.query", "ebuilder-form.openapi.*", "ebuilder-form.browser.resolve"], "notes": "脚本不随 Skill 打包；URL 解析、NList customConfig 编码、字段 dataKey 选择、成功判定和写入确认语义已迁移到 TypeScript CLI 与 references。" }
+  ],
+  "withheld": [
+    {
+      "capability": "一步按显示名新增/修改并自动解析所有字段",
+      "reason": "已拆成 fields/options/browser + prepare/apply，避免把字段匹配和重名处理只放在提示层。"
+    },
+    {
+      "capability": "文件上传、附件、OCR、导入",
+      "reason": "源资料未提供稳定接口与文件处理确认链；当前模块不读取或上传用户文件。"
+    },
+    {
+      "capability": "eBuilder 配置写入或菜单/页面修改",
+      "reason": "源资料明确业务边界为菜单/列表/表单数据，不包含配置写入确认链。"
+    }
+  ],
+  "generatedArtifacts": [
+    "src/shortcuts/ebuilder-form",
+    "docs/ebuilder-form.md",
+    "skills/weaver-e10-ebuilder-form",
+    "skill-template/domains/ebuilder-form.md"
+  ]
+}

package/skills/weaver-e10-esb/SKILL.md

@@ -15,7 +15,7 @@ cliHelp: "weaver-work-cli esb --help"
 
 # 泛微E10 ESB动作流执行
 
-**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。若不存在则必须先执行 `weaver-work-cli skills install shared`，若 CLI 未安装则先执行 `npm install -g weaver-work-cli`，安装或读取失败时必须停止执行。**
+**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。若不存在则必须先执行 `weaver-work-cli skills install shared --target-dir <当前Agent的Skills目录>`，若 CLI 未安装则先执行 `npm install -g weaver-work-cli`，安装或读取失败时必须停止执行。**
 
 
 本技能覆盖 ESB 中心的**自定义触发类型动作流**：取入参模板（只读）与执行动作流（写操作，需确认）。按动作流名称解析 ID、唯一值对应的 `primary_key` SQL 查询都不在本技能范围内，见「不在范围」。