@youzan-cloud/zan-saas-cli 0.0.0-stage → 0.1.0-beta.3

package/internal/registry/manifest.json

@@ -0,0 +1,424 @@
+{
+  "schemaVersion": 6,
+  "businessCommandCount": 59,
+  "domains": [
+    {
+      "name": "access",
+      "description": "访问控制：店铺角色定义与员工权限点",
+      "skill": "zan-saas-access",
+      "fingerprint": "a34377ac7c8fa698b9c9eee4479c987a40d44a9a554fd68e9b5af7fc293e07b5",
+      "indexFile": "access/commands.index.json",
+      "commandCount": 2,
+      "indexSize": 652,
+      "indexSha256": "77d7b2ec53cfff2a40f6dee4adb5501f12cf9681a09e7e759c78570feff46546"
+    },
+    {
+      "name": "aftersale",
+      "description": "售后：售后单查询、预算内扫描与退款资金记录",
+      "skill": "zan-saas-aftersale",
+      "fingerprint": "dd9d215f105f60f35aac2c78d072f1732894101d2429601df8fa5deed30f3cb8",
+      "indexFile": "aftersale/commands.index.json",
+      "commandCount": 4,
+      "indexSize": 1236,
+      "indexSha256": "0ff273295e45ce53833b9382d2612dd6f2801978272dd0353265f1f71ddc3608"
+    },
+    {
+      "name": "benefit",
+      "description": "权益：权益卡定义、客户持卡与发放记录",
+      "skill": "zan-saas-benefit",
+      "fingerprint": "7ccd52ed991db860337bf90aac001804e9ba805d50d41f022f3809f55bef7dc3",
+      "indexFile": "benefit/commands.index.json",
+      "commandCount": 5,
+      "indexSize": 1584,
+      "indexSha256": "a528ed46344e3f751e45e492e4be4e95df229516df381cd1eae2352048d7248e"
+    },
+    {
+      "name": "coupon",
+      "description": "优惠券：券发行活动与客户持券",
+      "skill": "zan-saas-coupon",
+      "fingerprint": "6848902d6529916e6867c995b59309d76756ea5055838f92c666ecaa0d1b3b0e",
+      "indexFile": "coupon/commands.index.json",
+      "commandCount": 4,
+      "indexSize": 1227,
+      "indexSha256": "9d6b67b9f818036e9f225b4cac0ff582792f76cb6cb89dbb1fe61124cdde93af"
+    },
+    {
+      "name": "customer",
+      "description": "客户：档案、行为、标签与分群",
+      "skill": "zan-saas-customer",
+      "fingerprint": "b54a41598d6147f32c235f4921cca8848d288a6b5d16b23fc0cbb50619eb0f57",
+      "indexFile": "customer/commands.index.json",
+      "commandCount": 10,
+      "indexSize": 3042,
+      "indexSha256": "f978a5016e0f30f32b4808d05f258992e1e162cff4c5448bd85672dc266a97b0"
+    },
+    {
+      "name": "fulfillment",
+      "description": "履约：发货单、配送单与物流轨迹",
+      "skill": "zan-saas-fulfillment",
+      "fingerprint": "92a78c0f2d74134012c228b3b1bd1441e74e44ccadc8bd0ba43662771d748fec",
+      "indexFile": "fulfillment/commands.index.json",
+      "commandCount": 3,
+      "indexSize": 975,
+      "indexSha256": "4fe241dd15fd01b92ba265dcccd1758a3f22c38667eb8ef4a77166e09b6ae823"
+    },
+    {
+      "name": "interaction",
+      "description": "互动营销：抽奖活动配置与活动查询",
+      "skill": "zan-saas-interaction",
+      "fingerprint": "b05b98819bbf63f422b30068deb2076e3bd2658ddf029bbd1e894f2179d8ee80",
+      "indexFile": "interaction/commands.index.json",
+      "commandCount": 2,
+      "indexSize": 674,
+      "indexSha256": "ddda0886aacb419476ac1a8c67e3c9f2c214b4225cbdcab8fb06dfd2a77694b3"
+    },
+    {
+      "name": "item",
+      "description": "商品：商品资料、规格与关联内容",
+      "skill": "zan-saas-item",
+      "fingerprint": "72124a32760747e2a9fd83d30109c9c514bdbd966f8d21decb449cda6ecdc244",
+      "indexFile": "item/commands.index.json",
+      "commandCount": 9,
+      "indexSize": 2639,
+      "indexSha256": "e4658bc4e8654dd582225d97f0401c41d7e40e5e3e770c8ba974dda59eea0d2a"
+    },
+    {
+      "name": "member",
+      "description": "会员：身份、等级、成长值与变更记录",
+      "skill": "zan-saas-member",
+      "fingerprint": "46e8866f9bbc01f144c78ffa077316970cdfb3eee5d9c4963780aa4e38adf8b5",
+      "indexFile": "member/commands.index.json",
+      "commandCount": 6,
+      "indexSize": 1811,
+      "indexSha256": "62618e138aa9ef06743cfc9b3c1a08fd40883d7ebf8bc058e880f1b8a4a1bb65"
+    },
+    {
+      "name": "order",
+      "description": "订单：交易订单、商品行与售后履约摘要",
+      "skill": "zan-saas-order",
+      "fingerprint": "ac980f08cb7f222d01d66b19562909115cf024ebd27e63b84d972006ac2f2c08",
+      "indexFile": "order/commands.index.json",
+      "commandCount": 3,
+      "indexSize": 918,
+      "indexSha256": "5b45860fd19977de29cb2d93772b0b3a0f3c9a52029b9bdd88191a9a39f9f3b5"
+    },
+    {
+      "name": "org",
+      "description": "组织：组织资料、员工与角色关联",
+      "skill": "zan-saas-org",
+      "fingerprint": "e2584b58e4c8ed6b2c080096e7e0fe1ba9c7f5297a1854d49f939749eef848c6",
+      "indexFile": "org/commands.index.json",
+      "commandCount": 4,
+      "indexSize": 1185,
+      "indexSha256": "553820c277b0965b1a4e9d485290588e5939ca5a4b7986ea66501ceb5197f17f"
+    },
+    {
+      "name": "points",
+      "description": "积分：客户积分、积分流水与规则",
+      "skill": "zan-saas-points",
+      "fingerprint": "9f3918d33f760cbf5e919b79dc41b7e0b9af7dfd5412244520ddeb2e308345b2",
+      "indexFile": "points/commands.index.json",
+      "commandCount": 3,
+      "indexSize": 923,
+      "indexSha256": "767827af5d38457a503c4319e4638b231e85b3dafda6e5a55b4e87beb4c30a82"
+    },
+    {
+      "name": "privacy",
+      "description": "隐私数据：订单字段受控解密，仅支持离线预览",
+      "skill": "zan-saas-privacy",
+      "fingerprint": "d9039cfc744e411ebc4d21a38ef8eb385effe76a1132aced2bc1ee7c4d50fbf8",
+      "indexFile": "privacy/commands.index.json",
+      "commandCount": 1,
+      "indexSize": 371,
+      "indexSha256": "702a6e587605b5c4e2862185fb7f611f21fee0418dd6bfb88c7d560ec99c7800"
+    },
+    {
+      "name": "stock",
+      "description": "库存：库存变化记录",
+      "skill": "zan-saas-stock",
+      "fingerprint": "a42f6e312e7d13d54a8976f034b54c16f7aedf4816e3868ea72b9995a0c98b84",
+      "indexFile": "stock/commands.index.json",
+      "commandCount": 1,
+      "indexSize": 352,
+      "indexSha256": "a8f99f851b5a2d4b8be2c0237433e59f81083f93c9dbb832c8c14efeacc9a5e5"
+    },
+    {
+      "name": "valuecard",
+      "description": "储值卡：余额卡与礼品卡的资产和余额",
+      "skill": "zan-saas-valuecard",
+      "fingerprint": "3bc44b028d62afbce49cb0c9d8e08bbbcf8555e66c344909898ed3f6ac68551c",
+      "indexFile": "valuecard/commands.index.json",
+      "commandCount": 2,
+      "indexSize": 652,
+      "indexSha256": "4f6bf3ad368eec7bd5f7bbcc160c848fb0bece49be8e9fa108e80eb52657005a"
+    }
+  ],
+  "skills": [
+    {
+      "name": "zan-saas",
+      "type": "entry",
+      "description": "有赞 SaaS CLI 入口。用户希望通过 zan-saas 查询商家业务数据或执行当前版本提供的操作时使用；按已发行领域选择指引，再用 help 和 schema 核实命令。",
+      "dependsOn": [
+        "zan-saas-shared"
+      ],
+      "files": [
+        "SKILL.md",
+        "references/host-entry.md"
+      ],
+      "fingerprint": "501e06cc8c97bd9a2352fed7779e7609f97266a8c4b1b29dd25ec9a6e93668cf"
+    },
+    {
+      "name": "zan-saas-shared",
+      "type": "shared",
+      "description": "zan-saas 跨领域公共使用规则。首次调用或 CLI 版本变化时读取，核对目标范围、当前认证边界、输出与结果判断；不定义领域参数或新增权限。",
+      "dependsOn": [],
+      "files": [
+        "SKILL.md",
+        "references/authentication.md",
+        "references/value-processing.md"
+      ],
+      "fingerprint": "5e4b2681b29e7e383fe0a39ca91327f7b9f00cded29c8f4da30eef8daca9dab0"
+    },
+    {
+      "name": "zan-saas-access",
+      "type": "domain",
+      "domain": "access",
+      "description": "访问控制：店铺角色定义与员工权限点",
+      "dependsOn": [
+        "zan-saas-shared"
+      ],
+      "files": [
+        "SKILL.md",
+        "references/role-list.md",
+        "references/staff-perms-get.md"
+      ],
+      "fingerprint": "03ce49f2cd786176282a75f7becdedcc318d3fd52c07b9477aaadf87b24f79d7"
+    },
+    {
+      "name": "zan-saas-aftersale",
+      "type": "domain",
+      "domain": "aftersale",
+      "description": "售后：售后单查询、预算内扫描与退款资金记录",
+      "dependsOn": [
+        "zan-saas-shared"
+      ],
+      "files": [
+        "SKILL.md",
+        "references/case-list.md",
+        "references/case-scan.md"
+      ],
+      "fingerprint": "a744dee062d9491c8fec107fc579a96dfc86636e41946d6e654ede84be1912d9"
+    },
+    {
+      "name": "zan-saas-benefit",
+      "type": "domain",
+      "domain": "benefit",
+      "description": "权益：权益卡定义、客户持卡与发放记录",
+      "dependsOn": [
+        "zan-saas-shared"
+      ],
+      "files": [
+        "SKILL.md",
+        "references/card-get.md",
+        "references/card-grant-list.md",
+        "references/card-list.md",
+        "references/customer-card-get.md",
+        "references/customer-card-list.md"
+      ],
+      "fingerprint": "8b3f87ae0cfb9129609b7bfe51512e426a6bbb613f545be8f1739c77751354c4"
+    },
+    {
+      "name": "zan-saas-coupon",
+      "type": "domain",
+      "domain": "coupon",
+      "description": "优惠券：券发行活动与客户持券",
+      "dependsOn": [
+        "zan-saas-shared"
+      ],
+      "files": [
+        "SKILL.md",
+        "references/activity-get.md",
+        "references/activity-list.md",
+        "references/voucher-get.md",
+        "references/voucher-list.md"
+      ],
+      "fingerprint": "658fbc89b2584f6bad72083964dad7c9096ab96a566e0eb025d17d644d2a3394"
+    },
+    {
+      "name": "zan-saas-customer",
+      "type": "domain",
+      "domain": "customer",
+      "description": "客户：档案、行为、标签与分群",
+      "dependsOn": [
+        "zan-saas-shared"
+      ],
+      "files": [
+        "SKILL.md",
+        "references/customer-scan.md",
+        "references/segment-list.md"
+      ],
+      "fingerprint": "8470178213e99997ec15b3fae5612e74c273e31931bf222ccc840ecd013ae10e"
+    },
+    {
+      "name": "zan-saas-fulfillment",
+      "type": "domain",
+      "domain": "fulfillment",
+      "description": "履约：发货单、配送单与物流轨迹",
+      "dependsOn": [
+        "zan-saas-shared"
+      ],
+      "files": [
+        "SKILL.md",
+        "references/delivery-get.md",
+        "references/shipment-list.md",
+        "references/waybill-get.md"
+      ],
+      "fingerprint": "acacdc1f7ee20d08f3f52f16f1b2cabe467361eab613353ce4d3f43b470b04f9"
+    },
+    {
+      "name": "zan-saas-interaction",
+      "type": "domain",
+      "domain": "interaction",
+      "description": "互动营销：抽奖活动配置与活动查询",
+      "dependsOn": [
+        "zan-saas-shared"
+      ],
+      "files": [
+        "SKILL.md",
+        "references/lottery-get.md",
+        "references/lottery-list.md"
+      ],
+      "fingerprint": "ddd171469bc816dc134b257cccc780be1aeea215620c29781efb9de3b4991771"
+    },
+    {
+      "name": "zan-saas-item",
+      "type": "domain",
+      "domain": "item",
+      "description": "商品：商品资料、规格与关联内容",
+      "dependsOn": [
+        "zan-saas-shared"
+      ],
+      "files": [
+        "SKILL.md",
+        "references/attribute-list.md",
+        "references/brand-list.md",
+        "references/classification-get.md",
+        "references/classification-list.md",
+        "references/group-list.md",
+        "references/item-content.md",
+        "references/item-get.md",
+        "references/item-search.md",
+        "references/product-identity.md"
+      ],
+      "fingerprint": "3968b6d1a695a795c55646bad4f78bbc93578ff654d3375a83c06649a0e1fb57"
+    },
+    {
+      "name": "zan-saas-member",
+      "type": "domain",
+      "domain": "member",
+      "description": "会员：身份、等级、成长值与变更记录",
+      "dependsOn": [
+        "zan-saas-shared"
+      ],
+      "files": [
+        "SKILL.md",
+        "references/customer-level-get.md",
+        "references/growth-log-list.md",
+        "references/membership-get.md"
+      ],
+      "fingerprint": "000a2b334e2ada6f1b8046dded4be151fe0d0464053be5215d888a40f3b77830"
+    },
+    {
+      "name": "zan-saas-order",
+      "type": "domain",
+      "domain": "order",
+      "description": "订单：交易订单、商品行与售后履约摘要",
+      "dependsOn": [
+        "zan-saas-shared"
+      ],
+      "files": [
+        "SKILL.md",
+        "references/order-get.md",
+        "references/order-list.md",
+        "references/order-scan.md"
+      ],
+      "fingerprint": "5dc09b5addec07dfb12878d8047c53a8aee14dd0aaa6ad91f712d1b5b8f0829c"
+    },
+    {
+      "name": "zan-saas-org",
+      "type": "domain",
+      "domain": "org",
+      "description": "组织：组织资料、员工与角色关联",
+      "dependsOn": [
+        "zan-saas-shared"
+      ],
+      "files": [
+        "SKILL.md",
+        "references/staff-get.md",
+        "references/staff-role-get.md",
+        "references/unit-get.md",
+        "references/unit-list.md"
+      ],
+      "fingerprint": "1ba9227cd426f9770a57c87fa335e5cac87f4c0e8d7d65f62437ab3bcbf1fa47"
+    },
+    {
+      "name": "zan-saas-points",
+      "type": "domain",
+      "domain": "points",
+      "description": "积分：客户积分、积分流水与规则",
+      "dependsOn": [
+        "zan-saas-shared"
+      ],
+      "files": [
+        "SKILL.md",
+        "references/account-get.md",
+        "references/log-list.md",
+        "references/rule-list.md"
+      ],
+      "fingerprint": "18e7a0569e2e2e5395f9e05fbdfd2fb46f99824f159cacd573698414d937240e"
+    },
+    {
+      "name": "zan-saas-privacy",
+      "type": "domain",
+      "domain": "privacy",
+      "description": "隐私数据：订单字段受控解密，仅支持离线预览",
+      "dependsOn": [
+        "zan-saas-shared"
+      ],
+      "files": [
+        "SKILL.md",
+        "references/field-decrypt.md"
+      ],
+      "fingerprint": "ac528338858b0a0d712cfc19d4c3c8dc5f89e415737b5d21092b5a0d23d3a2be"
+    },
+    {
+      "name": "zan-saas-stock",
+      "type": "domain",
+      "domain": "stock",
+      "description": "库存：库存变化记录",
+      "dependsOn": [
+        "zan-saas-shared"
+      ],
+      "files": [
+        "SKILL.md",
+        "references/log-list.md"
+      ],
+      "fingerprint": "f0262021156a20bc0b4197e62e0ce737e81a3465fe86e91f70fba3377e08c1df"
+    },
+    {
+      "name": "zan-saas-valuecard",
+      "type": "domain",
+      "domain": "valuecard",
+      "description": "储值卡：余额卡与礼品卡的资产和余额",
+      "dependsOn": [
+        "zan-saas-shared"
+      ],
+      "files": [
+        "SKILL.md",
+        "references/card-get.md",
+        "references/card-list.md"
+      ],
+      "fingerprint": "8f170112f98379f817379bb2110bc3154a8651d8ea1e3e061ba4e0156b118152"
+    }
+  ]
+}

package/npm-shrinkwrap.json

@@ -0,0 +1,86 @@
+{
+  "name": "@youzan-cloud/zan-saas-cli",
+  "version": "0.1.0-beta.3",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@youzan-cloud/zan-saas-cli",
+      "version": "0.1.0-beta.3",
+      "license": "MIT",
+      "dependencies": {
+        "ajv": "8.20.0",
+        "commander": "12.1.0"
+      },
+      "bin": {
+        "zan-saas": "./bin/zan-saas-cli.js"
+      },
+      "engines": {
+        "node": ">=18",
+        "npm": ">=8 <12"
+      }
+    },
+    "node_modules/ajv": {
+      "version": "8.20.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz",
+      "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==",
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.3",
+        "fast-uri": "^3.0.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
+    "node_modules/commander": {
+      "version": "12.1.0",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-12.1.0.tgz",
+      "integrity": "sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/fast-deep-equal": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
+      "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
+      "license": "MIT"
+    },
+    "node_modules/fast-uri": {
+      "version": "3.1.9",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.9.tgz",
+      "integrity": "sha512-hS/0Wt3Ya043oKXs0sIxrMpKQITXhMLIrVAKKXi4gozGC9v7YRWVnXIZzjNPTO02M9BdxLCWqK1yRXgNziVyJQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/json-schema-traverse": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+      "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+      "license": "MIT"
+    },
+    "node_modules/require-from-string": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
+      "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,35 @@
 {
   "name": "@youzan-cloud/zan-saas-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0-beta.3",
+  "description": "Youzan SaaS CLI preview",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18",
+    "npm": ">=8 <12"
+  },
+  "bin": {
+    "zan-saas": "./bin/zan-saas-cli.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "internal/registry/",
+    "skills/",
+    "LICENSE",
+    "NOTICE",
+    "THIRD_PARTY_NOTICES.txt",
+    "DEPENDENCIES.json",
+    "npm-shrinkwrap.json",
+    "INSTALL.md",
+    "README.md"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public",
+    "tag": "latest"
+  },
+  "dependencies": {
+    "ajv": "8.20.0",
+    "commander": "12.1.0"
+  }
+}

package/skills/README.md

@@ -0,0 +1,30 @@
+# 对外发布的 Skill
+
+随包提供入口 [zan-saas](zan-saas/SKILL.md)、[公共规则](zan-saas-shared/SKILL.md) 和以下领域指引。以 `zan-saas skills list` 发现当前安装版，领域登记不表示已经提供该域的全部操作。
+
+| 领域 | 可选择的用户目标与关键边界 |
+| --- | --- |
+| [组织 org](zan-saas-org/SKILL.md) | 当前组织、总部下级组织、单店员工与员工角色关联；角色目录和权限点转交访问控制域。 |
+| [访问控制 access](zan-saas-access/SKILL.md) | 店铺角色定义目录与当前单店员工权限点；目录、授角和权限分别判断。 |
+| [客户 customer](zan-saas-customer/SKILL.md) | 客户档案、标签定义、标签组与客户标签关系；客户不等于会员。 |
+| [会员 member](zan-saas-member/SKILL.md) | 会员身份、实际等级、等级定义与成长值；不从其中一个事实推算另一个。 |
+| [积分 points](zan-saas-points/SKILL.md) | 当前积分、历史变动与奖励规则；流水余额不代替当前账户。 |
+| [权益 benefit](zan-saas-benefit/SKILL.md) | 权益卡定义、客户持卡与历史发放记录；历史发放不证明当前可用。 |
+| [优惠券 coupon](zan-saas-coupon/SKILL.md) | 券发行活动与客户持券的列表、详情；活动状态不证明订单可用。 |
+| [储值卡 valuecard](zan-saas-valuecard/SKILL.md) | 余额卡、礼品卡的单卡或客户持卡查询；单卡余额不是客户资产汇总。 |
+| [商品 item](zan-saas-item/SKILL.md) | 商品资料、SKU、图文及相关目录；商品配置不等于库存数量。 |
+| [订单 order](zan-saas-order/SKILL.md) | 单笔订单、单页列表与预算内扫描；配送和物流转交履约域。 |
+| [履约 fulfillment](zan-saas-fulfillment/SKILL.md) | 发货单集合、配送单详情及物流运单轨迹；各对象的标识与状态分别核对。 |
+| [库存 stock](zan-saas-stock/SKILL.md) | 指定商品和时间范围的库存变动日志；不提供当前库存或进销存单据查询。 |
+| [售后 aftersale](zan-saas-aftersale/SKILL.md) | 售后单详情、单页或有界扫描，以及关联退款资金明细；售后状态不证明到账。 |
+| [互动营销 interaction](zan-saas-interaction/SKILL.md) | 抽奖活动列表与详情；活动、参与和实际奖励分别判断。 |
+
+从 `zan-saas skills read zan-saas` 开始，再读取公共规则和当前任务涉及的领域。`skills list` 的 `type` 区分 `entry`、`shared` 和 `domain`。`skills read <名称> [相对 Markdown 路径]` 默认读取正文，只有命中特定分支时再读取正文指向的 reference。
+
+领域指引负责对象、关系、用户目标、跨域转交和停止条件。选定命令后，从同版 help/schema 取得参数、默认值、枚举、返回字段、单位与授权前置；金额计算或时间处理再按 shared 的条件指引读取。Skill 不授予权限，也不能让未注册命令可执行。
+
+当前领域命令均为只读原子操作，内部可以调用多个 API。Agent/宿主负责理解需求、组合命令和解释结果；复合任务入口的含义与当前范围见入口指引。需要未提供的查询或写入时说明缺口，不自动转成 Raw API。
+
+首次准备员工登录时查看 `zan-saas auth login --help`，本地凭证状态使用 `zan-saas auth status`。凭证与目标店铺、上下文及业务权限仍须分别核对。
+
+需要将轻量入口接入 Agent 宿主时，读取 `zan-saas skills read zan-saas references/host-entry.md`。宿主和作用范围由用户选择，CLI 安装不自动改写宿主或全局指令。

package/skills/zan-saas/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: zan-saas
+description: 有赞 SaaS CLI 入口。用户希望通过 zan-saas 查询商家业务数据或执行当前版本提供的操作时使用；按已发行领域选择指引，再用 help 和 schema 核实命令。
+---
+
+# zan-saas 入口
+
+## 人机交接
+
+Agent 负责运行命令、定位对象和解释结果。用户只需完成浏览器授权，并在目标店铺不明确时补充选择。
+
+需要登录时，Agent 运行 `zan-saas auth login` 并把输出的授权地址交给用户；用户在浏览器确认授权，Agent 等待命令成功，再运行 `zan-saas auth status`。浏览器显示授权完成但命令失败时，按错误核查并停止，不将已有凭证状态当作本次登录成功。用户取消或授权超时后，需要继续时重新运行登录。
+
+先运行 `zan-saas shop current` 查看当前店铺。已有有效上下文且用户没有要求切店时继续使用，不重复询问。用户明确指定店名时，Agent 用 `zan-saas shop list` 查找可选店铺。核对相关候选和分页后，只有店名唯一匹配时才用结果中的 `kdtId` 执行 `zan-saas shop use <kdtId>`。同名或含义不明确时，展示店名和类型让用户区分，不从名称片段推定目标。
+
+没有上下文且用户没有指定店铺时，展示候选店名供选择。即使只有一个候选，也简短询问“使用某某店吗？”。用户可以按店名或本次展示的序号回答，Agent 保留候选与 ID 的对应关系，无需用户理解或输入 `kdtId`。不默认选第一家，也不把未查完的一页当成全部候选。
+
+店铺列表的 `total` 是员工停用过滤前的匹配总数，未知时为 `null`。`nextPageNo` 非空时，保留名称、业务线、容量及 `--all` 等选项，用 `--page-no` 继续；`hasMore=null` 表示是否还有后续未知。不要因本页候选少或为空就认定查完；`windowLimitReached=true` 时停止翻页，缩小筛选，不宣称已查全。
+
+选店后用 `zan-saas shop current` 核对实际生效的店铺和来源。切店无需重新登录，浏览器中的店铺选择不改变 CLI 上下文。账号接口路由或 OAuth 地址错误时，按共享指引的[认证排查](../zan-saas-shared/references/authentication.md)核查版本、配置和服务端路由，停止后续请求。`whoami`、`shop current`、`help`、`schema`、`--dry-run`、业务请求和错误判断由 Agent 完成。
+
+## 选择当前能力
+
+首次使用或 CLI 版本变化时，先读取 `zan-saas skills read zan-saas-shared`。公共规则不代替用户本次目标和授权。
+
+1. 运行 `zan-saas skills list`，从 `type: "domain"` 的条目中按用户目标选择领域。`entry` 和 `shared` 是指引类型，不是业务领域。
+2. 用 `zan-saas skills read <列表中的名称>` 读取所选领域。领域正文说明对象、易混边界、转交和停止条件；命中特定分支时再读取它指向的 reference。
+3. 选定领域和资源后，用 `zan-saas help item.item.get` 或 `zan-saas help item item get` 这样的叶子路径查看帮助；也可以使用叶子命令的 `--help`。先用 `zan-saas schema <命令路径> --section input` 核对参数和前置，执行前按需读取 `--section output` 理解结果。需要其他部分时读取 `preview`、`error` 或完整契约。`--section` 只用于叶子命令，不能与 `--summary` 同用；路径未知时可用 `zan-saas schema --summary` 或 `zan-saas schema item --summary` 查轻量目录。点号路径作为一个参数，空格路径按词分别传入，不能把含空格的整条命令当成一个参数。
+4. 核对命令要求的对象、目标店铺及其他必要范围。信息不全或候选含义不同，就询问能区分目标的最小问题。已有只读定位能力时，按其契约使用；缺少定位能力时说明缺口并停止。
+
+已知命令和对象时，可以直接读取相关领域指引和叶子契约。同一任务内无需重复读取未变化的指引，也不必展开所有领域或全量 schema。摘要只用于发现，不替代调用契约。
+
+## 能力与执行边界
+
+当前提供原子查询命令：每条命令完成职责明确的业务读取，内部可以调用多个 API。意图识别、命令组合、分页决策和自然语言回答由 Agent/宿主按同版契约完成。`+任务` 表示 CLI 自身负责定位、选路或步骤核验的复合任务入口；本版尚未发行这类命令。
+
+当前安装版未提供目标命令时，说明未支持的操作并停止。Raw API 需要独立、明确的 API 调用目标，不能用作领域操作缺失后的自动替代。
+
+Skill 解释如何选择和使用命令，不授予员工、店铺或业务权限。执行和结果判断遵循共享规则与该命令契约。
+
+## 从一句话到查询结果
+
+例如用户说“查当前店铺最新创建的 10 个商品”：
+
+1. Agent 检查登录状态和 `shop current`；已有有效店铺时沿用，缺登录或目标时按上面的流程补齐。
+2. 读取商品领域指引，选择 `item item list`，而非遍历全部商品的 `scan`。
+3. 读取 `help item.item.list`、输入与输出契约，确认按创建时间降序取一页的参数，以及返回金额、时间和分页的含义。
+4. 当前上下文能提供店铺时省略 `--kdt-id`，执行 `zan-saas item item list --page-size 10 --sorts CREATED_TIME_DESC`。需要本地核对计划时可先加 `--dry-run`，预览不证明真实接口可用。
+5. 参数错误时按 `issues` 定位问题；只有错误诊断明确允许 `correct_input` 且整次调用完整观测、零请求，才修正输入并构造新调用。不得修改用户的目标或筛选含义；业务请求已发送、状态未知或诊断不足时停止核查，不自动重放。
+6. 查询成功后，把这页商品整理成用户能读懂的回答，说明本次最多读取 10 条。按分页结果说明是否还有结果或未知，不把一页当成全店商品。
+
+## 接入宿主
+
+需要让外部 Agent 发现本入口时，运行 `zan-saas install`。安装范围、其他宿主及重复安装规则见 `zan-saas skills read zan-saas references/host-entry.md`。

package/skills/zan-saas/references/host-entry.md

@@ -0,0 +1,25 @@
+# 将入口接入 Agent 宿主
+
+使用 `zan-saas install` 选择 Agent 并安装入口，默认个人范围。非交互安装使用 `zan-saas install --yes --host <宿主>`；仅当前项目使用时追加 `--scope project`。
+
+安装器从同包模板生成轻量入口，记录持久 CLI 的 Node.js 与启动位置，供桌面宿主按需读取指引。普通 npm 安装不自动改写宿主配置。其他宿主可以指定 `--directory <Skill目录>`，也可手动保存下面模板。
+
+```markdown
+---
+name: zan-saas
+description: 用户希望通过 zan-saas 查询商家业务或使用当前版本提供的操作时使用。读取当前安装 CLI 的指引，再按领域 help 和 schema 继续。
+---
+
+# zan-saas
+
+开始时运行 `zan-saas --version` 和 `zan-saas skills read zan-saas`。
+使用 CLI 返回的同版正文，再按其中的共享规则与领域指引继续。
+
+如果命令不可用、入口读取失败或版本兼容性无法确认，说明缺口并停止。
+```
+
+宿主负责把用户需求交给 Agent，并提供运行本机 CLI、展示授权地址及返回结果的能力。入口 Skill 负责指向当前安装版，领域选路、参数校验和输出解释规则由 CLI 同包指引与契约提供。
+
+宿主侧只保存这个轻量入口，不复制整份领域知识。CLI 升级后重新读取同版指引；宿主不支持按需读取时，需要显式安装匹配版本的静态副本。
+
+重复安装只更新本项目管理且未被手工修改的入口；同名其他 Skill 保留并报错。安装不执行登录、选店或业务请求。完成后在宿主技能列表确认 `zan-saas` 已启用，再打开新会话。