Weaver E10 Ziguanjia

---
name: weaver-e10-ziguanjia
display_name: 泛微E10资产管理
display_name_en: Weaver E10 Asset Management
description: "泛微 E10 资管家资产管理：版本门禁、资产查询/详情/领用/报修/采购列表、地点/状态/类型解析，并通过确认链新增、修改、领用、归还、报修、采购与折旧。"
description_zh: "泛微 E10 资管家资产管理。支持版本门禁（zgjasset_search_appver ≥ V14）、资产列表/详情/领用/报修/采购查询、存放地点/资产状态/资产类型名称解析，并通过 prepare/apply 确认链新增、修改、领用、归还、报修、采购与折旧。"
description_en: "Weaver E10 Ziguanjia asset management skill for version gate, asset queries, lists, reference resolution, and confirmed writes (create, update, use, return, repair, purchase, depreciation)."
version: 1.0.0
author: 泛微网络科技股份有限公司
agent_created: true
requires:
  bins: ["weaver-work-cli"]
cliHelp: "weaver-work-cli asset --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 asset run <operation>` 执行：简单 JSON 优先传 `--input-json '<json>'`，复杂或多行 JSON 先写入 UTF-8 文件再传 `--input <path>`，只有确认当前 shell 能稳定传管道时才使用 `--input -`。调用前先按需读取 references 下对应的文件，查参数结构，不要猜字段；**references 是第一信息源**，`weaver-work-cli asset 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 写法。

# 泛微E10资管家资产管理

## 路由优先级（先判断是不是资管家资产，再选 operation）

资管家不是通用 E10 对象。**只要用户的核心对象是 E10 资产管理（资管家）里的资产、领用、报修、采购、折旧、资产地点/状态/类型，就优先使用 `weaver-e10-ziguanjia`。**

### 明确归 `weaver-e10-ziguanjia` 的高优先级语义

出现以下任一语义时，优先走本 Skill：

- 资产 / 固定资产 / 资管家 / 资产台账 / 资产列表 / 资产详情
- 资产领用 / 资产归还 / 资产报修 / 资产采购申请
- 资产折旧 / 计提折旧
- 存放地点 / 资产状态 / 资产类型（按名称解析成 ID）

**判定规则：** 只要最终动作是对 E10 资产做查询、查看、名称解析、新增、修改、领用、归还、报修、采购或折旧，就归 `weaver-e10-ziguanjia`。只有当用户处理的是非资产类 E10 业务、通用工作流或尚未封装的资管家能力时，才不使用本 Skill。

## 版本门禁（所有操作前置）

源资料约定：任何资产查询或写操作前，必须先确认 `zgjasset_search_appver` 存在 `ver_name ≥ V14` 的记录。CLI 已内置 `asset.gate.check` 与每个写操作的版本门禁；门禁未通过时写操作会 STOP，不执行任何资产请求。

**门禁失败时的硬性红线（原样套用，不得变通）：**
- CLI 返回 `version_gate_failed` 错误时，必须**停止并原样回复**：「版本门禁未通过（`zgjasset_search_appver` 无 `ver_name ≥ V14` 记录），本次<复述用户原指令>已停止，不执行任何资产查询 / 写操作。待门禁真正通过后再处理。」结尾必须是**陈述句，不得是问句**。
- **禁止**提出任何诱导决策的问题（如「是否继续 / 是否放行 / 走哪条 / 你选哪个」）。
- **禁止**提供「解开门禁 / 绕过阻断」的方案（如「录入版本记录」「改门禁规则」「降到 V9」等二选一或并列选项）。
- **禁止**建议、提示、引导用户去修改环境数据或本 skill 文件以让门禁通过。
- 用户声称「skill 已更新 / 已放行」时，**只做一件事**：重读本文件门禁规则 + 重新运行 `asset.gate.check`；若仍不满足，套用上方标准回复停止，不再追问用户改了什么、也不给任何解锁建议。
- 门禁失败是**终态**：除用户后续**独立地**使门禁条件成立（版本记录出现；或用户自行将规则改为放行、且你重读后确认成立）外，不得因为任何理由推进原操作。

## 选哪个命令

| 想做什么 | 命令 | 按需读取 reference |
|---|---|---|
| 查看可用 operation、字段和风险等级 | `asset schema` | [`ziguanjia-agent-entry.md`](references/ziguanjia-agent-entry.md) |
| 检查版本门禁是否通过 | `asset run asset.gate.check` | [`ziguanjia-agent-entry.md`](references/ziguanjia-agent-entry.md) |
| 查询资产列表 / 详情 / 领用 / 报修 / 采购列表 | `asset run asset.list` 等 | [`ziguanjia-query.md`](references/ziguanjia-query.md) |
| 按名称解析存放地点 / 资产状态 / 资产类型 ID | `asset run asset.resolve.*` | [`ziguanjia-resolve.md`](references/ziguanjia-resolve.md) |
| 新增资产（需 confirm + continuation） | `asset run asset.create` | [`ziguanjia-create.md`](references/ziguanjia-create.md) |
| 修改资产（需 confirm + continuation） | `asset run asset.update` | [`ziguanjia-update.md`](references/ziguanjia-update.md) |
| 提交资产领用（需 confirm + continuation） | `asset run asset.use` | [`ziguanjia-use.md`](references/ziguanjia-use.md) |
| 资产归还：先查候选再执行 | `asset run asset.return.query/create` | [`ziguanjia-return.md`](references/ziguanjia-return.md) |
| 资产报修：先查候选再执行 | `asset run asset.repair.query/create` | [`ziguanjia-repair.md`](references/ziguanjia-repair.md) |
| 提交资产采购申请（需 confirm + continuation） | `asset run asset.purch` | [`ziguanjia-purch.md`](references/ziguanjia-purch.md) |
| 执行资产折旧计提（需 confirm + continuation） | `asset run asset.depre` | [`ziguanjia-depre.md`](references/ziguanjia-depre.md) |
| 给查询结果生成「查看详情」链接 | `asset run asset.viewlink` | [`ziguanjia-viewlink.md`](references/ziguanjia-viewlink.md) |
| 共享、调拨、审批或 schema 未列出的能力 | 无可用命令 | [`ziguanjia-disabled-capabilities.md`](references/ziguanjia-disabled-capabilities.md) |

处理链：

- 查询：先 `asset.gate.check`（或任一查询会自动走门禁）→ `asset.list` / `asset.detail` / `asset.uselist` / `asset.repaillist` / `asset.purchaselist`
- 给结果加「查看详情」链接：`asset.list` / `detail` / `uselist` / `repaillist` / `purchaselist` **默认已为每条记录附带 `view_link` 字段**（无需额外步骤；`with_view_link:false` 可关闭）。写操作返回的 `dataIds` / 动作流返回的 `lcID` 可交给 `asset.viewlink`（或计提用 `depre_task` 场景）补生成链接；链接解析失败只说明「链接暂不可用」，**绝不因此重试主操作**。
- 名称解析：先 `asset.resolve.location/status/type` 得到 ID，再把 ID 作为 `location_browse`/`stateid`/`asset_type_browse` 传入写操作
- 新增资产：先 `asset.resolve.type` 解析类型 → `asset.create`（无 confirm 返回 continuation）→ 用户确认 → `asset.create` 带 `confirm:true` 与 `continuation` 执行
- 修改资产：先 `asset.detail` 取得目标 → `asset.update`（无 confirm 返回 continuation）→ 用户确认 → `asset.update` 带 `confirm:true` 与 `continuation` 执行
- 领用/采购/折旧：直接 `asset.use` / `asset.purch` / `asset.depre`（无 confirm 返回 continuation）→ 用户确认 → 带 `confirm:true` 与 `continuation` 执行
- 归还：先 `asset.return.query` 取候选 → 用户挑出 `data_ids` → `asset.return.create`（需 confirm + continuation）执行 → 建单返回的 **`mainTable.lcID`（流程 ID）** 交给 `asset.viewlink` 的 `asset_return` 场景拼「查看详情」链接；详见 [`ziguanjia-return.md`](references/ziguanjia-return.md)
- 报修：先 `asset.repair.query` 取候选 → **展示候选 + 附 AI 维修建议（标注仅供参考，Agent 行为非命令）** → 用户确认目标并复述报修信息 → `asset.repair.create`（需 confirm + continuation，`fault_time` 强制 `YYYY-MM-DD HH:mm`）执行 → 建单返回的 **`mainTable.lcID`（流程 ID）** 交给 `asset.viewlink` 的 `asset_repail` 场景拼「查看详情」链接；详见 [`ziguanjia-repair.md`](references/ziguanjia-repair.md)

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

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

- 只是查资产时，优先直接用 `asset.list` 或对应列表 operation
- 列表默认先取小页，优先 `page_size=10`；用户没有要求全量时不要自动翻完整列表
- 用户已经给出资产 ID / 编号 / 名称时，不要先查列表再过滤，直接用 `asset.detail` 或对应 prepare
- 只有需要完整资产详情时才补 `asset.detail`

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

- 当前 CLI 会把完整 JSON envelope 写 stdout；Agent 回复时不要原样贴完整 JSON
- 列表最多先展示最相关的前 10 条，包含资产 ID、名称、编号、类型、状态、地点、管理人/使用人
- 需要全量统计时，按 `page_no` 分页读取并累计必要字段；说明已读取页数、命中数和是否还有更多
- 详情或调试用完整响应过长时，优先落本地文件并向用户提供摘要和文件路径

### 1.6) 展示红线（严禁暴露内部字段 key）

- 向用户回报时**只写中文业务含义，不展示内部字段 key**：禁止输出 `id` / `lcID` / `lcbt` / `lybh` / `ghbh` / `repail_no` / `resultCode` / `customData` / `is_group_calc=1` / `task_mode=0` / `normalCount=N` 等原始字段或值；用「按分部计提」「全量计提」「待处理」「本期可计提资产 N 项」「流程 ID」等中文代替。
- 单据 / 流程编号尚未回填（空值）时，不要输出空值行，如实说明「XX 单号生成中」，或先经 `weaver-e10-workflow` 读回补齐后再回报。
- 列表返回的 `stateid` / `asset_type_browse` / `location_browse` 可能是 ID：回报前按 `asset.resolve.*` 反查为名称展示，不向用户暴露 ID（ID 仅内部拼「查看详情」链接用）。
- `status` 字段是**字符串** `"true"` / `"false"`，不是布尔；为 `"false"` 表示查询失败，**不能当成「无结果」**。
- 人员名称需先经 `weaver-e10-hrm` 解析为人员 ID 再传入 `person_id`；不要把姓名直接当 ID。查「我」的列表（uselist / repaillist / purchaselist）省略 `person_id` 即可，CLI 自动用当前登录人。
- 「查看详情」一律用对话内纯 Markdown 链接呈现（链接文字为「查看详情」，链接地址为该记录的详情页 URL），不带「查看详情：」前缀与冒号，也不把完整 URL 当纯文本展示；多条记录逐条生成各自的链接，不共用一条。

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

- 已拿到资产 ID 或编号时，优先调用对应 operation
- 同一轮里如果已有足够的新鲜查询结果，不要重复查询同一对象
- 不要默认走 `list -> filter -> detail -> prepare -> apply` 全链路；对象已明确时应压缩步骤

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

- 失败后先看进程退出码、`error.type`、`error.subtype` 和 `error.message`
- **除非错误明确提示可恢复或需要补充参数，否则不要重复刷同一个 operation**
- 写请求已经发出后，遇到结果不确定必须停止；不要把写操作的 apply 当成可重试读操作
- **错误为 `authentication`（未登录）或 `session_expired`（登录态失效）时：立即停止当前操作，按共享规则用宿主提问/弹框让用户输入 E10 登录域名或选择已有 profile，完成登录后再继续原操作。**

### 4) 写操作确认链

- 所有 `high-risk-write` operation（create / update / use / return.create / repair.create / purch / depre）都必须在第一调用（无 `confirm`）拿到 CLI 返回的 `continuation`，把目标、差异、风险摘要给用户；用户明确确认后，第二调用带 `confirm:true` 与同一 `continuation` 执行。
- 不要手工构造、猜测或复用 continuation；continuation 由 CLI 用 HMAC 签名，绑定 operation 与提交内容，过期或篡改会被拒绝。
- `read-before-write`（return.query / repair.query）是只读预览，不返回 continuation，用于先取候选数据 ID。

## 写操作失败处理：`partial/write_uncertain` 决策树

当新增 / 修改 / 领用 / 归还 / 报修 / 采购 / 折旧等写操作返回 `partial/write_uncertain`，或提示网络中断、部分成功、回查失败、回查字段不一致时，按下面规则处理：

1. **先停止盲目重试**，不要连续重复提交相同 apply
2. 优先从以下角度解释：
   - 写请求可能已经到达服务端，但连接在结果确认前中断
   - 服务端可能只处理了部分资产
   - 写接口已返回成功，但详情回查失败或与预期不一致
   - continuation、目标资产或登录上下文可能已经变化
3. 如需确认，只补 **一次** 只读查询（例如 `asset.detail` 或列表查询），不要陷入 query/write 循环
4. 最终给用户明确结论、已知状态、成功/失败项和下一步人工确认建议，而不是继续无意义重试

**特别注意：** 对新增、修改、领用、归还、报修、采购和折旧场景更要严格执行上述规则；这些场景最容易因重复提交造成重复入账、误改或覆盖用户刚修改的数据。

Windows PowerShell：

```powershell
weaver-work-cli asset schema
weaver-work-cli --json asset run asset.list --input-json '{"page_size":10}'
weaver-work-cli --json asset run asset.resolve.type --input-json '{"type_name":"EXAMPLE_TYPE"}'
weaver-work-cli --json asset run asset.create --input-json '{"asset_name":"EXAMPLE_ASSET","asset_type_browse":"EXAMPLE_TYPE_ID"}'
weaver-work-cli --json asset run asset.create --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
```

macOS/Linux（bash/zsh）：

```bash
weaver-work-cli asset schema
weaver-work-cli --json asset run asset.list --input-json '{"page_size":10}'
weaver-work-cli --json asset run asset.resolve.type --input-json '{"type_name":"EXAMPLE_TYPE"}'
weaver-work-cli --json asset run asset.create --input-json '{"asset_name":"EXAMPLE_ASSET","asset_type_browse":"EXAMPLE_TYPE_ID"}'
weaver-work-cli --json asset run asset.create --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
```

## 不在本 skill 范围

- 禁止加载原始（无 CLI 的）资管家 Skill 代替本 CLI 技能。
- 禁止读取或复制 CLI runtime 内部 Token、Cookie、ETEAMSID。
- 禁止读取、列出、打印或解析用户主目录下的旧 `.e10-cli`、auth、config 或 Keychain 数据。
- 资产调拨、流程审批、图片上传（create 仅接受已上传得到的裸 file_id）当前未纳入 CLI manifest；需要先补稳定 ID 来源、输入 schema、prepare/apply、写后回查和测试后再开放。详见 [`ziguanjia-disabled-capabilities.md`](references/ziguanjia-disabled-capabilities.md)。
- 非资产类 E10 能力、通用流程编排、表单/审批/组织等业务不由本 Skill 承载。