CRITICAL — 开始前 MUST 先用 Read 工具读取 ../weaver-e10-shared-connector/SKILL.md,其中包含安装、E10 认证、JSON 输出和高风险写入规则。该文件由连接器随包提供,读取失败时必须停止执行;不要自行安装 CLI 或 Skill。
认证和登录态只能按共享规则通过 weaver-work-cli auth ... 命令判断;禁止直接读取、列出、打印或解析用户主目录下的旧 .e10-cli、auth、config 或 Keychain 数据。
所有命令通过 weaver-work-cli --profile eteams --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-connector。
明确归 weaver-e10-ziguanjia-connector 的高优先级语义
出现以下任一语义时,优先走本 Skill:
- 资产 / 固定资产 / 资管家 / 资产台账 / 资产列表 / 资产详情
- 资产领用 / 资产归还 / 资产报修 / 资产采购申请
- 资产折旧 / 计提折旧
- 存放地点 / 资产状态 / 资产类型(按名称解析成 ID)
判定规则: 只要最终动作是对 E10 资产做查询、查看、名称解析、新增、修改、领用、归还、报修、采购或折旧,就归 weaver-e10-ziguanjia-connector。只有当用户处理的是非资产类 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 |
| 检查版本门禁是否通过 | asset run asset.gate.check |
ziguanjia-agent-entry.md |
| 查询资产列表 / 详情 / 领用 / 报修 / 采购列表 | asset run asset.list 等 |
ziguanjia-query.md |
| 按名称解析存放地点 / 资产状态 / 资产类型 ID | asset run asset.resolve.* |
ziguanjia-resolve.md |
| 新增资产(需 confirm + continuation) | asset run asset.create |
ziguanjia-create.md |
| 修改资产(需 confirm + continuation) | asset run asset.update |
ziguanjia-update.md |
| 提交资产领用(需 confirm + continuation) | asset run asset.use |
ziguanjia-use.md |
| 资产归还:先查候选再执行 | asset run asset.return.query/create |
ziguanjia-return.md |
| 资产报修:先查候选再执行 | asset run asset.repair.query/create |
ziguanjia-repair.md |
| 提交资产采购申请(需 confirm + continuation) | asset run asset.purch |
ziguanjia-purch.md |
| 执行资产折旧计提(需 confirm + continuation) | asset run asset.depre |
ziguanjia-depre.md |
| 给查询结果生成「查看详情」链接 | asset run asset.viewlink |
ziguanjia-viewlink.md |
| 共享、调拨、审批或 schema 未列出的能力 | 无可用命令 | 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 - 报修:先
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
执行原则(减少误路由、误重试和无效消耗)
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-connector读回补齐后再回报。 - 列表返回的
stateid/asset_type_browse/location_browse可能是 ID:回报前按asset.resolve.*反查为名称展示,不向用户暴露 ID(ID 仅内部拼「查看详情」链接用)。 status字段是字符串"true"/"false",不是布尔;为"false"表示查询失败,不能当成「无结果」。- 人员名称需先经
weaver-e10-hrm-connector解析为人员 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(登录态失效)时:立即停止当前操作,按共享规则引导用户断开并重新连接本连接器完成重新登录,然后再继续原操作。
4) 写操作确认链
- 所有
high-risk-writeoperation(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,或提示网络中断、部分成功、回查失败、回查字段不一致时,按下面规则处理:
- 先停止盲目重试,不要连续重复提交相同 apply
- 优先从以下角度解释:
- 写请求可能已经到达服务端,但连接在结果确认前中断
- 服务端可能只处理了部分资产
- 写接口已返回成功,但详情回查失败或与预期不一致
- continuation、目标资产或登录上下文可能已经变化
- 如需确认,只补 一次 只读查询(例如
asset.detail或列表查询),不要陷入 query/write 循环 - 最终给用户明确结论、已知状态、成功/失败项和下一步人工确认建议,而不是继续无意义重试
特别注意: 对新增、修改、领用、归还、报修、采购和折旧场景更要严格执行上述规则;这些场景最容易因重复提交造成重复入账、误改或覆盖用户刚修改的数据。
Windows PowerShell:
weaver-work-cli --profile eteams asset schema
weaver-work-cli --profile eteams --json asset run asset.list --input-json '{"page_size":10}'
weaver-work-cli --profile eteams --json asset run asset.resolve.type --input-json '{"type_name":"EXAMPLE_TYPE"}'
weaver-work-cli --profile eteams --json asset run asset.create --input-json '{"asset_name":"EXAMPLE_ASSET","asset_type_browse":"EXAMPLE_TYPE_ID"}'
weaver-work-cli --profile eteams --json asset run asset.create --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
macOS/Linux(bash/zsh):
weaver-work-cli --profile eteams asset schema
weaver-work-cli --profile eteams --json asset run asset.list --input-json '{"page_size":10}'
weaver-work-cli --profile eteams --json asset run asset.resolve.type --input-json '{"type_name":"EXAMPLE_TYPE"}'
weaver-work-cli --profile eteams --json asset run asset.create --input-json '{"asset_name":"EXAMPLE_ASSET","asset_type_browse":"EXAMPLE_TYPE_ID"}'
weaver-work-cli --profile eteams --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。 - 非资产类 E10 能力、通用流程编排、表单/审批/组织等业务不由本 Skill 承载。