@crabcloud/skills 0.1.9 → 0.1.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: crabcloud-shop
3
- description: Manage the user's Crab Cloud shop stores through the `crab` CLI — store status, opening applications, products, stock and inventory, members and role presets. Use this skill when the user asks about their shops, wants to open or apply for a store, create or update products, adjust stock, check orders or inventory movements, manage store members/roles ("我的店铺", "开店", "上架商品", "改库存", "出入库", "商店订单", "店铺成员", "crab shop"), or asks what their stores look like — even if they never say "crab" or "Crab Cloud" explicitly.
3
+ description: Manage the user's Crab Cloud shop stores through the `crab` CLI — store status, opening applications, products, stock and inventory, coupons, membership tiers, members and role presets. Use this skill when the user asks about their shops, wants to open or apply for a store, create or update products, adjust stock, manage membership tiers, check orders or inventory movements, manage store members/roles ("我的店铺", "开店", "上架商品", "改库存", "出入库", "优惠券", "发券", "会员等级", "商店订单", "店铺成员", "crab shop"), or asks what their stores look like — even if they never say "crab" or "Crab Cloud" explicitly.
4
4
  ---
5
5
 
6
6
  # Crab Cloud 商店(crab shop)
@@ -42,6 +42,15 @@ description: Manage the user's Crab Cloud shop stores through the `crab` CLI —
42
42
  | 入库 / 出库 / 盘点 | `crab shop stock in\|out\|set <id\|SKU码> --amount N [--variant "红/M"] --note "说明"`(实物动仓库账;数字限量同命令走上架账;set 或未给 --reason 必带 --note) |
43
43
  | 设销售库存(上架额度) | `crab shop listed <id\|SKU码> --stock N [--variant …]`(仅实物;0 ≤ N ≤ 实际库存,不够先入库) |
44
44
  | 看出入库台账 | `crab shop movements [--product <id\|SKU码>] [--limit N --offset N]`(新→旧;发货/退款自动落账也在内) |
45
+ | 看优惠券 | `crab shop coupons [--status active\|disabled] --store <slug>`(发放/核销 + 码数;券无主码) |
46
+ | 新建优惠券 | `crab shop coupon create --kind amount_off\|percent_off --name 名称 [--amount-cents N \| --percent N] [--min-spend-cents N] [--max-uses N] [--per-user N] [--auto-trigger register\|order_paid] --store <slug>`(所有券先领取/兑换再使用;--auto-trigger = 新用户自动发 / 该店订单支付后自动发) |
47
+ | 给兑换码 / 看兑换码 | `crab shop coupon code add <id> [--count N] [--code 码] [--max-uses N] [--note 渠道]`(批量 ≤100 或单个自定义码,每码独立限次)· `crab shop coupon codes <id>` |
48
+ | 定向发券 | `crab shop coupon grant <id> --emails "a@x.com,b@x.com" [--notify] --store <slug>`(逐邮箱造专属券码进对方卡包;--notify 发通知邮件) |
49
+ | 看领取记录 / 启停 | `crab shop coupon claims <id> [--status unused\|used]` · `crab shop coupon on\|off <id>` |
50
+ | 删 / 启停兑换码 | `crab shop coupon code rm <码>`(已使用的码只能停用不能删)· `crab shop coupon code on\|off <码>` |
51
+ | 看会员等级 | `crab shop tiers --store <slug>`(按累计实付门槛升序;每店上限 10 级) |
52
+ | 加会员等级 | `crab shop tier add <名称> --threshold-cents 10000 [--benefits "权益说明"] [--enabled off] --store <slug>`(默认启用;名称店内唯一;门槛整数分 10000 = $100.00) |
53
+ | 改 / 删会员等级 | `crab shop tier edit <id\|名称> [--name 新名称 --threshold-cents 分 --benefits 文本 --enabled on\|off]`(只改显式给出的字段)· `crab shop tier delete <id\|名称>` |
45
54
 
46
55
  商品引用统一 `<id|SKU码>`:id 优先,SKU 码店内反查(组合码优先于商品级码)。
47
56
 
@@ -67,7 +76,9 @@ description: Manage the user's Crab Cloud shop stores through the `crab` CLI —
67
76
  `team`(团队管理)· `settings`(店铺设置)
68
77
 
69
78
  商品/库存命令的写操作(create/update/spec/archive/stock/listed)需要
70
- `products` 权限;列表、详情与台账只需成员身份。
79
+ `products` 权限;优惠券写操作(coupon create/grant/on/off、coupon code
80
+ add/on/off/rm)需要 `marketing` 权限、会员等级写操作(tier add/edit/delete)
81
+ 需要 `customers` 权限;列表、详情与台账只需成员身份。
71
82
 
72
83
  业务身份(--biz):`sales` / `support`,逗号分隔可多选——决定客户归属与业绩
73
84
  归因资格,与权限正交。
@@ -76,4 +87,7 @@ description: Manage the user's Crab Cloud shop stores through the `crab` CLI —
76
87
 
77
88
  - 店主不可改权限(由店铺归属决定);改成员权限前先 `shop members` 确认目标。
78
89
  - `shop invite --reset` 会使旧链接立即作废——先和用户确认再重置。
90
+ - 优惠券纪律:所有券先领取/兑换再使用(买家在店面领券卡或领券中心输兑换码),
91
+ 结账一单一券不叠加;`grant --notify` 按封扣积分,积分不足自动跳过邮件;
92
+ 删除仅限未使用的兑换码。
79
93
  - 订单/发货/售后命令按批次扩充;本 skill 随 CLI 更新同步维护。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@crabcloud/skills",
3
- "version": "0.1.9",
3
+ "version": "0.1.10",
4
4
  "type": "module",
5
5
  "description": "Crab Cloud agent skills (SKILL.md) with a standalone installer — teach coding agents to operate the user's personal cloud via the crab CLI.",
6
6
  "bin": {