前言¶

ima 知识库（ima.qq.com）用久了通常会有两类问题：一是文件夹层次随意，同一个主题的资料散落在不同层级；二是命名和标签各写各的，检索时只能靠关键词碰运气。手动整理的问题是，一旦目录结构调整，原有的引用和习惯都要跟着改，成本高、收益不确定，所以多数情况是”知道乱，但不知道从哪下手”。

下面介绍的这个 Skill 就是针对这个场景的：它不直接动手改你的库，而是先做一次只读诊断，输出一份包含文件夹结构、命名规范、标签体系和归位映射表的整理蓝图，再由你决定哪些步骤真正执行。

这是什么¶

「ima知识库自动整理」是一个面向 ima 知识库的智能整理与规范化 Skill，由社区作者 user_8dd18822 发布（作者署名：安全理论公众号，作者自用），发布在 SkillHub 上，坐标 @user_8dd18822/ima-auto-organizer，版本 1.0.0，分类 knowledge-management，来源标记为 community。

它要解决的问题是：知识库结构缺乏规范时，先量化地看出”乱在哪、乱到什么程度”，再给出一套可落地的整理方案，而不是靠感觉重排目录。

触发方式¶

这个 Skill 是按语义触发的。当你在对话中提到下列说法时，它会介入：

知识库整理、知识库归档、知识库分类、整理知识库、知识库太乱、
知识库重命名、知识库标签规范、知识库归位、清理知识库根目录、
建立知识库体系

也就是说，它既覆盖”整理”这类宽泛请求，也覆盖”重命名”“标签规范”这类具体动作。

核心能力¶

按官方简介，能力分成四个环节，依次衔接。

1. 递归扫描知识库结构

从根目录开始逐层向下读取现有结构，得到一份当前目录与文件的全貌。这一步是只读的，不会改动任何内容。

2. 诊断打分

对扫描结果给出量化诊断，维度包括：散乱程度、命名规范程度、层级深度、重复内容、类型混杂情况。打分的作用是让”乱”变成一个可比较的指标，而不是一句主观评价。

3. 生成整理蓝图

基于诊断结果输出四部分内容：

• 文件夹结构：建议的目标目录划分
• 命名规范：统一后的文件命名规则
• 标签体系：一套可复用的标签集合
• 归位映射表：每个现有条目建议移动到哪个位置

蓝图本身是一份可回写的「知识地图」文档，可以脱离客户端单独查看和评审。

4. 执行与手动清单

对于 API 支持的写操作，在用户确认后自动执行；对于 API 无法覆盖的部分，产出一份 ima 客户端手动执行清单，照着在客户端里操作即可。

默认只读，写操作需确认¶

这是它与一般”整理类”脚本最大的差别。默认模式只做诊断，不产生任何写入。任何写操作之前都必须经过用户确认，不会因为一次”整理”请求就静默移动大量文件。

对知识库里有长期积累、历史引用较多的使用者来说，这个边界是必要的：先看清诊断结果和归位映射表，判断这套划分是否真的适合自己，再决定是否动手。

安装与启用¶

官方资料中未给出具体的安装命令或配置字段，本文不做推测。已知的前置条件有两点：

• 该 Skill 带有 requires_api_key=true 标签，需要先准备好可用的 API Key。
• 目标环境是 ima 知识库，且需要通过 SkillHub 平台获取该 Skill（坐标 @user_8dd18822/ima-auto-organizer）。

安装与启用的具体步骤，建议以 SkillHub 页面和客户端内的引导为准。

适合谁、需要注意什么¶

适合的场景：

• 知识库已经积累到一定量，能明显感到检索困难、层级混乱
• 希望先看到诊断结果再决定是否调整结构，而不是直接动手
• 需要统一命名和标签规范，且希望规范能落实到归位映射表里
• API 覆盖不到的部分，愿意按手动清单在客户端里完成

需要注意的地方：

• 诊断打分依赖现有结构，库内条目很少时参考价值有限
• 归位映射表是建议方案，不保证与个人使用习惯完全一致，执行前应逐条复核
• 写操作受 API 能力限制，超出范围的部分仍需人工完成，不是端到端全自动
• 该 Skill 来源标记为 community，发布说明中写明作者自用，选用前建议自行验证与自身知识库结构的匹配度

小结¶

它的价值不在于替你重排目录，而在于把”知识库有点乱”这个模糊判断，拆成一次可核对的只读诊断加一份结构化的整理蓝图：哪里散、命名差在哪、重复有多少，以及每个条目该往哪儿放。写操作交给你确认，读不出来的部分交给手动清单。

官方地址：https://api.skillhub.cn/user_8dd18822/ima-auto-organizer
SkillHub 页面：https://www.skillhub.cn/skills/user_8dd18822/ima-auto-organizer