钉钉知识库 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），在当前 Cobra flags 不确定时读取 dws wiki <shortcut> --help。仅当现有路由和 reference 都无法定位低频能力时，才用 dws shortcut list --service wiki --format json 批量发现。

意图表

标准 SOP（必遵流程）

命中以下意图必须按对应 SOP 顺序执行；禁止跳步、替换命令、编造 workspaceId/nodeId。每条命令必须带 --format json。workspaceId/nodeId 一律先查后用。

SOP-1 找知识库（find-space）

触发：找知识库/列表空间/某知识库在哪。

1. 执行（必须）：dws wiki space list --format json（列所有知识库/钉盘空间）；按名称找 dws wiki space search --type orgWikiSpace --query "<名称>" --format json。
2. 解析（必须）：取真实 workspaceId；多候选让用户确认，禁止默认取第一个。hasMore=true 用 nextPageToken 翻页。

禁止：编造 workspaceId、把空间名当 ID。

SOP-2 浏览 / 查节点（list-nodes）

触发：知识库里有哪些文档/列节点/看某节点。

1. 前置（必须）：先按 SOP-1 拿 workspaceId。
2. 执行（必须）：dws wiki node list --workspace <workspaceId> --format json（按需 --folder <nodeId> 看子节点）；按内容找 dws wiki node search --workspace <workspaceId> --query "<关键词>" --format json。
3. 解析（必须）：取真实 nodeId + nodeType/type；锁定目标后按需切 dingtalk-doc 读写节点内容。

禁止：跳过 SOP-1 直接猜 workspaceId、用 node list 替代 node search 做关键词查找。

SOP-3 建节点（create-node）

触发：在知识库建文档/页面。

1. 执行（必须）：dws wiki node create --workspace <workspaceId> --type adoc --name "<名称>" --format json（按需 --parent-id <父节点>）；返回取 nodeId。
2. 写内容（必须）：节点内容编辑切 dingtalk-doc，用 dws doc update --node <nodeId> --mode overwrite|append --content-file <tmp.md> --yes；写后 doc read 回读。
3. 验证（必须）：dws wiki node list --workspace <workspaceId> --format json 复核节点已建。

禁止：在 wiki 内直接拼内容（应切 doc 写）、建后不回读。

SOP-4 移动 / 复制 / 删节点（mutate-node）

触发：移动节点/复制节点/删节点。

1. 执行（必须）：移动 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）。
2. 验证（必须）：移动/复制后执行 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

局部意图与短流程

• 局部意图消歧；短流程。