用途
本 Skill 是知识库健康度审计工作流，用于检查飞书知识空间的文档状态。触发场景包括：「检查一下知识库的状态」「哪些文档过时了」「知识库健康度报告」「审计一下知识库」「有没有很久没更新的文档」「知识库结构分析」「知识库优化建议」「Wiki audit」「清理一下知识库」「哪些文档可能需要更新了」。
该 Skill 与已有 Skill 组成「知识管理三件套」：knowledge-qa 负责搜索问答（使用知识库），doc-summarizer 负责文档摘要（理解知识库），wiki-auditor 负责健康审计（维护知识库）。
主要能力
按工作流顺序，包含以下环节：
- 列出知识空间：通过 wiki spaces list 列出可用空间，如存在多个空间则列出供用户选择。
- 遍历知识节点：通过 wiki spaces nodes list 获取空间根节点下的子节点，并通过 parent_node_token 递归获取子节点的子节点。对每个节点记录 node_token、obj_token、obj_type、title、has_child 以及按递归深度计算的节点层级深度。
- 获取文档元数据：通过 drive metas batch_query 批量获取文档元数据（每次最多 15 个），提取 latest_modify_time、create_time、owner、url。
- AI 健康度分析：包含三部分。
- 过时文档检测：按最后更新距今划分等级，新鲜（< 30 天，🟢）、正常（30-90 天，🟡）、陈旧（90-180 天，🟠）、过时（> 180 天，🔴）。
- 结构分析：层级深度分布（过深 > 4 层不利于发现）、孤立节点（有文档但无子节点也无兄弟节点的叶子节点比例）、空节点（有节点但关联的文档为空或已删除）、目录均衡度（某目录下文档过多 > 20 篇）。
- 覆盖评估：总文档数、按文档类型分布（docx / sheet / bitable 等）、按创建者分布（是否高度集中于少数人）。
- 生成审计报告：报告包含空间信息、健康度评分（内容新鲜度、结构合理性、覆盖完整性三个维度及综合评分）、过时文档清单、新鲜度分布、结构分析、贡献者分布、优化建议。
- 自动创建修复建议 Wiki（可选，v1.0.7+）：可在知识库中创建审计报告节点，将审计报告嵌入知识库便于团队查看和跟踪修复进度。
- 自动修复错位文档（可选，v1.0.10+）：审计发现文档放置位置不合理时，可将错位文档移动到正确目录。
使用方式
前置条件：支持 user 身份，执行前需确保已授权：
lark-cli auth login --domain wiki,drive
开始前必须先用 Read 工具读取 lark-shared/SKILL.md，其中包含认证、权限处理和安全规则。
关键命令示例：
列出所有可见知识空间： lark-cli wiki spaces list --format json
获取空间根节点下的子节点： lark-cli wiki spaces nodes list --params '{"space_id":"<space_id>","page_size":50}' --format json
获取子节点的子节点（递归）： lark-cli wiki spaces nodes list --params '{"space_id":"<space_id>","parent_node_token":"<parent_token>","page_size":50}' --format json
批量获取文档元数据（每次最多 15 个）： lark-cli drive metas batch_query --data '{ "request_docs": [ {"doc_type": "docx", "doc_token": "<token1>"}, {"doc_type": "docx", "doc_token": "<token2>"} ], "with_url": true }' --format json
创建审计报告节点（v1.0.7+ shortcut）： lark-cli wiki +node-create --space-id "<space_id>" --parent-node-token "<parent_token>" --title "知识库审计报告 (<date>)"
移动错位文档（v1.0.10+ shortcut）： lark-cli wiki +move --space-id "<space_id>" --node-token "<misplaced_node_token>" --target-parent-token "<correct_parent_token>"
安全规则：移动文档前必须展示变更计划并获得用户确认。wiki +move 支持异步任务轮询，长时间操作不会超时。
适用场景
适用于需要检查飞书知识空间状态、发现过时文档、分析知识库结构合理性、评估文档覆盖与贡献者分布，以及获得知识库优化建议的场景。
限制与容错
数据量控制：大型知识库可能有数百个节点，建议限制最大遍历深度为 3-4 层，超过时提示用户缩小范围。
容错机制：
- 知识空间无访问权限：提示用户加入空间或联系管理员。
- 节点数量 > 200：限制遍历深度为 2 层，提示用户缩小范围。
- 文档元数据获取失败：记录失败节点，其余正常分析。
- 空间无文档：提示「该知识空间暂无文档」。
- drive 域未授权：无法获取修改时间，仅做结构分析。
权限表：
- 列出空间（wiki spaces list，scope：wiki:wiki:readonly，必选）。
- 遍历节点（wiki spaces nodes list，scope：wiki:wiki:readonly，必选）。
- 文档元数据（drive metas batch_query，scope：drive:drive:readonly，推荐）。
- 创建审计报告（wiki +node-create，scope：wiki:wiki，可选，写入审计结果时）。
- 移动错位文档（wiki +move，scope：wiki:wiki，可选，v1.0.10+）。
参考文档：lark-shared（认证、权限，必读）、lark-wiki（知识空间遍历详细用法）、lark-drive（文档元数据查询）。