knowledge-audit
对钉钉知识库进行系统性诊断审计,支持轻量级审计和深度审计两种模式, 输出文档健康度评估、分类规划和知识地图索引文档。 Use when user mentions "审计知识库", "知识库体检", "盘一盘文档", "文档太乱了", "帮我理一理文档", "哪些文档过期了", "建个文档索引", "生成知识地图", or asks to "诊断文档质量", "规划目录结构", "看看哪些文档该清
SKILL.mdqwenwork/skills/knowledge-audit/SKILL.md
GitHub知识库审计
对钉钉知识库进行系统性诊断,支持两种审计模式,输出审计报告与知识地图索引。定位为"诊断 + 规划",不承诺自动移动文件。
禁止事项
- 禁止通过 curl、HTTP API 等非
dws方式操作钉钉产品 - 禁止凭空构造 nodeId、UUID 等标识符,所有 ID 必须从实际命令返回值中获取
- 禁止
dws命令不加--format json - 禁止在未读取文档证据前直接给出分类结论
- 禁止把"建议迁移"写成"已完成移动"——本技能不执行文档移动
- 禁止未经用户确认执行写入操作;
doc update --mode overwrite会清空原内容,风险极高,除非用户明确要求否则只用 append - 禁止遇到子文件夹就跳过——必须递归扫描子文件夹内的文档
强制要求
- 每条
dws命令均须携带--format json参数 - 范围确认和审计模式选择不可跳过
- 所有分类结论必须有已读取的文档证据支撑
- Module A 完成后必须向用户展示诊断摘要,确认后再进入 Module B
- Module B 目录方案确认后,才能进入 Module C 索引生成
- 扫描文件夹时必须递归处理子文件夹(
type=folder的节点继续doc list --folder)
能力清单
| 动作 | 安全等级 | 说明 |
|---|---|---|
| 范围与模式确认 | 只读 | 确认目标范围 + 审计模式(轻量/深度) |
| 文档扫描与诊断 | 只读 | doc list/search + doc info + doc read,递归扫描子文件夹 |
| 目录方案设计 | 只读 | 根据分类结果设计目录结构(不实际创建) |
| 目录创建 | 写入 | 用户确认方案后创建分类文件夹(需用户确认) |
| 知识地图生成 | 写入 | 创建索引文档并写入审计结果(需用户确认) |
涉及工具
| 工具 | 用途 | 参考文件 |
|---|---|---|
dws doc |
搜索、递归列出、读取、建目录、写索引 | command-recipes.md |
环境前置:连接器依赖
本技能依赖以下连接器和技能,使用前需确保已就绪:
- DingTalk (DWS) 连接器(
qwenwork.settings.connector.builtin.dws):提供钉钉文档读写能力。未连接时所有dws doc命令将失败。 - dws 技能:提供
dwsCLI 命令的使用指引。
前置检查步骤(在检查点 0 之前执行):
qw_query qwenwork.settings.connector.builtin.dws确认enabled: true且authenticated: true。- 若未连接,用
qw_action connect引导用户完成钉钉 OAuth 登录,或提示用户在「设置 → 连接器」中手动开启。 - 确认
dws技能已安装(qw_query qwenwork.settings.skills)。 - 前置检查失败时,停止执行并告知用户需先启用 DWS 连接器。
总体工作流
用户: "帮我审计一下知识库"
|
v
⏸ 检查点 0: 范围与模式确认(三选一 + 两选一)
范围: ① 个人文档空间(默认)② 指定知识库/文件夹(需提供链接)③ 关键词搜索
模式: ① 轻量级审计(快速,基于标题+元数据)② 深度审计(精确,逐篇读取+摘要)
|
v
Module A: 文档扫描与诊断 → ⏸ 检查点 1(用户确认诊断摘要)
|
v
Module B: 目录规划 → ⏸ 检查点 2(用户确认目录方案)
|
v
Module C: 落地索引文档 → 返回文档链接
检查点 0 — 范围与模式确认(不可跳过)
审计范围(向用户提供三个选项):
| 选项 | 说明 | 对应操作 |
|---|---|---|
| ① 个人文档空间(默认) | 审计我的个人知识库 | dws doc list --format json 从根目录开始递归 |
| ② 指定知识库或文件夹 | 需提供知识库首页链接或文件夹链接 | dws doc list --folder "{URL}" --format json 从该目录递归 |
| ③ 关键词搜索 | 搜索特定标题的文档 | dws doc search --keyword "{关键词}" --format json |
审计模式(向用户提供两个选项):
| 模式 | 速度 | 精确度 | 适用场景 | 核心差异 |
|---|---|---|---|---|
| 轻量级审计 | 快 | 中等 | 快速摸底、文档数多 | 仅用标题+元数据分类和去重 |
| 深度审计 | 慢 | 高 | 精确诊断、文档数适中 | 逐篇 doc read + AI 摘要,基于内容分类和去重 |
Module A — 文档扫描与诊断
目标: 扫描目标范围内所有文档(含子文件夹),产出健康度评分和分类结果。
- A1 文档扫描: 按检查点 0 确定的范围获取文档列表。遇到
type=folder的节点,递归doc list --folder继续扫描子文件夹,详见 references/command-recipes.md 递归策略 - A2 元数据采集: 对每篇文档
dws doc info --node "{docUrl}" --format json,提取 title/type/creator/updatedAt - A3 内容采集(仅深度模式): 对每篇文档
dws doc read --node "{docUrl}" --format json,生成 ≤ 100 字摘要,存入分析上下文 - A4 健康度评估: 按 references/health-model.md 评分模型打分(A/B/C/D 四档)
- A5 分类诊断: 轻量模式按标题+类型分类;深度模式按摘要内容分类。分类动态生成,不硬编码
- A6 问题识别: 轻量模式按标题重合度 > 80% 标记疑似重复;深度模式按摘要相似度标记内容重复
⏸ 检查点 1: 展示诊断摘要(文档总数、健康度分布、分类数量、主要问题),用户确认后继续。
Module B — 目录规划
目标: 根据分类结果设计目标目录结构和迁移清单。
- B1 目录设计: 根据 A5 分类结果设计目录树,每个目录附定义和归入规则
- B2 迁移清单: 列出待迁移文档(原位置 → 建议目标 → 原因)
- B3 处理清单: 列出待处理文档(过期/重复/标题不规范 → 建议操作 → 优先级)
⏸ 检查点 2: 展示完整目录方案和清单,用户确认(可调整目录名称/合并拆分分类)后继续。
Module C — 落地索引文档
目标: 创建目录结构和知识地图索引文档。
- C1 创建目录:
dws doc folder create --name "{分类名}" --workspace "{ID}" --format json,提取 docUrl - C2 创建索引:
dws doc create --name "{知识库}审计报告与知识地图 {YYYY-MM}" --format json,提取 docUrl - C3 写入内容:
dws doc update --node "{docUrl}" --content "{内容}" --content-format markdown --mode append --format json,按 references/index-template.md 结构分块写入(每块 ≤ 1500 字符) - C4 返回链接: 返回索引文档链接 + 审计核心数据摘要
关键陷阱:
- markdown 内容禁止以
#一级标题开头——doc create --name已设置文档标题 - markdown 参数中的换行必须使用真实换行符(U+000A),不能使用字面量
\n - 索引文档中避免 ASCII Art 架构图——钉钉文档等宽字体不保证对齐,用表格或列表替代
上下文传递表
| 阶段 | 从返回中提取 | 用于 |
|---|---|---|
| 检查点 0 | 审计范围、审计模式 | 指导 A1 扫描方式和 A3 是否启用 |
A1: doc list(递归) |
docUrl、title、type | type=folder 继续递归;type=file 进入 A2 |
A2: doc info |
title、type、creator、updatedAt | A4 健康度 + A5 分类 |
A3: doc read(深度模式) |
markdown → AI 摘要 | A5 内容分类 + A6 内容去重 |
C1: doc folder create |
新目录 docUrl | C3 索引导航 |
C2: doc create |
索引文档 docUrl | C3 doc update --node |
意图映射
| 用户说 | 线索 | 映射功能 |
|---|---|---|
| "审计一下知识库" / "知识库体检" | 审计/体检 | 完整流程,检查点 0 确认模式 |
| "文档太乱了" / "找不到东西了" | 问题驱动 | 完整流程,强调分类 + 目录规划 |
| "帮我给文档分个类" / "规划目录结构" | 分类/目录 | Module A→B,分类规划模式 |
| "哪些文档过期了" / "有多少陈旧文档" | 过期/陈旧 | Module A(健康度),过期清理模式 |
| "仔细看看每篇文档内容" / "深度审计" | 深度/内容 | 完整流程,强制深度模式 |
| "快速扫一下" / "先大致看看" | 快速/大致 | 完整流程,强制轻量模式 |
| "生成知识地图" / "建一个文档索引" | 地图/索引 | 完整流程,侧重 Module C |
易混淆场景
| 用户说 | 线索 | 应路由到 |
|---|---|---|
| "帮我重写这篇文档" | 修改正文内容 | 通用 doc 写作能力 |
| "帮我搜一下XX文档" | 单次检索 | 直接 dws doc search |
| "把文档移到XX文件夹" | 实际移动 | 需人工操作(暂无 doc move) |
| "帮我做竞品分析" | 研究报告产出 | competitive-analysis |
使用示例
示例 1: 深度审计
用户说: "帮我深度审计一下某项目知识库" 执行步骤:
- 检查点 0: 范围(某项目知识库链接),模式(深度审计)
- Module A: 递归扫描含子文件夹 → 逐篇 doc read + 摘要 → 基于内容分类和去重
- ⏸ 展示诊断摘要,用户确认
- Module B→C: 目录规划 → 索引文档 期望输出: 含内容摘要的精确审计报告
示例 2: 轻量扫描个人空间
用户说: "快速看看我的文档情况" 执行步骤:
- 检查点 0: 范围(个人文档空间),模式(轻量级)
- Module A: 递归扫描 → 标题+元数据分类
- ⏸ 展示诊断摘要 期望输出: 快速概览 + 健康度分布
示例 3: 最简触发
用户说: "文档太乱了" 执行步骤:
- 追问范围和模式(展示三选一 + 两选一选项)
- 确认后执行对应流程 期望输出: 确认后生成审计报告
错误处理
| 错误 | 原因 | AI 应该怎么做 |
|---|---|---|
doc search 结果为空 |
关键词过窄 | 换更宽泛的关键词重试;仍无结果建议 doc list |
doc info 字段缺失 |
权限不足 | 基于已有字段评估,标注"元数据不完整" |
doc read 无权限(403) |
文档访问限制 | 深度模式降级为标题分类,标注"无法读取正文" |
| 递归深度超过 5 层 | 文件夹嵌套过深 | 停止该分支递归,标注"深层文件夹未扫描" |
| 文档总数超过 200 篇 | 大规模知识库 | 轻量模式分批;深度模式建议缩小范围或改用轻量 |
doc folder create 失败 |
重名冲突 | 换名重试;仍失败则跳过,仅输出方案 |
详细参考(按需读取)
- references/command-recipes.md — DWS 命令模板、递归扫描策略与参数说明
- references/health-model.md — 文档健康度评分模型与两种模式差异详解
- references/index-template.md — 知识地图索引文档写入模板