技能介绍

要解决什么问题

物达通 ERP 覆盖工单、OA 审批、项目与房产等业务，日常操作分散在 Web 端与多套接口里。若让大模型直接拼 HTTP 或猜字段，容易越权、写错 ID，或在「工单待办」与「OA 待办」之间路由错误。本技能把交互收敛到 erp-cli：由 Agent 根据自然语言选择 Shortcut，读取产品参考文档后再执行命令，输出统一为 {"ok": true, "data": ...} 或错误信封。

技能如何工作

认证与配置：业务前需完成 Device Flow 登录（auth login-start → 用户打开链接 → login-wait）；Token 按 profile 落在本地，过期后需重新走登录，不会静默续期。
工单（workorder）：列表、详情、分派/接单/处理等流程与状态强绑定；创建报修可走 +request-link 生成一次性线上填报链接。
OA（oa）：待办、退回、超时、经办历史、草稿、我发起、抄送等各有独立子命令；详情后再做审批、驳回、转交、退回步骤或撤回，且多数写操作支持 --dry-run 预览。
辅助与兜底：project、property 等已可用；api 在 Shortcut 不足时调用 RuoYi API；contact、charge 等模块在文档中仍标为待实现。

跨模块常见组合是 auth + oa 或 auth + workorder；分派工单指定处理人时可能先查工单详情，再 search-user，再二次分派。

边界与注意点

禁止用 curl、浏览器或非 CLI 方式改 ERP 数据；标识符必须从命令返回提取，不得编造。
用户只说「我的待办」时，应先区分工单还是 OA，再执行对应列表。
创建、删除、作废、审批类操作须先向用户确认；备注类字段应询问用户是否填写，不要自填文案。
列表带分页时，应先说明总条数与当前页，再展示明细。

截图预览

使用场景

物业报修需线上填报时，由管理员确认后生成 `workorder +request-link` 一次性链接，报修人在网页提交工单。
用户问「我手上还有哪些工单」时，先列当前待办工单并报告分页，再按工单号与部门 ID 查详情与处理记录。
员工要请假或报销时，用 `oa +available-processes` 展示可发起流程，选定模板后生成 OA 填写链接供网页提交。
审批人办理 OA 节点前，从待办核对任务 ID 查 `+info`，用 `--dry-run` 预览通过、驳回或退回步骤后再执行写操作。

适合人员

物业或客服工单调度员：需按工单状态分派、接单、指定处理人，且员工搜不到时要提示核对姓名而非编造 userId。
部门审批负责人：每天要区分 OA 办理待办、被退回项、超时项与抄送，避免与工单待办混查。
项目/房产运营：需查询当前用户可用项目、按名称查房产或车位，并在建单或分派时带上正确分类字段。
在 Agent 里接物达通集成的维护者：希望统一 Device Flow 登录、profile 多环境与 CLI JSON 信封，避免模型直连 RuoYi API。