RAG Manager
Use when 需要管理 RAG 语义搜索的索引生命周期 — 检查索引状态、重建索引、增量索引、移除索引、配置扫描范围。label-manager(RAG 场景) 的前置门控。 触发词:RAG 索引、语义搜索索引、重建索引、索引状态、重新索引、更新索引、reindex、NAS 文件索引、搜索索引管理、索引文件更新。 不适用:语义搜索本身(用 MCP semantic_search tool)、文件打标签(用 label-manager)、文件审计(用 file-organizer)。
Install
npx skills add coracoo/zspace_skill --skill rag-managergit clone --depth 1 https://github.com/coracoo/zspace_skill.git /tmp/zspace_skill
mkdir -p ~/.claude/skills
cp -r /tmp/zspace_skill/skills/rag-manager ~/.claude/skills/rag-managerPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# RAG Manager — 语义搜索索引管理
## 概述
管理 NAS 上 RAG docker daemon(`<nas_ip>:8000`,bge-small-zh-v1.5 + sqlite-vec)的索引生命周期。
**前置**:`nas-setup` skill(验证 NAS 登录 + RAG daemon 在线)。
**依赖 MCP tool**:
- `index_status()` — 索引概况(model/chunks/db_size)
- `reindex(scope, full)` — 重建索引
- `semantic_search(query, scope, top_k)` — 按 query 搜索(验证索引用)
RAG **不会**自动扫描 NAS 文件。需要手动 `reindex` 或 NAS cron 定时触发。
---
## 工作流
### 场景 1:门控检查(label-manager RAG 的前置)
**触发**:label-manager 的 RAG 依赖 skill 被加载时,先调 rag-manager 做门控。
**步骤**:
1. 调 `index_status()` → 拿 `chunks`、`model`、`db_size`
2. 如果 `chunks == 0`:调 `reindex(scope="files", full=true)` → 等完成后重查 status
3. 如果 `error` 或 daemon 不通:返回错误,"RAG daemon 未就绪,请先部署 rag-server docker"
4. 如果 `chunks > 0`:门控通过,告诉调用方"RAG ready,chunks=X"
### 场景 2:用户说"更新 RAG 索引"
**触发**:"重建 RAG 索引"、"reindex"、"把 NAS 文件重新索引"、"RAG 搜不到新文件"
**步骤**:
1. 调 `index_status()` 看当前状态
2. 调 `reindex(scope="files", full=true)` → 同步阻塞(大目录几分钟)
3. 调 `index_status()` 确认 chunks 数量增加
4. 报告:已索引 X chunks,共 Y MB
### 场景 3:用户说"去掉某个文件的索引"
**触发**:"把 XX 文件从 RAG 索引里移除"、"unindex"
**步骤**:
1. 当前 MCP **无 `unindex` tool**。走 rag-server HTTP API:`POST /unindex {source_type, source_path}`
2. 确认状态 `/status` → chunks 减少
### 场景 4:用户说"配置 RAG 扫描范围"
**触发**:"RAG 只索引教材目录"、"让 RAG 扫更多目录"
**步骤**:
1. 编辑 `rag-server/.env` 的 `SCAN_ROOTS` 和 `NAS_RAG_PATH_MAP`
2. 调 `reindex(scope="files", full=true)` 应用新范围
3. API 不暴露修改配置端点(需 SSH 或 docker compose restart)
---
## 跟 label-manager 的 RAG 分工
| 能力 | 用哪个 |
|------|--------|Details
- Skill name
rag-manager- Repository
- coracoo/zspace_skill
- Path
skills/rag-manager/SKILL.md- License
- MIT
- Repo updated
- 6 August 2026
FAQ
What does the RAG Manager skill do?
Use when 需要管理 RAG 语义搜索的索引生命周期 — 检查索引状态、重建索引、增量索引、移除索引、配置扫描范围。label-manager(RAG 场景) 的前置门控。 触发词:RAG 索引、语义搜索索引、重建索引、索引状态、重新索引、更新索引、reindex、NAS 文件索引、搜索索引管理、索引文件更新。 不适用:语义搜索本身(用 MCP semantic_search tool)、文件打标签(用 label-manager)、文件审计(用 file-organizer)。
How do I install the RAG Manager skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add coracoo/zspace_skill --skill rag-manager. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is RAG Manager popular?
It lives in coracoo/zspace_skill, which has 43 GitHub stars and 13 forks.
Related skills
File Organizer
43coracoo/zspace_skill
Use when 用户想诊断 ZSpace NAS 文件库,找出重复文件 + 孤儿文件(只读,不动 NAS)。 触发词:重复文件、孤儿文件、文件整理诊断、哪些文件重复了、哪些文件没归类、找重复电影、找重复照片。 不适用:写操作(删除重复 / 移动孤儿)— 这些走 MCP tool(remove/move/save_file_label)+ LLM 二次确认,不在这 skill 范围。
IOS Memo Bak
43coracoo/zspace_skill
Use when 用户想把 iPhone 备忘录自动备份到 NAS 记事本 — "帮我设置 iPhone 备忘录同步"、"重新告诉我一下怎么配"、"换一个新的备份密钥"、"我同事也要用这个功能"。 触发词:iPhone 备忘录同步、ios 备忘录 bak、备忘录备份到 NAS、备忘 → NAS、iPhone notepad sync、ios 备忘录、备忘录同步、iphone shortcut 备份、iPhone 推笔记、给我配 iPhone 备份、帮我把备忘录同步到 NAS。 不适用:不是直接写 NAS 的 skill — 实际写由 iPhone Shortcut 发起;此 skill 只设置基础设施(生成密钥 + 重启 dashboard + 给配置步骤)。
Label Manager
43coracoo/zspace_skill
管理和查询 ZSpace NAS 标签——按文件名打标(label-manager scan)、按文件内容语义搜打标(RAG)、按标签找文件、新建/删除标签。 触发词:打标签、给 XX 打 XX 标签、按标签找、找所有带 XX 标签的文件、新建标签、删除标签、给 XX 内容的文件打标签、智能打标、语义打标、给一年级的文件打《一年级》标签、给课本打标签、按内容找文件打标、给所有 XX 内容的文件批量打标。 不适用:文件重命名(用 MCP file_rename)、笔记搜索(用 MCP notebook_search)。
MCP Builder
49vitoworleone/claude-code-handbook
Build MCP (Model Context Protocol) servers that give Claude new capabilities. Use when user wants to create an MCP server, add tools to Claude, or integrate external services.
Nas Setup
43coracoo/zspace_skill
Use when 用户说"连不上 NAS"、"检查 NAS 连接状态"、"NAS 环境有问题"、任何 MCP tool 返回 N001208/N001414 等鉴权错误、skill 跑之前先确认环境。所有其他 NAS skill 的第一步都应该先调此 skill。 触发词:检查 NAS、NAS 环境、连不上 NAS、NAS 连接状态、setup nas、NAS 配置检查、check nas。 不适用:不是解决具体业务问题的 skill — 只做环境校验;具体功能用对应的 skill。
AI Interface Reviewer
32uxuiprinciples/agent-skills
Audit AI-powered interfaces against the uxuiprinciples Part V taxonomy — 44 principles covering transparency, trust calibration, human override, consent, agentic workflows, and conversational design. Returns structured findings with severity and remediation. API key optional — enriched output requires uxuiprinciples.com API Access.
Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.