ARTICLE · 1157122
开源skill系列:合同、Excel、纪要散在本地:Garden KB Retriever 让 AI 沿目录找证据再回答
唐伯猫 · 开源skill
采购会前问一句“供应商 A 的付款条件到底以哪版为准”，文件夹里却有合同 PDF、付款 Excel 和三次会议纪要。全文塞进对话，既慢又容易把旧版当最新版；只搜文件名，又找不到藏在第 14 页的补充条款。
| 项目一句话： |
图 1｜官方仓库或项目图。来源：https://cdn.jsdelivr.net/gh/ConardLi/assets@main/imgs/kb-retriever-skill.webp
它怎么干：从输入走到交付
它不是把所有文件一次读进上下文。每级目录的 data_structure.md 告诉 Agent 内容范围；命中 PDF 或 Excel 时先看相应 references，选合适的读取方式；再用关键词和小范围窗口逐步收窄，最多五轮。若目录索引没写好，它也不会凭空知道哪个文件是最新版。
| 输入 |
图 2｜唐伯猫原创任务链图，仅解释工作方法，不是运行截图。
三个真正有用的能力
| 1｜目录索引先缩范围 |
| 2｜按文件格式读取 |
| 3｜渐进检索与停止条件 |
怎么跑：命令与交付检查
1. 在工作区建立 knowledge/，给根目录和子目录各写 data_structure.md，列文件用途、时间范围和版本。
2. 安装 kb-retriever，明确允许检索的目录；不要让 Agent 猜测私人目录。
3. 提出具体问题，要求每个结论带文件路径、PDF 页码或 Excel 行/列，并单列冲突与未确认项。
| 官方安装/调用路径 |
装好后，直接给 AI 这条任务
| 可复制 Prompt |
三个真实应用场景
| 场景 1｜采购经理会前核对条款 |
| 场景 2｜产品运营追溯决策 |
| 场景 3｜创作者整理采访素材 |
把结果想象具体一点
示意：knowledge/data_structure.md 指向 procurement/ → 该目录索引指向 contract-v3.pdf 与 payments-q3.xlsx → 答案记录“合同第 14 页写 30 天；Excel 的付款计划表第 22 行写 45 天” → 标记冲突，等采购确认。示例不是对真实合同的读取。
当前核验
官方 README 确认层级索引、PDF/Excel 先读 references、窗口化检索及五轮上限；未亲自运行。Skill 不附带你的知识库，也不保证索引、OCR 或页码永远正确。本文合同与表格为虚构任务样例。
官方链接
GitHub：https://github.com/ConardLi/garden-skills
官方文档：https://github.com/ConardLi/garden-skills/blob/main/skills/kb-retriever/README.zh-CN.md
Demo / 项目页：https://www.skills.sh/conardli/garden-skills/kb-retriever