30 分钟,让知识库全自动 · 六步实操图文教程

配套《30分钟,让知识库全自动:6 个自动开关 + 一键安装 Skill,你只管往里扔》一文。每一步都有图、有命令、有验收标准,照着做一遍就能跑通。

先跑通 = 第 1、3、6 步 · 第 2、4 步属"这周补齐",可后补 · 做完之后每周维护时间 → 0 · 全部基于 75 页真实知识库实测

先看全貌:六个开关怎么转起来的

你只做这一步:往里扔资料 ① 自动分类 type 八值,不许自造 ③ 织入式更新 动 3–10 页,不存摘要 ④ 自动维护 索引 / 日志 / 报告 ② 每周自动体检 只读脚本 + 定时任务 ⑤ AI 精准检索 规则层 + 带引用回答 ⑥ 自动去重 建页标准 + 新旧更替 你只在它报警时才出手 红色 = 让它自己长 蓝色 = 让它自己干净 绿色 = 闭环
图 1 六个开关的闭环:①②③ 负责"长",④⑤⑥ 负责"干净"

第二步之前:把目录摆成这个样子

我的知识库/ ├── AGENTS.md← 给 AI 的规矩(地基,必须先有) ├── sources/← 原始素材,只读 │ └── 99-收件箱/已摄入/ ├── wiki/← 加工后的知识 │ ├── index.md← 唯一入口,人从这进 │ └── _meta/知识库体检报告.md ├── reports/← 体检快照 + 趋势记录 └── tools/体检.py← 只读体检脚本
图 2 目录骨架:AGENTS.md 在库根,AI 一进门就看得见

六步实操(每步都有验收标准)

先跑 第 1、3、6 步,库就能转起来;第 2、4 步是长期不脏的保障,这周内补上即可。

1
建规则层 先跑通

在库根目录新建 AGENTS.md,写清三层结构、六条红线、三动作、新旧更替。这份文件是写给 AI 看的,不是给你看的。

# 本知识库的 AI 干活规则

## 三层结构
sources/         原始素材,只读,永不修改
wiki/            加工后的知识,AI 负责写
wiki/index.md    唯一入口,人从这进

## 六条红线(违反即停工,先问我再动)
1. sources/ 永不被修改
2. 生产目录没我点头不许动
3. 删文件走回收站,永不硬删
4. 发现矛盾不覆盖 —— 标出来:"与 XX 页冲突:……"
5. log.md 只追加,不改写历史
6. 读不到就说读不到,不许编
验收:把库路径丢给 AI,问它"哪些目录你不能动",它能一字不差背出红线。
2
定死分类口径 这周补

type 只留八个取值,多一个都不许用;同义异名全部收编。这一步直接决定后面检索能不能搜全。

类型装什么
concept概念、原理、认知
entity实体(人、物、工具)
project在跑的项目
playbook能照做的做法、流程、方法论
source原始素材的摘要
log流水、进度记录
index导航、索引页
reference清单、台账(查表用的)
硬规矩:方法 / 流程 / process 一律写成 playbook。
建页标准:只是被顺带提一句的,不建独立页 —— 这是去重的第一道闸门。
3
跑第一次体检 先跑通

写一个只读脚本(或让 AI 帮你写),一条命令跑完,产出三样东西。

python tools/体检.py
产物干什么用
最新报告人从这看,永远是最新的
历史快照每次留一份,能回看"上个月库长什么样"
趋势记录一条一行,让报告自己算"跟上次的差"

查九项:空页、坏链、孤立页、类型标注合不合规、索引和实际页数对不对、索引多久没更新、分类索引在不在、收件箱有没有积压、关键目录丢没丢。

实测基线:75 页库,坏链 0、孤立页 0、类型标注 75/75 合规、健康度 100 分。第一跑多少分不重要,看趋势才有意义。
4
设每周自动体检 这周补

把体检挂成定时任务,让它自己跑、自己写日志、有问题才找你。下面这段任务描述可以直接抄:

给知识库做一次例行体检,只诊断不动手改内容。
1. 先读库根目录的 AGENTS.md 确认边界
2. 运行体检脚本,产出最新报告 + 历史快照 + 趋势记录
3. 读报告顶部「与上次体检对比」,看健康度和新冒出来的问题
4. 在 log.md 末尾追加一条体检记录(只追加,不改写历史)
5. 回报一句话:健康度多少、有没有新问题、要不要我出手

红线:只报不改。体检发现的问题一律不动手修,
等我点头再改;sources/ 只读;删文件走回收站。
铁律:只报不改。体检发现问题一律不动手,等你点头 —— 自动改的库一定越改越乱。
5
换成织入式摄入 日常

不是"存摘要",是把新信息织进老页面。判断标准很硬:一次摄入只动了 1 页,就是没想透,重做。

① 通读素材 → 口头过一遍要点(30 秒,别省)
② 新建或更新 3–10 页 —— 关键是找到它跟老页面的关系
③ 更新总索引 + 对应分类索引 + 追加日志
④ 源文件归档到「已摄入」
⑤ 记一笔:新建 X 页 / 更新 Y 页 / 发现 Z 处矛盾
真跑过的一次:一份存了 40 天、引用数为 0 的手册 → 新建 2 页、更新 6 页、标出 4 处新旧口径冲突(一条都没覆盖,全标"两说并存,以现行为准")。
6
装技能包,把流程固化进 AI 先跑通 · 60 秒

把三动作 SOP、分类口径、红线封装成 Skill,AI 以后不用你每次重新交代。想先跑通的,其实可以第一步就装它——装完后面几步 AI 都会照着做。三步:

1. 在 skills 目录下建 kb-closed-loop/ 文件夹
2. 把 Skill 正文写进该目录的 SKILL.md
3. 以后只说三句话:「收资料」「查库」「体检」
你说它干
把这份资料收进库自动跑摄入 SOP,回你"新建 X 页 / 更新 Y 页 / 发现 Z 处冲突"
库里有没有讲 XX 的带引用回答,并问你要不要存成新页
体检跑脚本,只报不改,有问题才找你
检索能准,靠的不是模型变聪明,是规则层:
读 index → 定位 2–5 页 → 逐页读 → 带引用回答 → 问要不要存新页

为什么 AI 以前找不到你的东西

读 index.md 从唯一入口进 定位 2–5 页 不全文乱扫 逐页读原文 读过才许说 带引用回答 读不到就说读不到 没有规则层时,AI 是进了一个没路牌的仓库 —— 它只能猜,猜完还编 装上规则层之后,检索变成这条固定路径,幻觉不是被模型治好的,是被规则治好的
图 3 检索四步固定路径,写进 AGENTS.md 的"动作②"

六个坑,照着避

#坑怎么避
1没写规矩就开工先写 AGENTS.md 再干活,否则同一个活三次三个样
2分类越分越细控制在 8 个以内,分到 15 类你就再也找不到东西了
3摘要式摄入看这次摄入动了几页,只动 1 页就重做
4发现问题随手改只报不改,批量改动先过脑子,不然越改越乱
5冲突时图省事覆盖标出来别删 —— 删掉旧的同时把"为什么改"也删了
6把体检当一次性动作设成每周自动跑,看趋势才有意义