weaver-work-cli 0.1.24 → 0.1.26

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

@@ -16,12 +16,12 @@ cliHelp: "weaver-work-cli workflow --help"
 ---
 
 **CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。若共享规则不存在、CLI 未安装或读取失败，说明本技能的必需依赖缺失，必须调用宿主提供的提问/确认弹框，向用户说明必须补齐 `weaver-work-cli` 与共享 skill `weaver-e10-shared`（不补齐本技能无法执行）及补齐计划，并把下面两条待执行命令原样完整展示在确认信息中；Agent 不能在未确认时自行安装。用户明确确认后，Agent 必须直接代为按顺序执行且每条仅执行一次，不得要求或引导用户手动执行：① 缺 CLI 时执行 `npm install -g weaver-work-cli`；② 再执行 `weaver-work-cli skills install shared --target-dir <SKILLS_ROOT>` 装回共享 skill，`<SKILLS_ROOT>` 取本 SKILL.md 所在目录的上一级绝对目录（即与本技能同级的 skills 根目录），不要省略 `--target-dir`——省略会装进默认目录，导致本技能依然读不到共享规则。命令均成功后重新读取共享规则；仍读不到就停止并把结果报告用户，不得凭猜测继续。**
-**`--is-connector` 判据**：用户明确使用连接器、或上下文要求用连接器完成任务 → 传 `true`；本次任务或上下文直接选择单独技能 → 不传；用户没有明确说明时，按**正在运行的这份 Skill 是哪一级**定——**用户级（条目标 `(user)`）不传，连接器级（标 `(connector)`）传**（同名 Skill 只会运行用户级那一份）。传 `true` 时不要再写 `--profile` / `--base-url`。完整规则见 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)。
 
-认证和登录态只能按共享规则通过 `weaver-work-cli auth ...` 命令判断；禁止直接读取、列出、打印或解析用户主目录下的旧 `.e10-cli`、auth、config 或 Keychain 数据。
-所有命令通过 `weaver-work-cli --json workflow run <operation>` 执行：**统一用 `--input-json '<json>'` 内联传入**——`planJson`、`filterFields` 这类嵌套结构也一样内联（总量通常只有几百字符，内联完全够用；**不要因为"看着复杂"就去写 JSON 文件**，那会白白多出一次文件写入与一次工具往返）。仅当 JSON 确实很大（几十 KB 级，如超长消息列表）或含难以在 shell 里转义的单引号时，才改写 UTF-8 文件配 `--input <path>`；只有确认当前 shell 能稳定传管道时才用 `--input -`。调用前先按需读取 references 下对应的文件，查参数结构，不要猜字段；**references 是第一信息源**，`weaver-work-cli workflow schema` 是 operation、字段和风险等级的合约来源。
-生成或改写的 docs、reference、提示词和命令示例必须同时兼容 Windows 和 macOS/Linux。凡涉及 JSON 输入、用户目录、路径分隔符、文件删除、目录查看或文件比对，必须同时给出 Windows PowerShell 与 macOS/Linux（bash/zsh）两套示例；Agent 先根据当前系统和 shell 选择对应示例，不确定时用 `node -p "process.platform"` 判断。Windows/PowerShell 示例不要使用 `printf`、`$HOME/...`、`~/...`、bash 反斜杠续行、`rm/ls/diff/python3` 等 Unix-only 写法。
-涉及附件、图片、本地文件、远程 URL 文件或文件内容解析的 operation，执行前必须提醒用户：文件内容可能被上传到业务系统、OCR/解析服务，并可能进入当前大模型上下文用于理解和处理；必须等待用户明确确认后才继续。
+**`--is-connector` 判据**：用户明确使用连接器、或上下文要求用连接器完成任务 → 传 `true`；本次任务或上下文直接选择单独技能 → 不传；用户没有明确说明时，按**正在运行的这份 Skill 是哪一级**定——**用户级（条目标 `(user)`）不传，连接器级（标 `(connector)`）传**（同名 Skill 只会运行用户级那一份）。传 `true` 时不要再写 `--profile` / `--base-url`。完整判据表见 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)「连接器模式」。
+
+认证和登录态只能按共享规则通过 `weaver-work-cli auth ...` 命令判断；禁止直接读取、列出、打印或解析用户主目录下的旧 `.e10-cli`、auth、config 或 Keychain 数据，也不得自建登录流程或索取、转存任何凭证。
+
+所有命令通过 `weaver-work-cli --json workflow run <operation>` 执行：**统一用 `--input-json '<json>'` 内联传入**——`planJson`、`filterFields` 这类嵌套结构也一样内联（总量通常只有几百字符，内联完全够用；**不要因为"看着复杂"就去写 JSON 文件**，那会白白多出一次文件写入与一次工具往返）。仅当 JSON 确实很大（几十 KB 级，如超长消息列表）或含难以在 shell 里转义的单引号时，才改写 UTF-8 文件配 `--input <path>`；只有确认当前 shell 能稳定传管道时才用 `--input -`。调用前先按需读取 references 下对应的文件，查参数结构，不要猜字段；**references 是第一信息源**，`weaver-work-cli workflow schema` 是 operation、字段和风险等级的合约来源。生成或改写的 docs、reference、提示词和命令示例必须同时兼容 Windows 和 macOS/Linux（口径见共享规则「通用准则」），Windows/PowerShell 示例不要使用 `printf`、`$HOME/...`、`~/...`、bash 反斜杠续行、`rm/ls/diff/python3` 等 Unix-only 写法。
 
 # 泛微E10流程智能助手
 
@@ -29,12 +29,7 @@ cliHelp: "weaver-work-cli workflow --help"
 
 用户提到待办、已办、我发起的流程、流程详情与摘要、同意/退回/转办/加审等流程操作、批量处理、共享流程、发起创建流程或修改流程表单时，使用本技能。
 
-用户要查组织架构与人员 ID 时转 `weaver-e10-hrm`；查发票、邮件、日程、费控时转对应业务技能。
-
-## 认证与请求头契约
-
-登录与会话由 `weaver-e10-shared` 共享规则和 `weaver-work-cli auth ...` 命令体系统一托管。业务 Skill 不自建登录流程，不索取、打印或转存任何凭证。
-
+用户要查组织架构与人员 ID 时转 `weaver-e10-hrm`；查发票、邮件、日程、费控时转对应业务技能。（附件/文件类操作执行前必须先取得用户对"内容可能进入大模型/外部解析服务"的明确确认，口径见共享规则。）
 
 ## 任务入口（每收到用户任务，先按本固定步骤执行）
 
@@ -42,11 +37,11 @@ cliHelp: "weaver-work-cli workflow --help"
 
 1. **第一轮就并行发起（关键：不要串行拆成多轮往返）**：在**同一条消息**里同时发出下列调用——
     - Read `../weaver-e10-shared/SKILL.md`（若尚未读过）；
-    - `weaver-work-cli [--is-connector true] --json workflow run workflow.memoryPrompt`——该命令**无入参**；**先按本文件开头的 `--is-connector` 判据确定前缀，再直接执行**（仅"非首次对话且距上次成功读取记忆不足 6 小时"时跳过）；
+    - `weaver-work-cli [--is-connector true] --json workflow run workflow.memoryPrompt`——该命令**无入参**；**先按上方 `--is-connector` 判据确定前缀，再直接执行**（仅"非首次对话且距上次成功读取记忆不足 6 小时"时跳过）；
     - **查询类意图**只读 [`workflow-query.md`](references/workflow-query.md) 一份（已覆盖 `workflow.search` 与 `workflow.todoStat`，不要再读其他查询文档）；**但该文件约 108 KB / 835 行——整读会超单次读取上限被明确拒绝**（Read 单次上限约 **20,000 tokens ≈ 100 KB / 800 行**）：**首轮一次读完开头的契约段**（`offset 1 limit 244`，约 30 KB，已覆盖 Operation、全部输入参数含「大分类判定」、时间条件与「待办时间默认语义」、执行流程），其余章节（`planJson` 编排、汇报式分组骨架、渲染规则与示例）**只在需要的那一刻按它开头的「分段索引」给出的行区间补读**；查看/操作/共享/发起/修改等意图读对应那一份 reference 即可，不要顺手把查询文档也一起读；**唯一例外是批量操作**——用 `scopeCondition` 走范围驱动时要构造与 `workflow.search` 同形的查询条件，**这一轮可以同时读 [`workflow-query.md`](references/workflow-query.md) 与 [`workflow-batch.md`](references/workflow-batch.md)**（前者给条件写法，后者给 `scopeCondition`/`action` 的执行口径），其余意图仍只读对应那一份；
     - **泛化待办查询**（如"今天有哪些待办"）先看上一步 `memoryPrompt` 返回的 `oaContext.smartGrouping`：`false`（低版本）→ **直接** `workflow.search`（category=todo，**不要带 `planJson`/`subCategory`**），CLI 已自带分组统计与卡片，原样渲染即结束；`true`（智能分组）→ 才追加 `workflow.todoStat` 做统计规划，再带 `planJson` 取数。**不要在 `smartGrouping` 为 `true` 之前先调 `workflow.todoStat`**——低版本必然失败（报 `todo_stat_requires_smart_mode`）白费一次调用。
-   > 以上调用**互不依赖，必须并行**：串行拆轮会成倍拉长耗时。**实测基准**：一次泛化待办查询全程约 70s，其中**模型轮次占 ~95%**（每轮约 8~25s，主因是模型输出量），CLI 命令本身合计只有 1~2s。**能省一轮就省一轮**——尤其不要为"解析上一轮输出""取流程 ID"另起一轮。
-    - **[`workflow-memory.md`](references/workflow-memory.md) 本步不读**——记忆读取的命令形态见上一行（**含 `--is-connector` 判据**，按它确定前缀后执行），**记忆保存的规则已在本文件「记忆保存（全局规则）」章节给全**（本轮任务结束时按那一节执行）；只有需要判断"放 `user.md` / `memory.md` / `workflow:{id}` 哪一类"或其它字段细节时，才在需要的那一刻去读它。
+   > 以上调用**互不依赖，必须并行**：串行拆轮会成倍拉长耗时。**实测**：一次泛化待办查询全程约 70s，其中**模型轮次占 ~95%**（每轮约 8~25s，主因是模型输出量），CLI 命令本身合计只有 1~2s。**能省一轮就省一轮**——尤其不要为"解析上一轮输出""取流程 ID"另起一轮。
+    - **[`workflow-memory.md`](references/workflow-memory.md) 本步不读**——记忆读取的命令形态见上一行（**含 `--is-connector` 判据**），**记忆保存的规则已在本文件「记忆保存」章节给全**；只有需要判断"放 `user.md` / `memory.md` / `workflow:{id}` 哪一类"或其它字段细节时，才在需要的那一刻去读它。
     - **读被拒就按行段重读源文件，不要去读宿主的落盘文件**：Read 单次超限是**明确报错**（提示改用 `offset`/`limit`），照提示把源文件分行段重读即可；**不要**去读宿主的落盘文件（`~/.workbuddy/projects/**/tool-results/**`：**没有读取权限**，去读必然拿一句 `Permission … has been denied`、白费一轮——那是**命令输出**超线时的落盘预览，不是 Read 的读取路径）。
 2. **执行用户任务**：按下方「选哪个命令」与「处理链」选定 operation 并执行，参数以对应 reference 为准。
 
@@ -55,12 +50,11 @@ cliHelp: "weaver-work-cli workflow --help"
 ## 总原则
 
 - **全程中文**；输出时把技术术语翻译成普通用户能看懂的话（命令要求对返回内容原样输出的除外）。
-- **列表/详情最终回复 = 原样粘贴命令返回的渲染文本全文，一字不改**：**`workflow.search` 用 `finalMarkdown`**（卡片列表；`smart` 模式无顶部行）、**`workflow.detail` 用 `renderMarkdown`**（该 operation 没有 `finalMarkdown`）——两者不要混用、不要自己拼装；其中禁止出现 `<div>`/`<span>`/`style` 等 HTML 标签。
+- **列表/详情/发起结果的最终回复正文 = 命令返回的渲染文本全文本身（从第一个字符到最后一个字符，不增不减）**：**`workflow.search` 用 `finalMarkdown`**（卡片列表；`smart` 模式无顶部行）、**`workflow.detail` 用 `renderMarkdown`**（该 operation 没有 `finalMarkdown`）、**`workflow.createRequest` 的结果用 `finalMarkdown`**——**落地三态（`CREATED` / `CREATED_SUBMITTED` / `CREATED_SUBMIT_FAILED`）**（结论 + 流程编号/链接 + 已填内容 + 明细）与 **`NEEDS_INPUT`（必填缺失）**（结论 + 已填内容 + 明细 + **待补必填项清单**，其中**历史取值一致**的待补字段带一行 `历史推荐值`——由命令算好）**完全同一口径、都是同一段文本**：字段、表格、待补清单、缺项的类型提示都已渲染在里面——**这段文本之外，回复里不再有别的**（不重拼表格、不另列清单、不进弹窗；弹窗要给候选选项，而这里不做任何值推断）；三者不要混用。其中禁止出现 `<div>`/`<span>`/`style` 等 HTML 标签。**`已填内容` 按"用户在表单上看到的已填字段"渲染**（流程标题 + 表单默认值 + 本次入参，业务字段按表单布局顺序）——**里面出现你没传过的默认值字段是正常的，照贴、不要删**。
 - 只执行本 skill 列出的 operation，把命令返回的结果、提示、候选**原样呈现**；命令没做的、没返回的、查不到的，反馈用户或停止——**绝不自行发明、探测、绕过**。
 - **澄清一律不向用户索取 ID**：凡是"名称没匹配到 / 有多个候选待确认"的情形（填单、查询、转发接收人、共享对象等一律适用），只问该对象的**完整名称**或**其它可用于检索的关键词**；`名称(ID)`（或 `{id,name}` 这类结构）由你按命令返回的 `candidates` 自己拼好、重发同一条命令，**不要让用户提供 ID**。
 - 失败、超时、登录失效、业务错误一律立即停止，不自动重试、不延长等待、不切换地址、不换接口。**例外**：读操作遇登录失效时按 `weaver-e10-shared` 的认证引导处理，认证完成后重放原请求（写操作见「写操作失败处理」）。
 - **接口异常一律原样反馈给用户，禁止自行尝试解决方案**：命令返回里出现接口报错（`error.type = api`）时，把接口提示原文转述给用户、并说明本次操作**没有完成**；不得替接口解释原因，不得自行改用别的做法去绕。
-- **若决策依据了历史记忆，最终回复要说明；若本轮保存了记忆，要说明会记住什么。**
 - **不得写 agent 工具的工作日志/工程日志/对话记录**；**不读取、不处理与本任务无关的工作区引导/身份文件**（如工作区根的引导说明、身份档案等——那是别的流程负责的事，在本轮纠结它只会让任务跑偏并白白多花几秒）；不读取命令源码、不执行调试命令、不使用调试参数。
 
 ## 记忆保存（全局规则，每轮任务结束都要执行）
@@ -71,15 +65,13 @@ cliHelp: "weaver-work-cli workflow --help"
     - **`msgList` 每项的字段名固定是 `msgRole` / `msgValue`**（按对话顺序：user 放用户原话/澄清回复，assistant 放命令返回/你的确认说明），**不要写成 `role` / `content`**；
     - **`workflowId` 只在「这条记忆换个工作流就不成立」时才带**——① 澄清**工作流本身**（业务别名、名称消歧、把口语简称落到某个工作流）⇒ **不带**：这类事实跨工作流通用，带上会被锁进该工作流维度，**而别名存在的意义正是"还没确定工作流时用它去找工作流"**；② 澄清**该工作流内部**（表单字段与选项含义、节点流转、提交节奏、审批规则）⇒ **带上**。一句话判据：**换个工作流还成立吗？成立 → 不带；只在某个工作流里成立 → 带**；
     - **保存「业务别名 → 工作流」映射时，ID 必须来自本轮命令返回**：`workflow.search` / plan 的 **`cards[].workflowId`**、`workflow.createForm` 澄清候选的 `id`、`workflow.todoStat` 的 `countDetails[].workflowId`——拿到就必须把 ID 写进 `msgValue` 的事实句（如「业务别名"问题流程"= 工作流"E10客户问题支持解决流程"，workflowId=1003655203465764898」）；**不允许只记名称、把 ID 留空**——留空就是「（待确认）」，后续查询只能拿纯名称去试探，多命中还要再澄清一次；
-    - `saved:true` → **用自然语言告知用户会记住什么**（如"后续再发起请假流程时会默认按本次偏好（年假）填写"），不展示接口原文；
-    - `saved:false` → 按静默失败处理，不告知用户、不重试，直接继续回答用户原本问题。
+    - `saved:true` / `saved:false` → **都静默处理**（不告知用户、不展示接口原文、不重试），直接继续回答用户原本问题。
 - **没有** → 不调用 `workflow.memoryExtract`，直接输出最终回复；**不要纠结"一次性原因（如请假事由）是否值得记忆"**。
 
 **硬禁令（违反即为没保存）**：
 
 - **不允许只在思考里写"应该保存记忆"**：判断"有"后必须**真的发出 `workflow.memoryExtract` 命令**，拿到真实 `saved` 结果后再输出最终回复。只在内心说"要保存"而不执行 = 没保存。
 - **发起流程（`workflow.createForm` / `workflow.createRequest`）按本节更窄的口径**：本轮发起过程中，只有**用户有新的明确澄清**——① 工作流名称；② 字段名称；③ 浏览按钮字段值；④ 选项字段的选项值——才属于要保存的情形（口径见 [`workflow-create.md`](references/workflow-create.md)）；**这四类之外一律不保存**（用户只是给出普通文本 / 日期 / 金额字段的本次取值、或只是正常走完一次填单，都不算记忆），不要漏也不要多存。
-- 用户澄清后确认的**工作流名称 / 字段名称 / 浏览按钮字段值 / 选项字段的选项值**属于典型的"有价值记忆"，**属于要保存的情形**，不要漏。
 - **记忆里的别名条目写「（待确认）」时，它是一张待办、不是终态**：本轮只要把该别名唯一解析出了 `workflowId`（**`cards[].workflowId`** 或 `countDetails[].workflowId` 里就有），任务结束时**必须再保存一次把 ID 补上**（口径同上），不要放着不管。
 
 > 本节的规则已足够直接执行；仅当需要判断"放 user.md / memory.md / workflow:{id} 哪一类"或需要其它字段细节时，才去读 [`workflow-memory.md`](references/workflow-memory.md)。
@@ -127,7 +119,7 @@ cliHelp: "weaver-work-cli workflow --help"
     - **目标是一个范围（没有准确 `requestId`）** → **必须先数条数再执行**：先用 `scopeCondition`（与 `workflow.search` 同形的条件）+ `action:"total"` **只查条数**（`action` 在给了 `scopeCondition` 时**必填**，漏写报 `batch_action_required`），把「范围 + 条数」报给用户确认（`total=0` 但 `scopeTotal>0` 时要说明"有 N 条但不适用本次操作"，不能说成没有数据）。
     - **目标是一个范围、用户已确认条数** → 再用同一条 `scopeCondition` 配 `action:"execute"`；**循环由 CLI 内部完成**（查一页→执行→排除已处理/失败的 ID→再查，直到取完或触达上限），**不要自己写"查一页→数 ID→再执行"的多轮流程**。返回里给的是成功/失败条数、失败清单与 `stoppedReason`（**不含批次数等内部细节**），照它汇报即可——`scope_not_batch_eligible` 表示"范围内有数据但本次操作一条都取不到"（**不是**"没有数据"），要说明原因并给替代操作（如改 `workflow.batchRead`）。
 - 单条共享 -> `workflow.sharePrepare` -> 用户确认 -> `workflow.shareApply`。
-- 发起流程 -> `workflow.createForm`（传 `workflow`，**目标写法优先用 `名称(ID)`**：自带显式 ID 时不查可发起列表、少一次往返，纯名称才走可发起列表模糊匹配；解析可发起的工作流并拿到 `continuation`；返回 `NEEDS_CLARIFICATION` 时按 `candidates` 与用户确认后用 `名称(ID)` 重发）-> 按用户意图填 `data` -> `workflow.createRequest`（`context` 传上一步的 `continuation`，`action` 取 `draft`/`submit`）。**必填是否齐不用模型判断**：`action:"submit"` 缺必填时命令不会创建流程，返回 `NEEDS_INPUT` + `missingFields`，一次问齐后带同一 `context` 重发；`action:"draft"` 则照常建草稿、缺失项只作提醒。
+- 发起流程 -> `workflow.createForm`（传 `workflow`，**目标写法优先用 `名称(ID)`**：自带显式 ID 时不查可发起列表、少一次往返，纯名称才走可发起列表模糊匹配；解析可发起的工作流并拿到 `continuation`；返回 `NEEDS_CLARIFICATION` 时按 `candidates` 与用户确认后用 `名称(ID)` 重发）-> 按用户意图填 `data` -> `workflow.createRequest`（`context` 传上一步的 `continuation`，`action` 取 `draft`/`submit`）。**字段的 id 与名称由 `createForm` 返回的唯一一份 `fields` 给出**（可编辑 ∪ 必填且可见；**有默认值的字段已把值直接带在字段属性上（`initialValue`）**），历史参考值在 `historyRequestData` 里，**不要为了拿名称去读 `resultFile`**。**必填是否齐不用模型判断**：`action:"submit"` 缺必填时命令不会创建流程，返回 `NEEDS_INPUT` + `missingFields`，一次问齐后带同一 `context` 重发；`action:"draft"` 则照常建草稿、缺失项只作提醒。**结果落地三态（`CREATED` / `CREATED_SUBMITTED` / `CREATED_SUBMIT_FAILED`）与 `NEEDS_INPUT`（必填缺失）都直接原样回复命令给的 `finalMarkdown`**（`NEEDS_INPUT` 那份末段就是待补必填项清单：**原样粘贴即可，不要自己列、也不要塞进弹窗**；清单里带 `历史推荐值` 的行是**命令按历史一致性算好的**，不要自己再算、也不要回头翻历史），不要自己挑字段、拼主表/明细表格。填 `data` 按 [`workflow-create.md`](references/workflow-create.md) 的「填值纪律」一遍定案——每个字段只做一次取舍、取完不再回头，不要在同一字段上反复比较历史值。
 - 修改表单 -> `workflow.editLoad` 拿 `context` -> `workflow.editPrepare` -> 用户确认 -> `workflow.editApply`。
 
 ## 执行原则（减少误路由、误重试和无效消耗）
@@ -163,20 +155,20 @@ cliHelp: "weaver-work-cli workflow --help"
 
 ### 4) 附件、图片和文件解析确认
 
-- 命中发起流程上传附件、读取本地文件、使用远程 URL 文件或复用已上传文件对象时，必须先提醒数据处理风险并等待用户明确确认。
-- 风险提醒必须说明文件内容可能进入大模型上下文，也可能被发送到业务系统或解析服务。
+- 命中发起流程上传附件、读取本地文件、使用远程 URL 文件或复用已上传文件对象时，必须先提醒数据处理风险并等待用户明确确认（提醒口径见共享规则「通用准则」与「安全规则」）。
 - 上传前先按表单返回的 `fileUploadParams` 核对文件大小、扩展名格式和数量限制；不满足时先告知用户、不执行上传。
 - 用户未确认前，不要运行会读取、上传或解析该文件的命令。
 
 ### 5) 命令输出读取纪律（禁止截断、禁止重复取数）
 
 - **禁止对命令输出做管道截断**：不要用 `| head`、`| tail`、`| more` 等处理 `weaver-work-cli --json ...` 的 stdout。截断会破坏 JSON，并且必然导致重复执行同一条命令（实测最常见的一条命令被执行 2 次，就是 `| head` 引起的）。
-- **一律直读 stdout（失败时读 stderr，见下条），不要落盘、不要写脚本回读**：`--json` 输出是**多行 pretty JSON**，且已按体积做过控制（`workflow.todoStat` 约 20 KB/400 余行；`workflow.search` 的条目已收窄到必要字段、泛化待办查询实测约 **14 KB**；`workflow.detail` 只有几 KB；`workflow.createForm` / `editLoad` 遇到大表单会落盘、stdout **只回一条提示**（提示里直接给出可照抄的读命令））——都在宿主单次输出上限以内，每行也都不长——**直接读即可**，不存在行长截断问题。**禁止**把 stdout 重定向到文件（`> /tmp/xxx.json`）再写脚本解析回读：它不会带来任何新信息，只会白白多出一次工具往返（实测多一轮约 +7s，占整轮耗时可观）。
+- **一律直读 stdout（失败时读 stderr，见下条），不要落盘、不要写脚本回读**：`--json` 输出是**多行 pretty JSON**，且已按体积做过控制（`workflow.todoStat` 约 20 KB/400 余行；`workflow.search` 的条目已收窄到必要字段、泛化待办查询实测约 **14 KB**；`workflow.detail` 只有几 KB；`workflow.createForm` / `editLoad` 遇到大表单会落盘、stdout 只回提示）——都在宿主单次输出上限以内——**直接读即可**。注意 `workflow.createForm` 的 `fields` / `historyRequestData` / `systemFields` 三个键是**压成单行**输出的（只去缩进、内容一字不改），其中 `fields` 那一行字段多时可能上万字符——**这属正常，不是被截断**，照常按 JSON 解析。**禁止**把 stdout 重定向到文件（`> /tmp/xxx.json`）再写脚本解析回读：它不会带来任何新信息，只会白白多出一次工具往返（实测多一轮约 +7s，占整轮耗时可观）。
 - **`workflow.search` 的体积纪律（别等被截断）**：泛化待办按要求走 `planJson` 分组（各组独立渲染、各 10 条，体积天然分散）；要看更多用 `current` 分页续查；**不要靠加大 `pageSize` 一次拉全**。CLI 侧已按 **24 KB（美化口径）** 设体积守卫：超线时自动把完整结果落盘，并在结果**最前面**给出 `resultFile`（结构化 JSON）+ `resultMdFile`（纯 `finalMarkdown`），**stdout 仍保留全量 `finalMarkdown`** ⇒ 正常渲染**直接用 stdout 即可、不需要读文件**；只有需要完整结构化明细（如逐条 `requestId`）时才从 `resultFile` 按需提取，并一次读完（不要 `| head`/`| tail`）。宿主把输出截成一小段预览时：**不要重跑同一条命令**（结果一样、白烧一轮），改用更小页或 `planJson` 分组重取；宿主提示的落盘副本（`~/.workbuddy/projects/**/tool-results/**`）**不能用 Read 工具读**（会拿 `Permission … has been denied`），确实要用时以 shell 命令读取并只提取需要的字段。
 - **失败出口在 stderr（stdout 为空即失败）**：命令失败时退出码非 0、**错误 JSON 只出现在 stderr**（`{ok:false, error:{type,subtype,message,retryable}}`），**stdout 是空的**。因此：**stdout 为空 → 一律视为失败并去读 stderr**，按 `error.subtype` 决定下一步（如 `todo_stat_requires_smart_mode` → 不要重试 todoStat，改走 `workflow.search`；`plan_requires_smart_mode` → 去掉 `planJson` 重查）；判断成败**以 `ok` 字段为准**，宿主界面把命令显示成"运行成功"只代表进程结束，不代表业务成功。
 - **同一个 operation 最多执行一次**：拿到 stdout 后一次性解析完，不要先截断看一眼再重跑。
-- **结果里出现 `resultFile` 时不要重跑命令**：`workflow.search`、`workflow.todoStat`、`workflow.createForm`、`workflow.editLoad` 等大输出 operation 会把完整数据落盘，并在结果**最前面**返回 `resultFile` 与 `largeOutputNotice`；`workflow.search` / `workflow.todoStat` 的 stdout 已保留可用内容，被省略的大字段（如查询的逐条明细、某工作流的 `formFields`、通知正文 `formFieldValues` 全文）再**按需提取**（只取要用的键，不要把整份读进上下文）；**`createForm` / `editLoad` 则相反——stdout 里已没有任何表单属性，必须照抄提示里的读命令把该文件整份读完**，之后不要再重读。两类都**不要重新执行 operation**。
-- **`createForm` / `editLoad` 大表单超线时只回一条提示**（字段少时就是原样全量）：结果里**只有** `resultFile` / `persistedResult` / `outputBytes` / `largeOutputNotice` 四个键，**不带任何表单属性**。`largeOutputNotice` 里直接给出可照抄执行的读命令（文件路径 + `limit` = 该文件总行数），**先照抄它把文件一次读完、再继续下一步**——字段清单、必填、`initialValues` / `historyRequestData`、以及下一步要用的 `contextId` 全在那个文件里。**不要重跑本命令、不要分段读、不要用 `head`/`tail` 截断、也不要用脚本去挖文件。** 只有落盘不可用（极少见）时才返回全量并在 `largeOutputNotice` 里说明。**必填不要自己推演**：OA 的联动（显示属性）规则不下发，一律按 `createRequest` 的 `missingFields` 补齐。
+- **结果里出现 `resultFile` 时不要重跑命令**：`workflow.search`、`workflow.todoStat`、`workflow.createForm`、`workflow.editLoad` 等大输出 operation 会把完整数据落盘，并在结果**最前面**返回 `resultFile` 与 `largeOutputNotice`；`workflow.search` / `workflow.todoStat` 的 stdout 已保留可用内容，被省略的大字段（如查询的逐条明细、某工作流的 `formFields`、通知正文 `formFieldValues` 全文）再**按需提取**（只取要用的键，不要把整份读进上下文）；两类都**不要重新执行 operation**。
+- **`createForm` 大表单超线时只回一句话（必须先读文件）**：输出**超过 20,000 字符**（字符口径；量的就是**最终打出来的那段文本**，已压掉 `fields` / `historyRequestData` / `systemFields` 的缩进空白）时，stdout **只有** `resultFile` / `persistedResult` / `outputChars` / `largeOutputNotice`，其中 `largeOutputNotice` 就是那一句「当前表单内容较大，已临时写入文件 x，请直接读取 x 获取完整结果」——**`fields`（含 `initialValue`）、`contextId`、`historyRequestData` 一个都不在 stdout 里**，它们全在那个文件里（未裁剪的完整 pretty JSON）。所以大表单下**必须先按 `resultFile` 把该文件一次读完**，拿到字段清单与 `contextId` 之后再拼 `data`、走 `createRequest`；**不要重跑 `createForm`、不要只给小 `limit` 分段读、不要 `head`/`tail` 截断、不要用脚本去挖**（宿主若报单次读取超限，按报错提示调整 `limit`/`offset`）。字段少（未超线）时仍是**原样全量**的 JSON，直接用即可，不存在任何提示键（只是那三个键在 stdout 上压成了单行）。只有落盘不可用（极少见）时才返回全量并在 `largeOutputNotice` 里说明。**必填不要自己推演**：OA 的联动（显示属性）规则不下发，一律按 `createRequest` 的 `missingFields` 补齐。
+- **`editLoad` 大表单超线时要读文件**（与 `createForm` 口径不同）：超线时结果**只有** `resultFile` / `persistedResult` / `outputBytes` / `largeOutputNotice` 四个键，`currentValues`（当前字段值）/ `editableFields` / `contextId` 都只在文件里 ⇒ **这四样都拿到之后才能拼修改内容**，所以**照 `largeOutputNotice` 那条读命令把文件一次读完**（`limit` 已给足），再走下一步；同样**不要重跑本命令、不要分段读**。
 - **一次解析取全，不要把"判定"与"取 ID"拆成两次**：同一次输出里已有的信息应在同一步一并取出——例如 `countDetails[].requestInfos` 里 `requestId` 与同条目的标题、字段值就在一起，判定完可直接用该 `requestId` 构造 `planJson`，**不要为了拿 ID 再跑第二个脚本、也不要为此再发一次 `workflow.search`**。注意 `requestInfos` **不是每行都有**（接口只对配置了关注字段的工作流返回该字段，未带的行即没有，属正常、不是数据缺失）：**没有 `requestInfos` 的行不参与逐条判定，也绝不为它去取 ID**——为一条明细另跑一次查询会白多整整一轮工具往返（实测 +10s 以上），而它本来在自己的分组里照常展示。
 - **用户对已展示结果的更正不重跑**：用户指出上一轮汇报里某条的性质/归属不对（如"重点关注里第一条其实是转发给我的，意见是请知悉"）时，这是**呈现层的更正**、底层数据没变——**不要重跑那次 `workflow.search`（plan）**：在受影响分组的汇总摘要里标注一句用户提供的信息即可（口径见 `references/workflow-query.md`「渲染红线」）。**只有用户明确要求"重新出一份 / 挪到某组重出"时才重跑**，且复用上一轮那次的 `planJson`、只改受影响的分组。重跑一次 ≈ **1 轮 + 30~50s**，纯属浪费；用户表述是陈述句、看不出意图时，先问一句再动手。
 
@@ -187,16 +179,11 @@ cliHelp: "weaver-work-cli workflow --help"
 
 ## 写操作失败处理：`partial/write_uncertain` 决策树
 
-当发起、操作、批量、共享、修改等写操作返回 `partial/write_uncertain`，或提示网络中断、部分成功、回查失败、回查字段不一致时，按下面规则处理：
+当发起、操作、批量、共享、修改等写操作返回 `partial/write_uncertain`，或提示网络中断、部分成功、回查失败、回查字段不一致时（停止条件与"不允许的做法"见共享规则 [`high-risk-write.md`](../weaver-e10-shared/references/high-risk-write.md)，各 operation 的细则见对应 reference）：
 
-1. **先停止盲目重试**，不要连续重复提交相同 `.apply`
-2. 优先从以下角度解释：
-    - 写请求可能已经到达服务端，但连接在结果确认前中断
-    - 服务端可能只处理了部分流程
-    - 写接口已返回成功，但详情回查失败或与预期不一致
-    - continuation、`context`、目标流程或登录上下文可能已经变化
-3. 如需确认，只补 **一次** 只读查询（例如 `workflow.detail` 或 `workflow.search`），不要陷入 query/write 循环
-4. 最终给用户明确结论、已知状态、成功/失败项和下一步人工确认建议，而不是继续无意义重试
+1. **先停止盲目重试**，不要连续重复提交相同 `.apply`；不要靠反复重跑 Prepare 来"试"。
+2. 如需确认，只补 **一次** 只读查询（例如 `workflow.detail` 或 `workflow.search`），不要陷入 query/write 循环。
+3. 最终给用户明确结论、已知状态、成功/失败项和下一步人工确认建议，而不是继续无意义重试。
 
 **特别注意：** 对退回、删除、批量提交和发起场景更要严格执行上述规则；这些场景最容易因重复提交造成重复审批、误删或重复发起。
 
@@ -204,16 +191,12 @@ cliHelp: "weaver-work-cli workflow --help"
 
 | 返回 | 含义 | 该怎么做 |
 | --- | --- | --- |
-| `ok:true` + `data.status = "ALREADY_APPLIED"` | 该句柄上一次**已经执行成功**，本次没有重复写入 | **当作成功汇报**（用 `previousResult` 的结果，需要定位时才带 `requestId`），不要重跑 Prepare、不要再 apply |
+| `ok:true` + `data.status = "ALREADY_APPLIED"` | 该句柄上一次**已经执行成功**，本次没有重复写入 | **当作成功汇报**（用 `previousResult` 的结果，需要定位时才带 `requestId`），不要重跑 Prepare、不要再 apply；**对用户只报业务结果**，不要说"此前已执行过/没有重复写入" |
 | `partial/write_uncertain` | 上一次**已发出写入请求、结果未确认** | 先只读核对目标是否已生效；已生效按成功汇报，确认没生效才重跑 Prepare |
 | `validation/continuation_busy` | 句柄正被另一次执行占用，上一次**还没发出写入**（可安全重试） | **稍后原样重试同一条命令**，不要重跑 Prepare、不要换句柄 |
 | `validation/continuation_consumed` | 占用该句柄的执行停在**无法判定的旧状态**（旧版本标记） | 先只读核对目标是否已生效，再决定是否重跑 Prepare |
 
-> 不要只凭"命令报错"就认定"没做成"：`ALREADY_APPLIED` 是成功，`busy` 可以直接重试；只有 `write_uncertain` 和 `consumed` 才需要先只读核对。**任何时候都不要靠反复重跑 Prepare 来"试"。**
-
-> **6 个批量单命令（`workflow.batchSubmit` / `batchRead` / `batchSupervise` / `batchShare` / `batchForward` / `batchReject`）没有句柄**：它们只会出现上表前两行——幂等保护由「同一操作 + 同一批 `requestId` + 同一组写向对象」的一次性写入闸门承担，**不会**出现 `continuation_busy` / `continuation_consumed`。`write_uncertain` 的恢复路径是「先只读核对 → 确认没生效 → 等约 1 分钟原样重跑同一条命令」，**不要去重跑并不存在的 Prepare**。
-
-> **`ALREADY_APPLIED` 对用户只报结果**：这是 CLI 内部的幂等保护（防止重试造成重复写入），不是用户关心的事件。给用户的回复**只写业务结果**（如"两条流程已提交/已置为已办"），**不要**写"系统回报此前已执行过""幂等回报""本次没有重复写入"这类话——那会让用户怀疑是不是提交了两遍。只有当 `previousResult` **不是成功态**、或需要解释"为什么这次没有再次写入"时才说明。
+> 不要只凭"命令报错"就认定"没做成"：`ALREADY_APPLIED` 是成功，`busy` 可以直接重试；只有 `write_uncertain` 和 `consumed` 才需要先只读核对。**6 个批量单命令（`workflow.batchSubmit` / `batchRead` / `batchSupervise` / `batchShare` / `batchForward` / `batchReject`）没有句柄**：只会有上表前两行——幂等保护由「同一操作 + 同一批 `requestId` + 同一组写向对象」的一次性写入闸门承担，**不会**出现 `continuation_busy` / `continuation_consumed`；`write_uncertain` 的恢复路径是「先只读核对 → 确认没生效 → 等约 1 分钟原样重跑同一条命令」，**不要去重跑并不存在的 Prepare**。
 
 Windows PowerShell：
 
@@ -221,8 +204,6 @@ Windows PowerShell：
 weaver-work-cli workflow schema
 weaver-work-cli --json workflow run workflow.search --input-json '{"category":"todo","pageSize":10}'
 weaver-work-cli --json workflow run workflow.todoStat --input-json '{"category":"todo"}'
-weaver-work-cli --json workflow run workflow.detail --input-json '{"requestId":"123456"}'
-weaver-work-cli --json workflow run workflow.operatePrepare --input-json '{"requestId":"123456","action":"submit","opinion":"同意"}'
 weaver-work-cli --json workflow run workflow.operateApply --input-json '{"requestId":"123456","action":"submit","continuation":"wc-1a2b3c4d5e6f7a8b","confirm":true}'
 weaver-work-cli --json workflow run workflow.createForm --input-json '{"workflow":["费用报销"]}'
 weaver-work-cli --json workflow run workflow.createRequest --input-json '{"context":"wc-1a2b3c4d5e6f7a8b","data":{"main":{}},"action":"submit"}'
@@ -234,8 +215,6 @@ macOS/Linux（bash/zsh）：
 weaver-work-cli workflow schema
 weaver-work-cli --json workflow run workflow.search --input-json '{"category":"todo","pageSize":10}'
 weaver-work-cli --json workflow run workflow.todoStat --input-json '{"category":"todo"}'
-weaver-work-cli --json workflow run workflow.detail --input-json '{"requestId":"123456"}'
-weaver-work-cli --json workflow run workflow.operatePrepare --input-json '{"requestId":"123456","action":"submit","opinion":"同意"}'
 weaver-work-cli --json workflow run workflow.operateApply --input-json '{"requestId":"123456","action":"submit","continuation":"wc-1a2b3c4d5e6f7a8b","confirm":true}'
 weaver-work-cli --json workflow run workflow.createForm --input-json '{"workflow":["费用报销"]}'
 weaver-work-cli --json workflow run workflow.createRequest --input-json '{"context":"wc-1a2b3c4d5e6f7a8b","data":{"main":{}},"action":"submit"}'

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

@@ -888,7 +888,7 @@
     }
   },
   "artifactBaseline": {
-    "aggregateSha256": "a70b78d1893cf024dd80372667f58775830d310d20c38d8778ca21bbdf7f1e2f",
+    "aggregateSha256": "89ee9f67e64f8c6e7c94ddbacc98d4adf9accd37bc3c8fb871fe7734161d86df",
     "files": [
       {
         "path": "skills/weaver-e10-workflow/references/workflow-agent-entry.md",
@@ -902,18 +902,18 @@
       },
       {
         "path": "skills/weaver-e10-workflow/references/workflow-create.md",
-        "size": 42157,
-        "sha256": "0c2d103baed11bd10254ef61f72ca31d3410e1de0d3ce515eafe855c823924d6"
+        "size": 65844,
+        "sha256": "136ed885b0abb9908150e3d47e763ef5f1ed406d293702c656b6e3c6344bbd32"
       },
       {
         "path": "skills/weaver-e10-workflow/references/workflow-edit.md",
-        "size": 6585,
-        "sha256": "17c233c2c6edd175f7bbc059dc1878b2a6c17154047d47ec6e88e4c38e1fee66"
+        "size": 6728,
+        "sha256": "de8d2295cbb118ed27bba4e1ab5200f4211a8566fd653f743dcab2d438b2a029"
       },
       {
         "path": "skills/weaver-e10-workflow/references/workflow-memory.md",
-        "size": 13929,
-        "sha256": "70758e63429a6cbfaf7a821ad93889b384bb42c895d2082680ed0006a19d4793"
+        "size": 13481,
+        "sha256": "807dee9118bb1ba7737ed8528a2c3ea44d11b436a62311307197f16f0e1962f7"
       },
       {
         "path": "skills/weaver-e10-workflow/references/workflow-operate.md",
@@ -922,8 +922,8 @@
       },
       {
         "path": "skills/weaver-e10-workflow/references/workflow-query.md",
-        "size": 108743,
-        "sha256": "c5bb7942ee840b9934a08475d6d6827dc8f7801c24bab85d859c8d75cc4234f8"
+        "size": 108768,
+        "sha256": "4eb67609ffe8e51e6cac12ee30c66f116f8a0980c9ba29174ddf091157d4897b"
       },
       {
         "path": "skills/weaver-e10-workflow/references/workflow-share.md",
@@ -937,8 +937,8 @@
       },
       {
         "path": "skills/weaver-e10-workflow/SKILL.md",
-        "size": 40794,
-        "sha256": "d33da96aec46a20a7824dd2e8c6702765bfc06d40e268c79bbe9eebbc5b1e25f"
+        "size": 41574,
+        "sha256": "fe8860d92a5bf2f96f3a71e203bbd5993a82acb826a774cd98f371e8b80a2a1d"
       },
       {
         "path": "src/shortcuts/workflow/continuation.ts",
@@ -947,8 +947,8 @@
       },
       {
         "path": "src/shortcuts/workflow/endpoints.ts",
-        "size": 9589,
-        "sha256": "2ef1ea72023bb4b7941aaa258159151999983ebac3c91c1034e5ca40e1c18e89"
+        "size": 10182,
+        "sha256": "42363eb685546d065a23363f96ef0e8fbd9d9eece1733a6401cd70596900c614"
       },
       {
         "path": "src/shortcuts/workflow/errors.ts",
@@ -957,13 +957,13 @@
       },
       {
         "path": "src/shortcuts/workflow/host.ts",
-        "size": 11980,
-        "sha256": "c1f0ae44fb2267be1888b80faa35fb0ce9ab596b9aa7ca6e0e5429933745b920"
+        "size": 12448,
+        "sha256": "ae66c65b2c99a300a88ff5ff11fd3c1cd6b594138d2d7779f1939c71e648f0fc"
       },
       {
         "path": "src/shortcuts/workflow/index.ts",
-        "size": 4833,
-        "sha256": "32940c87aa81111457e403b840afde29a777434b58a85e7224c78c01d57608c6"
+        "size": 6275,
+        "sha256": "a626636dba15624b7216aead4d5e016ceffa975eae3b999ec9a7091409bed579"
       },
       {
         "path": "src/shortcuts/workflow/manifest.ts",
@@ -975,6 +975,11 @@
         "size": 9461,
         "sha256": "50f028b494fc572637c90afeade84c0f0cc36de92a5fa355b4813125a3c6eff0"
       },
+      {
+        "path": "src/shortcuts/workflow/operations/chatscene.ts",
+        "size": 13774,
+        "sha256": "64abb0654df387c33b8a380e051a0084d9f8efa40652b6d2516cb394912dba7e"
+      },
       {
         "path": "src/shortcuts/workflow/operations/flow-status.ts",
         "size": 3774,
@@ -982,13 +987,13 @@
       },
       {
         "path": "src/shortcuts/workflow/operations/form.ts",
-        "size": 235099,
-        "sha256": "db612187d35df210c3caeaccdfd9618f20ea870c361b5a45aeec5f2434568043"
+        "size": 351032,
+        "sha256": "3b2036ab629078ac50e0ff37de27d3e42de95e9e9e2cb80f32a31783fbe00cfa"
       },
       {
         "path": "src/shortcuts/workflow/operations/read.ts",
-        "size": 272728,
-        "sha256": "55a8baf6cd4feef9508a13f8acc5bf3a018b31616368df90fbfc33ab93d92927"
+        "size": 282043,
+        "sha256": "8606f1c0cd165c3ffafbba8d1fecc4c4d22d155de44f194bacd34fa88fa8c2ee"
       },
       {
         "path": "src/shortcuts/workflow/operations/registry.ts",
@@ -997,8 +1002,13 @@
       },
       {
         "path": "src/shortcuts/workflow/operations/shared.ts",
-        "size": 9323,
-        "sha256": "496c414e40cca8a96cb05800961e03baf6657e61ac36ea0025cd3960f1cc2c05"
+        "size": 10848,
+        "sha256": "54a9b2626514461cb9c48a1ffd464cd50cb3c85bfe681ce464cebdc93702ef0f"
+      },
+      {
+        "path": "src/shortcuts/workflow/operations/sign-input.ts",
+        "size": 5577,
+        "sha256": "ecee488053fcf280679b977d4d10c758d74e2539bd5be77f3b02c7f3c9249f5e"
       },
       {
         "path": "src/shortcuts/workflow/operations/types.ts",
@@ -1007,13 +1017,18 @@
       },
       {
         "path": "src/shortcuts/workflow/operations/write.ts",
-        "size": 141978,
-        "sha256": "f8ca00a7096aef887bd4ed84391988589b128b8cdde2cbb043d78f0460342414"
+        "size": 142628,
+        "sha256": "5de4cbc724a4882aabc0d2ee796e2d72141c2c48e622a3499a89a5fc2b0de114"
       },
       {
         "path": "src/shortcuts/workflow/state.ts",
         "size": 8625,
         "sha256": "4e3d9a3848574269a64f891a06edf04c185fda5ebd4bc4fc394f151a02d26c6c"
+      },
+      {
+        "path": "src/shortcuts/workflow/stdout-compact.ts",
+        "size": 2958,
+        "sha256": "1d72ac72a69c63655530f0c458f34733ebeb5645a9f1937f3ecdc07815adb40e"
       }
     ]
   },