---
name: weaver-e10-{{module}}
display_name: "{{display_name}}"
display_name_en: "{{display_name_en}}"
description: "{{meta_description}}"
description_zh: "{{meta_description_zh}}"
description_en: "{{meta_description_en}}"
version: {{meta_version}}
author: 泛微网络科技股份有限公司
agent_created: true
requires:
  bins: ["weaver-work-cli"]
cliHelp: "weaver-work-cli {{command}} --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`——省略会装进默认目录，导致本技能依然读不到共享规则。安装或读取失败时必须停止执行；命令均成功后重新读取共享规则，仍读不到就停止并把结果报告用户，不得凭猜测继续。**
认证和登录态只能按共享规则通过 `weaver-work-cli auth ...` 命令判断；禁止直接读取、列出、打印或解析用户主目录下的旧 `.e10-cli`、auth、config 或 Keychain 数据。
所有命令通过 `weaver-work-cli --json {{command}} run <operation>` 执行：简单 JSON 优先传 `--input-json '<json>'`，复杂或多行 JSON 先写入 UTF-8 文件再传 `--input <path>`，只有确认当前 shell 能稳定传管道时才使用 `--input -`。调用前先按需读取 references 下对应的文件，查参数结构，不要猜字段；**references 是第一信息源**，`weaver-work-cli {{command}} schema` 是 operation、字段和风险等级的合约来源。
若 `schema` 或 reference 提供 `inputExamples`，优先复用其中和当前意图最接近的样例并只替换用户明确给出的值；标记为 `synthetic` 的样例需要业务复核，不能当作源资料事实。若 operation 标记了 `missingExamples` 或参数覆盖矩阵中的 `needs-confirmation` 字段，先向用户说明缺少哪些入参事实并索取补充，不要通过反复尝试不同 JSON 格式来猜。
生成或改写的 docs、reference、提示词和命令示例必须同时兼容 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 写法。
涉及附件、图片、本地文件、远程 URL 文件或文件内容解析的 operation，执行前必须提醒用户：文件内容可能被上传到业务系统、OCR/解析服务，并可能进入当前大模型上下文用于理解和处理；必须等待用户明确确认后才继续。

## 路由优先级（先判断是不是 {{title}}，再选 operation）

{{routing_priority}}

### 明确归 `weaver-e10-{{module}}` 的高优先级语义

{{intent_bullets}}

**判定规则：** {{routing_rule}}

## 选哪个命令

| 想做什么 | 命令 | 按需读取 reference |
| --- | --- | --- |
{{reference_rows}}

处理链：

{{workflow_chains}}

## 执行原则（减少误路由、误重试和无效消耗）

### 1) 先拿最小必要信息，再执行

{{minimum_info_rules}}

### 1.5) 大结果只摘要给用户

- 当前 CLI 的 `--json` 会把完整 JSON envelope 写 stdout；Agent 回复时不要原样粘贴完整 JSON
- 列表默认先取小页，优先 `page_size=10` 或本业务 schema 中等价的小页参数；用户没有要求全量时不要自动扫完整数据集
- 需要全量统计时，按分页字段分批读取，只累计任务所需字段和去重键，并报告已读取页数、命中数和是否还有更多
- 超长文本、大数组、OCR/导出/详情原始响应或调试 JSON 需要保留时，优先落本地文件并向用户提供摘要和路径

### 2) 已知对象时直达动作

{{direct_action_rules}}

### 3) 错误语义驱动，而不是盲目重试

- 失败后先看进程退出码、`error.type`、`error.subtype` 和 `error.message`
- **除非错误明确提示可恢复或需要补充参数，否则不要重复刷同一个 operation**
- 写请求已经发出后，遇到结果不确定必须停止；不要把 `.apply` 当成可重试读操作

### 4) 附件、图片和文件解析确认

- 命中上传附件、上传图片、读取本地文件、使用远程 URL 文件、OCR、文件解析、导入文件或复用已上传文件对象时，必须先提醒数据处理风险并等待用户明确确认。
- 风险提醒必须说明文件内容可能进入大模型上下文，也可能被发送到业务系统或 OCR/解析服务。
- 用户未确认前，不要运行会读取、上传、解析、OCR 或导入该文件的命令；单接口 reference 的“注意”里也必须标出这个确认要求。

## 写操作失败处理：{{write_uncertain_label}} 决策树

{{write_uncertain_tree}}

Windows PowerShell：

```powershell
weaver-work-cli {{command}} schema
weaver-work-cli --json {{command}} run {{command}}.operation --input-json '{"key":"value"}'
```

macOS/Linux（bash/zsh）：

```bash
weaver-work-cli {{command}} schema
weaver-work-cli --json {{command}} run {{command}}.operation --input-json '{"key":"value"}'
```

## 不在本 skill 范围

{{out_of_scope}}