1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | redis-search | GitHub API / SKILL.md |
| 作者/维护者 | Redis, Inc.（官方 redis/agent-skills 仓库） |
GitHub API |
| 来源链接 | https://github.com/redis/agent-skills/tree/main/skills/redis-search | — |
| 许可证 | MIT | GitHub API |
| GitHub Stars / Forks | 所属仓库 90★ / 21 forks（该数字属整个 Redis Agent Skills 合集，不代表本技能个体热度，仅供了解所属仓库规模） | GitHub API |
| 最新版本 | SKILL.md 标注 version 1.0.0；子目录最近一次提交 2026-07-09 | 仓库提交历史 / SKILL.md |
| 安装方式 | npx skills add redis/agent-skills 或 Claude Code 插件市场一条命令安装（见第 9 章） |
仓库 README |
2. 功能介绍与亮点
redis-search 是 Redis 官方 Agent Skills 合集中专攻检索场景的技能，覆盖 Redis Query Engine 的全套查询命令与向量检索能力。
核心能力：
- 在
FT.SEARCH（文档检索）、FT.AGGREGATE（聚合分析）、FT.HYBRID（词法+向量融合检索，Redis ≥8.4）三个命令间给出选型依据 - 覆盖
FT.CREATE索引 schema 设计，包括 TEXT/TAG/NUMERIC/GEO/GEOSHAPE/VECTOR 及 JSON 路径字段的取舍原则 - 向量检索专项指导：HNSW 与 FLAT 算法的适用边界、DIM/DISTANCE_METRIC/TYPE 三项必须与 embedding 模型对齐的参数、HNSW 调优参数（M/EF_CONSTRUCTION/EF_RUNTIME）
- 完整 RAG 检索管道模式：分块策略、批量写入、属性预过滤、重排序
- 零停机索引更新（别名切换）与
FT.EXPLAIN/FT.PROFILE故障排查方法 - 19 篇独立 references 文档（含 Python/Java/RedisVL 三种客户端的对照示例），配合渐进式披露架构按需加载
亮点：仓库自带 CI 校验（npm run validate）与按技能划分的 evals/ 评测套件，对技能输出质量做基准测试；技能自 2026 年 5 月首发后持续迭代，7 月初仍有版本号升级与 marketplace 收录更新，是同批官方数据库技能中维护节奏较快的一个。
3. 适用场景
固定分类：数据分析与可视化
- 用 Claude Code / Codex 等 agent 在 Redis 上设计全文检索或多字段过滤索引的开发者
- 需要构建向量相似度检索、语义搜索或 RAG 检索管道的 AI 应用开发者
- 对已有 Redis 查询做性能排查（慢查询、空结果、tokenization 异常）的场景
- 需要在不停机前提下变更线上搜索索引 schema 的运维场景
4. 跨 Agent 兼容性
- Claude Code：原生支持——仓库自带
.claude-plugin/marketplace.json，/plugin install redis-development@redis连带装入本技能 - Codex：官方明确支持——Redis 官方博客（redis.io/blog，2026-02-03 发布）原文列出“every AI coding agent you use (Claude Code, Cursor, Codex, Copilot, Augment Code, whatever)”，明确将 Codex 纳入支持范围；但仓库内未见针对 Codex 的专用清单目录，实际安装依赖通用 Agent Skills CLI（
npx skills add） - OpenClaw：未验证——官方材料未提及，技能遵循标准 SKILL.md 格式，理论上可通用安装，但未见官方或可靠第三方验证
- Hermes Agent：未验证——官方材料未提及
（仅基于已抓取材料判断，未为兼容性单独发起搜索）
5. 推荐理由
Redis 8.4 起原生支持词法+向量融合检索，是当前 Redis 用户构建 RAG 与语义搜索最直接的路径，但涉及的字段类型、索引参数、算法选择远比普通 CRUD 复杂，agent 缺乏专项指导时很容易在 DIM 不匹配、TAG/TEXT 选错、HNSW 参数生搬硬套上踩坑。redis-search 把这套决策收敛成可直接执行的命令模板与调优表格，配合覆盖三种主流客户端的参考文档，是官方出品、持续迭代的检索场景补全，能显著降低初中级开发者在 Redis 搜索与向量检索上的试错成本。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Redis, Inc. 官方仓库出品；子目录自身有 8 次提交、两位贡献者持续迭代（含 2026-07-09 的版本号升级与 marketplace 收录更新），活跃度高于合集内多数仅 2 次提交的同级子技能，但作为合集中的专项检索能力，受众窄于覆盖全体 Redis 用户的旗舰技能 redis-core |
| 可用性 | 9 | npx skills add 或 Claude Code 插件市场一条命令安装；SKILL.md 正文精炼、19 篇 references 文档覆盖 schema/查询/向量/RAG/运维全流程外加三种客户端示例；仓库自带 CI 校验与按技能划分的 evals 套件；最近一次提交 2026-07-09，维护活跃；MIT 许可，技能自身无付费依赖（连接自有 Redis 实例） |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
① 执行 shell 命令——纯文档指导型技能，无 scripts/ 目录，SKILL.md 内命令示例仅作讲解素材
② 联网外发数据——技能内容为本地建议，不涉及技能自身向外部服务器发送数据，用户自有 Redis 实例的连接由用户代码负责
③ API key/凭据——不涉及凭据；认证相关内容属合集内另一子技能 redis-security，不在本次推荐范围
④ 未发现可疑指令——抓取 SKILL.md 全文与 references 目录清单，内容均为透明的 Redis 查询/索引说明，未见 prompt injection 或混淆代码迹象
⑤ 作者信誉——Redis, Inc. 官方仓库，主要提交者之一的 GitHub 资料确认任职于 Redis
⑥ License——MIT，明确
⑦ 维护时间——最近提交 2026-07-09，近一个月内，配有 CI
综合评分：8.3（三项均值）
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与 redis-search 的差异 |
|---|---|---|
| qdrant-search-quality（qdrant/skills） | Qdrant 官方向量检索质量调优技能，聚焦纯向量数据库场景 | 面向专用向量数据库，不涉及词法检索；redis-search 面向同时承担缓存/存储职责的 Redis 实例，词法与向量检索共用一套索引机制，适合已用 Redis 做主存储、不想引入独立向量库的团队 |
| Elasticsearch ES|QL（elastic/agent-skills） | Elastic 官方查询语言技能，聚焦全文检索与日志分析的声明式查询语法 | 面向专职搜索/日志分析集群，查询语言与运维模型完全独立；redis-search 面向把 Redis 作为多功能数据层的场景，检索能力与缓存、会话等其他 Redis 用途共享同一实例 |
| redis-core（同合集内） | 同合集旗舰技能，聚焦数据结构选型与 key 命名规范 | 解决“如何存”的问题，覆盖全体 Redis 用户；redis-search 解决“如何检索”的问题，仅面向需要全文/向量检索能力的子集用户，两者互补而非竞争 |
redis-search 的差异化在于“复用现有 Redis 实例做检索”：不需要额外部署专用搜索或向量数据库，FT.CREATE/FT.HYBRID 与缓存、会话等其他 Redis 用途共享同一套基础设施与运维模型，适合技术栈已围绕 Redis 展开、希望以最小架构复杂度接入语义搜索或 RAG 的团队。
8. 用户评价
该技能目前在 Reddit、Hacker News 等平台尚无具名用户评价；第三方技能市场收录页面上的评论内容笼统，未具体提及该技能的功能细节。
9. 安装使用方式
- Agent Skills CLI：
npx skills add redis/agent-skills（安装整个合集，含 redis-search） - Claude Code 插件市场：
/plugin marketplace add redis/agent-skills，再执行/plugin install redis-development@redis - Cursor：在对话中使用
/add-plugin redis - 手动安装：将
skills/redis-search目录复制到对应 agent 的技能目录
安装后注意事项：redis-search 属于 redis-development 插件包的一部分，按插件方式安装会连带装入其余 7 个 Redis 子技能（redis-core、redis-connections、redis-clustering、redis-security、redis-observability、redis-semantic-cache、iris-development）；若只需要检索能力，可只手动复制 redis-search 子目录（其内容不依赖其他子技能）。安装后无需重启，agent 会在涉及 Redis 全文检索、向量检索或 RAG 管道的对话中自动触发。
10. 注意事项
FT.HYBRID命令需要 Redis ≥8.4，低版本只能用 SKILL.md 中给出的“预过滤+KNN”方案近似实现词法+向量融合- 本次评审范围仅为 redis-search 一个子技能，合集内涉及认证安全的 redis-security 等其余子技能未在本次评审范围内
- Codex 支持基于官方博客的文字声明，未见专用清单目录佐证，建议使用前自行验证实际安装效果
- OpenClaw、Hermes Agent 的兼容性目前均无官方或可靠第三方材料佐证，两个生态的用户使用前建议先自行验证基本安装流程
- 该技能仓库自 2026 年 1 月创建以来历史较短（约半年），长期维护稳定性有待观察