前言¶

物业一线人员用自然语言提需求——“帮我看看某项目今天的收款”、”把这条号码拉黑”、”生成 3 月的催缴通知单”——落地的常常不是业务动作，而是一轮互相试探的命令排查：试错、翻文档、把命令丢回给用户自己跑。盈绰服务云要解决的问题是：在 Agent 侧把”该调哪个业务模块、参数怎么拼、谁有权执行”一次定清楚，让请求直接落到已注册的 Go 版 CLI 业务模块上。

这是什么¶

盈绰服务云（坐标 @user_ea7a4de8/yc-cli）是 SkillHub 社区（community）发布的 business-ops 分类 Skill，版本 1.0.13，发布者 user_ea7a4de8。它自身不实现物业业务逻辑，只承担两件事：把请求路由到当前 Go 版 CLI 已注册的业务模块，并在执行前跑一遍最小必要的全局守卫。适合在业务面很宽、模块很多的物业 SaaS 场景里做统一入口。

核心功能¶

1、模块路由与全局守卫。Skill 内置 Routing 表，把用户的收费、催缴、工单、巡检、多经、旅游等请求分发到对应业务模块，执行前做最小必要的全局守卫，不做越权或跨模块猜测。

2、微信 Agent Pay（X402）付费资源流程。付费前置检查走 weixinpay 插件，不是 CLI 根命令；触发 HTTP 402 支付后，重试时通过 X-Out-Trade-No 传递订单号，完成付费资源获取。

3、催缴短信预检，不做实际发送。单批用 collection sms-task notice-create –preflight，多批用 collection sms-task notice-preflight-batches。

4、短信黑名单管理。加入黑名单用 collection sms-blacklist create –mobile [–remark]，缺应用先 collection sms-blacklist app-list。

5、催缴通知单生成。必须用 collection payment-reminder create –project-id –project-name –cost-date [–house-names] [–charge-subject-names]，用户已给项目/房号/月份/科目时同一轮直接 create。

安装与启用¶

该 Skill 使用通用 SKILL.md 格式，可通过 SkillHub 页面获取：

https://www.skillhub.cn/skills/user_ea7a4de8/yc-cli

获取后，在支持 SKILL.md 的 Agent 环境中加载该 Skill。启用前需配置 API Key，该 Skill 标记为 requires_api_key=true。目前官方资料未提供统一的一行安装命令，具体加载方式取决于使用的 Agent 运行时。

典型用法¶

下面的例子都来自 SKILL.md 中的明确约束，可直接对照执行。

催缴短信多批预检（不实际发送）：

collection sms-task notice-preflight-batches

单批预检：

collection sms-task notice-create --preflight --project-id <项目ID> --template-id <模板ID> --task-name <任务名> --input <输入>

缺模板时先查模板列表：

collection sms-task list-templates

查项目列表：

collection sms-task list-projects

查科目：

collection sms-task list-fee-items

应收入账列表：

collection receivable list-accounts --project-id <项目ID>

押金退款办理列表：

deposit-refund apply-list

生成催缴通知单：

collection payment-reminder create --project-id <项目ID> --project-name <项目名> --cost-date <费用日期> [--house-names <房号,...>] [--charge-subject-names <科目,...>]

加入短信黑名单：

collection sms-blacklist create --mobile <手机号> [--remark <备注>]

适用场景与注意¶

适合：完全不懂代码的一线物业运营人员，由 Agent 读取 Routing 表后直接执行到底。覆盖收费、催缴、欠费、列表筛选、分组汇总、Top N、短信与黑名单、模板、收银台、应收管理、缴费明细与汇总、押金退款、租户/业主/房屋/客户管理、员工管理、工单、报事报修、派单审批、巡检、多经、旅游、店铺权限、闪购、日报等 yc-cloud 业务流。

执行前必须先 Read 本 SKILL.md；读匹配的模块文件后再执行，不要用猜测的接口、通用闲聊或模块白名单外的命令。

几条硬约束：

• 禁止 --help 探路，禁止把命令甩给用户去试。
• 禁止把叶子命令或项目 ID 当根命令，禁止自造命令名，禁止向用户要命令。
• weixinpay 只用于 X402 付费，催缴短信预检不走 weixinpay，禁止自造 weixinpay / weixinpay.precheck-sms / precheck-sms。
• 短信黑名单没有自造的 blacklist.add-phone，缺应用先查 app-list。

结尾¶

盈绰服务云的价值不在于实现更多业务，而在于在 Agent 和 Go 版 CLI 之间建立一张明确、可守卫的路由表：该调哪个模块、参数怎么拼、哪些路径不能走，都写进 SKILL.md。对使用者来说，减少的是命令试错和来回确认；对维护者来说，业务扩展只需更新 Routing 和模块白名单。官方地址：https://www.skillhub.cn/skills/user_ea7a4de8/yc-cli