前言¶

物業一線人員用自然語言提需求——“幫我看看某項目今天的收款”、”把這條號碼拉黑”、”生成 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