配套《30分钟,让知识库全自动:6 个自动开关 + 一键安装 Skill,你只管往里扔》一文。每一步都有图、有命令、有验收标准,照着做一遍就能跑通。
AGENTS.md 在库根,AI 一进门就看得见先跑 第 1、3、6 步,库就能转起来;第 2、4 步是长期不脏的保障,这周内补上即可。
在库根目录新建 AGENTS.md,写清三层结构、六条红线、三动作、新旧更替。这份文件是写给 AI 看的,不是给你看的。
# 本知识库的 AI 干活规则 ## 三层结构 sources/ 原始素材,只读,永不修改 wiki/ 加工后的知识,AI 负责写 wiki/index.md 唯一入口,人从这进 ## 六条红线(违反即停工,先问我再动) 1. sources/ 永不被修改 2. 生产目录没我点头不许动 3. 删文件走回收站,永不硬删 4. 发现矛盾不覆盖 —— 标出来:"与 XX 页冲突:……" 5. log.md 只追加,不改写历史 6. 读不到就说读不到,不许编
type 只留八个取值,多一个都不许用;同义异名全部收编。这一步直接决定后面检索能不能搜全。
| 类型 | 装什么 |
|---|---|
concept | 概念、原理、认知 |
entity | 实体(人、物、工具) |
project | 在跑的项目 |
playbook | 能照做的做法、流程、方法论 |
source | 原始素材的摘要 |
log | 流水、进度记录 |
index | 导航、索引页 |
reference | 清单、台账(查表用的) |
方法 / 流程 / process 一律写成 playbook。写一个只读脚本(或让 AI 帮你写),一条命令跑完,产出三样东西。
python tools/体检.py
| 产物 | 干什么用 |
|---|---|
| 最新报告 | 人从这看,永远是最新的 |
| 历史快照 | 每次留一份,能回看"上个月库长什么样" |
| 趋势记录 | 一条一行,让报告自己算"跟上次的差" |
查九项:空页、坏链、孤立页、类型标注合不合规、索引和实际页数对不对、索引多久没更新、分类索引在不在、收件箱有没有积压、关键目录丢没丢。
把体检挂成定时任务,让它自己跑、自己写日志、有问题才找你。下面这段任务描述可以直接抄:
给知识库做一次例行体检,只诊断不动手改内容。 1. 先读库根目录的 AGENTS.md 确认边界 2. 运行体检脚本,产出最新报告 + 历史快照 + 趋势记录 3. 读报告顶部「与上次体检对比」,看健康度和新冒出来的问题 4. 在 log.md 末尾追加一条体检记录(只追加,不改写历史) 5. 回报一句话:健康度多少、有没有新问题、要不要我出手 红线:只报不改。体检发现的问题一律不动手修, 等我点头再改;sources/ 只读;删文件走回收站。
不是"存摘要",是把新信息织进老页面。判断标准很硬:一次摄入只动了 1 页,就是没想透,重做。
① 通读素材 → 口头过一遍要点(30 秒,别省) ② 新建或更新 3–10 页 —— 关键是找到它跟老页面的关系 ③ 更新总索引 + 对应分类索引 + 追加日志 ④ 源文件归档到「已摄入」 ⑤ 记一笔:新建 X 页 / 更新 Y 页 / 发现 Z 处矛盾
把三动作 SOP、分类口径、红线封装成 Skill,AI 以后不用你每次重新交代。想先跑通的,其实可以第一步就装它——装完后面几步 AI 都会照着做。三步:
1. 在 skills 目录下建 kb-closed-loop/ 文件夹 2. 把 Skill 正文写进该目录的 SKILL.md 3. 以后只说三句话:「收资料」「查库」「体检」
| 你说 | 它干 |
|---|---|
| 把这份资料收进库 | 自动跑摄入 SOP,回你"新建 X 页 / 更新 Y 页 / 发现 Z 处冲突" |
| 库里有没有讲 XX 的 | 带引用回答,并问你要不要存成新页 |
| 体检 | 跑脚本,只报不改,有问题才找你 |
读 index → 定位 2–5 页 → 逐页读 → 带引用回答 → 问要不要存新页AGENTS.md 的"动作②"| # | 坑 | 怎么避 |
|---|---|---|
| 1 | 没写规矩就开工 | 先写 AGENTS.md 再干活,否则同一个活三次三个样 |
| 2 | 分类越分越细 | 控制在 8 个以内,分到 15 类你就再也找不到东西了 |
| 3 | 摘要式摄入 | 看这次摄入动了几页,只动 1 页就重做 |
| 4 | 发现问题随手改 | 只报不改,批量改动先过脑子,不然越改越乱 |
| 5 | 冲突时图省事覆盖 | 标出来别删 —— 删掉旧的同时把"为什么改"也删了 |
| 6 | 把体检当一次性动作 | 设成每周自动跑,看趋势才有意义 |