@crabcloud/skills 0.1.9 → 0.1.11
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, announcements and campaigns, storefront homepage decoration blocks, 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 ("我的店铺", "开店", "上架商品", "改库存", "出入库", "优惠券", "发券", "公告", "活动", "首页装修", "装修", "会员等级", "商店订单", "店铺成员", "店铺设置", "SKU 前缀", "客服电话", "微信号", "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）
|
|
@@ -30,6 +30,8 @@ description: Manage the user's Crab Cloud shop stores through the `crab` CLI —
|
|
|
30
30
|
| 店铺成员（权限组合/业务身份） | `crab shop members --store <slug>` |
|
|
31
31
|
| 改成员权限 / 业务身份 | `crab shop member edit <用户名> --perms products,orders --biz sales --store <slug>` |
|
|
32
32
|
| 查看 / 重置常驻邀请链接 | `crab shop invite [--reset --perms orders,customers --biz sales] --store <slug>` |
|
|
33
|
+
| 看店铺资料（SKU 前缀/联系方式/链接） | `crab shop settings [--store <slug>] [--json]` |
|
|
34
|
+
| 改店铺资料 / SKU 前缀 / 联系方式 | `crab shop settings edit [--name … --tagline … --description … --sku-prefix … --contact-email … --contact-phone … --contact-wechat …] --store <slug>`（给 flag 才改；前缀自动大写去非法字符截 8 位、空串 = 纯流水；联系方式传空串 = 清除；写需 `settings` 权限） |
|
|
33
35
|
| 看分类（多级树） | `crab shop categories --store <slug>`（缩进树 + 商品数 + id） |
|
|
34
36
|
| 加分类 / 加子分类 | `crab shop category add <名称> [--parent <id或名称>] --store <slug>`（新建落同级末尾） |
|
|
35
37
|
| 分类改名 / 排序 / 删除 | `crab shop category rename <id或名称> <新名称>` · `crab shop category move <id或名称> <up\|down>`（同级换位，边界不动）· `crab shop category delete <id或名称>`（有子级拒绝；叶子删除后商品迁入「未分类」） |
|
|
@@ -42,6 +44,24 @@ description: Manage the user's Crab Cloud shop stores through the `crab` CLI —
|
|
|
42
44
|
| 入库 / 出库 / 盘点 | `crab shop stock in\|out\|set <id\|SKU码> --amount N [--variant "红/M"] --note "说明"`（实物动仓库账；数字限量同命令走上架账；set 或未给 --reason 必带 --note） |
|
|
43
45
|
| 设销售库存（上架额度） | `crab shop listed <id\|SKU码> --stock N [--variant …]`（仅实物；0 ≤ N ≤ 实际库存，不够先入库） |
|
|
44
46
|
| 看出入库台账 | `crab shop movements [--product <id\|SKU码>] [--limit N --offset N]`（新→旧；发货/退款自动落账也在内） |
|
|
47
|
+
| 看优惠券 | `crab shop coupons [--status active\|disabled] --store <slug>`（发放/核销 + 码数；券无主码） |
|
|
48
|
+
| 新建优惠券 | `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] [--valid-days N] [--expires YYYY-MM-DD] [--auto-trigger register\|order_paid] --store <slug>`（所有券先领取/兑换再使用；--valid-days = 领取后 N 天有效、--expires = 可领取截止，可并存；--auto-trigger = 新用户自动发 / 该店订单支付后自动发） |
|
|
49
|
+
| 给兑换码 / 看兑换码 | `crab shop coupon code add <id> [--count N] [--code 码] [--max-uses N] [--note 渠道]`（批量 ≤100 或单个自定义码，每码独立限次）· `crab shop coupon codes <id>` |
|
|
50
|
+
| 定向发券 | `crab shop coupon grant <id> --emails "a@x.com,b@x.com" [--notify] --store <slug>`（逐邮箱造专属券码进对方卡包；--notify 发通知邮件） |
|
|
51
|
+
| 看领取记录 / 启停 | `crab shop coupon claims <id> [--status unused\|used]` · `crab shop coupon on\|off <id>` |
|
|
52
|
+
| 删 / 启停兑换码 | `crab shop coupon code rm <码>`（已使用的码只能停用不能删）· `crab shop coupon code on\|off <码>` |
|
|
53
|
+
| 看会员等级 | `crab shop tiers --store <slug>`（按累计实付门槛升序；每店上限 10 级） |
|
|
54
|
+
| 加会员等级 | `crab shop tier add <名称> --threshold-cents 10000 [--benefits "权益说明"] [--enabled off] --store <slug>`（默认启用；名称店内唯一；门槛整数分 10000 = $100.00） |
|
|
55
|
+
| 发店铺公告 | `crab shop announcement add <内容> [--link <URL>] [--start 2026-10-08T10:00 --end 2026-10-09] [--sort N] --store <slug>`（多条按排序轮播在店面首页；时间窗可空 = 长期） |
|
|
56
|
+
| 改 / 删公告 | `crab shop announcement edit <id\|前缀> [--content … --link URL\|none --start …\|none --enabled on\|off]`（只改显式字段，none 清除）· `crab shop announcement rm <id\|前缀>` |
|
|
57
|
+
| 看活动 | `crab shop campaigns --store <slug>`（标题/时间窗/四态/关联项；进行中的轮播在店面首页） |
|
|
58
|
+
| 发活动（带关联项） | `crab shop campaign add <标题> [--subtitle … --description …] --link "看直播\|https://…" --coupon <券id> --products <商品id,id> --store <slug>`（关联项可重复，顺序即活动页展示顺序） |
|
|
59
|
+
| 改 / 删活动 | `crab shop campaign edit <id\|前缀> [--title … --enabled on\|off --sort N]`（关联项 flags 任一给出 = 整单替换全部，`--items-clear` 清空，不给则不动）· `crab shop campaign rm <id\|前缀>` |
|
|
60
|
+
| 看首页装修块 | `crab shop decor --store <slug>`（按页面顺序：类型/标题/摘要/启停/id；买家端发现页照此渲染，未装修 = 平台默认页） |
|
|
61
|
+
| 加装修块 | `crab shop decor add <banner\|products\|categories\|coupons\|campaigns\|richtext\|links> … --store <slug>`——banner `--slide "图片id\|标题\|副标题\|跳转"` 可重复(1..5)；products `--products <id,id> --style grid\|scroll`；categories `--categories <id,id>`；coupons `--coupons <id,id>`；campaigns `--campaigns <id,id>`；richtext `--text "正文" [--image 图片id]`；links `--link-item "标题\|跳转"` 可重复(1..8)。跳转目标统一 `none\|product:<id>\|category:<id>\|campaign:<id>\|url:<https://…>`；引用须本店存在（bad_blocks） |
|
|
62
|
+
| 改装修块 | `crab shop decor edit <id\|前缀> [--title … --slide … --products … --text … --image none --height lg --style scroll --enabled on\|off …]`（读改写只改显式字段；列表字段给了 = 整体替换；类型不可改，改类型 = 删了重建） |
|
|
63
|
+
| 装修块启停 / 排序 / 删除 | `crab shop decor on\|off <id\|前缀>`（停用即刻从买家端隐藏）· `crab shop decor move <id\|前缀> <up\|down>`（页面顺序）· `crab shop decor rm <id\|前缀>` |
|
|
64
|
+
| 改 / 删会员等级 | `crab shop tier edit <id\|名称> [--name 新名称 --threshold-cents 分 --benefits 文本 --enabled on\|off]`（只改显式给出的字段）· `crab shop tier delete <id\|名称>` |
|
|
45
65
|
|
|
46
66
|
商品引用统一 `<id|SKU码>`：id 优先，SKU 码店内反查（组合码优先于商品级码）。
|
|
47
67
|
|
|
@@ -67,7 +87,14 @@ description: Manage the user's Crab Cloud shop stores through the `crab` CLI —
|
|
|
67
87
|
`team`（团队管理）· `settings`（店铺设置）
|
|
68
88
|
|
|
69
89
|
商品/库存命令的写操作（create/update/spec/archive/stock/listed）需要
|
|
70
|
-
`products`
|
|
90
|
+
`products` 权限；优惠券写操作（coupon create/grant/on/off、coupon code
|
|
91
|
+
add/on/off/rm）、公告/活动写操作（announcement/campaign 的 add/edit/rm）与
|
|
92
|
+
首页装修写操作（decor add/edit/on/off/move/rm）需要 `marketing` 权限、会员
|
|
93
|
+
等级写操作（tier add/edit/delete）需要 `customers` 权限、店铺资料写操作
|
|
94
|
+
（settings edit）需要 `settings` 权限；列表、详情与台账
|
|
95
|
+
只需成员身份。公告/活动的时间窗可空 = 长期/不限；装修块无时间窗，enabled
|
|
96
|
+
即上下架；装修块引用的图片/商品/分类/券/活动必须本店存在（跨店引用报
|
|
97
|
+
bad_blocks）。
|
|
71
98
|
|
|
72
99
|
业务身份（--biz）：`sales` / `support`，逗号分隔可多选——决定客户归属与业绩
|
|
73
100
|
归因资格，与权限正交。
|
|
@@ -76,4 +103,7 @@ description: Manage the user's Crab Cloud shop stores through the `crab` CLI —
|
|
|
76
103
|
|
|
77
104
|
- 店主不可改权限（由店铺归属决定）；改成员权限前先 `shop members` 确认目标。
|
|
78
105
|
- `shop invite --reset` 会使旧链接立即作废——先和用户确认再重置。
|
|
106
|
+
- 优惠券纪律：所有券先领取/兑换再使用（买家在店面领券卡或领券中心输兑换码），
|
|
107
|
+
结账一单一券不叠加；`grant --notify` 按封扣积分，积分不足自动跳过邮件；
|
|
108
|
+
删除仅限未使用的兑换码。
|
|
79
109
|
- 订单/发货/售后命令按批次扩充；本 skill 随 CLI 更新同步维护。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@crabcloud/skills",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.11",
|
|
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": {
|