weaver-work-cli 0.1.2 → 0.1.5

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

@@ -0,0 +1,163 @@
+---
+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 输出和高风险写入规则。若不存在则必须先执行 `weaver-work-cli skills install shared --skills-dir <当前Agent的Skills目录>`，若 CLI 未安装则先执行 `npm install -g weaver-work-cli`，安装或读取失败时必须停止执行。**
+
+认证和登录态只能按共享规则通过 `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 写法。
+
+## 路由优先级（先判断是不是资管家资产，再选 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 承载。

package/skills/weaver-e10-ziguanjia/product.json

@@ -0,0 +1,8 @@
+{
+  "schemaVersion": 1,
+  "product": "weaver-work-cli",
+  "productVersion": "0.1.0",
+  "packageName": "weaver-work-cli",
+  "command": "weaver-work-cli",
+  "nodeEngine": ">=18"
+}

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

@@ -0,0 +1,147 @@
+{
+  "schemaVersion": 2,
+  "module": "asset",
+  "skill": "weaver-e10-ziguanjia",
+  "generatedFrom": {
+    "sourceSkill": "weaver-e10-ziguanjia",
+    "version": "unknown",
+    "path": "weaver-e10-ziguanjia",
+    "kind": "workbuddy-document-skill",
+    "availability": "available-in-external-dir"
+  },
+  "generatedAt": "2026-09-07T00:00:00.000Z",
+  "sourceSet": {
+    "aggregateSha256": "0000000000000000000000000000000000000000000000000000000000000000",
+    "sourceRoots": ["weaver-e10-ziguanjia"],
+    "detectionStrength": "weak"
+  },
+  "generatedTargets": {
+    "cli": ["src/shortcuts/asset", "src/shortcuts/index.ts"],
+    "skill": ["skills/weaver-e10-ziguanjia"],
+    "tests": ["test/business/ziguanjia-*.test.ts"],
+    "docs": ["docs/ziguanjia.md", "skill-template/domains/ziguanjia.md"]
+  },
+  "sources": [],
+  "sourceChunks": [
+    {
+      "id": "asset.gate.check",
+      "sourcePath": "skills/weaver-e10-ziguanjia/references/ziguanjia-agent-entry.md",
+      "anchor": "reference:ziguanjia-agent-entry.md",
+      "sha256": "0000000000000000000000000000000000000000000000000000000000000000",
+      "mapsToOperations": ["asset.gate.check"],
+      "mapsToReferences": ["references/ziguanjia-agent-entry.md"]
+    },
+    {
+      "id": "asset.list",
+      "sourcePath": "skills/weaver-e10-ziguanjia/references/ziguanjia-query.md",
+      "anchor": "reference:ziguanjia-query.md",
+      "sha256": "0000000000000000000000000000000000000000000000000000000000000000",
+      "mapsToOperations": ["asset.list", "asset.detail", "asset.uselist", "asset.repaillist", "asset.purchaselist"],
+      "mapsToReferences": ["references/ziguanjia-query.md"]
+    },
+    {
+      "id": "asset.resolve",
+      "sourcePath": "skills/weaver-e10-ziguanjia/references/ziguanjia-resolve.md",
+      "anchor": "reference:ziguanjia-resolve.md",
+      "sha256": "0000000000000000000000000000000000000000000000000000000000000000",
+      "mapsToOperations": ["asset.resolve.location", "asset.resolve.status", "asset.resolve.type"],
+      "mapsToReferences": ["references/ziguanjia-resolve.md"]
+    },
+    {
+      "id": "asset.create",
+      "sourcePath": "skills/weaver-e10-ziguanjia/references/ziguanjia-create.md",
+      "anchor": "reference:ziguanjia-create.md",
+      "sha256": "0000000000000000000000000000000000000000000000000000000000000000",
+      "mapsToOperations": ["asset.create"],
+      "mapsToReferences": ["references/ziguanjia-create.md"]
+    },
+    {
+      "id": "asset.update",
+      "sourcePath": "skills/weaver-e10-ziguanjia/references/ziguanjia-update.md",
+      "anchor": "reference:ziguanjia-update.md",
+      "sha256": "0000000000000000000000000000000000000000000000000000000000000000",
+      "mapsToOperations": ["asset.update"],
+      "mapsToReferences": ["references/ziguanjia-update.md"]
+    },
+    {
+      "id": "asset.use",
+      "sourcePath": "skills/weaver-e10-ziguanjia/references/ziguanjia-use.md",
+      "anchor": "reference:ziguanjia-use.md",
+      "sha256": "0000000000000000000000000000000000000000000000000000000000000000",
+      "mapsToOperations": ["asset.use"],
+      "mapsToReferences": ["references/ziguanjia-use.md"]
+    },
+    {
+      "id": "asset.return",
+      "sourcePath": "skills/weaver-e10-ziguanjia/references/ziguanjia-return.md",
+      "anchor": "reference:ziguanjia-return.md",
+      "sha256": "0000000000000000000000000000000000000000000000000000000000000000",
+      "mapsToOperations": ["asset.return.query", "asset.return.create"],
+      "mapsToReferences": ["references/ziguanjia-return.md"]
+    },
+    {
+      "id": "asset.repair",
+      "sourcePath": "skills/weaver-e10-ziguanjia/references/ziguanjia-repair.md",
+      "anchor": "reference:ziguanjia-repair.md",
+      "sha256": "0000000000000000000000000000000000000000000000000000000000000000",
+      "mapsToOperations": ["asset.repair.query", "asset.repair.create"],
+      "mapsToReferences": ["references/ziguanjia-repair.md"]
+    },
+    {
+      "id": "asset.purch",
+      "sourcePath": "skills/weaver-e10-ziguanjia/references/ziguanjia-purch.md",
+      "anchor": "reference:ziguanjia-purch.md",
+      "sha256": "0000000000000000000000000000000000000000000000000000000000000000",
+      "mapsToOperations": ["asset.purch"],
+      "mapsToReferences": ["references/ziguanjia-purch.md"]
+    },
+    {
+      "id": "asset.depre",
+      "sourcePath": "skills/weaver-e10-ziguanjia/references/ziguanjia-depre.md",
+      "anchor": "reference:ziguanjia-depre.md",
+      "sha256": "0000000000000000000000000000000000000000000000000000000000000000",
+      "mapsToOperations": ["asset.depre"],
+      "mapsToReferences": ["references/ziguanjia-depre.md"]
+    },
+    {
+      "id": "disabled",
+      "sourcePath": "skills/weaver-e10-ziguanjia/references/ziguanjia-disabled-capabilities.md",
+      "anchor": "reference:ziguanjia-disabled-capabilities.md",
+      "sha256": "0000000000000000000000000000000000000000000000000000000000000000",
+      "mapsToOperations": ["asset.transfer", "asset.approve", "asset.file.upload"],
+      "mapsToReferences": ["references/ziguanjia-disabled-capabilities.md"]
+    }
+  ],
+  "operationImpact": {
+    "added": [
+      "asset.gate.check",
+      "asset.list",
+      "asset.detail",
+      "asset.uselist",
+      "asset.repaillist",
+      "asset.purchaselist",
+      "asset.resolve.location",
+      "asset.resolve.status",
+      "asset.resolve.type",
+      "asset.create",
+      "asset.update",
+      "asset.use",
+      "asset.return.query",
+      "asset.return.create",
+      "asset.repair.query",
+      "asset.repair.create",
+      "asset.purch",
+      "asset.depre"
+    ],
+    "withheld": ["asset.transfer", "asset.approve", "asset.file.upload"],
+    "changed": [],
+    "removed": []
+  },
+  "artifactBaseline": {
+    "cliModule": "src/shortcuts/asset",
+    "skillDir": "skills/weaver-e10-ziguanjia",
+    "referenceCount": 11,
+    "manifestOperations": 18,
+    "withheldOperations": 3
+  }
+}

package/skills/weaver-e10-ziguanjia/references/ziguanjia-agent-entry.md

@@ -0,0 +1,65 @@
+# Agent 入口与 Schema
+
+## 什么时候读取
+
+使用 `weaver-work-cli asset` 前、编写自动化调用、选择 operation 或确认字段结构时读取本文件。
+
+## 准备命令
+
+```text
+weaver-work-cli --version
+weaver-work-cli doctor --e10
+weaver-work-cli asset schema
+```
+
+如未登录，按共享规则读取 `../../weaver-work-cli-shared/references/e10-auth-and-session.md` 后处理。
+
+## 固定入口
+
+Agent 优先调用统一 operation 入口：
+
+```text
+weaver-work-cli --json asset run asset.list --input-json '{"page_size":10}'
+```
+
+简单 JSON 通过 `--input-json` 传入，复杂或多行 JSON 使用 UTF-8 文件和 `--input <path>`；只有确认当前 shell 能稳定传管道时才使用 `--input -`。按环境选择示例：
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json asset run asset.list --input-json '{"page_size":10}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json asset run asset.list --input-json '{"page_size":10}'
+```
+
+`weaver-work-cli asset schema` 是可用 operation、输入字段、固定参数和风险等级的第一信息源。不要用未出现在 schema 中的 operation，也不要把原始 `weaver-e10-ziguanjia` reference 当作可直接调用的 CLI 合约。
+
+## 输出处理
+
+成功结果在 stdout，失败结果在 stderr。判断规则读取共享 reference：`../../weaver-work-cli-shared/references/json-output-contract.md`。
+
+列表、详情或回查结果可能很长时，不要把 stdout 的完整 envelope 直接展示给用户。默认 `page_size=10` 小页读取；只渲染资产决策所需字段，例如资产 ID、名称、编号、类型、状态、地点、管理人/使用人。需要更多结果时按 `page_no` 分页继续；需要保留完整原始 JSON 时落本地文件并返回路径。
+
+高风险写入读取共享 reference：`../../weaver-work-cli-shared/references/high-risk-write.md`。
+
+## 版本门禁
+
+所有查询与写操作前，CLI 会先校验 `zgjasset_search_appver` 是否存在 `ver_name ≥ V14` 的记录。门禁结果也可直接查询：
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json asset run asset.gate.check --input-json '{}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json asset run asset.gate.check --input-json '{}'
+```
+
+返回 `meta.status=VERSION_GATE_PASSED` 表示通过；`VERSION_GATE_FAILED` 表示未通过，此时应停止后续资产操作并提示用户升级到 V14 及以上。

package/skills/weaver-e10-ziguanjia/references/ziguanjia-create.md

@@ -0,0 +1,45 @@
+# 新增资产
+
+## 什么时候读取
+
+用户要新增一条固定资产记录时读取本文件。
+
+## Operation
+
+`asset.create`（风险 `high-risk-write`）。必须 `prepare -> apply`：第一次调用不带 `confirm` 返回 continuation 与预览，用户确认后第二次调用带 `confirm:true` 与 `continuation` 执行。
+
+## 输入要点
+
+以 `weaver-work-cli asset schema` 为准。必填：`asset_name`、`asset_type_browse`（资产类型 ID，先经 `asset.resolve.type` 解析）。可选：`asset_spec`、`stockindate`（默认今天）、`startprice`、`original_value`、`image_id`（裸 file_id，不接受文件上传）、`asset_data_attr`（默认 `0`）、`admin_istrator`（默认当前操作人）、`blongdepartment`、`resourceid`、`stateid`。
+
+`asset_type_browse` 必须是已解析的类型 ID，不要传中文类型名。
+
+## 示例
+
+Windows PowerShell：
+
+```powershell
+# prepare（返回 continuation）
+weaver-work-cli --json asset run asset.create --input-json '{"asset_name":"EXAMPLE_ASSET","asset_type_browse":"EXAMPLE_TYPE_ID"}'
+# apply（用户确认后）
+weaver-work-cli --json asset run asset.create --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+# prepare（返回 continuation）
+weaver-work-cli --json asset run asset.create --input-json '{"asset_name":"EXAMPLE_ASSET","asset_type_browse":"EXAMPLE_TYPE_ID"}'
+# apply（用户确认后）
+weaver-work-cli --json asset run asset.create --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+## 返回
+
+`apply` 成功返回 `dataIds`（新增资产数据 ID 列表）、`count` 与 `mainTable`。失败时见写操作失败决策树。
+
+## 注意
+
+- `image_id` 仅接受已通过文件上传能力得到的裸 file_id；CLI 不内置图片上传，需要上传时走外部文件上传模块。
+- 不要手工构造 continuation；它绑定本次提交的主表内容，过期或篡改会被拒绝。
+- 出现 `partial/write_uncertain` 时停止，先做一次 `asset.detail` 只读回查，不要重复提交 apply。

package/skills/weaver-e10-ziguanjia/references/ziguanjia-depre.md

@@ -0,0 +1,48 @@
+# 资产折旧计提
+
+## 什么时候读取
+
+用户要执行某月资产折旧计提时读取本文件。
+
+## Operation
+
+`asset.depre`（风险 `high-risk-write`）。必须 `prepare -> apply`：第一次调用不带 `confirm` 做折旧设置读取与计提月份预检（动作流 `deprePrecheck`），返回 continuation 与预检结果；用户确认后第二次调用带 `confirm:true` 与 `continuation` 执行折旧任务创建。
+
+## 输入要点
+
+以 `weaver-work-cli asset schema` 为准。必填：`calc_month`（格式 `YYYY-MM`，须早于当前月份）。可选：`company_ids`（当前登录人所属分部 ID，大整数按字符串传）。折旧方案与是否分组计提来自 `zgjasset_depre_setting` 配置，由 CLI 在 prepare 阶段读取。
+
+- 计提类型（`task_mode`）由折旧设置的「是否分组计提」自动推导：分组计提开启 → 按分部计提（1）；关闭 → 全量计提（0）。**无需用户传入**。
+- 分组计提开启时，CLI 自动取「当前登录人所属分部 ID」：优先用输入的 `company_ids`，否则按登录会话的分部名称解析；解析不到会明确报错（不臆造 ID），此时请提供 `company_ids`。
+- prepare 阶段会按预检返回的可计提条件（无符合条件资产 / 已存在关联业务记录 / 后续周期已结提）判断，命中则停止，不进入 apply。
+
+## 示例
+
+Windows PowerShell：
+
+```powershell
+# prepare（折旧设置读取 + 计提月份预检，返回 continuation）
+weaver-work-cli --json asset run asset.depre --input-json '{"calc_month":"2026-08"}'
+# apply（用户确认后）
+weaver-work-cli --json asset run asset.depre --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+# prepare（折旧设置读取 + 计提月份预检，返回 continuation）
+weaver-work-cli --json asset run asset.depre --input-json '{"calc_month":"2026-08"}'
+# apply（用户确认后）
+weaver-work-cli --json asset run asset.depre --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+## 返回
+
+`apply` 成功返回折旧任务 `dataIds`、`count`、`calc_month`、`is_group_calc` 与 `task_mode`。
+
+## 注意
+
+- `calc_month` 必须早于当前月份；预检不通过（如月份非法、命中不可计提条件）时 prepare 会报错，不进入 apply。
+- `apply` 建任务按契约写 `calc_month` + `task_mode`（由是否分组推导）+ `is_group_calc` + `task_status`（固定 0）；分组计提开启时才附 `company_ids`，关闭时整项省略（不传空串）。
+- 折旧字段映射依赖 `zgjasset_depre_setting` 配置；若实际部署的配置字段与默认假设不同，apply 可能返回业务错误，此时停止并向用户说明，不要重复提交。
+- 出现 `partial/write_uncertain` 时停止，先做一次只读回查，不要重复提交 apply。

package/skills/weaver-e10-ziguanjia/references/ziguanjia-disabled-capabilities.md

@@ -0,0 +1,22 @@
+# 暂未暴露的能力
+
+本文件列出当前 `weaver-e10-ziguanjia` manifest 未暴露、或明确禁用的资管家能力，以及遇到这些意图时的处理边界。
+
+## 已禁用 / 暂未暴露
+
+| 能力 | 状态 | 原因与边界 |
+| --- | --- | --- |
+| 资产调拨（`asset.transfer`） | 禁用 | 源资料未提供稳定的调拨接口路径、目标资产/接收人 ID 解析来源与写后回查契约。需要补充稳定接口与回查后再开放。 |
+| 流程审批（`asset.approve`） | 禁用 | 审批处理未覆盖，源资料未提供审批动作流或回查契约。走通用流程编排 Skill，不要在本 Skill 内猜测。 |
+| 图片上传（`asset.file.upload`） | 禁用 | 图片上传依赖外部文件上传模块；CLI 的 `asset.create` 仅接受已上传后得到的裸 `file_id`，不内置文件上传。需要上传时走对应文件上传能力，再把它返回的 `file_id` 传入 create。 |
+
+## 遇到这些意图时
+
+- 不要假装这些能力可用；不要用未出现在 `weaver-work-cli asset schema` 中的 operation。
+- 向用户说明当前 CLI 不支持该动作，并给出原因（缺少稳定接口 / 回查契约 / ID 解析来源）。
+- 若用户确实需要，先确认源资料里是否有稳定接口与回查方式，再按 CLI 规范实现并补测试、reference 与 docs 后开放。
+
+## 不在本 skill 范围
+
+- 非资产类 E10 业务、通用流程编排、表单/审批/组织等业务不由本 Skill 承载。
+- 禁止绕过 `weaver-work-cli` 直接访问 E10 `/api/ebuilder/*`、`/api/esb/*`。

package/skills/weaver-e10-ziguanjia/references/ziguanjia-purch.md

@@ -0,0 +1,57 @@
+# 资产采购申请
+
+## 什么时候读取
+
+用户要提交资产采购申请（多条采购明细）时读取本文件。
+
+## Operation
+
+`asset.purch`（风险 `high-risk-write`）。必须 `prepare -> apply`：第一次调用不带 `confirm` 返回 continuation 与预览，用户确认后第二次调用带 `confirm:true` 与 `continuation` 执行。
+
+## 输入要点
+
+以 `weaver-work-cli asset schema` 为准。必填：`detail1`（数组，至少一条；每条 `apply_info` 必填，`apply_count` 默认 1，`apply_remark`、`apply_spec`、`apply_asset_type` 可选）。可选：`purchase_name`。`detail1[].apply_asset_type` 为资产类型 ID。
+
+## 示例
+
+Windows PowerShell：
+
+```powershell
+# prepare（返回 continuation）
+weaver-work-cli --json asset run asset.purch --input-json '{"purchase_name":"EXAMPLE_PURCHASE","detail1":[{"apply_info":"EXAMPLE_APPLY_INFO","apply_count":2,"apply_asset_type":"EXAMPLE_TYPE_ID"}]}'
+# apply（用户确认后）
+weaver-work-cli --json asset run asset.purch --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+# prepare（返回 continuation）
+weaver-work-cli --json asset run asset.purch --input-json '{"purchase_name":"EXAMPLE_PURCHASE","detail1":[{"apply_info":"EXAMPLE_APPLY_INFO","apply_count":2,"apply_asset_type":"EXAMPLE_TYPE_ID"}]}'
+# apply（用户确认后）
+weaver-work-cli --json asset run asset.purch --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+## 返回
+
+`apply` 成功返回统一结构：`resultCode`、`resultMsg`、`actionData`、`responseData`、`customData`，以及提到顶层的 **`mainTable`**（= `responseData.customData.mainTable`）。
+
+关键字段在 `mainTable`：
+
+| 业务含义 | 字段 | 用途 |
+| --- | --- | --- |
+| 采购申请流程 ID | `lcID` | **作为「查看详情」链接（scene=`asset_purch_apply`）的 dataID** |
+| 流程标题 | `lcbt` | 回报给用户 |
+| 采购申请单号 | 以运行时返回为准 | 回报给用户的关键标识 |
+
+建单后按 `asset.viewlink` 的 `asset_purch_apply` 场景拼链接：
+
+```powershell
+weaver-work-cli --json asset run asset.viewlink --input-json '{"scene":"asset_purch_apply","ids":["<上一步返回的 lcID>"]}'
+```
+
+单号可能为回填中（空值），此时不要重试建单；链接解析失败只说明「链接暂不可用」，不影响采购申请单本身。
+
+## 注意
+
+- 出现 `partial/write_uncertain` 时停止，不要重复提交 apply。

package/skills/weaver-e10-ziguanjia/references/ziguanjia-query.md

@@ -0,0 +1,62 @@
+# 资产查询（列表 / 详情 / 领用 / 报修 / 采购）
+
+## 什么时候读取
+
+用户要查询资产列表、资产详情、我的领用列表、我的报修列表或采购申请列表时读取本文件。
+
+## Operation 与固定规则
+
+| Operation | 固定规则 |
+| --- | --- |
+| `asset.list` | 资产台账列表，按 `mainTable` 字段筛选 |
+| `asset.detail` | 资产详情，至少传 `id` / `asset_number` / `asset_name` 之一 |
+| `asset.uselist` | 领用列表，`person_id` 缺省时查询当前登录人 |
+| `asset.repaillist` | 报修列表，`person_id` 缺省时查询当前登录人 |
+| `asset.purchaselist` | 采购申请列表，`person_id` 缺省时查询当前登录人；`purchaser` 为采购员 ID |
+
+所有查询默认走版本门禁（见 `ziguanjia-agent-entry.md`）。
+
+## 输入要点
+
+字段以 `weaver-work-cli asset schema` 为准。常用筛选字段：
+
+- `asset.list`：`asset_name`、`asset_number`、`stateid`（状态 ID）、`asset_type_browse`（类型 ID）、`location_browse`（地点 ID）、`admin_istrator`（管理人 ID）、`resourceid`（使用人 ID）、`page_no`、`page_size`
+- `asset.detail`：`id`、`asset_number`、`asset_name`
+- `asset.uselist` / `repaillist`：`person_id`（缺省当前登录人）、`page_no`、`page_size`
+- `asset.purchaselist`：`person_id`、`purchaser`、`page_no`、`page_size`
+
+`stateid` / `asset_type_browse` / `location_browse` 是浏览字段 ID，先通过 `asset.resolve.*` 按名称解析，不要把中文名称直接当字段值。
+
+## 示例
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json asset run asset.list --input-json '{"page_size":10}'
+weaver-work-cli --json asset run asset.detail --input-json '{"asset_number":"EXAMPLE_NUMBER"}'
+weaver-work-cli --json asset run asset.uselist --input-json '{"page_size":5}'
+weaver-work-cli --json asset run asset.purchaselist --input-json '{"purchaser":"EXAMPLE_PURCHASER_ID","page_size":5}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json asset run asset.list --input-json '{"page_size":10}'
+weaver-work-cli --json asset run asset.detail --input-json '{"asset_number":"EXAMPLE_NUMBER"}'
+weaver-work-cli --json asset run asset.uselist --input-json '{"page_size":5}'
+weaver-work-cli --json asset run asset.purchaselist --input-json '{"purchaser":"EXAMPLE_PURCHASER_ID","page_size":5}'
+```
+
+## 返回
+
+列表返回 `items`（数组）、`count`。详情返回 `items` 中命中的资产主表。分页时递增 `page_no`，保持筛选条件不变。
+
+## 注意
+
+- 空筛选条件直接省略，不要把空字符串传给字段；`page_size` 不传时按各 operation 默认（列表默认 10，个人列表默认 5）。
+- 不要把中文状态 / 类型 / 地点名称直接作为 `stateid` / `asset_type_browse` / `location_browse` 的值，先走 `asset.resolve.*`。
+- 门禁未通过时查询会直接返回版本门禁错误，此时不要重试业务查询。
+- **查看详情链接**：`list` / `detail` / `uselist` / `repaillist` / `purchaselist` 默认（`with_view_link:true`）为每条记录附带 `view_link` 字段（卡片链接 `/sp/ebdfpage/card/0/{表单ID}/{数据ID}`，表单ID 经两步 tag 接口实时解析）；传 `with_view_link:false` 可关闭。链接解析失败只会在返回里带 `view_link_warning`，不影响主查询结果，不要因此重试查询。
+- `status` 字段是**字符串** `"true"` / `"false"`（不是布尔）；为 `"false"` 表示查询失败，不能当成「无结果」。
+- 人员名称需先经 `weaver-e10-hrm` 解析为人员 ID 再传入 `person_id`；不要把姓名直接当 ID。查「我」的列表（uselist / repaillist / purchaselist）省略 `person_id` 即可，CLI 自动用当前登录人。
+- 列表返回的 `stateid` / `asset_type_browse` / `location_browse` 可能是 ID；回报用户前按 `asset.resolve.*` 反查为名称展示，不要暴露原始 ID。