weaver-work-cli 0.1.36 → 0.1.39

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

@@ -2,23 +2,24 @@
 name: weaver-e10-caizhilian
 display_name: 泛微E10采知连知识管理
 display_name_en: Weaver E10 Document Management
-description: "泛微E10采知连知识管理系统Skill，包含多个功能模块，覆盖文档创建/搜索/编辑/比对、附件管理、文件夹操作、参与人与标签管理、文档共享与权限设置、文件存储/备份/加解密/附件设置、FTP/SFTP文件采集、本地文件上传。"
-description_zh: "泛微E10采知连知识管理系统Skill，包含多个功能模块，覆盖文档创建/搜索/编辑/比对、附件管理、文件夹操作、参与人与标签管理、文档共享与权限设置、文件存储/备份/加解密/附件设置、FTP/SFTP文件采集、本地文件上传。"
-description_en: "Weaver E10 document management Skill with multiple functional modules covering document CRUD, attachments, folders, sharing, permissions, file settings, FTP/SFTP collection, and file upload."
-version: 1.1.36
+description: "泛微E10采知连知识管理：文档创建/搜索/编辑/比对、文件夹与权限共享、标签参与人、附件封面、文件采集与上传。当用户处理采知连/知识库的文档、文件夹、共享权限或附件时使用。"
+description_zh: "泛微E10采知连知识管理：文档创建/搜索/编辑/比对、文件夹与权限共享、标签参与人、附件封面、文件采集与上传。当用户处理采知连/知识库的文档、文件夹、共享权限或附件时使用。"
+description_en: "Weaver E10 caizhilian knowledge management: document create/search/edit/compare, folders and sharing permissions, tags and participants, attachments and covers, file collection and upload. Use this skill when the user works with caizhilian or knowledge-base documents, folders, sharing permissions, or attachments."
+version: 1.1.42
 author: 泛微网络科技股份有限公司
+tags: [文档管理, 知识库, 泛微E10, document-management, knowledge-base]
 agent_created: true
 requires:
   bins: ["weaver-work-cli"]
+dependencies:
+  - weaver-e10-shared
 cliHelp: "weaver-work-cli caizhilian --help"
+compatibility: "需 Node.js >=18 与 npm 全局安装 weaver-work-cli；业务操作需可访问目标 E10 系统并完成登录；支持 Windows / macOS / Linux"
 ---
 
-**CRITICAL — 开始前先读共享规则**：同级目录存在 `weaver-e10-shared` 技能时，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`——省略会装进默认目录，
-导致本技能依然读不到共享规则。
-命令均成功后重新读取共享规则；若环境中确实无法补齐共享规则，停止依赖登录态的业务操作，告知用户共享认证规则缺失；不要在业务 Skill 中猜测宿主或写死登录命令。
+**开始前先做环境自检，首轮必须有产出**：先按 [`auth-and-install.md`](references/auth-and-install.md) 检查 `weaver-work-cli` 是否可用（`weaver-work-cli --version`），并按需执行 `weaver-work-cli caizhilian schema` / `caizhilian operations`（不依赖登录态，不发起业务请求）；`caizhilian health` 需已有登录配置，未登录时返回认证错误属预期结果、如实转述即可。把能力目录或自检结论随首轮草案一并交付，见「首轮必有产出」。
+本包的安装、认证、JSON 输出与高风险写入规则已完整沉淀在 [`auth-and-install.md`](references/auth-and-install.md) 与 [`write-protocol.md`](references/write-protocol.md)，**不依赖任何包外技能**；同级目录若装有共享规则技能（weaver-e10-shared），可顺带读取作规则复核——它是可选增强，缺它也能跑，不存在或读取失败都直接按本包规则继续。
+CLI 未安装时**不要空手终止、也不要擅自安装**：先把安装命令原样展示给用户（`npm install -g weaver-work-cli`，用户提供 registry 时加 `--registry "<用户提供的 registry 地址>"`），等用户明确确认后代为执行一次；确实无法补齐时，停止依赖登录态的业务操作，但仍交付「能力边界说明 + 安装/登录步骤 + 本任务执行草案」。不要在业务 Skill 中猜测宿主或写死登录命令。
 **`--is-connector` 判据**：用户明确使用连接器、或上下文要求用连接器完成任务 → 传 `true`；本次任务或上下文直接选择单独技能 → 不传；用户没有明确说明时，按**正在运行的这份 Skill 是哪一级**定——**用户级（条目标 `(user)`）不传，连接器级（标 `(connector)`）传**（同名 Skill 只会运行用户级那一份）。
 传 `true` 时不要再写 `--profile` / `--base-url`。
 完整规则见 [`auth-and-install.md`](references/auth-and-install.md)。
@@ -39,6 +40,23 @@ Windows/PowerShell 下不要使用 `printf`、`$HOME/...`、`~/...`、bash 反
 
 涉及附件、封面图片、正文文件、本地文件上传或下载落盘的操作，执行前必须提醒用户：文件内容可能被上传到 E10 采知连文档中心或文件服务器、下载内容会写入本地磁盘，并可能进入当前大模型上下文用于理解和处理；必须等待用户明确确认后才继续。
 
+## 执行预算（最小动作集，避免冗余读取与重复调用）
+
+- 同一轮已有新鲜查询结果时不重复查询同一列表或同一详情；`*.form` 的表单结构同轮内复用。
+- 列表默认小页（`page_size=10`）且只查第一页；用户要求「继续」才翻页，不自动拉全量。
+- 已拿到 `doc_id` / `folder_id` / `attachment_id` 或本地文件路径时直达对应操作，不默认走「search -> get -> form -> list -> prepare -> apply」全链路。
+- 一次只跑一个文件上传/下载；reference 按需读取，不为同一件事连翻多个文件。
+
+## 首轮必有产出（先给草案，再补信息）
+
+用户一句话进来，第一轮回复必须包含产出物，不允许只回提问、只报依赖缺失或空手等待：
+
+- **先给草案卡**：任务理解（对象 / 动作 / 范围 / 预期结果）+ 执行方案（准备走的处理链与关键取值）+「本卡假设（不符请改）」列出所用默认假设；能推断的按最稳默认直接写进草案，用户否决再改。
+- **必问项 ≤3 且附在产出之后**：只问确实缺失、无默认值且影响动手的问题，一次问全；不要第一句先反问，不要挤牙膏式追问。
+- **确认门只卡写操作落地**：查询、方案、草案与结果摘要直接交付，不设确认门；只有真正执行写操作（prepare → apply、上传、下载落盘）前才等用户明确确认。
+- **环境缺失不等于零产出**：CLI 未装 / 未登录 / 规则缺失时，交付「能力边界说明 + 原样展示的安装与登录步骤 + 本任务执行草案」，按 [`auth-and-install.md`](references/auth-and-install.md) 执行。
+- **无交互 / 无登录环境同样要有产出**：拿不到用户应答（自动化执行器、托管沙箱），或 CLI 未装、未登录、无 E10 环境时，首轮直接交付四件套：①环境自检结论（`--version` / `schema` / `operations` 的真实输出摘要；`health` 报认证错误属预期，原样转述）②能力目录摘要 ③本任务的分步执行方案——可直接复制执行的真实命令 + 参数模板 + 字段取值来源 ④前置条件清单（安装 CLI、提供登录域名、所需权限）。此环境下不等待确认，也不执行安装、登录与任何写操作——方案交付即为本轮产出；恢复交互后回到正常流程。
+
 ## 路由优先级（先判断是不是采知连文档中心，再选 operation）
 
 采知连是 E10 的文档中心 / 知识库能力，不是通用网盘，也不是流程表单。**只要用户的核心对象是采知连文档、知识库文件夹、文档共享与权限、文档标签/参与人、文档附件与封面、文档比对，就优先使用 `weaver-e10-caizhilian`。**
@@ -195,7 +213,7 @@ Windows/PowerShell 下不要使用 `printf`、`$HOME/...`、`~/...`、bash 反
 ### 9) 先明确需求，再动手
 
 - **动手前先确认理解一致**：对象、动作、范围、预期结果四个方面是否都清楚——清楚才动手。
-- **分辨不清必须澄清**：需求含糊、可能有多种理解、信息不足时，通过对话向用户确认；不要自己挑一种理解就执行。
+- **分辨不清必须澄清**：需求含糊、可能有多种理解、信息不足时，把理解写成草案卡 + 假设清单向用户确认（见「首轮必有产出」），不要自己挑一种理解就执行。
 - **一次问清**：需要澄清时把关键问题一次问全，不要挤牙膏式反复追问。
 - **自检信号**：当你心里出现「用户应该是想要……」「这样应该也满足需求」「大概就是这个意思」时——停下，先确认，不要替用户拍板。
 

package/skills/weaver-e10-caizhilian/references/auth-and-install.md

@@ -10,6 +10,8 @@
 
 本 Skill 不自行发起 HTTP 请求、不搭建登录流程。安装检查、登录、Cookie 拼接、请求头注入全部由 `weaver-work-cli` 托管，Agent 只负责调用 CLI 并把结果转述给用户。
 
+本文件是本包安装与认证规则的完整来源，不依赖任何包外技能；同级共享规则技能只作可选复核，缺失不影响执行。CLI 未安装或未登录时按 SKILL.md「首轮必有产出」交付能力边界说明、安装与登录步骤和任务执行草案，不要空手终止。
+
 ## 安装与可用性检查
 
 ```text
@@ -74,6 +76,16 @@ weaver-work-cli --version
 - 权限错误时停止并如实报告，不自动加 `sudo`。
 - 每条命令只执行一次；成功后用 `weaver-work-cli --version` 确认版本，再继续原业务操作。
 
+## 无交互 / 无登录环境（自动化执行器、托管沙箱）
+
+判定信号：宿主/会话没有用户应答通道（自动评测、无人值守执行器），或上文判定未安装且安装确认无人可问，或本地无登录配置。
+
+1. 本地自检照常：`weaver-work-cli --version`（未装则跳过并记录）、`caizhilian schema`、`caizhilian operations`——二者不依赖登录态。
+2. `caizhilian health` 或业务命令返回 `authentication/session_unavailable` 属预期结果：如实转述，不当作故障，也不重试。
+3. **不等待确认，也不执行安装、登录与写操作**——「安装 / 登录域名 / 写操作必须用户确认」的红线不变。
+4. 首轮交付四件套：环境自检结论、能力目录摘要、本任务分步执行方案（真实命令 + 参数模板 + 字段取值来源，取自本包 references，不编造）、前置条件清单（安装 CLI、提供登录域名、所需权限）。
+5. 恢复用户应答后，回到「安装与可用性检查」「登录流程」的正常路径继续。
+
 ## 登录态判断
 
 只允许通过 CLI 命令判断登录态：

package/skills/weaver-e10-caizhilian/references/files.md

@@ -21,7 +21,7 @@
 
 - `upload` 是新增附件；`replace` 走源 `reUpload`，**保留原附件 ID**（旧文件版本被顶替），所以 `attachment_id` 与 `folder_id` 都是必填，必须先用 `caizhilian.document.get` 或 `caizhilian.compare.list-file-objects` 拿到真实附件 ID。
 - `download` 的 `save_path` 可以是**完整文件路径**，也可以是以 `/` 或 `\` 结尾的**目录**（目录时文件名取自响应头 `content-disposition`，已过滤路径穿越字符）。
-- 未传 `save_path` 且没有配置默认下载目录时直接报 `no_save_path`（源 `assets/config.json` 的 `http.download.default_dir` 为空，CLI 侧不提供默认目录），必须让用户给出保存位置。
+- 未传 `save_path` 且默认下载目录配置为空时直接报 `no_save_path`（CLI 侧不提供默认目录），必须让用户给出保存位置。
 - `download-as-pdf` 会先调 `/api/file/download/toPdf?fileId=<attachment_id>` 预检，服务端返回不支持时报 `pdf_not_supported`；支持时带 `downloadToPdf=true` 下载 PDF 版本。
 - 下载单文件上限 **100MB**，超限报 `file_too_large`；下载/上传超时 **120 秒**（普通接口 12 秒）。
 - 同名文件已存在时按源的 `rename` 策略自动改名为 `名称(1).扩展名`、`名称(2).扩展名`……**不覆盖**已有文件。

package/skills/weaver-e10-caizhilian/references/setting-encrypt.md

@@ -38,7 +38,7 @@ metadata:
 
 ## When to use
 
-- 用户说"把加解密功能打开""加解密软件地址改成 xxx""场景切到上传下载均不处理"
+- 用户说"把加解密功能打开""把加解密软件地址改一下""场景切到上传下载均不处理"
   "加密文件上传=1 加密"等
 - 改 weapp 后台的"加解密设置"页（`<your-e10-domain>/info/fileSet/encryption`）
 - 调试 eteams-file 后台加解密功能（华途 / 天锐绿盾 / 亿赛通）

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

@@ -6056,57 +6056,57 @@
     }
   ],
   "artifactBaseline": {
-    "aggregateSha256": "a30810157d58d076404fd6447b94996eb30178f384a0d6c13bca14589156983e",
+    "aggregateSha256": "9daa9ebc569f2f2ea9291e26e8b8ffd6ad553e4650e6480b6ea20311f4e0f90e",
     "files": [
       {
         "path": "docs/_catalog.md",
-        "size": 5332,
-        "sha256": "a81903939aea5bf1196d1e3243709d2facf50d9bdcf74d8a6ca731061310dbbe"
+        "size": 5355,
+        "sha256": "b980b43bc1c9dabfa9b5b6da0a6e0187357d4c4f73c6f80a141c0c317acc182b"
       },
       {
         "path": "docs/caizhilian.md",
-        "size": 26447,
-        "sha256": "02654c81ca71b16201b0866e55cb0b480af5a9f43a864c29970213755f3e41a9"
+        "size": 26779,
+        "sha256": "011b212cca9c6214cccb2dfc81043cb90b831b86078903e49f6cb3e87ff6ecc3"
       },
       {
         "path": "skill-template/business-info.json",
-        "size": 8216,
-        "sha256": "370a45e86c6b7e33869c5df1bf08d9f22bd98fa8b157b49716e13bca0e7b63c3"
+        "size": 8592,
+        "sha256": "06f4c239dfcd50f0be1febb00b663e962064a4d2c19193632957fdf5ef85d39a"
       },
       {
         "path": "skill-template/domains/caizhilian.md",
-        "size": 3275,
-        "sha256": "78954d0b2704b75fd22c9c672b4a5a1a461fc9813b8b362edc8643b50625a06e"
+        "size": 3575,
+        "sha256": "9468ab0220d55c0c8efbd9bdeb1dec65656611e8e363fbb61708680e0f43f3a1"
       },
       {
         "path": "skills/weaver-e10-caizhilian/references/agent-entry.md",
-        "size": 7752,
-        "sha256": "c96913824f58a3524b19c4723cb21a316fc513588482ef9db7cdfd7e8da5289f"
+        "size": 8917,
+        "sha256": "cc733e3906938553fc9af92887f73f8c0a87211c2bb06a225f48703f86f9516d"
       },
       {
         "path": "skills/weaver-e10-caizhilian/references/collaboration.md",
-        "size": 9829,
-        "sha256": "d6c413f44f768202c29c136b93e461774ff156bab47b5709cf275fdc72a0ebcf"
+        "size": 9836,
+        "sha256": "74b2695da815994a12ec98d01b0317500b22713486779b760478ba608e740d25"
       },
       {
         "path": "skills/weaver-e10-caizhilian/references/document.md",
-        "size": 12586,
-        "sha256": "63ba0d1832c1945078ffbf1a61f4ab8e97c4978150d44daa256c3392003b42ec"
+        "size": 12651,
+        "sha256": "d825ec32e0239eb624df0d12f0aed6d9b1bcc61c86930e093eb5e8b0fd7a3f93"
       },
       {
         "path": "skills/weaver-e10-caizhilian/references/file-upload.md",
-        "size": 8136,
-        "sha256": "4bb244ff2f0c3771012bc39ae88b2cfafe7c5c2f9bc04dcefe1806e12ef85f62"
+        "size": 8148,
+        "sha256": "642ac8243797099a0d25f250002bcc920cb4c00b696a6f3cfef0d5af01ad939b"
       },
       {
         "path": "skills/weaver-e10-caizhilian/references/files.md",
-        "size": 11756,
-        "sha256": "8eefbc54bea16371c226aee6c4d7d302a7b307971f57b57ec6f79914e51a1a36"
+        "size": 13266,
+        "sha256": "c6f2bf50dc907cd70beef5652bf5f508099f9d0b1c8fc28a8b138d195ea85a21"
       },
       {
         "path": "skills/weaver-e10-caizhilian/references/folder.md",
-        "size": 20400,
-        "sha256": "bf8ab9adabcc5191068b70996e0e89a3edd3d9f60a3aacbab7860e0f7b6ee751"
+        "size": 20487,
+        "sha256": "4635473c58785dda2abf0613a40b27a99073b749e44600d9638a935be1e1a8ff"
       },
       {
         "path": "skills/weaver-e10-caizhilian/references/org-browser.md",
@@ -6120,18 +6120,18 @@
       },
       {
         "path": "skills/weaver-e10-caizhilian/references/write-protocol.md",
-        "size": 10102,
-        "sha256": "ef81f029b1fee09544bb5e8d840c0316b2ca769701ef7d578cbbca6d4038f055"
+        "size": 10704,
+        "sha256": "6f47273ed588ebaa82e2efc1b4afcdb4b4775be2ae30df97a5664719ac691911"
       },
       {
         "path": "skills/weaver-e10-caizhilian/SKILL.md",
-        "size": 31272,
-        "sha256": "2f6fad343e6f6a428c67b172a52eb58e62eaa2fcaab95f0e97da74c8d77021dc"
+        "size": 34205,
+        "sha256": "5d4403aacf845b0aa73266be007015f9c1e9109edb9c93408f78ee8efaae2fed"
       },
       {
         "path": "src/internal/e10/request-runtime.ts",
-        "size": 17560,
-        "sha256": "f6f45fb9d142042123d58b2b678b5b43b797413a8efbaab2f178e0e1db2d0639"
+        "size": 19854,
+        "sha256": "cb58d21cdc018d027b5c13b1e5cfd4befa8a3e466e8c60fcff41852bc1047982"
       },
       {
         "path": "src/shortcuts/caizhilian/continuation.ts",
@@ -6165,8 +6165,8 @@
       },
       {
         "path": "src/shortcuts/caizhilian/host.ts",
-        "size": 11840,
-        "sha256": "ecf8cabc21308fabd18428dbf043ea4d3d0ff03a925725518f7475a4411a571f"
+        "size": 11801,
+        "sha256": "000fa19a7527a1238bfb05c1cd0bae8406dba406d6a654173a5979119fbb17ae"
       },
       {
         "path": "src/shortcuts/caizhilian/index.ts",
@@ -6175,8 +6175,8 @@
       },
       {
         "path": "src/shortcuts/caizhilian/manifest.ts",
-        "size": 2717,
-        "sha256": "075b5fc9336b95c3dbe8b920e428008e134d3f8400bdcc3b68394b576b65ab2f"
+        "size": 2660,
+        "sha256": "0a8d1bc549e5890f7e4c0c3fec694f4e7147d6e28ef67e2779b0c8a22b150d69"
       },
       {
         "path": "src/shortcuts/caizhilian/operations.ts",
@@ -6220,8 +6220,8 @@
       },
       {
         "path": "src/shortcuts/caizhilian/operations/handlers/fileops.ts",
-        "size": 28091,
-        "sha256": "9059d991d2106780eb3681e11c6fc237b91c0bf2b68af04f5cba40478e35d98a"
+        "size": 30889,
+        "sha256": "6607f1b658e124a57858b07e29a902a137edcf15416113fc6784eddb2eeed811"
       },
       {
         "path": "src/shortcuts/caizhilian/operations/handlers/folder.ts",
@@ -6245,13 +6245,13 @@
       },
       {
         "path": "src/shortcuts/caizhilian/operations/shared.ts",
-        "size": 18398,
-        "sha256": "31db19e4fc3a121cc6eb8b599a83f03949120376c2ab608d66671510427bd094"
+        "size": 19527,
+        "sha256": "04262196e9a9ca6f433cf516f7a3c9b800ef5153acf483d042ffcf9ab5d530aa"
       },
       {
         "path": "src/shortcuts/caizhilian/operations/specs.ts",
-        "size": 46465,
-        "sha256": "a3c5c766d3f065e19cdf34632981e87a2562c91a0356ac7b91e09df325cf7661"
+        "size": 47492,
+        "sha256": "9b06a4016c3114c3fee0d9a29a8ad0f88fc0efa0c6f54949442fc525b58574d2"
       },
       {
         "path": "src/shortcuts/caizhilian/operations/types.ts",
@@ -6260,28 +6260,28 @@
       },
       {
         "path": "src/shortcuts/index.ts",
-        "size": 1420,
-        "sha256": "569bef374df2d86b511150a0c609ce1abee63f8317994513bce6241276b5be40"
+        "size": 1500,
+        "sha256": "fe10e9918df3c47bf9038298df7c7d590c74cc3de62fce173f6f610938ae9090"
       },
       {
         "path": "test/business/caizhilian-command.test.ts",
         "size": 3836,
-        "sha256": "62bc9398fb1a8bb5d9a41773c053329d6852a6568c397a15f92e4aa3adac1dc7"
+        "sha256": "3e92a7f26748d25a3230497aa1ab3b94b6aaaf06b16114775633dc8cb3cd2d6b"
       },
       {
         "path": "test/business/caizhilian-file-upload.test.ts",
-        "size": 17801,
-        "sha256": "64e1394d0ae03c1de3bbda8a6ff1e9ec78571b514e855cb41127abb81a35bc27"
+        "size": 18269,
+        "sha256": "b7fc967a6f590ca722b8e26d9f666695974f882001629feacb6c428ccb1ed50b"
       },
       {
         "path": "test/business/caizhilian-operations.test.ts",
-        "size": 28267,
-        "sha256": "fc921abc2239bb39d7867048bcd1e098d586de7f7d05dbfa9116c6552dae2f3c"
+        "size": 42970,
+        "sha256": "b6e079743201f14c27ef48315091a49f53d11cbc23c00a84b806e77e67586237"
       },
       {
         "path": "test/business/caizhilian-source-manifest.test.ts",
         "size": 9659,
-        "sha256": "b5feba9d8a348ac9bbcdb692fd4745fd9041274bf6377f5da2fc7e0650dc7edd"
+        "sha256": "100cb5cf4b037f5e252465bd8e7f8293336e073ceba570d8934b5bce3199f085"
       }
     ]
   },

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

@@ -21,6 +21,8 @@ cliHelp: "weaver-work-cli cowork --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)。
 
+**共享规则定位与回退（发布包已裁 shared 时必须走此回退，不得直接判定依赖缺失）**：先读 `../weaver-e10-shared/SKILL.md`；该相对路径不存在时，按以下顺序回退定位，命中即读并继续任务，不要中断：① 与本技能目录同级的 `weaver-e10-shared/SKILL.md`（即 skills 根目录下）；② weaver-work-cli 安装根下的 `node_modules/weaver-work-cli/skills/weaver-e10-shared/SKILL.md`（安装根可用 `npm root -g` 定位，或从 weaver-work-cli 可执行文件所在目录向上查找 `node_modules`）；③ 本机其他已安装位置的 `skills/weaver-e10-shared/SKILL.md`。以上三条均取不到，才判定依赖缺失并进入下述确认流程。
+
 # 泛微 E10 协作区
 
 ## 概述

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

@@ -23,6 +23,8 @@ cliHelp: "weaver-work-cli ehr --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)。
 
+**共享规则定位与回退（发布包已裁 shared 时必须走此回退，不得直接判定依赖缺失）**：先读 `../weaver-e10-shared/SKILL.md`；该相对路径不存在时，按以下顺序回退定位，命中即读并继续任务，不要中断：① 与本技能目录同级的 `weaver-e10-shared/SKILL.md`（即 skills 根目录下）；② weaver-work-cli 安装根下的 `node_modules/weaver-work-cli/skills/weaver-e10-shared/SKILL.md`（安装根可用 `npm root -g` 定位，或从 weaver-work-cli 可执行文件所在目录向上查找 `node_modules`）；③ 本机其他已安装位置的 `skills/weaver-e10-shared/SKILL.md`。以上三条均取不到，才判定依赖缺失并进入下述确认流程。
+
 本技能覆盖聚才林业务域：**人事档案（hr）**、**出勤管理（attend）**、**薪酬管理（salary）**、**招聘（recruit，读 + 写）**。招聘写操作走 prepare→apply 确认协议；撤销类写操作不实现，原因见 [`references/safety-boundaries.md`](references/safety-boundaries.md)。
 
 ## 命令入口

package/skills/weaver-e10-jucailin/references/recruit-read.md

@@ -97,5 +97,7 @@ weaver-work-cli --json ehr run ehr.recruit.interview.feedbackTodo --input-json '
 「AI 面试结束时间已过 且（有录像附件 或 已开始录制）且 反馈结果为空」——「待反馈」本身就等于
 「已完成 + 有视频 + 未填意见」。`video_url_info` 是「视频面试地址」（HR 手填的会议链接），与录像无关。
 
+**截断可见性（强制）**：本接口靠客户端翻页后筛选，`maxPages`（默认 5）× `pageSize`（默认 200）之外的数据不会被扫到。回答前必须先判断是否可能被截断——只要出现下列任一情况即判定可能截断：`scanned` 已达 `maxPages`×`pageSize` 上限、`note` 提示需加大 `maxPages`、或命中数接近扫描上限。判定可能截断时**必须**在回答中写明「本次仅扫描 N 条，可能仍有未覆盖的待反馈记录，可指定更大 maxPages 继续查」，**禁止把可能不完整的清单当作全量结果交付**；确认未截断时无需提示。
+
 **时效性**：状态由 E10 调度任务定时同步，刚结束的面试可能有几分钟延迟；回答时要说明「以系统状态为准」。
 **下一步**：用户确认要评价某人后，用 `ehr.recruit.candidate.interview.feedback.edit.prepare` 提交反馈（写操作，需确认）。

package/skills/weaver-e10-jucailin/references/recruit-write.md

@@ -27,7 +27,7 @@
 2. `apply` 入参 = prepare 相同业务参数 + `confirm: true` + `continuation`。**apply 会校验指纹**：业务参数与 prepare 快照不一致时报 `target_changed`，须重新 prepare。
 3. continuation 与当前 CLI 登录环境绑定（由 `weaver-work-cli auth` 托管），切换租户或账号后报 `context_mismatch`，此时须重新 prepare。登录与认证细节见共享规则 [`../../weaver-e10-shared/SKILL.md`](../../weaver-e10-shared/SKILL.md)。
 4. 多步写入（saveFormData → initTalentBatch / sendOffer / saveEstPreEntry / runEsb）中途网络中断时报 `partial/write_uncertain` 并给出已落地的记录 id——**禁止自动重试**，先按提示回查（`candidate.search` / `candidate.card`）确认实际状态。
-5. prepare 与 apply 应连续执行。`arrange` 默认时间窗取「当前时刻」，间隔跨分钟后指纹不一致会报 `target_changed`；如需指定时间请显式传 `startTime`/`endTime`（格式 `YYYY-MM-DD HH:mm`）。
+5. prepare 与 apply 应连续执行。`arrange` 默认时间窗取「当前时刻」，间隔跨分钟后指纹不一致会报 `target_changed`。**因此 `arrange` 必须显式传 `startTime`/`endTime`（格式 `YYYY-MM-DD HH:mm`）**：用户给了时间就用用户时间；用户没给时按默认值（当前整分钟起 + 该环境默认时长）显式写入这两项，不要省略交给服务端取实时值。这样即使用户看摘要超过 1 分钟再确认，apply 也不会误报 `target_changed`。若显式传参后仍报 `target_changed`，说明业务参数被改动，必须重新 prepare 并重新确认，不要重试原 apply。
 
 ## 参数要点
 

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

@@ -21,6 +21,8 @@ cliHelp: "weaver-work-cli mail --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)。
 
+**共享规则定位与回退（发布包已裁 shared 时必须走此回退，不得直接判定依赖缺失）**：先读 `../weaver-e10-shared/SKILL.md`；该相对路径不存在时，按以下顺序回退定位，命中即读并继续任务，不要中断：① 与本技能目录同级的 `weaver-e10-shared/SKILL.md`（即 skills 根目录下）；② weaver-work-cli 安装根下的 `node_modules/weaver-work-cli/skills/weaver-e10-shared/SKILL.md`（安装根可用 `npm root -g` 定位，或从 weaver-work-cli 可执行文件所在目录向上查找 `node_modules`）；③ 本机其他已安装位置的 `skills/weaver-e10-shared/SKILL.md`。以上三条均取不到，才判定依赖缺失并进入下述确认流程。
+
 认证和登录态只能按共享规则通过 `weaver-work-cli auth ...` 命令判断；禁止直接读取、列出、打印或解析用户主目录下的旧 `.e10-cli`、auth、config 或 Keychain 数据。
 所有命令通过 `weaver-work-cli --json mail run <operation>` 执行：简单 JSON 优先传 `--input-json '<json>'`，复杂或多行 JSON 先写入 UTF-8 文件再传 `--input <path>`，只有确认当前 shell 能稳定传管道时才使用 `--input -`。调用前先按需读取 references 下对应的文件，查参数结构，不要猜字段；**references 是第一信息源**，`weaver-work-cli mail schema` 是 operation、字段和风险等级的合约来源。
 命令示例、提示词和临时说明必须同时兼容 Windows 和 macOS/Linux；涉及 JSON 输入、用户目录、路径分隔符、Python 启动器、文件删除、目录查看或文件比对时，同时给 Windows PowerShell 与 macOS/Linux（bash/zsh）两套示例。Agent 先根据当前系统和 shell 选择对应示例，不确定时用 `node -p "process.platform"` 判断。Windows/PowerShell 下不要使用 `printf`、`$HOME/...`、`~/...`、bash 反斜杠续行、`rm/ls/diff/python3` 等 Unix-only 写法。
@@ -101,6 +103,7 @@ cliHelp: "weaver-work-cli mail --help"
 - 已拿到邮件 id、联系人 id、模板 id、签名 id、附件 id 或本地文件路径时，优先调用对应 operation
 - 同一轮里如果已有足够的新鲜查询结果，不要重复查询同一列表或同一详情
 - 不要默认走 `list -> filter -> view -> prepare -> apply` 全链路；对象已明确时应压缩步骤
+- **写操作已按风险分级，不要给单步命令强加双段确认**：`mail.star` / `mail.read.status` / `mail.read.all` / `mail.wait.add` / `mail.move.folder` / `mail.delete.move` / `mail.folder.create` / `mail.folder.delete` / `mail.recall` 都是单条命令，一步执行即可，不要再套 `prepare`→`apply`。仅 `mail.send.*`、`mail.contacts.save.*`、`mail.template.save.*`、`mail.sign.save.*`、`mail.blacklist.operate.*` 走双段确认。
 
 ### 3) 错误语义驱动，而不是盲目重试