weaver-work-cli 0.1.6 → 0.1.7

package/skills/weaver-e10-calendar/references/source-manifest.json

@@ -4,47 +4,329 @@
   "skill": "weaver-e10-calendar",
   "generatedAt": "2026-09-08",
   "sourceSet": {
-    "aggregateSha256": "2120af4a51488aa4c29bfe0efafb6017b5b4f46f92c8c5c35f2a9e96a2e60f28",
-    "sourceRoots": ["H:/日程SKILL包/weaver-e10-calendar"],
+    "aggregateSha256": "cdf3a32c775c5a64311d6c1a69130ac7a4aecf8cccca17758b9ee91ebf1bdde9",
+    "sourceRoots": [
+      "H:/日程SKILL包/weaver-e10-calendar"
+    ],
     "detectionStrength": "strong"
   },
   "generatedTargets": {
-    "cli": ["src/shortcuts/calendar", "src/shortcuts/index.ts"],
-    "skill": ["skills/weaver-e10-calendar"],
-    "tests": ["test/business/calendar-*.test.ts"],
-    "docs": ["docs/calendar.md", "skill-template/domains/calendar.md"]
+    "cli": [
+      "src/shortcuts/calendar",
+      "src/shortcuts/index.ts"
+    ],
+    "skill": [
+      "skills/weaver-e10-calendar"
+    ],
+    "tests": [
+      "test/business/calendar-*.test.ts"
+    ],
+    "docs": [
+      "docs/calendar.md",
+      "skill-template/domains/calendar.md"
+    ]
   },
   "sources": [
-    { "path": "SKILL.md", "role": "existing-skill", "size": 12914, "sha256": "57c18643d5db7ffc2d8051832d0687d61368d9ac7415a3bc8b48a3c6af99a9d2" },
-    { "path": "references/catalog.md", "role": "api-doc", "size": 3835, "sha256": "d00f89c65b1cda6c957368bede0644906a4bbd92e4b9aeaa99cb132c2d716032" },
-    { "path": "references/calendar-create-save.md", "role": "api-doc", "size": 9696, "sha256": "26a1009e631832a29a15035afa99675ca77b474bf04b28948ba00ce32821834f" },
-    { "path": "references/calendar-delete-delete.md", "role": "api-doc", "size": 4008, "sha256": "04deda7c3f0074d18695d1a46f75b40d70ffb073eab79fdbe7ce3ac33e9c6f31" },
-    { "path": "references/calendar-list-esb.md", "role": "api-doc", "size": 8535, "sha256": "5c2b022455afac7776a8915a0d7b25c05cfd32206bcc6506d05ea4607cd370be" },
-    { "path": "references/calendar-priority-query.md", "role": "api-doc", "size": 4801, "sha256": "2578d6731e497a45a6f1a67ef29b59afea3dfda422bef6eaaf0caad03970de01" },
-    { "path": "references/calendar-query-count.md", "role": "api-doc", "size": 2763, "sha256": "f898f0bb4a6a85a2015e94af48ddef53f416e597da524d41349f3fdafc149079" },
-    { "path": "references/calendar-query-get.md", "role": "api-doc", "size": 9354, "sha256": "7f9babaa26b23e77f9d8c4e4714318ef323c4ae817c0ba4e265004cdf6ad83ae" },
-    { "path": "references/calendar-type-query.md", "role": "api-doc", "size": 5404, "sha256": "4696c2e981e349e04a49840b47cb55e5440c391e3167efdda1a7e1b44c638858" },
-    { "path": "references/calendar-update-update.md", "role": "api-doc", "size": 8899, "sha256": "c3ca3c98be1779bfeda67d2e1041a703b9ea14bc525e0af6d6c835fee382bdc2" }
+    {
+      "path": "SKILL.md",
+      "role": "existing-skill",
+      "size": 12914,
+      "sha256": "57c18643d5db7ffc2d8051832d0687d61368d9ac7415a3bc8b48a3c6af99a9d2"
+    },
+    {
+      "path": "references/catalog.md",
+      "role": "api-doc",
+      "size": 3835,
+      "sha256": "d00f89c65b1cda6c957368bede0644906a4bbd92e4b9aeaa99cb132c2d716032"
+    },
+    {
+      "path": "references/calendar-create-save.md",
+      "role": "api-doc",
+      "size": 9696,
+      "sha256": "26a1009e631832a29a15035afa99675ca77b474bf04b28948ba00ce32821834f"
+    },
+    {
+      "path": "references/calendar-delete-delete.md",
+      "role": "api-doc",
+      "size": 4008,
+      "sha256": "04deda7c3f0074d18695d1a46f75b40d70ffb073eab79fdbe7ce3ac33e9c6f31"
+    },
+    {
+      "path": "references/calendar-list-esb.md",
+      "role": "api-doc",
+      "size": 8535,
+      "sha256": "5c2b022455afac7776a8915a0d7b25c05cfd32206bcc6506d05ea4607cd370be"
+    },
+    {
+      "path": "references/calendar-priority-query.md",
+      "role": "api-doc",
+      "size": 4801,
+      "sha256": "2578d6731e497a45a6f1a67ef29b59afea3dfda422bef6eaaf0caad03970de01"
+    },
+    {
+      "path": "references/calendar-query-count.md",
+      "role": "api-doc",
+      "size": 2763,
+      "sha256": "f898f0bb4a6a85a2015e94af48ddef53f416e597da524d41349f3fdafc149079"
+    },
+    {
+      "path": "references/calendar-query-get.md",
+      "role": "api-doc",
+      "size": 9354,
+      "sha256": "7f9babaa26b23e77f9d8c4e4714318ef323c4ae817c0ba4e265004cdf6ad83ae"
+    },
+    {
+      "path": "references/calendar-type-query.md",
+      "role": "api-doc",
+      "size": 5404,
+      "sha256": "4696c2e981e349e04a49840b47cb55e5440c391e3167efdda1a7e1b44c638858"
+    },
+    {
+      "path": "references/calendar-update-update.md",
+      "role": "api-doc",
+      "size": 8899,
+      "sha256": "c3ca3c98be1779bfeda67d2e1041a703b9ea14bc525e0af6d6c835fee382bdc2"
+    }
   ],
   "sourceChunks": [
-    { "id": "POST /api/ebuilder/form/formdata/v2/saveFormData/createAgenda", "sourcePath": "references/calendar-create-save.md", "anchor": "创建日程", "mapsToOperations": ["calendar.create.prepare", "calendar.create.apply"], "mapsToReferences": ["references/calendar-write.md"] },
-    { "id": "POST /api/ebuilder/form/formdata/v2/getFormDataByPk/queryAgenda", "sourcePath": "references/calendar-query-get.md", "anchor": "查询日程", "mapsToOperations": ["calendar.get"], "mapsToReferences": ["references/calendar-query.md"] },
-    { "id": "POST /api/ebuilder/form/formdata/v2/getFormDataCount/queryAgendaCount", "sourcePath": "references/calendar-query-count.md", "anchor": "查询日程总数", "mapsToOperations": ["calendar.count"], "mapsToReferences": ["references/calendar-query.md"] },
-    { "id": "POST /api/ebuilder/form/formdata/v2/updateFormData/updateAgenda", "sourcePath": "references/calendar-update-update.md", "anchor": "更新日程", "mapsToOperations": ["calendar.update.prepare", "calendar.update.apply"], "mapsToReferences": ["references/calendar-write.md"] },
-    { "id": "POST /api/ebuilder/form/formdata/v2/deleteFormData/deleteAgenda", "sourcePath": "references/calendar-delete-delete.md", "anchor": "删除日程", "mapsToOperations": ["calendar.delete.prepare", "calendar.delete.apply"], "mapsToReferences": ["references/calendar-write.md"] },
-    { "id": "POST /api/ebuilder/form/formdata/v2/getFormDataList/queryAgendaPriority", "sourcePath": "references/calendar-priority-query.md", "anchor": "查询日程紧急程度", "mapsToOperations": ["calendar.priority.list"], "mapsToReferences": ["references/calendar-dict.md"] },
-    { "id": "POST /api/ebuilder/form/formdata/v2/getFormDataList/queryAgendaType", "sourcePath": "references/calendar-type-query.md", "anchor": "查询日程类型", "mapsToOperations": ["calendar.type.list"], "mapsToReferences": ["references/calendar-dict.md"] },
-    { "id": "POST /api/esb/server/event/triggerActionFlow", "sourcePath": "references/calendar-list-esb.md", "anchor": "查询日程列表", "mapsToOperations": ["calendar.list"], "mapsToReferences": ["references/calendar-query.md"] }
+    {
+      "id": "POST /api/ebuilder/form/formdata/v2/saveFormData/createAgenda",
+      "sourcePath": "references/calendar-create-save.md",
+      "anchor": "创建日程",
+      "mapsToOperations": [
+        "calendar.create.prepare",
+        "calendar.create.apply"
+      ],
+      "mapsToReferences": [
+        "references/calendar-write.md"
+      ]
+    },
+    {
+      "id": "POST /api/ebuilder/form/formdata/v2/getFormDataByPk/queryAgenda",
+      "sourcePath": "references/calendar-query-get.md",
+      "anchor": "查询日程",
+      "mapsToOperations": [
+        "calendar.get"
+      ],
+      "mapsToReferences": [
+        "references/calendar-query.md"
+      ]
+    },
+    {
+      "id": "POST /api/ebuilder/form/formdata/v2/getFormDataCount/queryAgendaCount",
+      "sourcePath": "references/calendar-query-count.md",
+      "anchor": "查询日程总数",
+      "mapsToOperations": [
+        "calendar.count"
+      ],
+      "mapsToReferences": [
+        "references/calendar-query.md"
+      ]
+    },
+    {
+      "id": "POST /api/ebuilder/form/formdata/v2/updateFormData/updateAgenda",
+      "sourcePath": "references/calendar-update-update.md",
+      "anchor": "更新日程",
+      "mapsToOperations": [
+        "calendar.update.prepare",
+        "calendar.update.apply"
+      ],
+      "mapsToReferences": [
+        "references/calendar-write.md"
+      ]
+    },
+    {
+      "id": "POST /api/ebuilder/form/formdata/v2/deleteFormData/deleteAgenda",
+      "sourcePath": "references/calendar-delete-delete.md",
+      "anchor": "删除日程",
+      "mapsToOperations": [
+        "calendar.delete.prepare",
+        "calendar.delete.apply"
+      ],
+      "mapsToReferences": [
+        "references/calendar-write.md"
+      ]
+    },
+    {
+      "id": "POST /api/ebuilder/form/formdata/v2/getFormDataList/queryAgendaPriority",
+      "sourcePath": "references/calendar-priority-query.md",
+      "anchor": "查询日程紧急程度",
+      "mapsToOperations": [
+        "calendar.priority.list"
+      ],
+      "mapsToReferences": [
+        "references/calendar-dict.md"
+      ]
+    },
+    {
+      "id": "POST /api/ebuilder/form/formdata/v2/getFormDataList/queryAgendaType",
+      "sourcePath": "references/calendar-type-query.md",
+      "anchor": "查询日程类型",
+      "mapsToOperations": [
+        "calendar.type.list"
+      ],
+      "mapsToReferences": [
+        "references/calendar-dict.md"
+      ]
+    },
+    {
+      "id": "POST /api/esb/server/event/triggerActionFlow",
+      "sourcePath": "references/calendar-list-esb.md",
+      "anchor": "查询日程列表",
+      "mapsToOperations": [
+        "calendar.list"
+      ],
+      "mapsToReferences": [
+        "references/calendar-query.md"
+      ]
+    }
   ],
   "operationImpact": {
-    "calendar.list": { "sourceChunkIds": ["POST /api/esb/server/event/triggerActionFlow"], "schemaFields": ["start_time", "end_time", "keywork", "page_no", "page_size"], "references": ["references/calendar-query.md"], "tests": ["test/business/calendar-*.test.ts"], "risk": "read", "requiresConfirmationChain": false },
-    "calendar.get": { "sourceChunkIds": ["POST /api/ebuilder/form/formdata/v2/getFormDataByPk/queryAgenda"], "schemaFields": ["id"], "references": ["references/calendar-query.md"], "tests": ["test/business/calendar-*.test.ts"], "risk": "read", "requiresConfirmationChain": false },
-    "calendar.count": { "sourceChunkIds": ["POST /api/ebuilder/form/formdata/v2/getFormDataCount/queryAgendaCount"], "schemaFields": [], "references": ["references/calendar-query.md"], "tests": ["test/business/calendar-*.test.ts"], "risk": "read", "requiresConfirmationChain": false },
-    "calendar.priority.list": { "sourceChunkIds": ["POST /api/ebuilder/form/formdata/v2/getFormDataList/queryAgendaPriority"], "schemaFields": ["priority_name", "pageNo", "pageSize"], "references": ["references/calendar-dict.md"], "tests": ["test/business/calendar-*.test.ts"], "risk": "read", "requiresConfirmationChain": false },
-    "calendar.type.list": { "sourceChunkIds": ["POST /api/ebuilder/form/formdata/v2/getFormDataList/queryAgendaType"], "schemaFields": ["type_name", "pageNo", "pageSize"], "references": ["references/calendar-dict.md"], "tests": ["test/business/calendar-*.test.ts"], "risk": "read", "requiresConfirmationChain": false },
-    "calendar.create.prepare": { "sourceChunkIds": ["POST /api/ebuilder/form/formdata/v2/saveFormData/createAgenda"], "schemaFields": ["agn_name", "start_time", "end_time", "participants", "agn_type", "priority"], "references": ["references/calendar-write.md"], "tests": ["test/business/calendar-*.test.ts"], "risk": "write-confirmed", "requiresConfirmationChain": true },
-    "calendar.update.prepare": { "sourceChunkIds": ["POST /api/ebuilder/form/formdata/v2/updateFormData/updateAgenda"], "schemaFields": ["id", "agn_name", "start_time", "end_time", "participants", "agn_type", "priority"], "references": ["references/calendar-write.md"], "tests": ["test/business/calendar-*.test.ts"], "risk": "write-confirmed", "requiresConfirmationChain": true },
-    "calendar.delete.prepare": { "sourceChunkIds": ["POST /api/ebuilder/form/formdata/v2/deleteFormData/deleteAgenda"], "schemaFields": ["id"], "references": ["references/calendar-write.md"], "tests": ["test/business/calendar-*.test.ts"], "risk": "write-confirmed", "requiresConfirmationChain": true }
+    "calendar.list": {
+      "sourceChunkIds": [
+        "POST /api/esb/server/event/triggerActionFlow"
+      ],
+      "schemaFields": [
+        "start_time",
+        "end_time",
+        "keywork",
+        "page_no",
+        "page_size"
+      ],
+      "references": [
+        "references/calendar-query.md"
+      ],
+      "tests": [
+        "test/business/calendar-*.test.ts"
+      ],
+      "risk": "read",
+      "requiresConfirmationChain": false
+    },
+    "calendar.get": {
+      "sourceChunkIds": [
+        "POST /api/ebuilder/form/formdata/v2/getFormDataByPk/queryAgenda"
+      ],
+      "schemaFields": [
+        "id"
+      ],
+      "references": [
+        "references/calendar-query.md"
+      ],
+      "tests": [
+        "test/business/calendar-*.test.ts"
+      ],
+      "risk": "read",
+      "requiresConfirmationChain": false
+    },
+    "calendar.count": {
+      "sourceChunkIds": [
+        "POST /api/ebuilder/form/formdata/v2/getFormDataCount/queryAgendaCount"
+      ],
+      "schemaFields": [],
+      "references": [
+        "references/calendar-query.md"
+      ],
+      "tests": [
+        "test/business/calendar-*.test.ts"
+      ],
+      "risk": "read",
+      "requiresConfirmationChain": false
+    },
+    "calendar.priority.list": {
+      "sourceChunkIds": [
+        "POST /api/ebuilder/form/formdata/v2/getFormDataList/queryAgendaPriority"
+      ],
+      "schemaFields": [
+        "priority_name",
+        "pageNo",
+        "pageSize"
+      ],
+      "references": [
+        "references/calendar-dict.md"
+      ],
+      "tests": [
+        "test/business/calendar-*.test.ts"
+      ],
+      "risk": "read",
+      "requiresConfirmationChain": false
+    },
+    "calendar.type.list": {
+      "sourceChunkIds": [
+        "POST /api/ebuilder/form/formdata/v2/getFormDataList/queryAgendaType"
+      ],
+      "schemaFields": [
+        "type_name",
+        "pageNo",
+        "pageSize"
+      ],
+      "references": [
+        "references/calendar-dict.md"
+      ],
+      "tests": [
+        "test/business/calendar-*.test.ts"
+      ],
+      "risk": "read",
+      "requiresConfirmationChain": false
+    },
+    "calendar.create.prepare": {
+      "sourceChunkIds": [
+        "POST /api/ebuilder/form/formdata/v2/saveFormData/createAgenda"
+      ],
+      "schemaFields": [
+        "agn_name",
+        "start_time",
+        "end_time",
+        "participants",
+        "agn_type",
+        "priority"
+      ],
+      "references": [
+        "references/calendar-write.md"
+      ],
+      "tests": [
+        "test/business/calendar-*.test.ts"
+      ],
+      "risk": "write-confirmed",
+      "requiresConfirmationChain": true
+    },
+    "calendar.update.prepare": {
+      "sourceChunkIds": [
+        "POST /api/ebuilder/form/formdata/v2/updateFormData/updateAgenda"
+      ],
+      "schemaFields": [
+        "id",
+        "agn_name",
+        "start_time",
+        "end_time",
+        "participants",
+        "agn_type",
+        "priority"
+      ],
+      "references": [
+        "references/calendar-write.md"
+      ],
+      "tests": [
+        "test/business/calendar-*.test.ts"
+      ],
+      "risk": "write-confirmed",
+      "requiresConfirmationChain": true
+    },
+    "calendar.delete.prepare": {
+      "sourceChunkIds": [
+        "POST /api/ebuilder/form/formdata/v2/deleteFormData/deleteAgenda"
+      ],
+      "schemaFields": [
+        "id"
+      ],
+      "references": [
+        "references/calendar-write.md"
+      ],
+      "tests": [
+        "test/business/calendar-*.test.ts"
+      ],
+      "risk": "write-confirmed",
+      "requiresConfirmationChain": true
+    }
   },
   "notes": [
     "源资料为纯文档型 skill（无脚本），请求体构造依据各单接口文档的请求示例。",

package/skills/weaver-e10-ebuilder-form/SKILL.md

@@ -0,0 +1,123 @@
+---
+name: weaver-e10-ebuilder-form
+display_name: 泛微E10 eBuilder表单
+display_name_en: Weaver E10 eBuilder Forms
+description: "泛微E10 eBuilder 表单助手：定位菜单，查询 List/NList 列表，读取字段和浏览数据，并通过 CLI 安全执行表单 OpenAPI/自定义接口读写。"
+description_zh: "面向泛微 E10 eBuilder 表单：通过 weaver-work-cli ebuilder-form 定位菜单与页面上下文，查询列表和表单数据，解析字段、选项和浏览字段，并用 prepare/apply 确认链新增、修改或删除数据。"
+description_en: "Query eBuilder menus, List/NList pages, fields, browser values, and form data through the weaver-work-cli ebuilder-form command with prepare/apply confirmation for writes."
+version: 1.0.0
+author: 泛微网络科技股份有限公司
+agent_created: true
+requires:
+  bins: ["weaver-work-cli"]
+dependencies:
+  - weaver-e10-login
+cliHelp: "weaver-work-cli ebuilder-form --help"
+---
+
+# 泛微E10 eBuilder表单
+
+**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`，安装或读取失败时必须停止执行。**
+
+本技能覆盖 eBuilder 表单菜单定位、List/NList 页面查询、字段/选项/浏览字段解析，以及 OpenAPI 和已发布自定义接口的表单数据读写。所有业务调用必须通过 `weaver-work-cli ebuilder-form`，禁止绕过 CLI 直接拼 E10 接口、Cookie、ETEAMSID 或 `/api/bs/` 路径。
+
+认证由 `weaver-work-cli` 共享登录能力和 `weaver-e10-login` 兼容依赖托管。底层请求头由 CLI 自动设置，Agent 不得在对话或命令输入中索取、粘贴或输出这些凭证：
+
+```text
+Cookie: <e10-login 返回的完整原始 Cookie 串>（禁止裁剪/去重/改写）
+eteamsid: <e10-login 返回的 ETEAMSID>
+User-Agent: AgentType=<agentType>,IsAgent=true
+```
+
+## 命令入口
+
+```text
+weaver-work-cli ebuilder-form --help
+weaver-work-cli ebuilder-form schema
+weaver-work-cli --json ebuilder-form run <operation> --input-json '<json>'
+```
+
+`schema` 是可用 operation 与字段的事实来源。未出现在 schema 中的能力，不要写成可执行步骤。
+
+## 高优先级语义
+
+- “这个表单在哪 / 找某个 eBuilder 菜单” → `ebuilder-form.menu.search` 取候选菜单，再 `ebuilder-form.context.resolve`
+- “页面 URL 解析 / 这个列表页对应哪个 objId” → `ebuilder-form.context.resolve`（`url` 传整串 URL）
+- “这个表单有哪些视图 / 切换列表视图” → `ebuilder-form.views.list`
+- “查列表 / 表格数据 / 分页 / 总数” → 先 resolve，再按 `listKind` 走 `ebuilder-form.list.query` 或 `ebuilder-form.nlist.query`
+- “看列表字段、搜索项、排序、统计、固定条件” → `ebuilder-form.list.config` 或 `ebuilder-form.nlist.config`
+- “表单字段、选项、主明细映射、人员/部门/关联字段按名称解析” → `fields.get`、`options.get`、`mapping.get`、`browser.resolve`
+- “按 objId 查详情/分页/总数” → `openapi.detail`、`openapi.query`、`openapi.count`
+- “新增/修改/删除表单数据” → 对应 `*.prepare` → 用户确认 → 对应 `*.apply`
+- “已发布自定义接口 interfacePk 查询/写入” → `custom.*`
+
+菜单多命中时必须列出候选让用户选择，不得自动取第一条。
+
+## Reference 路由表
+
+| 触发条件 | Reference |
+| --- | --- |
+| 菜单搜索、URL 解析、apiPrefix、appId/listId/objId 上下文、页面地址、视图枚举 | [`references/context-routing.md`](references/context-routing.md) |
+| List/NList 配置、分页、总数、搜索条件、NList customConfig 编码 | [`references/list-nlist.md`](references/list-nlist.md) |
+| 字段定义、选项、主明细映射、人员/部门/审批/文档等浏览字段 | [`references/fields-browser.md`](references/fields-browser.md) |
+| OpenAPI 详情、分页、总数的只读查询 | [`references/openapi-read.md`](references/openapi-read.md) |
+| OpenAPI 新增、修改、删除的 prepare/apply 确认链 | [`references/openapi-write.md`](references/openapi-write.md) |
+| 已发布自定义接口的查询、新增、修改、删除 | [`references/custom-api.md`](references/custom-api.md) |
+| 源资料中存在但当前 CLI 未自动化或需要人工补充的能力边界 | [`references/disabled-capabilities.md`](references/disabled-capabilities.md) |
+
+## 处理链
+
+1. 先运行 `weaver-work-cli ebuilder-form schema` 确认 operation 和字段。
+2. 有菜单名或页面 URL 时先执行 `ebuilder-form.context.resolve`，保留返回的 `context`。同一任务后续 operation 优先传 `context`，避免重复搜索菜单或猜 ID。
+3. 页面列表查询必须按 `context.listKind` 分流：`List` 用 `list.*`，`NList` 用 `nlist.*`。不要把两套接口互相试跑。
+4. 表单级数据查询或写入必须先确认接口族：有 `objId` 走 OpenAPI；有 `interfacePk` 且用户明确是已发布自定义接口时走 `custom.*`；两者同时出现且用户没有指定时先消歧。
+5. 字段显示名（`text`）不能直接当写入键：通常用字段的 `name`；自定义字段若 `name == id`，或目标接口明确要求组件数据键时，改用 `config.dataKey`。写入前用 `fields.get` 核对真实字段。选择类字段写入选项 `id`，不写选项名称。
+6. 新增、修改、删除必须先 prepare。prepare 返回 `requestPreview` 和 10 分钟有效的 `continuation`；向用户摘要目标、字段、数量和风险，得到明确确认后 apply。
+
+## 写操作失败决策树
+
+| 错误 subtype | 含义 | 处置 |
+| --- | --- | --- |
+| `required` / `confirm_required` | 未显式确认 | 先向用户确认，再传 `confirm: true` |
+| `continuation_invalid` / `continuation_expired` / `continuation_mismatch` | continuation 无效、过期或不属于当前 operation | 重新执行 prepare |
+| `continuation_actor_changed` | 当前 E10 登录环境或用户与 prepare 时不一致 | 重新 prepare，不复用旧 continuation |
+| `business_error` / `http_error` | 服务端业务失败或 HTTP 失败 | 保留业务消息，停止后续写入 |
+| `session_expired` | 登录态失效或权限不足 | 按 shared 规则恢复 E10 会话后从只读步骤重新开始 |
+| `too_many_pages` | 查询全部页超过 100 页预算 | 请用户增加筛选条件，不得拆成多次单页查询规避预算 |
+| `write_uncertain` | 写请求结果未知 | 立即停止，不自动重放；先做只读核验 |
+
+## 安全边界
+
+- 认证、profile、Cookie、ETEAMSID 和小 E 统一登录由 `weaver-work-cli` 托管；不要索取或输出凭证。
+- 禁止调用 `/api/bs/`，禁止默认域名，禁止从 `menuId`、`appId`、`listId` 或 `objId` 互相猜测。
+- 文件、附件、OCR、导入、远程 URL 解析不属于当前模块；如后续新增，必须先按 shared 规则取得用户对文件内容处理的明确确认。
+- 查询列表时单页最大 200；查询全部页预计 100 页或更多时停止。
+- 删除不可逆。用户当前请求已明确删除目标时仍必须走 CLI 的 continuation 校验；目标不明确时先询问。
+
+## 失败处理与自检
+
+- 业务失败看 stderr JSON 的 `error.type` / `error.subtype` / `error.message`，不要用退出码 `0` 判断成功。
+- 不确定某个能力是否可用时，先跑 `weaver-work-cli ebuilder-form schema` 核对；`schema` 是唯一事实来源，未出现在其中的能力不要写成可执行步骤。
+- 命令不可用（`command not found` 或退出码 127）时，按 shared 规则的安装章节处理，不要自行拼装接口。
+- **诊断出口**：任何步骤拿不到预期结果时，优先回到 `ebuilder-form schema` 与对应 reference 核对参数，不要换接口硬试、不要绕过 CLI 直连 E10。
+- 认证类错误（`authentication` / `session_expired`）：按 shared 规则恢复 E10 会话后从**只读步骤**重新开始；写操作的旧 continuation 作废，必须重新 prepare。
+
+## 平台兼容示例
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli ebuilder-form schema
+weaver-work-cli --json ebuilder-form run ebuilder-form.menu.search --input-json '{"menuKeywords":["客户档案"]}'
+weaver-work-cli --json ebuilder-form run ebuilder-form.context.resolve --input-json '{"menuKeywords":["客户档案"]}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli ebuilder-form schema
+weaver-work-cli --json ebuilder-form run ebuilder-form.menu.search --input-json '{"menuKeywords":["客户档案"]}'
+weaver-work-cli --json ebuilder-form run ebuilder-form.context.resolve --input-json '{"menuKeywords":["客户档案"]}'
+```
+
+复杂 JSON 使用 UTF-8 文件和 `--input <path>`；只在确认当前 shell 管道稳定时使用 `--input -`。

package/skills/weaver-e10-ebuilder-form/references/context-routing.md

@@ -0,0 +1,90 @@
+# 菜单定位与上下文解析
+
+## 何时使用
+
+用户给了菜单名、页面 URL，或需要拿到 `appId` / `apiPrefix` / `objId` / `listId` / 页面地址时使用。这是几乎所有其它 operation 的前置步骤。
+
+## 请求头契约（CLI 注入，Agent 不手写）
+
+CLI 发往 E10 的每个请求都自动携带以下三项用户信息参数，缺一不可（业务入参里不要传这些字段，也不要手工拼装请求头）：
+
+```text
+Cookie: <e10-login 返回的完整原始 Cookie 串>（禁止裁剪/去重/改写）
+eteamsid: <e10-login 返回的 ETEAMSID>
+User-Agent: AgentType=<agentType>,IsAgent=true
+```
+
+## operation
+
+| operation | risk | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `ebuilder-form.menu.search` | read | `menuKeywords` | 按业务关键词查询当前账号有权限访问的 eBuilder 表格/数据列表菜单 |
+| `ebuilder-form.context.resolve` | read | 至少一种定位输入 | 从菜单关键词、页面 URL、`objId` 或现有 `context` 解析出完整上下文 |
+| `ebuilder-form.views.list` | read | `objId` | 枚举某个表单对象下的 List/NList 视图 |
+
+### 定位输入（任选其一，命中多条时报错而非猜）
+
+| 字段 | 说明 |
+| --- | --- |
+| `menuKeywords` | 菜单关键词数组，最多 5 个；给菜单名时用这个 |
+| `menu` / `menuId` | 菜单名或菜单 ID |
+| `url` | E10 列表页面 URL；支持 `/sp/ebdfpage/list`、`viewport` 和 `/ebdapp/view` 三种形态 |
+| `appId` / `objId` / `listId` | 已拿到的上下文片段，用于补全 |
+| `context` | 上一次 `context.resolve` 的返回对象，原样回传可跳过重复搜索 |
+| `listKind` | `List` 或 `NList`；已知时显式传入可避免二次判定 |
+
+### 返回的 `context` 关键字段
+
+`appId`、`apiPrefix`、`objId`、`listId`、`hostPageId`、`listKind`、`menuUrl`、`entryUrl`。
+
+后续 operation 优先传 `context`（整个对象原样回传），避免重复搜索菜单或猜 ID。`context` 里的 `appId` 同时作为字段、选项接口的 `groupId`；没有可靠 `groupId` 时必须从当前应用上下文取得，不要猜测。`context` 里已有的字段不要再用单字段入参重复传，两者冲突会报 `context_conflict`。
+
+## 推荐顺序
+
+1. 有菜单名 → `menu.search` 拿候选菜单；多个候选时**列给用户选择**，不要用第一个。
+2. 拿到菜单（或用户直接给了页面 URL）→ `context.resolve` 拿 `context`。
+3. 需要切换同一表单的其它视图 → `views.list` 枚举，再回到 `context.resolve` 或直接带 `listId` 查询。
+
+## 命令
+
+按菜单关键词定位：
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json ebuilder-form run ebuilder-form.menu.search --input-json '{"menuKeywords":["客户档案"]}'
+weaver-work-cli --json ebuilder-form run ebuilder-form.context.resolve --input-json '{"menuKeywords":["客户档案"]}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json ebuilder-form run ebuilder-form.menu.search --input-json '{"menuKeywords":["客户档案"]}'
+weaver-work-cli --json ebuilder-form run ebuilder-form.context.resolve --input-json '{"menuKeywords":["客户档案"]}'
+```
+
+按页面 URL 解析（把用户给的整串 URL 原样传入，不要手工截取参数）：
+
+```powershell
+weaver-work-cli --json ebuilder-form run ebuilder-form.context.resolve --input-json '{"url":"https://<用户域名>/sp/ebdfpage/list/0/123456"}'
+```
+
+## 失败处理
+
+| subtype | 含义 | 处置 |
+| --- | --- | --- |
+| `keywords_required` | 未提供任何定位输入 | 至少补一种：`menuKeywords` / `url` / `objId` / `context` |
+| `menu_not_found` | 菜单名未命中 | 换更通用关键词重试一次；仍无命中就向用户索取菜单全称或页面 URL |
+| `menu_ambiguous` / `menu_not_unique` | 菜单多命中 | **列候选让用户选**，不要自动取第一条 |
+| `menu_response_invalid` / `deployment_response_invalid` | 响应结构异常 | 停止并原样反馈，不要换接口重试 |
+| `url_invalid` / `url_type_missing` / `url_id_missing` / `url_origin_required` | URL 无法解析 | 向用户索取完整 URL（含域名），不要手工拼 |
+| `url_cross_origin` | URL 域名与当前登录环境不一致 | 确认用户给的是当前环境的地址，不要跨环境解析 |
+| `url_app_conflict` / `url_menu_conflict` / `url_id_conflict` / `url_type_conflict` | URL 与其它入参冲突 | 只保留 URL，去掉冲突入参 |
+| `api_prefix_invalid` / `api_prefix_conflict` | apiPrefix 非法或冲突 | 以 `context.resolve` 返回为准，不要手工指定 |
+| `app_conflict` / `context_conflict` / `input_conflict` | 入参互相冲突 | 只保留一种定位来源 |
+| `session_expired` | 登录态失效 | 按 shared 规则恢复 E10 会话后从只读步骤重新开始 |
+
+## 红线
+
+- 禁止从 `menuId`、`appId`、`listId`、`objId` 互相猜测，缺哪个就用 `context.resolve` 补。
+- 禁止把未出现在 `ebuilder-form schema` 中的能力当作可用 operation。