crimsonblazezero 钉钉知识库 Skill
前置条件 — 执行操作前必读
**CRITICAL — 执行任何
dws操作前，MUST 先用 Read 工具完整读取dws-shared。**该轻量文件包含全局执行契约、安全底线及 shared references 的按需加载导航；不要预加载其全部 references。
命令参考：wiki.md。
Shortcuts（无专用脚本/recipe 时优先）
以下 shortcut 同时进入公开 catalog 与 Runtime Schema。先按本 skill 的意图表、脚本和 recipe 路由：存在精确覆盖该场景的专用脚本/recipe 时按其执行；否则用户意图命中时，shortcut 优先于手写原子命令。用 leaf Schema（例如 dws schema --cli-path "wiki +<shortcut>" --format json）读取 Agent 选择、参数、约束、风险和确认语义；用 dws shortcut list --service wiki --format json 批量发现；最后以 dws wiki <shortcut> --help 核对当前 Cobra flags。
| Shortcut | 风险 | 适用场景 |
|---|---|---|
dws wiki +space-search |
read | 搜索知识库 |
意图表
| 用户说 | 命令 |
|---|---|
| "创建知识库" | dws wiki space create --name "<名称>" [--desc "<描述>"] |
| "搜索组织知识库空间" | dws wiki space search --type orgWikiSpace --query "<关键词>" |
| "我的文档 / 个人知识库" | dws wiki space search --type myWikiSpace |
| "列出知识库" | dws wiki space list |
| "列出我的文档空间" | dws wiki space list --type myWikiSpace |
| "列出知识库里的文件/节点" | dws wiki node list --workspace <WS_ID> |
| "在知识库里搜" | dws wiki node search --workspace <WS_ID> --query "<关键词>" |
| "在知识库里创建文档节点" | dws wiki node create --workspace <WS_ID> --type adoc --name "<名称>" |
标准 SOP（必遵流程）
命中以下意图必须按对应 SOP 顺序执行；禁止跳步、替换命令、编造 workspaceId/nodeId。每条命令必须带
--format json。workspaceId/nodeId一律先查后用。
SOP-1 找知识库（find-space）
触发：找知识库/列表空间/某知识库在哪。
- 执行（必须）：
dws wiki space list --format json（列所有知识库/钉盘空间）；按名称找dws wiki space search --type orgWikiSpace --query "<名称>" --format json。 - 解析（必须）：取真实
workspaceId；多候选让用户确认，禁止默认取第一个。hasMore=true用nextPageToken翻页。
禁止：编造 workspaceId、把空间名当 ID。
SOP-2 浏览 / 查节点（list-nodes）
触发：知识库里有哪些文档/列节点/看某节点。
- 前置（必须）：先按 SOP-1 拿
workspaceId。 - 执行（必须）：
dws wiki node list --workspace <workspaceId> --format json（按需--folder <nodeId>看子节点）；按内容找dws wiki node search --workspace <workspaceId> --query "<关键词>" --format json。 - 解析（必须）：取真实
nodeId+nodeType/type；锁定目标后按需切dingtalk-doc读写节点内容。
禁止：跳过 SOP-1 直接猜 workspaceId、用 node list 替代 node search 做关键词查找。
SOP-3 建节点（create-node）
触发：在知识库建文档/页面。
- 执行（必须）：
dws wiki node create --workspace <workspaceId> --type adoc --name "<名称>" --format json（按需--parent-id <父节点>）；返回取nodeId。 - 写内容（必须）：节点内容编辑切
dingtalk-doc，用dws doc update --node <nodeId> --mode overwrite|append --content-file <tmp.md> --yes；写后doc read回读。 - 验证（必须）：
dws wiki node list --workspace <workspaceId> --format json复核节点已建。
禁止：在 wiki 内直接拼内容（应切 doc 写）、建后不回读。
SOP-4 移动 / 复制 / 删节点（mutate-node）
触发：移动节点/复制节点/删节点。
- 执行（必须）：移动
dws wiki node move --workspace <workspaceId> --node <nodeId> --folder <目标文件夹nodeId> --format json；复制dws wiki node copy --workspace <workspaceId> --node <nodeId> --folder <目标文件夹nodeId> --format json；删除dws wiki node delete --workspace <workspaceId> --node <nodeId>（必须先与用户确认，再加--yes）。 - 验证（必须）：移动/复制后执行
dws wiki node list --workspace <workspaceId> --folder <目标文件夹nodeId> --format json，从真实返回确认目标节点；删除后回查确认节点已不存在或进入回收站。
禁止：未确认就删除、编造 nodeId/folder、把 --node-id / --target-parent-id 当作公开参数。
高频硬约束
space search用--query，不要用--keyword；组织知识库显式加--type orgWikiSpace。- 用户说"我的文档/个人空间/my workspace"时必须用
dws wiki space search --type myWikiSpace --format json；该模式不需要 keyword。 - 用户给空关键词时，不要构造空
--query ""；若语义是我的文档则用--type myWikiSpace，否则请用户补关键词。 - 搜到空间后复用返回的
workspaceId/id；空间内节点创建/列表/搜索用wiki node，具体文档内容读写切到dingtalk-doc，复制/移动切到dingtalk-drive。 - 所有
dws wiki命令加--format json。
跨产品协作
- 知识库内具体文档读写 → 切到
dingtalk-doc - 普通钉盘文件存储及复制移动 → 切到
dingtalk-drive
局部意图与短流程
- 局部意图消歧；短流程。