把本地文件夹建成 AI Agent 可稳定查找、收录和维护的知识库，支持导航、版本判断、健康检查及 SOT 分层治理。输入文件夹路径，输出知识库结构、导航文件、版本状态和健康报告。适用于内容创作者、自媒体运营者建立内容素材库，或项目经理整理项目文档。

文件夹知识库建设助手

【适用场景】

- 内容创作者：将分散的参考资料、爆款文案、历史稿件整理为可检索的知识库 - 自媒体运营者：建立选题库、素材库、对标账号分析库，支持快速查找和复用 - 一人公司创始人：把客户资料、合同模板、项目文档结构化存档，避免版本混乱 - 知识工作者：把论文、读书笔记、研究资料归档管理，支持主题检索

Step 1：确定知识库目录

按以下顺序确定根目录：

1. 用户明确给出目录：使用该目录 2. 用户说「这个文件夹」且当前工作目录边界清楚：使用当前工作目录 3. 当前目录范围过大：先请用户指定一个更具体的目录 4. 用户没有任何资料：询问知识库名称和保存位置

Step 2：只读审计

先查看根级与 1～2 层目录，再按实际问题下钻。大型目录不要一次读取全部正文。

优先查看： - `SOURCE_OF_TRUTH.md`（知识库导航） - `AGENTS.md`、`CLAUDE.md`（Agent 规则） - 根级和主要目录中的 `README.md` - 能反映业务结构的顶层目录 - 文件名中带日期、版本、最终版、原始、汇总、归档等信号的文件

默认排除： - `.git/`、`node_modules/`、`.trash/` - 缓存、构建产物、临时目录 - `.env`、密钥文件、密码文件、凭证数据库

Step 3：识别状态与意图

状态 A：目录为空或几乎没有资料

进入「新建知识库」，默认提出最小结构：

```text {知识库根目录}/ ├── 00-待整理/ ├── SOURCE_OF_TRUTH.md ├── AGENTS.md └── CLAUDE.md ```

状态 B：已有资料，缺少知识库导航

先输出审计结果： 1. 当前资料大致分成哪些领域 2. 已经清楚的目录职责 3. 候选当前版本与待确认冲突

状态 C：已有知识库导航但需要更新

检查现有导航路径是否有效，补充新增资料，标记失效文件。

Step 4：生成知识库导航

根据审计结果生成或更新 `SOURCE_OF_TRUTH.md`，包含： - 目录职责说明 - 权威文件列表（含版本判断依据） - 失效路径和冲突说明

【代码模板】

输出模板：知识库导航（SOURCE_OF_TRUTH.md）

```markdown

{知识库名称}

目录结构

目录	职责	权威版本
00-待整理	临时存放未分类资料	—
01-素材库	原始参考资料	—
02-选题库	选题方向和笔记	—

权威文件

文件	版本	说明
素材库/竞品分析/2026-06.md	v2.1	最新版

失效路径

- 旧版/已废弃/ → 已迁移至 xxx ```

输出模板：健康检查报告

```markdown

知识库健康检查

问题清单

1. ❌ 失效路径：xxx.md（文件不存在） 2. ⚠️ 版本冲突：xxx-v1.md vs xxx-v2.md 3. ⚠️ 散落文件：根目录有 3 个未归档文件

建议

- 删除失效路径对应的导航条目 - 确认保留哪个版本后更新导航 ```

【复盘要点】

本技能产出：结构化知识库 + 可维护导航 + 健康状态报告

关键判断：「知识库导航只负责指路与解决冲突，回答具体问题时，继续读取导航指向的原始文件，不能只根据导航中的摘要作答。」

常见错误： - 把 AI 总结当成权威答案，而不读取原始文件 - 一次性扫描全部目录，消耗大量 token - 预建大量空目录，而不是等用户实际放入资料

适用边界： - ✅ 适合：内容素材、项目文档、研究资料、学习笔记 - ❌ 不适合：数据库、密钥、浏览器数据、聊天记录等敏感内容 - ❌ 不适合：需要安装数据库、向量库或 Embedding 服务的场景

来源：GitHub https://github.com/dontbesilent2025/dbskill