Rag Skill

本地知识库检索 Skill 演示项目

⚠️ **项目已归档** 本仓库已停止维护，不再更新。作者后续所有的开源 Skills 将统一发布至 [garden-skills](https://github.com/ConardLi/garden-skills) 仓库，欢迎 Star 关注，获取最新动态 ✨

---

一个专为本地知识库智能检索设计的 AI Skill 演示仓库，展示如何通过分层索引和渐进式检索实现高效的多格式文件问答系统。

📖 项目简介

本项目是一个完整的本地知识库检索解决方案演示，包含：

• 核心 Skill：.agent/skills/rag-skill - 智能知识库检索助手
• 示例知识库：knowledge/ - 包含多领域、多格式的真实数据样本
• 最佳实践：遵循 Skill 编写规范，展示如何构建高效的 RAG（检索增强生成）系统

核心特性

✅ **多格式支持** - Markdown、PDF、Excel 等多种文件格式 ✅ **分层索引** - 通过 `data_structure.md` 实现智能目录导航 ✅ **渐进式检索** - 避免全文加载，按需局部读取，节省 token ✅ **强制学习机制** - 处理 PDF/Excel 前必须先学习处理方法 ✅ **多轮迭代** - 最多 5 轮智能检索，确保找到最相关信息

---

📁 项目结构

skilltest/
├── .agent/
│   └── skills/
│       ├── rag-skill/              # 核心知识库检索 Skill
│       │   ├── SKILL.md            # Skill 主文件（13KB）
│       │   └── references/         # 参考文档
│       │       ├── pdf_reading.md  # PDF 处理方法指南
│       │       ├── excel_reading.md # Excel 读取方法
│       │       └── excel_analysis.md # Excel 分析方法
│       └── skill-creator/          # Skill 创建指南（可选）
│
└── knowledge/                      # 示例知识库（30+ 文件）
    ├── data_structure.md           # 根目录索引
    ├── AI Knowledge/               # AI 行业报告（14 个 PDF）
    │   ├── data_structure.md
    │   ├── 2026年AI Agent智能体技术发展报告.pdf
    │   ├── OpenAI深度报告：大模型王者，引领AGI之路.pdf
    │   └── ...
    ├── Financial Report Data/      # 金融财报数据（6 个 PDF）
    │   ├── data_structure.md
    │   └── ...
    ├── E-commerce Data/            # 电商业务数据（4 个 Excel）
    │   ├── data_structure.md
    │   ├── customers.xlsx
    │   ├── employees.xlsx
    │   ├── inventory.xlsx
    │   └── sales_orders.xlsx
    └── Safety Knowledge/           # 安全知识文档（Markdown）
        ├── data_structure.md
        └── ...

---

🚀 快速开始

1. 环境准备

确保你的 AI 助手支持以下工具：

• grep - 文本搜索
• read_file - 文件读取
• pdftotext 或 pdfplumber - PDF 处理
• pandas - Excel 数据分析

2. 使用示例

示例 1：查询 AI 行业趋势

问：2026年AI Agent技术有哪些关键发展趋势？

**Skill 执行流程**：

1. 读取 knowledge/data_structure.md 识