@crabcloud/skills 0.1.17 → 0.1.19
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,13 +1,13 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: crabcloud-atelier
|
|
3
|
-
description: Fashion R&D workshop management via the `crab atelier` CLI — apply to create an atelier, manage members & permission sets, invite links, roles, collections, styles (with stage markers), design-stage documents (design/pattern/sample drafts with round-based reviews), the supplier directory (fabric vendors & factories), production orders (size breakdown, delivery, factory, frozen costing snapshot), the org-wide record stream and the desk digest. Use when the user asks anything about their fashion atelier
|
|
3
|
+
description: Fashion R&D workshop management via the `crab atelier` CLI — apply to create an atelier, manage members & permission sets, invite links, roles, collections, styles (with stage markers and archive/restore), the category dictionary for style creation, design-stage documents (design/pattern/sample drafts with round-based reviews), the supplier directory (fabric vendors & factories), production orders (size breakdown, delivery, factory, frozen costing snapshot), the org-wide record stream and the desk digest. Use when the user asks anything about their fashion atelier: 工坊、款式、样衣、打样、审版、样衣轮次、系列、款号、配色、设计师、服装研发、核价准备、建坊、成员、权限、邀请链接、岗位、记录、工作台、供应商、面辅料、加工厂、品类、归档、制单、生产单、排产、交期、投产、工艺单 — even if they never say "crab".
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
#
|
|
6
|
+
# Atelier 服装研发工坊（crab atelier）
|
|
7
7
|
|
|
8
8
|
管理服装研发工坊：成员与权限集、邀请链接、岗位（纯职务标识）、系列（批次容器）、
|
|
9
9
|
款式库（款号 + 阶段定位标记 + 配色 + 打样稿件）、设计阶段时间线（稿件上传 /
|
|
10
|
-
审版定版留痕）、供应商目录（面辅料商家 /
|
|
10
|
+
审版定版留痕）、供应商目录（面辅料商家 / 加工厂）、全量记录流与工作台聚合。独立产品 Atelier，同一套 REST API 服务 Web 与 CLI。
|
|
11
11
|
款（style）是唯一锚点——建档、轮次、结论都挂在款上并自动落时间线。
|
|
12
12
|
|
|
13
13
|
跨域时参考：邮件 `crabcloud-mail`、云盘 `crabcloud-storage`、协作
|
|
@@ -44,7 +44,9 @@ atelier 命令需要 **atelier scope + 工坊绑定**的令牌：`crab login --s
|
|
|
44
44
|
|
|
45
45
|
| 意图 | 命令 |
|
|
46
46
|
|---|---|
|
|
47
|
-
| 看我在哪些工坊 | `crab atelier orgs
|
|
47
|
+
| 看我在哪些工坊 | `crab atelier orgs`（当前绑定的带 `← 当前` 标记） |
|
|
48
|
+
| 看当前工坊 | `crab atelier org`（令牌绑定的工坊与 scope；绑定是服务端状态） |
|
|
49
|
+
| 切换工坊 | `crab atelier org switch <org:名称\|id>`（浏览器授权一次即换绑，原令牌不撤销；多工坊轮换用） |
|
|
48
50
|
| 申请创建工坊 | `crab atelier org apply <名称> [--note 说明]`（审核通过自动建坊） |
|
|
49
51
|
| 查申请进度 | `crab atelier org application`（pending / approved〔含驳回意见〕/ 从未申请） |
|
|
50
52
|
| 工坊改名 | `crab atelier org rename <新名称>`（settings 权限；改名后 `org:<名称>` 标识随新名） |
|
|
@@ -81,6 +83,10 @@ flags 的数组）判定：`styles`（款式库）、`records`（记录）、`ma
|
|
|
81
83
|
|
|
82
84
|
**系列批次**（批次容器）：标题 + 年月（`YYYY-MM` 必填）+ 选填说明 + 归档状态——
|
|
83
85
|
归档不是删除，可随时恢复；归档后新建款式不可再挂该系列，存量款式引用不受影响。
|
|
86
|
+
**款式归档**同理（2026-10-14）：归档款从默认列表退场（`styles --status archived|all`
|
|
87
|
+
带出），记录与引用全部保留、可恢复、无删除。**品类是辅助输入不是关联**（2026-10-14
|
|
88
|
+
拍板）：品类字典只供建档时选词与记录页管理，款式上的品类仍是自由文本、不挂 id——
|
|
89
|
+
`--category` 直接写文本即可，想进字典供团队复选再 `category create`。
|
|
84
90
|
款式阶段是**定位标记不是状态机**（设计 → 核算 → 生产 → 完成；打样与审版收在
|
|
85
91
|
设计段内）——任意阶段可编辑、可补录，阶段变更自动落时间线。金额一律**整数分**
|
|
86
92
|
（`--retail-cents 19900` = ¥199.00）。款号 = 工坊内唯一业务主键（重复建档 409）。
|
|
@@ -91,13 +97,18 @@ flags 的数组）判定：`styles`（款式库）、`records`（记录）、`ma
|
|
|
91
97
|
| 建系列 | `crab atelier collection create "2026 秋冬首批" --ym 2026-09 [--note 备注]`（年月必填） |
|
|
92
98
|
| 改系列 | `crab atelier collection edit <id> [--name ... --ym 2026-10 --note ...]`（给的 flag 才改） |
|
|
93
99
|
| 归档 / 恢复 | `crab atelier collection archive <id>` / `crab atelier collection restore <id>`（幂等无删除） |
|
|
94
|
-
|
|
|
100
|
+
| 看品类 | `crab atelier categories [--status active\|archived\|all] [--q 关键字]`（默认只看在册；带状态计数） |
|
|
101
|
+
| 建品类 | `crab atelier category create "连衣裙"`（同 org 重名 409；归档同名同样占用，恢复即可） |
|
|
102
|
+
| 改品类 | `crab atelier category edit <id> --name 新名称`（撞名 409） |
|
|
103
|
+
| 归档 / 恢复品类 | `crab atelier category archive <id>` / `crab atelier category restore <id>`（归档后建档选择器不再出，已录款式文本不受影响） |
|
|
104
|
+
| 看款式库 | `crab atelier styles [--q 关键字] [--stage 核算] [--collection <id>] [--status active\|archived\|all] [--page N]`（默认只看在库；带阶段与状态计数） |
|
|
95
105
|
| 看一款 | `crab atelier style <id>`（信息按组展示：01 基础信息 / 02 商品规格 / 03 生产信息 / 04 尺寸表〔部位 × 尺码矩阵 + 档差，尺码列随商品规格联动〕，+ 轮次时间线 + 最近事件，一次取全） |
|
|
96
|
-
| 款式建档 | `crab atelier style create --code KH001 --name "羊毛大衣" [--category 大衣] [--collection <id>] [--designer ... --pattern-maker 纸样师 --sample-maker
|
|
97
|
-
|
|
|
106
|
+
| 款式建档 | `crab atelier style create --code KH001 --name "羊毛大衣" [--category 大衣] [--collection <id>] [--designer ... --pattern-maker 纸样师 --sample-maker 车版师] [--retail-cents 199000] [--notes ...]`（款号唯一；归档系列不可挂）。**开款 ≠ 补录**：建档只收基本字段，色板/尺码/工艺开款后补录（Web 详情页分组编辑或下方 CLI flag 均可；建档时也可一并带上，见 `--colorways/--sizes/--craft-notes`） |
|
|
107
|
+
| 归档款式 | `crab atelier style archive <styleId>` / `crab atelier style restore <styleId>`（幂等无删除；归档款详情仍可看，时间线落归档句） |
|
|
108
|
+
| 编辑款式 | `crab atelier style edit <id> --stage 生产 [--pattern-maker 纸样师 --sample-maker 车版师]`（给的 flag 才改；`--collection clear` 解绑系列；人员字段均选填自由文本） |
|
|
98
109
|
| 设款式封面 | `crab atelier style cover <styleId> <本地图片路径>`（png/jpg/webp/gif ≤20MB；走工坊素材中转上传，素材自动进 owner 云盘「服装研发」分类，Web 产品库/详情画册位即显；`--clear` 移除引用素材不删）。封面引用只认工坊素材——云盘直传的通用文件挂不上 |
|
|
99
110
|
| 登记规格 | `crab atelier style edit <id> --colorways 驼色,黑,雾蓝 --sizes S,M,L --craft-notes "领口包边，成衣水洗"`（各项各自整体替换——空数组/空串 = 清空；色板与尺码是商品需要的规格，特殊工艺是生产需要的，Web 详情页即按此分组） |
|
|
100
|
-
| 登记尺寸表 | `crab atelier style edit <id> --size-chart "
|
|
111
|
+
| 登记尺寸表 | `crab atelier style edit <id> --size-chart "衣长:沿肩缝直量:2:S=66,M=68,L=70|胸围::S=100"`（**整体替换**，`clear` = 清空；行间 `\|`，行内 `部位:测量方式:档差:码=值,码=值`——测量方式段可整体省略，档差可省略或显式留空〔`部位::` = 无档差〕，值 0–1000 留空 = 该格不记；尺码列与商品规格联动，先配 `--sizes` 再录尺寸表；Web 信息 tab 04 组同源。部位枚举（KHARITES 纸单）：后中长/肩宽/胸围/腰围/臀围/脚围/袖长/袖肥/袖口围/夹圈/裤长·裙长/脾围/膝围/前浪/后浪/肩带长——Web 下拉选择 + 其他自填，CLI 自由文本均可） |
|
|
101
112
|
|
|
102
113
|
## 供应商目录
|
|
103
114
|
|
|
@@ -128,8 +139,8 @@ flags 的数组）判定：`styles`（款式库）、`records`（记录）、`ma
|
|
|
128
139
|
|
|
129
140
|
| 意图 | 命令 |
|
|
130
141
|
|---|---|
|
|
131
|
-
| 看核算单 | `crab atelier costing <styleId>`（面辅料/工艺/其他成本行 + 单件合计 +
|
|
132
|
-
| 加面辅料行 | `crab atelier material add <styleId> --name "澳毛纱" --category fabric --supplier <id\|前缀\|名称> --ref-price-cents 4800 --qty 0.4 --unit 公斤 [--article-no 货号 --spec 规格 --purpose 主面料 --composition "65%锦35%棉" --width 135 --gsm 70 --loss-pct 15 --pattern-usage 0.27 --colors 黑,橘 --supply-mode 现货\|订纺 --parts 所用部位 --shrinkage "经3%纬3%" --interlining-thickness 30g --note 备注]
|
|
142
|
+
| 看核算单 | `crab atelier costing <styleId>`（面辅料/工艺/其他成本行 + 单件合计 + 工艺说明；面辅料行带成份/门幅/克重/颜色/部位/缩率/烫朴/制版单耗/损耗/提供方式/备注等属性行；rowId 都在这里取。A4 打印单在 Web 款式详情「核算」tab） |
|
|
143
|
+
| 加面辅料行 | `crab atelier material add <styleId> --name "澳毛纱" --category fabric --supplier <id\|前缀\|名称> --ref-price-cents 4800 --qty 0.4 --unit 公斤 [--article-no 货号 --spec 规格 --purpose 主面料 --composition "65%锦35%棉" --width 135 --gsm 70 --loss-pct 15 --pattern-usage 0.27 --colors 黑,橘 --supply-mode 现货\|订纺 --parts 所用部位 --shrinkage "经3%纬3%" --interlining-thickness 30g --note 备注 --image 本地图片路径]…`（--qty/--pattern-usage 小数；**--width 单位 cm、--loss-pct 单位 %**；金额一律 --*-cents 整数分；供应商引用 id/前缀/名称，clear = 解绑；--image 小样图可重复 ≤3 张，material edit 另支持 `--image clear` 清空） |
|
|
133
144
|
| 加工艺行 | `crab atelier process add <styleId> --name "打鸡眼" --qty 100 --price-cents 100 [--requirement 要求 --supplier ... --unit 次]`（金额自动计入成本核算） |
|
|
134
145
|
| 加其他成本 | `crab atelier extra add <styleId> --name "包装" --price-cents 3000 [--qty 1 --unit ...]`（包装/运费/损耗） |
|
|
135
146
|
| 改/删核算行 | `crab atelier material\|process\|extra edit <rowId> [同 add 的 flag，给的才改]` / `… rm <rowId>`（合计随单自动重算；行编辑与 A4 打印单也可在 Web 核算 tab） |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@crabcloud/skills",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.19",
|
|
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": {
|