1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | weaviate（weaviate/agent-skills 合集内的核心子技能） | GitHub API / SKILL.md |
| 作者/维护者 | Weaviate（官方 weaviate/agent-skills 仓库） |
GitHub API |
| 来源链接 | https://github.com/weaviate/agent-skills/tree/main/skills/weaviate | — |
| 许可证 | BSD 3-Clause | GitHub API 实测 |
| GitHub Stars / Forks | 所属仓库 102★ / 17 forks（该数字属整个 Agent Skills 合集，不代表本技能个体热度，仅供了解所属仓库规模） | GitHub API |
| 最新版本 | 插件清单标注 version 0.2.3；子目录最近一次相关提交 2026-04-01 | 仓库 .claude-plugin/plugin.json / 提交历史 |
| 安装方式 | npx skills add weaviate/agent-skills 或 Claude Code 插件市场一条命令安装（见第 10 章） |
仓库 README |
2. 功能介绍与亮点
weaviate 是 Weaviate 官方 Agent Skills 合集中的核心操作技能，把向量数据库的常见操作封装成一组可直接调用的脚本：
- 多种检索方式：混合搜索（默认）、语义搜索（概念相似度）、关键词搜索（精确匹配 ID/SKU）、以及基于 Query Agent 的自然语言问答（返回带来源引用的合成答案）
- Schema 与数据探查：列出所有 collection、查看某 collection 的字段与向量化配置、分析数据分布与典型取值
- 数据导入：支持 CSV、JSON、JSONL 与 PDF 四种格式批量导入，PDF 导入会自动建 collection 并做多模态处理
- 精确检索：按 ID 或过滤条件获取指定对象，区别于模糊的相似度搜索
- 每类操作都配有独立的
references/*.md说明文档和对应的 Python 脚本（uv run scripts/xxx.py），环境变量按 17 家主流模型服务商（OpenAI、Cohere、HuggingFace 等）自动探测
亮点：脚本依赖版本全部锁定（如 weaviate-client==4.19.2），2026 年 2-4 月持续迭代（新增 PDF 导入、流式数据摄取、schema 增强等特性），提交记录显示由 4 位具名工程师协作维护，而非一次性提交后停摆。
3. 适用场景
固定分类：数据分析与可视化
- 需要在项目中接入 Weaviate 向量数据库做语义检索、RAG 问答的初中级开发者
- 想快速探查陌生 collection 的 schema 与数据分布、避免凭猜测写查询的开发者
- 需要把 CSV/JSON/PDF 等原始文件批量导入向量库、又不想手写导入脚本的用户
- 已有 Weaviate 实例、希望用自然语言而非编写查询代码来完成日常检索与数据管理的团队
4. 跨 Agent 兼容性
- Claude Code：原生支持——仓库自带
.claude-plugin/marketplace.json与plugin.json，/plugin marketplace add weaviate/agent-skills后/plugin install weaviate@weaviate-plugins一条命令安装；npx skills add weaviate/agent-skills同样适用 - Cursor：原生支持——仓库自带
.cursor-plugin/plugin.json，官方博客与新闻通稿均将 Cursor 列为首批适配对象 - Codex：未验证——官方博客与通稿列举的适配对象为 Claude Code、Cursor、GitHub Copilot、VS Code、Gemini CLI，未点名 Codex
- OpenClaw / Hermes Agent：未验证——官方材料未提及，技能遵循通用 Agent Skills 格式，理论上可手动安装，但未见官方或第三方验证
（仅基于已抓取材料判断，未为兼容性单独发起搜索）
5. 推荐理由
向量数据库的 API 细节（如何选检索模式、schema 怎么设计、导入不同文件格式要注意什么）容易让 agent 凭猜测生成过时或不兼容的代码。weaviate 技能把这些操作沉淀成锁定依赖版本的现成脚本和逐项细化的参考文档，配合官方持续两个多月的功能迭代，适合刚接触 Weaviate、还不熟悉其检索模式和 schema 设计的开发者直接上手。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | Weaviate 官方出品并有专门的产品博客发布（2026-02-18），多家科技媒体转载官方通稿；子目录自身由 4 位具名工程师在约两个月内持续提交 30 次，功能不断迭代，但未见 GitHub issue 或独立第三方评测等社区互动证据 |
| 可用性 | 8 | npx skills add 或 Claude Code 插件市场一条命令安装；SKILL.md 结构清晰，13 篇 references 逐项覆盖检索/管理/导入操作；子目录最近一次相关提交 2026-04-01，在近 6 个月维护窗口内但超出近 3 个月；需要 Weaviate 实例（提供免费 sandbox）及 API Key，属轻量配置 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
① 执行 shell 命令——脚本均为 uv run scripts/xxx.py 调用 Weaviate 官方 SDK 做检索/导入/管理操作，范围明确，依赖版本全部锁定
② 联网外发数据——仅连接用户自行配置的 WEAVIATE_URL 集群及用户主动设置的模型服务商 API（如启用向量化），无隐藏外发目标
③ API key/凭据——WEAVIATE_API_KEY 及各模型服务商 key 均通过环境变量注入，代码里有清晰的探测与映射逻辑，未见明文硬编码
④ 未发现可疑指令——抽查 SKILL.md 与核心脚本（weaviate_conn.py、import.py），未见混淆代码或隐蔽外发
⑤ 作者信誉——Weaviate 为知名开源向量数据库厂商，官方账号发布，无 SEO/刷量迹象
⑥ License——BSD 3-Clause，明确
⑦ 维护时间——子目录最近提交 2026-04-01，距今约 4 个月，仍在可接受窗口内
综合评分：8.3（三项均值）
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与 weaviate 的差异 |
|---|---|---|
| redis-search（redis/agent-skills） | Redis 官方出品，覆盖 Redis 的全文/向量/混合搜索索引设计与查询语法 | redis-search 面向“已经在用 Redis 做搜索”的场景，需要理解 Redis 自身的索引与数据结构；weaviate 是围绕专用向量数据库设计，原生支持多模态（PDF、图片）导入与多家 embedding 服务商，检索模式切换更直接 |
| qdrant-search-quality（qdrant/skills） | Qdrant 官方出品，聚焦检索质量调优——量化策略、过滤器设计、重排序等进阶参数 | qdrant-search-quality 定位在“已有 Qdrant 部署后如何调优”，偏进阶；weaviate 覆盖从建 collection、导入数据到检索的完整入门流程，更适合从零接入的用户 |
| pinecone-full-text-search（pinecone-io/skills） | Pinecone 官方技能，专注文档 schema 全文检索 API（预览版）的 schema 设计与查询构造 | 该技能仅覆盖 Pinecone 预览版全文检索这一单一场景；weaviate 覆盖语义/混合/关键词搜索、Schema 管理、多格式导入等更完整的日常操作集合 |
weaviate 的差异化在于覆盖面更完整的“入门到日常使用”操作集：不是单一检索模式或单一进阶参数的深挖，而是把建库、导入、多种检索方式整合进一套可直接调用的脚本，适合作为接入 Weaviate 的第一个技能。
8. 用户评价
该技能目前在第三方平台（如 Reddit、Hacker News）尚无独立具名用户评价。发布信息主要通过 Weaviate 官方博客（2026-02-18）及多家科技媒体转载的通稿传播，暂未见开发者社区的具名讨论或评测文章。
9. 其他补充
同仓库另含 weaviate-cookbooks 子技能，提供基于 FastAPI/Next.js 的完整应用蓝图（如 RAG 聊天机器人、数据探查前端），两者共享同一插件包，安装一次即可同时获得。
10. 安装使用方式
- Agent Skills CLI：
npx skills add weaviate/agent-skills - Claude Code 插件市场：
/plugin marketplace add weaviate/agent-skills，再执行/plugin install weaviate@weaviate-plugins - Cursor：仓库自带
.cursor-plugin/plugin.json，按 Cursor 插件安装流程添加 - 手动安装：
git clone https://github.com/weaviate/agent-skills.git，用claude --plugin-dir .指向该目录
安装后注意事项：需先在 Weaviate Cloud 创建免费沙箱实例并设置 WEAVIATE_URL、WEAVIATE_API_KEY 两个环境变量；如使用需要外部向量化的 collection，还需按需设置对应模型服务商的 API Key。安装后无需重启，可运行内置的 /weaviate:quickstart 命令完成交互式环境配置。
11. 注意事项
- 安装会同时装入 weaviate-cookbooks 子技能，如只需核心操作能力，可手动只复制
skills/weaviate目录 - 子目录自身提交历史集中在 2026 年 2-4 月，此后暂无新提交，长期维护节奏有待观察
- Codex、OpenClaw、Hermes Agent 的兼容性目前均无官方或可靠第三方材料佐证，三个生态的用户使用前建议自行验证基本安装流程
- 使用外部模型服务商做向量化会产生该服务商自身的调用费用，与 Weaviate 本身的免费额度无关，需自行确认预算