技能介绍

要解决什么问题

服务业 ERP 里的单据、审批、附件和专用业务命令往往分散在 Web 工作台与多套接口语义里。Agent 若凭记忆拼命令，容易在 profile、对象 apiName、字段操作符或「我的单据」这类预置视图上猜错，写入超时后还可能盲目重试，把状态搞成「以为成功、实际未知」。

本技能面向 已就绪的 qiqi CLI（安装、升级、首次授权由 qiqi-cli-installation 等流程处理）：把 当前终端里的 qiqi --help 与实际返回 当作能力和语法的权威，在身份清楚、目标可证的前提下完成查询与受控写入。

技能如何工作

任务按意图路由到对应命令族，而不是一律 find list：

身份：auth list、auth status；业务命令优先显式 --profile。
元数据：objects、describe fields / describe list、find values；跨对象文本用 seek。
查询：明细全集用 find list 分页直到 hasMore 为假；合计、分组、度量互比用 find aggregate，禁止拉第一页本地加总。
工作台视图：先 describe view 匹配再 find view，不匹配则不猜 viewId。
记录与动作：records get / records delete；提交、审批等走 describe actions 与 do-action；BUSINESS_WARNING 须展示警告，用户确认后再 --ignore-warn。
附件与业务命令：records attachments 系列；专用能力从 qiqi --help 的「业务命令」逐级 --help 发现叶子命令。

执行上采用 按需检查点：授权失败或身份变化先在线核对；名称不唯一先消歧，写入用稳定 RecordRef 或唯一编码；破坏性操作核对一次最小动作；写入结果不明确则标 状态未知，先读业务事实再决定是否重试。输出面向用户优先字段/对象标题，对内保留 apiName；遇 77hub.large-output 读完整 JSON，不用 summary 冒充全量分析。

适用边界

首次安装、CLI 缺失、重装或新增登录身份：不在本技能范围，应走安装与接入流程后再回来。
用户意图与当前 qiqi 能力不一致时：停止并说明差异，不构造替代请求；当前 profile 未暴露的命令只报告能力缺口。
describe list 样例与 seek 候选不能证明唯一性或全集；没有额外证据时，未查到只表述为「当前范围未查到」。
复杂场景可按任务读取技能内引用（如 list-query.md、actions-and-recovery.md），只读当前任务需要的文件。

截图预览

使用场景

切换或新增登录身份后，用 `auth status` 确认企业与用户，再对指定 `--profile` 执行 `find list` 分页拉全量明细。
处理审批队列前用 `describe view` 匹配「待我审批」等视图，经 `find view` 取单后 `describe actions` 与 `do-action` 完成同意或驳回。
单号或客户名称不唯一时先 `seek` 消歧，再用 `records get` 核对记录，合计与分组用 `find aggregate` 而非第一页本地加总。
目标记录已定位后处理 `records attachments` 上传或清单，或从 `qiqi --help` 业务命令逐级 `--help` 发现专用叶子命令再执行。

适合人员

同时维护多家客户账套的实施顾问，需按租户用 `objects`/`describe` 核对字段与操作符后再构造查询或写入。
负责项目或应收复盘的服务业财务，需用 `find aggregate` 做合计、分组与度量互比，并保证分页查询覆盖全集。
每日处理待办审批的业务主管，依赖 `describe view` 与 `find view` 使用工作台预置视图，避免手写易错的过滤条件。
在 Agent 里代查单据或执行提交的运营人员，需在 `BUSINESS_WARNING` 展示警告并经用户确认后再带 `--ignore-warn` 重试写入。