weaver-work-cli 0.1.8 → 0.1.21

package/skills/weaver-e10-jinchengda/references/contract-agent-entry.md

@@ -0,0 +1,82 @@
+# 今承达合同管理 CLI 入口
+
+## 请求头 / 认证
+
+所有 `weaver-work-cli contract run <operation>` 发起的 API 请求均自动携带以下凭证头，值来自 E10 登录会话（由 `weaver-work-cli auth login` 建立），禁止业务输入携带：
+
+| 头 | 值来源 | 说明 |
+|---|---|---|
+| `Cookie` | E10 登录返回的完整原始 Cookie 串 | CLI 从会话注入，禁止裁剪/去重/改写 |
+| `eteamsid` | E10 登录返回的 ETEAMSID | CLI 从会话注入 |
+| `User-Agent` | `AgentType=<agentType>,IsAgent=true` | CLI 自动拼接，`agentType` 来自登录时的 `--agent_type` 参数 |
+
+业务输入（`--input-json` / `--input`）**不得包含** `userid`、`userId`、`token`、`cookie`、`eteamsid` 等字段，用户 ID 由 CLI 从会话注入。
+
+## operation 合约第一信息源
+
+`weaver-work-cli contract schema` 输出 operation 名称、`risk`、`fixed`（固定的方法与路径）、`inputSchema` 和 `withheldOperations`。调用前先读它，不要凭记忆拼 operation 名和字段名。
+
+- operation 名称统一为 `contract.<domain>.<action>`。
+- 写操作一律是 `*.prepare` -> `*.apply` 两段：`prepare` 返回脱敏 `preview` 和 `continuation`，`apply` 必须带 `continuation` 与 `confirm: true`。
+- `inputSchema` 的 `additionalProperties` 为 `false`，未声明的字段会被拒绝。
+- `withheldOperations` 列出源资料不足、暂未实现的能力，遇到对应意图直接说明不可用，不要尝试用其它接口替代。
+
+## 统一调用方式
+
+所有 operation 都通过 `contract run <operation>` 调用。三种输入方式：
+
+1. `--input-json '<json>'`：简单 JSON，推荐。
+2. `--input <path>`：复杂或多行 JSON，先写入 UTF-8（无 BOM 也可，CLI 会自动剥离 BOM）文件。
+3. `--input -`：stdin，只有确认当前 shell 能稳定传管道时才使用。
+
+`--input` 与 `--input-json` 不能同时传，同时传会返回 `validation/input_conflict`。
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli contract schema
+weaver-work-cli --json contract run contract.template.list --input-json '{"templateName":"采购合同","pageNo":1,"pageSize":10}'
+weaver-work-cli --json contract run contract.request.status --input-json '{"requestId":"12345"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli contract schema
+weaver-work-cli --json contract run contract.template.list --input-json '{"templateName":"采购合同","pageNo":1,"pageSize":10}'
+weaver-work-cli --json contract run contract.request.status --input-json '{"requestId":"12345"}'
+```
+
+## 人类友好子命令
+
+除了 `run`，CLI 也提供分组子命令（参数会转成对应的 operation 输入），可用于排查和手工操作：
+
+- `contract type tree`
+- `contract template tree|list|detail`
+- `contract clause tree|list|groups|search|tags`
+- `contract clause reference get|save-prepare|save-apply`
+- `contract subject app|form|fields|options|query|create-prepare|create-apply`
+- `contract workflow query|list|form-info|field-options`
+- `contract request create-prepare|create-apply|save-prepare|save-apply|submit-prepare|submit-apply|supervise-prepare|supervise-apply|status|log`
+
+Agent 侧优先用 `run <operation>`，保证输入与 manifest 完全一致。
+
+## 退出码
+
+| 退出码 | 含义 |
+|---|---|
+| 0 | 成功 |
+| 1 | 业务/服务错误 |
+| 2 | 输入用法错误（含 ID 非法、字段非法） |
+| 3 | 认证失败或登录态失效 |
+| 4 | 网络错误 |
+| 5 | 内部错误 |
+| 6 | 策略拒绝（重复引用、流程状态不允许等） |
+| 10 | 需要确认（缺少 `confirm` 或 continuation） |
+| 11 | `partial/write_uncertain`，结果不确定，禁止自动重试 |
+
+## 注意
+
+- 业务输入不得包含 `userid`、`userId`、`token`、`cookie`、`eteamsid` 等字段；用户 ID 由 CLI 从会话注入。
+- 环境相关 ID（`appId`、`objId`、`formId`、`workflowId`、`nodeId`）只能运行时解析，禁止使用文档示例值或标准环境 ID 兜底。
+- 涉及合同正文或附件的操作，文件内容可能进入大模型上下文，执行前必须获得用户明确确认。

package/skills/weaver-e10-jinchengda/references/contract-clause-recommender.md

@@ -0,0 +1,69 @@
+# 条款查询与推荐
+
+## 请求头 / 认证
+
+本文件描述的 API 请求通过 `weaver-work-cli` 执行，CLI 从 E10 登录会话自动注入以下凭证头（禁止业务输入携带）：
+
+| 请求头 | 值 |
+|--------|-----|
+| `Cookie` | `<e10-login 返回的完整原始 Cookie 串>`（禁止裁剪/去重/改写） |
+| `eteamsid` | `<e10-login 返回的 ETEAMSID>` |
+| `User-Agent` | `AgentType=<agentType>,IsAgent=true` |
+
+业务输入（`--input-json` / `--input`）**不得包含** `userid`、`userId`、`token`、`cookie`、`eteamsid` 等字段，用户 ID 由 CLI 从会话注入。
+
+
+用途：按标签、分类或关键词查找合同条款，供用户挑选。五个 operation 全部为 `read`。
+
+## operation 与接口
+
+| operation | 方法 | 路径 | 关键输入 |
+|---|---|---|---|
+| `contract.clause.tags` | GET | `/api/ebd/contract/clauseinfo/getClausesConfig` | `label`、`value`、`pageNum`、`pageSize` |
+| `contract.clause.tree` | GET | `/api/ebd/contract/tree/queryList` | 无（无需传参） |
+| `contract.clause.search` | GET | `/api/ebd/contract/clauseinfo/getClauses` | `id`、`title`、`tagId`、`content`、`group`、`mark`、`pageNum`、`pageSize` |
+| `contract.clause.list` | GET | `/api/ebd/contract/clauseinfo/getListPage` | `belongId`、`clauseName`、`clauseNum`、`clauseStatus`、`clauseGroup`、`contractType`、`pageNo`、`pageSize` |
+| `contract.clause.group.list` | GET | `/api/ebd/contract/clausegroup/getListPage` | `belongId`、`clauseName`、`clauseNum`、`clauseStatus`、`contractType`、`pageNo`、`pageSize` |
+
+分页参数命名差异（源资料原文，不要统一）：
+- `contract.clause.list` / `contract.clause.group.list` 用 `pageNo`（默认 1）+ `pageSize`（默认 10）。
+- `contract.clause.search` / `contract.clause.tags` 用 `pageNum`（默认 **0**）+ `pageSize`（默认 10）。
+
+## 处理链
+
+1. `contract.clause.tags` 是**语义匹配的关键前置接口**，先拿 `tagId`。
+2. `contract.clause.tree` 拿条款分类树，取 `belongId`。
+3. `contract.clause.search` 是核心查询接口，传 `tagId`、`title` 或 `content`。
+4. 需要按分类浏览时用 `contract.clause.list`；需要按条款组浏览时用 `contract.clause.group.list`。
+
+## 调用示例
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json contract run contract.clause.tags --input-json '{"pageNum":0,"pageSize":10}'
+weaver-work-cli --json contract run contract.clause.tree
+weaver-work-cli --json contract run contract.clause.search --input-json '{"tagId":"12345","title":"违约金","pageNum":0,"pageSize":10}'
+weaver-work-cli --json contract run contract.clause.list --input-json '{"belongId":"12345","pageNo":1,"pageSize":10}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json contract run contract.clause.tags --input-json '{"pageNum":0,"pageSize":10}'
+weaver-work-cli --json contract run contract.clause.tree
+weaver-work-cli --json contract run contract.clause.search --input-json '{"tagId":"12345","title":"违约金","pageNum":0,"pageSize":10}'
+weaver-work-cli --json contract run contract.clause.list --input-json '{"belongId":"12345","pageNo":1,"pageSize":10}'
+```
+
+## 结果解读
+
+- 成功码为顶层 `code = 0`。
+- 展示候选时给条款名称、状态和推荐理由；**不伪造"智能评分"**。
+- 命中多条时先展示候选请用户选择，不要把第一条当成唯一答案。
+- 标签 ID、分类 ID、条款 ID 均为环境相关字符串，必须运行时解析。
+
+## 注意
+
+- 只做查询和推荐，不写入。要把条款真正插入合同文档，必须先走 [`contract-clause-reference-save.md`](contract-clause-reference-save.md) 的确认链。
+- 推荐前先用 `contract.clause.reference.get` 查已引用条款，避免推荐用户已经插入过的条款。

package/skills/weaver-e10-jinchengda/references/contract-clause-reference-save.md

@@ -0,0 +1,78 @@
+# 条款引用：查询与写入（本模块唯一条款写操作）
+
+## 请求头 / 认证
+
+本文件描述的 API 请求通过 `weaver-work-cli` 执行，CLI 从 E10 登录会话自动注入以下凭证头（禁止业务输入携带）：
+
+| 请求头 | 值 |
+|--------|-----|
+| `Cookie` | `<e10-login 返回的完整原始 Cookie 串>`（禁止裁剪/去重/改写） |
+| `eteamsid` | `<e10-login 返回的 ETEAMSID>` |
+| `User-Agent` | `AgentType=<agentType>,IsAgent=true` |
+
+业务输入（`--input-json` / `--input`）**不得包含** `userid`、`userId`、`token`、`cookie`、`eteamsid` 等字段，用户 ID 由 CLI 从会话注入。
+
+
+## 查询：`contract.clause.reference.get`
+
+- 方法/路径：`POST /api/ebd/contract/clauseReference/selectData`
+- 风险：`read`（虽为 POST，但属于查询）
+- 输入：`fileId`、`requestId`、`clauseId`、`referenceObjType`（默认 1，1=条款）、`startTime`、`endTime`、`pageNum`、`pageSize`
+- 响应关键字段：`data.records[].clauseId`、`data.records[].fileName`、`data.total`
+
+用途：查看当前合同文档已引用哪些条款，以及在写入前做重复校验。
+
+## 写入：`contract.clause.reference.save.prepare` -> `contract.clause.reference.save.apply`
+
+- 方法/路径：`POST /api/ebd/contract/clauseReference/saveData`
+- 风险：`read-before-write` / `high-risk-write`
+- 必填输入：`clauseIds`（非空 ID 数组）、`fileId`、`requestId`；可选 `fileName`、`requestName`
+- 固定值：`referenceObjType = 1`（1=条款）
+
+`prepare` 阶段 CLI 会先调用 `selectData` 查已引用条款：若传入的 `clauseIds` 中存在已被引用的条款，直接抛 `policy/already_referenced` 并停止，避免重复插入。
+
+`apply` 阶段写入成功后，CLI 会再次调用 `selectData` 回读：若仍有条款未出现在已引用列表中，返回 `partial/write_uncertain`（退出码 11），此时禁止自动重试，只补一次只读查询并向用户报告。
+
+## 确认要求
+
+写入前必须向用户展示并确认**具体条款、合同和文件**：
+
+- 目标合同文件（`fileId` / `fileName`）
+- 关联流程（`requestId` / `requestName`）
+- 待引用条款数量与条款 ID 摘要（CLI 返回的 `preview` 已脱敏）
+
+不要把"推荐"描述为"已插入"；只有 `apply` 回读成功后才能说条款已生效。
+
+## 调用示例
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json contract run contract.clause.reference.get --input-json '{"fileId":"901","requestId":"902","pageNum":1,"pageSize":20}'
+weaver-work-cli --json contract run contract.clause.reference.save.prepare --input-json '{"clauseIds":["301","302"],"fileId":"901","requestId":"902","requestName":"2024年IT设备采购合同"}'
+weaver-work-cli --json contract run contract.clause.reference.save.apply --input-json '{"clauseIds":["301","302"],"fileId":"901","requestId":"902","requestName":"2024年IT设备采购合同","continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json contract run contract.clause.reference.get --input-json '{"fileId":"901","requestId":"902","pageNum":1,"pageSize":20}'
+weaver-work-cli --json contract run contract.clause.reference.save.prepare --input-json '{"clauseIds":["301","302"],"fileId":"901","requestId":"902","requestName":"2024年IT设备采购合同"}'
+weaver-work-cli --json contract run contract.clause.reference.save.apply --input-json '{"clauseIds":["301","302"],"fileId":"901","requestId":"902","requestName":"2024年IT设备采购合同","continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+## 错误与边界
+
+| 场景 | 表现 | 处理 |
+|---|---|---|
+| 传入已引用条款 | `policy/already_referenced` | 停止，提示用户这些条款已插入，不要重复 |
+| `apply` 缺少 `confirm` | `confirmation/required`，退出码 10 | 重新调用时带 `confirm: true` 和 `prepare` 的 `continuation` |
+| `apply` 输入与 `prepare` 不一致 | `validation/target_changed` | 停止，重新 `prepare` |
+| 写入后回读缺失 | `partial/write_uncertain`，退出码 11 | 停止，不自动重放；只补一次 `contract.clause.reference.get` |
+| `code != 0` | `api/business_error` | 报告相对路径、脱敏参数摘要与错误信息后停止 |
+
+## 注意
+
+- `fileId` 需从编辑会话获取、`requestId` 需从流程上下文获取，均为环境相关 ID，禁止使用示例值。
+- 合同正文与附件内容可能进入大模型上下文；在读取、展示或写入合同文档前必须获得用户明确确认。
+- `continuation` 有效期 10 分钟，由 CLI 生成，禁止手工构造或跨操作复用。

package/skills/weaver-e10-jinchengda/references/contract-disabled-capabilities.md

@@ -0,0 +1,27 @@
+# 未实现能力（withheldOperations）
+
+以下能力出现在源资料的能力清单里，但源资料**没有给出可用的接口路径、方法、参数或响应结构**，因此未纳入 CLI manifest，也没有对应 operation。遇到这些意图时直接说明不可用，不要尝试用其它接口替代或猜测接口。
+
+| 能力 | 源资料状态 | 处理方式 |
+|---|---|---|
+| `contract.credit.query`（相对方工商资信查询，CM-018） | `references/enterprise-credit/api-enterprise-credit.md` 只有 9 行索引，指向的 `api-credit-info.md`、`api-enterprise-change.md`、`api-monitor-config.md` 三个子文档在源资料中不存在 | 告知用户当前不可用；如确需使用，请先提供完整的接口文档 |
+| `contract.credit.change`（企业变更查询） | 同上，接口文档缺失 | 同上 |
+| `contract.credit.monitor`（企业监控开启/修改） | 同上；且属于写操作，缺少确认与回查契约 | 同上；不得在未拿到契约前实现写操作 |
+| `contract.workflow.withdraw`（撤回/退回流程） | 源资料只提到"除非调用撤回/退回接口"，未给出路径、方法和参数 | 告知用户当前不可用；如需撤回请到 E10 前台操作 |
+
+## 已知的源资料状态冲突
+
+- `SKILL.md` 能力清单把 CM-005 ~ CM-015 多数标注为"可用"，但 `feature-map.json` 的 `not_released` 里写着 CM-005 ~ CM-015 未完成，且 `features` 只列出 CM-001、CM-002、CM-004、CM-018、CM-043、CM-044、CM-045。
+- 本 CLI 的实现以"接口文档完整可读"为准：只有能拿到路径、方法、参数和响应结构的接口才生成 operation，其余一律列入 `withheldOperations`。
+- 如果用户后续补齐了文档，需要同步更新 CLI 与 Skill，并更新 `references/source-manifest.json` 的指纹。
+
+## 其它边界
+
+- 12 类合同审批流程（销售、采购、协议、变更、解除、关闭、开票、收款、付款、履约计划、进度提报、供应商准入）共用同一组接口；流程差异体现在运行时解析出的 `workflowId` 与表单字段，而不是不同的接口路径。
+- 企业资信与合同审批是两条互不相干的链：不要把"查一下某公司资信"路由到 `contract.request.*`。
+- 提交审批后流程不可撤回（撤回接口未实现），执行前必须让用户清楚这一点。
+
+## 注意
+
+- 不要为了"完成任务"而猜测未文档化的接口路径或字段名。
+- 涉及未实现能力的用户请求，回复中应说明缺什么（路径/参数/响应/确认契约），并给出需要用户提供的材料。

package/skills/weaver-e10-jinchengda/references/contract-request-status.md

@@ -0,0 +1,71 @@
+# 审批状态与签字意见
+
+## 请求头 / 认证
+
+本文件描述的 API 请求通过 `weaver-work-cli` 执行，CLI 从 E10 登录会话自动注入以下凭证头（禁止业务输入携带）：
+
+| 请求头 | 值 |
+|--------|-----|
+| `Cookie` | `<e10-login 返回的完整原始 Cookie 串>`（禁止裁剪/去重/改写） |
+| `eteamsid` | `<e10-login 返回的 ETEAMSID>` |
+| `User-Agent` | `AgentType=<agentType>,IsAgent=true` |
+
+业务输入（`--input-json` / `--input`）**不得包含** `userid`、`userId`、`token`、`cookie`、`eteamsid` 等字段，用户 ID 由 CLI 从会话注入。
+
+
+用途：查审批进度、查审批意见，以及写操作后的持久化回读。两个 operation 均为 `read`。
+
+| operation | 方法 | 路径 | 输入 |
+|---|---|---|---|
+| `contract.request.status` | GET | `/api/workflow/core/paService/v1/getRequestStatus` | `requestId`（必填）、`userid` 由 CLI 注入 query |
+| `contract.request.log` | GET | `/api/workflow/core/paService/v1/getRequestLog` | `requestId`（必填）、`otherParams`（分页 JSON 串，如 `{"pageSize":10,"pageNumber":1}`） |
+
+## `flowStatus.code` 枚举（源资料原文）
+
+| code | 含义 |
+|---|---|
+| 0 | 草稿 |
+| 1 | 审批中 |
+| 2 | 已退回 |
+| 3 | 正常归档 |
+| 4 | 强制结束 |
+| 5 | 已作废 |
+| 6 | 待提交 |
+| 7 | 暂停 |
+| 8 | 撤销 |
+
+## 调用示例
+
+Windows PowerShell（复杂入参写 UTF-8 文件后传 `--input`，不要在单引号 JSON 里用反斜杠转义引号）：
+
+```powershell
+weaver-work-cli --json contract run contract.request.status --input-json '{"requestId":"67890"}'
+weaver-work-cli --json contract run contract.request.log --input .\request-log.json
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json contract run contract.request.status --input-json '{"requestId":"67890"}'
+weaver-work-cli --json contract run contract.request.log --input-json '{"requestId":"67890","otherParams":"{\"pageSize\":10,\"pageNumber\":1}"}'
+```
+
+复杂 JSON 建议写入 UTF-8 文件后用 `--input <path>`，避免不同 shell 的引号转义差异。
+
+## 结果解读
+
+- `contract.request.status` 返回 `requestId`、`workflowId`、`requestName`、`status`、`flowStatus`（`code` + `desc`）、`currentNodeType`；`lastOperator` 等人员 ID 已脱敏。
+- `contract.request.log` 返回 `operatorName`、`content`、`commentType`、`stepName`、`addTime`（毫秒时间戳）。
+- 成功码为 `message.errcode = "0"`；`data.workflowBaseInfo` 不存在或 `requestId` 与入参不一致时按失败处理。
+- `data` 为空数组表示暂无审批记录，属于正常返回。
+
+## 用途约束
+
+- 提交审批后必须用它回读 `flowStatus.code` 为 1 或 3，才能说"提交已生效"。
+- 保存表单、创建流程后也用它核验持久化结果。
+- 查流程列表用 `contract.workflow.list`，查流程基础信息用 `contract.workflow.query`，不要用本文件的接口替代。
+
+## 注意
+
+- 不要输出完整 `lastOperator`、`creatorId` 等人员 ID。
+- 回读一次即可；不要陷入"查询 -> 写入 -> 查询"的循环。

package/skills/weaver-e10-jinchengda/references/contract-request-write.md

@@ -0,0 +1,94 @@
+# 合同审批流程：创建、保存、提交、催办（写操作）
+
+## 请求头 / 认证
+
+本文件描述的 API 请求通过 `weaver-work-cli` 执行，CLI 从 E10 登录会话自动注入以下凭证头（禁止业务输入携带）：
+
+| 请求头 | 值 |
+|--------|-----|
+| `Cookie` | `<e10-login 返回的完整原始 Cookie 串>`（禁止裁剪/去重/改写） |
+| `eteamsid` | `<e10-login 返回的 ETEAMSID>` |
+| `User-Agent` | `AgentType=<agentType>,IsAgent=true` |
+
+业务输入（`--input-json` / `--input`）**不得包含** `userid`、`userId`、`token`、`cookie`、`eteamsid` 等字段，用户 ID 由 CLI 从会话注入。
+
+
+四个写操作全部是 `prepare -> apply` 两段，且必须分别报告每一步结果。
+
+| 动作 | prepare | apply | 路径 | 风险 |
+|---|---|---|---|---|
+| 创建流程实例 | `contract.request.create.prepare` | `contract.request.create.apply` | `POST /api/workflow/core/paService/v2/doCreateRequest` | write |
+| 保存表单 | `contract.request.save.prepare` | `contract.request.save.apply` | `POST /api/workflow/core/paService/v1/saveFormData` | write |
+| 提交审批 | `contract.request.submit.prepare` | `contract.request.submit.apply` | `POST /api/workflow/core/paService/v1/submitRequest` | high-impact |
+| 催办 | `contract.request.supervise.prepare` | `contract.request.supervise.apply` | `POST /api/workflow/core/paService/v1/requestSupervise` | high-impact |
+
+用户 ID 由 CLI 从会话注入：前三个接口注入 `userid`，催办接口注入 `userId`（源资料原文如此）。
+
+## 创建流程实例
+
+- 输入：`workflowId`（必填）、`requestname`、`remark`、`isnextflow`（默认 0）、`isVerifyFormRequired`（默认 false）、`requestLevel`（默认 0）、`formData`、`isNewFormData`、`seniorFormParam`
+- `prepare` 不再请求活动版本接口（`getActiveWfId` 在部分租户返回 500 系统错误且无必要），直接用 `contract.workflow.query` / `contract.workflow.list` 解析出的 `workflowId` 创建
+- `apply` 成功后从 `message.requestId` 取实例 ID，再用 `getRequestStatus` 回读；缺少 `requestId` 或回读 ID 不一致时返回 `partial/write_uncertain`
+
+## 保存表单
+
+- 输入：`requestId`（必填）、`formData`（必填，含 `dataDetails` 非空数组）、`workflowId`、`userCurrentNodeId`、`isNewFormData`、`seniorFormParam`
+- `formData.dataDetails[]` 用 `fieldId` 或 `dataKey` 二选一定位字段；选择类字段用 `dataOptions[].optionId`，有值时优先于 `content`
+- `prepare` 先读流程状态，只有草稿（0）、已退回（2）、待提交（6）可写；审批中（1）抛 `policy/already_submitted`，已结束（3/4/5/8）抛 `policy/request_closed`
+- 保存 ≠ 创建 ≠ 提交，三者必须分别报告
+
+## 提交审批（最高风险）
+
+- 输入：`requestId`（必填）、`remark`、`userCurrentNodeId`、`requestName`、`formdata`（注意全小写 d）、`otherParams`、`isVerifyFormRequired`（默认 true）
+- **必须与"创建并保存"分开的第二次确认**
+- `apply` 成功后必须回读 `contract.request.status` 的 `flowStatus.code`：只有 1（审批中）或 3（已归档）才算生效；否则返回 `partial/write_uncertain`
+- `1200301`（当前 userid 为空）：停止并诊断会话状态，**不自动切换接口或盲目重试**
+- `1200306`（服务端必填校验）：解析缺失字段列表，逐字段补全后重试（最多 3 轮），不切换接口
+- 提交后流程进入审批流转，不可撤回（撤回/退回接口未实现）
+
+## 催办（会发送真实通知）
+
+- 输入：`requestId`（必填）、`otherParam`（必填）、`remark`
+- `otherParam` 的 `currentOperator`、`doneOperator`、`submitOperator`、`ccOperator`、`otherReminder` **必须至少填 1 个**；`messageRemind`、`emailRemind` 只是提醒方式，不能算作提醒对象
+- `prepare` 先读流程状态，只有审批中（1）可催办，否则抛 `policy/not_in_approval`
+- 高影响操作：会向真实接收人发送通知，执行前必须展示脱敏摘要并获得明确确认；测试时只向明确的内部测试接收人发送，`remark` 包含 `[WB-SKILL-TEST]`
+
+## 调用示例
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json contract run contract.request.create.prepare --input-json '{"workflowId":"12345","requestname":"WB-SKILL-TEST 销售合同审批流程"}'
+weaver-work-cli --json contract run contract.request.create.apply --input-json '{"workflowId":"12345","requestname":"WB-SKILL-TEST 销售合同审批流程","continuation":"PREPARE_CONTINUATION","confirm":true}'
+weaver-work-cli --json contract run contract.request.save.prepare --input-json '{"requestId":"67890","formData":{"dataDetails":[{"fieldId":"111","content":"WB-SKILL-TEST 客户"}]}}'
+weaver-work-cli --json contract run contract.request.submit.prepare --input-json '{"requestId":"67890","requestName":"WB-SKILL-TEST 销售合同审批流程"}'
+weaver-work-cli --json contract run contract.request.supervise.prepare --input-json '{"requestId":"67890","remark":"[WB-SKILL-TEST] 测试催办","otherParam":{"currentOperator":1}}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json contract run contract.request.create.prepare --input-json '{"workflowId":"12345","requestname":"WB-SKILL-TEST 销售合同审批流程"}'
+weaver-work-cli --json contract run contract.request.create.apply --input-json '{"workflowId":"12345","requestname":"WB-SKILL-TEST 销售合同审批流程","continuation":"PREPARE_CONTINUATION","confirm":true}'
+weaver-work-cli --json contract run contract.request.save.prepare --input-json '{"requestId":"67890","formData":{"dataDetails":[{"fieldId":"111","content":"WB-SKILL-TEST 客户"}]}}'
+weaver-work-cli --json contract run contract.request.submit.prepare --input-json '{"requestId":"67890","requestName":"WB-SKILL-TEST 销售合同审批流程"}'
+weaver-work-cli --json contract run contract.request.supervise.prepare --input-json '{"requestId":"67890","remark":"[WB-SKILL-TEST] 测试催办","otherParam":{"currentOperator":1}}'
+```
+
+## 错误与边界
+
+| 场景 | 表现 | 处理 |
+|---|---|---|
+| `apply` 缺少 `confirm` | `confirmation/required`，退出码 10 | 带 `confirm: true` 与 `prepare` 的 `continuation` 重新调用 |
+| 输入与 `prepare` 不一致 | `validation/target_changed` | 重新 `prepare` |
+| 流程状态不允许写 | `policy/already_submitted` / `request_closed` / `not_in_approval` | 停止，先撤回/退回或换流程实例 |
+| `workflowId` 无效或不可创建 | `doCreateRequest` 返回业务失败 | 重新用 `contract.workflow.query` / `contract.workflow.list` 解析 `workflowId` |
+| 提交返回 `1200301` | `authentication/session_expired` | 停止，先确认 E10 登录态 |
+| 提交返回 `1200306` | `api/missing_required_fields` | 解析缺失字段补全后重试，最多 3 轮 |
+| 写请求超时/断线 | `partial/write_uncertain`，退出码 11 | 停止，只补一次 `contract.request.status` 查询 |
+
+## 注意
+
+- 不要连续重复提交同一个 `.apply`；提交审批最容易因重复提交造成重复流转。
+- 12 类合同审批流程共用这组接口，不要为某一类流程假设特殊参数。
+- `continuation` 有效期 10 分钟，由 CLI 生成，禁止手工构造或跨操作复用。

package/skills/weaver-e10-jinchengda/references/contract-signing-subjects.md

@@ -0,0 +1,89 @@
+# 签约主体：定位与查询
+
+## 请求头 / 认证
+
+本文件描述的 API 请求通过 `weaver-work-cli` 执行，CLI 从 E10 登录会话自动注入以下凭证头（禁止业务输入携带）：
+
+| 请求头 | 值 |
+|--------|-----|
+| `Cookie` | `<e10-login 返回的完整原始 Cookie 串>`（禁止裁剪/去重/改写） |
+| `eteamsid` | `<e10-login 返回的 ETEAMSID>` |
+| `User-Agent` | `AgentType=<agentType>,IsAgent=true` |
+
+业务输入（`--input-json` / `--input`）**不得包含** `userid`、`userId`、`token`、`cookie`、`eteamsid` 等字段，用户 ID 由 CLI 从会话注入。
+
+
+用途：查询我方、客户方或供应商签约主体。全部为 `read`。
+
+## 调用链（每步只能用上一步运行时返回的 ID）
+
+```
+① 应用 Tag   ->  contract.subject.app     GET  /api/bs/ebuilder/app/tags/getAppIds   取 appId
+② 表单 Tag   ->  contract.subject.form    GET  /api/ebuilder/form/obj/getObjsByTag   取 objId / formId
+③ 读字段     ->  contract.subject.fields  POST /api/ebuilder/common/ds/fields        取 fields[].id / name / config.dataKey
+④ 读选项     ->  contract.subject.options GET  /api/ebuilder/common/ds/options       取选项 id <-> name
+⑤ 查询       ->  contract.subject.query   POST /api/ebuilder/form/dataset/v2/getAllData
+```
+
+## 准确的 Tag 字符串
+
+| 步骤 | Tag | 说明 |
+|---|---|---|
+| 应用 Tag | `合同管理` | 固定值；CLI 默认也是它 |
+| 表单 Tag（我方） | `我方签约主体库` | 查我方签约主体 |
+| 表单 Tag（客户方） | `客户签约主体库` | 查客户签约主体 |
+| 表单 Tag（供应商） | `供应商签约主体库` | 查供应商主体 |
+
+Tag 需要 URL 编码，CLI 已处理；Agent 只需要传原始中文 Tag。
+
+## 各 operation 输入
+
+| operation | 必填 | 可选 |
+|---|---|---|
+| `contract.subject.app` | 无（默认 `tag=合同管理`） | `tag` |
+| `contract.subject.form` | `appId`、`tag` | 无 |
+| `contract.subject.fields` | `appId`、`objId` | `detailFieldsGroup`、`enableMerge`、`customParam`、`params` |
+| `contract.subject.options` | `appId`、`objId`、`fieldName` | 无 |
+| `contract.subject.query` | `objId` | `mainTable`、`pageNo`、`pageSize`、`isReturnDetail` |
+
+请求形状说明（CLI 负责转换，Agent 只按上表传）：
+
+- `contract.subject.fields` 走 `multipart/form-data`：`groupId=appId`、`sourceId=objId`、`sourceType=FORM`。
+- `contract.subject.options` 的 query 为 `groupId=appId`、`objId`、`sourceType=FORM`、`fieldName`。
+- `contract.subject.query` 的 body 为 `{ datajson: { header: { objId }, mainTable, pageInfo, operationinfo: { isReturnDetail } } }`；`mainTable` 内多个字段之间为 AND 关系。
+
+## 调用示例
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json contract run contract.subject.app --input-json '{"tag":"合同管理"}'
+weaver-work-cli --json contract run contract.subject.form --input-json '{"appId":"12345","tag":"我方签约主体库"}'
+weaver-work-cli --json contract run contract.subject.fields --input-json '{"appId":"12345","objId":"67890"}'
+weaver-work-cli --json contract run contract.subject.options --input-json '{"appId":"12345","objId":"67890","fieldName":"111"}'
+weaver-work-cli --json contract run contract.subject.query --input-json '{"objId":"67890","mainTable":{"clm_party_name":"XX科技"},"pageNo":1,"pageSize":10}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json contract run contract.subject.app --input-json '{"tag":"合同管理"}'
+weaver-work-cli --json contract run contract.subject.form --input-json '{"appId":"12345","tag":"我方签约主体库"}'
+weaver-work-cli --json contract run contract.subject.fields --input-json '{"appId":"12345","objId":"67890"}'
+weaver-work-cli --json contract run contract.subject.options --input-json '{"appId":"12345","objId":"67890","fieldName":"111"}'
+weaver-work-cli --json contract run contract.subject.query --input-json '{"objId":"67890","mainTable":{"clm_party_name":"XX科技"},"pageNo":1,"pageSize":10}'
+```
+
+## 结果解读与边界
+
+- ebuilder 元数据接口成功码是顶层 `code = 200` 且 `status` 不为 false；`getAllData` 成功码是 `message.code = "0"`。
+- `contract.subject.app` 返回 `appIds`；`contract.subject.form` 只返回 `id`、`objName`、`showName`、`tag`，不输出完整 `appId`、`permissionId`。
+- `data` 为空数组表示 Tag 在当前应用中不存在：提示用户确认 Tag 名称或换 Tag，**不使用标准环境 ID 兜底**。
+- 查询无结果时如实说明；返回多条时展示候选请用户选择。
+- 名称、证件、联系和银行字段不得跨表单猜测；字段键以 `fields` 接口返回为准（系统字段用 `name`，自定义字段用 `config.dataKey`，**不要用 `text`**）。
+- 选择类字段的值使用选项 ID（`id`），不要使用选项名称（`name`）。
+
+## 注意
+
+- 新建签约主体不是本文件的范围，见 [`contract-subject-create.md`](contract-subject-create.md)。
+- 企业资信、企业变更、企业监控未实现，见 [`contract-disabled-capabilities.md`](contract-disabled-capabilities.md)。

package/skills/weaver-e10-jinchengda/references/contract-subject-create.md

@@ -0,0 +1,77 @@
+# 新建签约主体（写操作）
+
+## 请求头 / 认证
+
+本文件描述的 API 请求通过 `weaver-work-cli` 执行，CLI 从 E10 登录会话自动注入以下凭证头（禁止业务输入携带）：
+
+| 请求头 | 值 |
+|--------|-----|
+| `Cookie` | `<e10-login 返回的完整原始 Cookie 串>`（禁止裁剪/去重/改写） |
+| `eteamsid` | `<e10-login 返回的 ETEAMSID>` |
+| `User-Agent` | `AgentType=<agentType>,IsAgent=true` |
+
+业务输入（`--input-json` / `--input`）**不得包含** `userid`、`userId`、`token`、`cookie`、`eteamsid` 等字段，用户 ID 由 CLI 从会话注入。
+
+
+- operation：`contract.subject.create.prepare` -> `contract.subject.create.apply`
+- 方法/路径：`POST /api/ebuilder/form/dataset/v2/saveFormData`
+- 风险：`read-before-write` / `high-risk-write`
+
+## 输入
+
+| 字段 | 必填 | 说明 |
+|---|---|---|
+| `objId` | 是 | 表单对象 ID，来自 [`contract-signing-subjects.md`](contract-signing-subjects.md) 第 ② 步 |
+| `mainTable` | 是 | 主表字段对象，键使用实际数据键，至少 1 个字段 |
+| `details` | 否 | 明细表数据，键按 `detail1`、`detail2`… 传入 |
+| `fieldNoFindIgnore` | 否 | 字段不存在是否忽略，默认 `"true"` |
+| `doAction` | 否 | 是否执行 action，默认 `"false"` |
+| `verify` | 否 | `{ field, value }`，写前查重条件 |
+
+CLI 会把输入转成 `{ datajson: { header: { objId }, datas: [{ mainTable, ...details }], operationinfo: { fieldNoFindIgnore, doAction } } }`。
+
+## 写前确认
+
+`prepare` 会返回脱敏摘要 `preview`（字段数量 + 每个字段值的掩码），**必须先展示给用户并获得明确确认**后才执行 `apply`。
+
+若传入 `verify`，`prepare` 会先用 `getAllData` 按 `field=value` 查重；命中记录时抛 `policy/already_exists` 并停止，提示用户复用已有记录而不是重复新建。
+
+## 调用示例
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json contract run contract.subject.create.prepare --input-json '{"objId":"67890","mainTable":{"clm_party_name":"XX科技有限公司"},"verify":{"field":"clm_party_name","value":"XX科技有限公司"}}'
+weaver-work-cli --json contract run contract.subject.create.apply --input-json '{"objId":"67890","mainTable":{"clm_party_name":"XX科技有限公司"},"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json contract run contract.subject.create.prepare --input-json '{"objId":"67890","mainTable":{"clm_party_name":"XX科技有限公司"},"verify":{"field":"clm_party_name","value":"XX科技有限公司"}}'
+weaver-work-cli --json contract run contract.subject.create.apply --input-json '{"objId":"67890","mainTable":{"clm_party_name":"XX科技有限公司"},"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+## 成功判定
+
+1. HTTP 200 且 `message.code = "0"`。
+2. `data.datajson.status` 为 `true` 且 `data.datajson.dataIds` 非空。
+3. CLI 在 `apply` 中校验这两项；不满足时返回 `partial/write_uncertain`（退出码 11），此时先用 `contract.subject.query` 确认是否已创建，**不盲目重试**。
+
+成功后保存返回的 `dataIds`，用于后续详情、修改和删除操作。
+
+## 错误与边界
+
+| 场景 | 表现 | 处理 |
+|---|---|---|
+| `mainTable` 为空 | `policy/empty_main_table` | 停止，补齐主表字段 |
+| 查重命中 | `policy/already_exists` | 停止，与用户确认是否复用已有记录 |
+| `apply` 缺少 `confirm` | `confirmation/required`，退出码 10 | 带 `confirm: true` 重新调用 |
+| 输入与 `prepare` 不一致 | `validation/target_changed` | 重新 `prepare` |
+| 网络中断 | `partial/write_uncertain`，退出码 11 | 停止，只补一次查询确认 |
+
+## 注意
+
+- 字段键规则：系统字段直接用 `name`；自定义字段（`name` 等于 `id`）改用 `config.dataKey`；**禁止用字段 `text` 作为键**。选择字段值用选项 ID。
+- 主体名称、证件号、联系方式、银行账号属于敏感信息；CLI 的 `preview` 已脱敏，回复用户时也不要贴完整证件号或银行账号。
+- 测试数据命名建议使用 `WB-SKILL-TEST-<日期>-<随机串>`，便于识别和清理。