盈绰服务云

先解决什么问题

在物业、园区或多业态运营场景里，Agent 经常要帮业务方做欠费催缴、应收汇总、工单查询、押金退款、旅游订单跟进这类事。这些操作背后是一套 yc-cloud CLI，命令分散、参数约束多，稍有不慎就会写出错误查询、误触写操作，或者在分页和统计上做无用功。

盈绰服务云 Skill 要解决的核心问题是：让 Agent 在收到自然语言请求后，先判断属于哪个业务模块，再按模块约定的 allowlist、预检和执行顺序调用 CLI，而不是临时探索、猜参数或自行翻页。

技能如何工作

1. 路由到业务模块

Skill 把请求映射到已注册模块，例如：

• collection：催缴、欠费、短信模板、黑名单
• receivable：应收、缴款明细、收缴率、票据更正
• house / employee：租客、业主、员工状态、角色
• deposit-refund：押金退款申请与审核
• order：工单派单、审批、转派、评价
• travel / flash：旅游团、商圈闪购数据

未注册的泛化聊天、历史命令或猜接口请求会被直接拒绝，并提示“当前模块不覆盖”。

2. 列表统计快速路径

当请求同时包含业务对象和统计关键词（如筛选、汇总、排行、Top N、分组）时，Skill 会进入快速路径：

1. 读 runtime.md 和 list-query.md
2. 校验数据源是否已接入及字段 schema
3. 生成受约束查询计划，执行一次列表命令
4. 直接展示紧凑结果，不再写 Python/jq 脚本，不再自行翻页

其中 count 聚合禁止带 field，collection sms-task preview --query-plan 内部按每页 500 自动翻页，上限 50000。

3. 统一执行顺序

所有模块遵循同一流程：

1. 读 runtime.md 确认 CLI 启动方式
2. 路由到模块并读对应文件
3. 校验命令在模块 allowlist 中
4. 校验 apiKey
5. 进行一次轻量预检
6. 校验参数白名单与默认值
7. 通过 sh ./scripts/yc-cloud.sh 执行
8. 仅在失败时回看源码和 COMMAND_SPEC

全局守卫会禁止：脑补 projectId / houseId / templateId 等参数、重复同类预检、读取无关本地文件，以及绕过正式 CLI 自建 launcher。

适用边界与注意点

• 只覆盖已注册模块，不支持未在 allowlist 中出现的命令。
• 缺少 apiKey 或关键业务参数时直接停止，不编造数据。
• Skill 不负责逐命令参数说明，具体细节见各模块文件。
• 当文档与源码冲突且无法定论时，执行停止并提示更新 CLI。