@crabcloud/skills 0.1.19 → 0.1.21

package/dist/skills/crabcloud-atelier/SKILL.md

@@ -106,6 +106,7 @@ flags 的数组）判定：`styles`（款式库）、`records`（记录）、`ma
 | 款式建档 | `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`） |
 | 归档款式 | `crab atelier style archive <styleId>` / `crab atelier style restore <styleId>`（幂等无删除；归档款详情仍可看，时间线落归档句） |
 | 编辑款式 | `crab atelier style edit <id> --stage 生产 [--pattern-maker 纸样师 --sample-maker 车版师]`（给的 flag 才改；`--collection clear` 解绑系列；人员字段均选填自由文本） |
+| 关联加工厂 | `crab atelier style create/edit <...> --factory <加工厂id\|名称>`（值引用供应商目录 type='factory'；`--factory clear` 解绑；面辅料型供应商会被拒；详情 03 生产信息与制单建单默认带出） |
 | 设款式封面 | `crab atelier style cover <styleId> <本地图片路径>`（png/jpg/webp/gif ≤20MB；走工坊素材中转上传，素材自动进 owner 云盘「服装研发」分类，Web 产品库/详情画册位即显；`--clear` 移除引用素材不删）。封面引用只认工坊素材——云盘直传的通用文件挂不上 |
 | 登记规格 | `crab atelier style edit <id> --colorways 驼色,黑,雾蓝 --sizes S,M,L --craft-notes "领口包边，成衣水洗"`（各项各自整体替换——空数组/空串 = 清空；色板与尺码是商品需要的规格，特殊工艺是生产需要的，Web 详情页即按此分组） |
 | 登记尺寸表 | `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 自由文本均可） |

package/dist/skills/crabcloud-wiki/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: crabcloud-wiki
+description: Organization knowledge base (LLM wiki) via the `crab wiki` CLI — navigate by index (root index → section index → document, no RAG), ingest material as structured markdown documents with one-line summaries, cross-link related pages, grant per-node read/write access to members, run structure lint, export the whole library as a skill-references style folder. Use when the user asks anything about their knowledge base or internal docs: 知识库、wiki、内部资料、文档库、资料库、归档、整理资料、索引、目录、摘要、手册、交接文档、产品资料、制度、know-how、导入文档、整理 PDF、授权、可读可写、体检、时间线 — even if they never say "crab".
+---
+
+# Wiki 知识库（crab wiki）
+
+组织内部资料的典藏馆：**索引进正文，分册按需读**。目录与文档都是节点，每个
+节点必有一行摘要——摘要就是父目录索引里的一行。全库默认私有，文件按人授权
+（可读 / 可写两档；目录授权对整棵子树生效）。这是 Karpathy llm-wiki 模式的
+组织级实现：**你是维护者**——摄取、回链、体检都是你的活，维护负担由你承担。
+
+跨域时参考：邮件 `crabcloud-mail`、云盘 `crabcloud-storage`、协作
+`crabcloud-collab`、店铺 `crabcloud-shop`、人事行政 `crabcloud-hr`、平台账号
+`crabcloud`。
+
+## 三操作：ingest / query / lint
+
+**query（查）**：回答问题先读索引，禁止整库扫读——
+`crab wiki read root`（根索引）→ 看中条目 → `crab wiki read <路径>`（目录出
+索引、文档出正文）→ 顺「相关页面」扩展。综合类答案值得归档：写成新文档
+（如「综合/」目录下），让探索也复利。
+
+**ingest（摄）**：把一份材料整理入库——读原文 → 和用户确认要点 → 找挂载
+目录（没有合适的先建目录）→ `crab wiki add` 写入 → `crab wiki link` 回写
+相关页 → `crab wiki lint` 收尾。一次摄入一个源，保持参与。实战细节（多文件、
+去重、frontmatter）按 **`references/ingest-playbook.md`** 指路（同目录分册）。
+
+**lint（体检）**：改动后 `crab wiki lint`——空摘要、空目录、悬挂互链、跨层
+重名、stale 候选；矛盾与过时断言这类语义体检按用户要求做。
+
+## 第一步：确认可用
+
+- 运行 `crab --version` 确认已安装。`crab` 命令缺失时先 `npx @crabcloud/cli init`
+  （只登录 + 装 skill、不含命令本体）；已装但缺 `wiki` 命令用
+  `npx @crabcloud/cli@latest init` 升级。不想装全局则整段跳过，下文所有
+  `crab <命令>` 直接 `npx @crabcloud/cli <命令>` 等价执行。
+- `crab whoami` 报「未登录」或退出码 3 → 引导用户 `crab login`。wiki 命令
+  还要求令牌绑定知识库：`crab login --scopes wiki --org org:<名称>`（授权页
+  批准后生效；`crab wiki orgs` 看绑定与列表）。
+- 退出码：0 成功 · 2 用法错误 · 3 认证失效 · 4 scope/绑定不足 · 5 资源不存在。
+
+## 命令表
+
+| 意图 | 命令 |
+| --- | --- |
+| 我的库 | `crab wiki orgs` |
+| 看结构 | `crab wiki tree`（穿越容器标「部分可见」；✎可写 👁可读） |
+| 看一层 | `crab wiki ls <id\|路径>` |
+| 读 | `crab wiki read <id\|路径>`（目录出索引 markdown，文档出正文） |
+| 建目录 | `crab wiki add-dir --parent <id\|路径> --title <标题> --summary <一行摘要> [--description 前言]` |
+| 建文档 | `crab wiki add --parent <id\|路径> --title <标题> --summary <一行摘要> [--content-file <md\|-]` |
+| 改 | `crab wiki edit <id\|路径> [--title] [--summary] [--content-file <md\|-]` |
+| 移动 | `crab wiki mv <id\|路径> --parent <id\|路径\|root> [--before <同级id>]` |
+| 互链 | `crab wiki link <id\|路径> --to <id\|路径> [--unlink]` |
+| 授权 | `crab wiki grant <id\|路径> --to <用户名> [--write]` |
+| 收权 | `crab wiki revoke <id|路径> --from <用户名>` |
+| 权限 | `crab wiki acl <id\|路径>`（我的档位与来源 + 直授名单） |
+| 体检 | `crab wiki lint` |
+| 时间线 | `crab wiki log [--limit N]`（owner 专属） |
+| 传图 | `crab wiki upload <文件>`（返回正文引用片段） |
+| 导出 | `crab wiki export [--out 目录]`（每层 INDEX.md + AGENTS.md，可直接挂给 agent） |
+| 导入 | `crab wiki import <本地md目录> [--parent <id|路径>] [--dry-run]` |
+
+寻址统一 `<id|路径>`：索引行尾的 `(wn_…)` 是 id；路径用标题分段（`产品资料/
+安装部署`）；裸标题全库唯一命中也可用，多命中会列候选要求消歧。
+
+## 机器可读输出（--json）
+
+所有命令支持 `--json`（结构化 data 直出）。程序化消费一律加 `--json` 解析
+stdout，不要解析人类可读格式；`tree`/`log` 的文本款仅供人看。
+
+## 纪律
+
+1. **先读索引再下钻**——索引进正文是这个库的消费协议；不要 `--json` 整库
+   拉取后自行排序检索。
+2. **摘要必填且写好**——它出现在父目录索引里，写给「决定要不要读的人」；
+   禁「各种说明」「相关资料」这类空词。
+3. **正文不重复 H1 标题**——页面与索引已经展示标题，正文从引言写起。
+4. **超长拆分**——单文档上限 100k 字符，到不了就该拆：一个主题一个节点，
+   目录即分类。
+5. **ingest 后回链**——新文档与既有相关页面互 `link`，保持知识网连通。
+6. **权限不绕过**——你以绑定成员的身份行事，成员看不到的你也不该看；
+   需要访问就引导用户找 Owner 开授权（`crab wiki grant`）。
+7. **写前复述**——创建/编辑前向用户复述：标题、摘要、挂载目录；批量导入
+   先 `--dry-run` 给用户过目。

package/dist/skills/crabcloud-wiki/references/ingest-playbook.md

@@ -0,0 +1,46 @@
+# ingest 实战手册（crabcloud-wiki 分册）
+
+何时读本文：用户给了一份或多份原始材料（PDF 导出文本、网页剪存、会议记录、
+现成 markdown 目录）让你「放进知识库 / 整理归档」。CLI 主管道见 SKILL.md，
+本文只管摄入实战。原文件（PDF/图片）本身**不进** wiki——wiki 只收整理好的
+markdown；原文件留在云盘（`crabcloud-storage`）或本地。
+
+## 单份材料（默认路径）
+
+1. **读原文**，提炼结构：这份材料讲什么？分几个主题？哪些值得留？
+2. **与用户确认**：挂到哪个目录、文档怎么拆（一个主题一个节点）、有没有
+   不该入库的内容。
+3. **找挂载点**：`crab wiki read root` → 逐层读目录索引。没有合适目录就
+   先 `crab wiki add-dir`（目录也是节点，同样要有摘要）。
+4. **写入**：`crab wiki add --parent <id|路径> --title <标题> --summary <一行摘要>
+   --content-file <整理好的.md>`。正文用 markdown（标题/列表/表格/代码）；
+   首行不要重复 `# 大标题`（标题已在页眉）。
+5. **回链**：`crab wiki link <新文档> --to <相关文档>`（双向信息用两条 link）。
+   相关页也可以补一条反向 link。
+6. **收尾**：`crab wiki lint`；有 stale/空目录顺手处理。
+
+## 多份材料 / 现成目录
+
+材料已是一组 markdown 文件（比如另一次导出）：
+
+1. 先摆目录镜像给用户确认：`crab wiki import <目录> --dry-run`
+   （子目录 → 目录，`.md` → 文档；标题取 frontmatter `title:` 或文件名；
+   摘要取 frontmatter `summary:` 或首段）。
+2. 目录默认描述：各子目录放一个 `README.md`，首段会作为该目录的「前言」
+   显示在它的索引顶部。
+3. 确认后去掉 `--dry-run` 真跑。**同名冲突会整条失败**（wiki.titleTaken）——
+   二次导入同一目录前先改标题或清理旧节点。
+
+## 去重与归并
+
+- 入库前先查重：`crab wiki read <疑似已有主题>`——已有文档就「增补」而非
+  新建（`crab wiki edit --content-file`，注意乐观锁：冲突时重读再改）。
+- 同主题多来源：并成一个文档，来源差异写进正文「来源与差异」小节；
+  不要一来源一节点。
+
+## 与用户确认的口径
+
+- 拆分粒度：默认「一个主题一个节点」；用户没意见就不要一次问拆分细节。
+- 摘要写法：一句话说清「这是什么 + 什么时候读它」，≤200 字，无空词。
+- 敏感内容：知识库默认私有但仍确认「这份要进库吗、给谁看」；入库后用
+  `crab wiki grant` 圈人（目录授权 = 整棵子树）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crabcloud/skills",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "type": "module",
   "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.",
   "bin": {