钉钉文档技能

负责钉钉知识库和文档的所有操作。本文件为策略指南，仅包含决策逻辑和工作流程。完整 API 请求格式见文末「references/api.md 查阅索引」。

dt_helper.sh 位于本 SKILL.md 同级目录的 scripts/dt_helper.sh。

核心概念

• 知识库（Workspace）：文档容器，有 workspaceId 和 rootNodeId
• 节点（Node）：文件或文件夹，type 为 FILE 或 FOLDER
• 文档标识（用于 /v1.0/doc/suites/documents/{id}）：可用 docKey 或 dentryUuid
  • 创建文档响应会返回：docKey、dentryUuid、nodeId
  • 其中 docKey / dentryUuid 可用于读写正文；nodeId 用于删除和文档管理类接口
  • wiki/nodes 返回的 nodeId 实际上是 dentryUuid，可直接用于正文读写
• operatorId：所有接口必须的 unionId 参数，通过 bash scripts/dt_helper.sh --to-unionid 自动转换

工作流程（每次执行前）

1. 先识别本次任务类型 → 例如：列知识库、读文档、写文档、创建文档、成员管理
2. 按本次任务校验所需配置 → 通过 bash scripts/dt_helper.sh --get KEY 读取；仅校验本任务必须项
3. 仅收集缺失配置 → 若缺少某项，一次性询问用户所有缺失值，用 bash scripts/dt_helper.sh --set KEY=VALUE 写入