1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | redis-clustering | GitHub API / SKILL.md |
| 作者/维护者 | Redis, Inc.（官方 redis/agent-skills 仓库） |
GitHub API |
| 来源链接 | https://github.com/redis/agent-skills/tree/main/skills/redis-clustering | — |
| 许可证 | MIT | GitHub API 实测 + SKILL.md front matter 双重确认 |
| GitHub Stars / Forks | 所属仓库 90★ / 21 forks（该数字属整个 Redis Agent Skills 合集，不代表本技能个体热度，仅供了解所属仓库规模） | GitHub API |
| 最新版本 | SKILL.md 标注 version 0.1.0；子目录专项创建提交 2026-05-22，最近一次相关提交 2026-05-27 | 仓库提交历史 / SKILL.md |
| 安装方式 | npx skills add redis/agent-skills 或 Claude Code 插件市场一条命令安装（见第 10 章） |
仓库 README |
2. 功能介绍与亮点
redis-clustering 是 Redis 官方 Agent Skills 合集中专攻 Redis Cluster 分片与副本读取 的技能，聚焦两个几乎每个初次接触集群部署的开发者都会踩的坑：
- 多键操作的 CROSSSLOT 错误：Redis Cluster 把键按哈希分布到 16384 个槽，
MGET/SDIFF/事务/pipeline 等多键命令要求涉及的键落在同一槽，否则报错。技能给出用{}包裹的 hash tag 写法把相关键强制分到同一槽，并提醒 tag 范围不宜定得太粗（裸用{1001}会让purchase:{1001}、employee:{1001}等不相关命名空间意外挤到同一槽，制造热点） - 副本读取分流：区分 Redis Cluster（每分片自带副本）与单机主从复制两种拓扑下如何把只读流量路由到副本，并明确指出副本是最终一致的，不适合读自己刚写入的数据或强一致场景（余额、幂等状态），只适合缓存、看板、推荐流一类可容忍轻微延迟的读
- 配套 2 篇
references/*.md（hash-tags、read-replicas），含 Python/redis-py 代码示例（如RedisCluster(read_from_replicas=True)的具体用法） - 附官方文档链接（Redis Cluster spec 的 hash tags 章节、多键操作说明、复制文档）供深入查阅
亮点：内容精炼到 SKILL.md 一份文件（约 90 行）加 2 篇专题参考，不含任何可执行脚本，属纯知识指导类技能；两个失败模式（CROSSSLOT、副本一致性）都配有“错误写法 vs 正确写法”的对照代码块，可直接照抄进客户端代码。
3. 适用场景
固定分类：工程效率与代码质量
- 为 Redis Cluster 部署设计键结构、需要判断哪些键该共享 hash tag 的开发者
- 遇到
MGET/SDIFF/事务/pipeline 报 CROSSSLOT 错误、需要定位原因的工程师 - 编写涉及多键的 Lua 脚本或事务、需要确保键落在同一槽的开发者
- 读多写少场景（缓存、分析看板、推荐流）想通过副本读分流减轻主节点压力的团队
- 可与同合集内 redis-connections（连接池/管道化）、redis-observability（监控排障）搭配使用
4. 跨 Agent 兼容性
- Claude Code：原生支持——仓库自带
.claude-plugin/marketplace.json，/plugin install redis-development@redis连带装入本技能 - Codex：Redis 官方博客（redis.io/blog，2026-02-02 发布）原文写明“one command, and every AI coding agent you use (Claude Code, Cursor, Codex, Copilot, Augment Code, whatever) gets opinionated, up-to-date Redis knowledge”，明确将 Codex 纳入支持范围（该表述针对整个技能包，非专指本子技能）；一篇越南语第三方技术文章（署名 Chính Nguyễn Quốc，viblo.asia，2026-07-20 发布）专门点出 redis-clustering 并记录作者用 Codex 实测该技能时，Codex 依据技能内容主动提示“不应该给所有分片使用同一个 hash tag”的真实使用片段，与 SKILL.md 正文建议一致
- OpenClaw：未验证——官方材料未提及，技能遵循标准 SKILL.md 格式，理论上可通用安装，但未见官方或可靠第三方验证
- Hermes Agent：未验证——官方材料未提及
（仅基于已抓取材料判断，未为兼容性单独发起搜索）
5. 推荐理由
CROSSSLOT 报错和副本读一致性问题，是几乎每个团队从单机 Redis 迁移到 Cluster 部署时都会踩的坑，但相关知识分散在官方文档的多个章节里。redis-clustering 把 hash tag 设计原则与副本读取的适用边界收敛成一份可直接对照的编码指南，配合两篇带代码示例的参考文档，尤其适合刚开始接触 Redis Cluster、还没形成分片键设计习惯的初中级开发者。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Redis, Inc. 官方仓库出品，仓库共 10 位贡献者持续维护；本子目录自身提交虽只有 2 次（含 1 次专属创建提交“feat(redis-clustering): add spec-compliant skill for cluster”，对应独立合并的 PR #26），但已被独立第三方技术文章（越南语开发者社区 viblo.asia，2026-07-20 署名文章）专门点名并给出 hash tag/CROSSSLOT 的具体使用案例；作为合集中的专项能力，受众窄于覆盖全体用户的旗舰技能 redis-core |
| 可用性 | 9 | npx skills add 或 Claude Code 插件市场一条命令安装；SKILL.md 正文精炼（约 90 行）配 2 篇代码示例齐全的 references 文档；最近一次内容相关提交 2026-05-27，在近 3 个月维护窗口内；纯文档指导，无需 API key 或付费依赖，对自建与云托管 Redis 同样适用 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
① 执行 shell 命令——纯文档指导型技能，无 scripts/ 目录，SKILL.md 内命令示例仅作讲解素材（Python/redis-py 代码片段）
② 联网外发数据——技能内容为本地建议，不涉及技能自身向外部服务器发送数据；客户端与 Redis 服务器的连接由用户自行配置和发起
③ API key/凭据——不涉及凭据；认证相关内容属合集内另一子技能 redis-security，不属本技能覆盖范围
④ 未发现可疑指令——抓取 SKILL.md 全文与 2 篇 references 内容，均为透明的 Redis Cluster 使用说明，未见 prompt injection 或混淆代码迹象
⑤ 作者信誉——Redis, Inc. 官方仓库，仓库共 10 位贡献者，多个账号资料可确认任职于 Redis
⑥ License——MIT，明确
⑦ 维护时间——子目录最近提交 2026-05-27，仓库整体最近推送 2026-07-09，持续维护中
综合评分：8.3（三项均值）
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与 redis-clustering 的差异 |
|---|---|---|
| qdrant-scaling（qdrant/skills） | Qdrant 官方出品，面向向量数据库集群按数据量/QPS/延迟路由扩容决策的参考技能，给出分段数、量化、CPU 预算等具体配置参数 | 同为“官方出品的单一数据存储集群指南”，但 qdrant-scaling 解决的是“该不该加节点、往哪个方向扩容”的容量规划问题；redis-clustering 解决的是“应用代码怎么设计键才不会在已有集群上报错”的编码正确性问题，两者对应的决策阶段不同 |
| database-skills 的 vitess 子技能（planetscale/database-skills） | PlanetScale 官方发布的 MySQL 水平扩展方案，覆盖 VSchema 设计、分片键选择、跨分片查询限制 | 同样处理“分布式存储的多键/跨分片操作限制”，但 vitess 面向 MySQL 生态，需理解 VSchema 这层额外抽象；redis-clustering 直接对应 Redis Cluster 原生的 16384 槽模型，概念更薄，上手门槛更低 |
| 同包姊妹技能 redis-connections | 覆盖连接池、多路复用、管道化、危险命令替代等客户端连接层知识 | redis-connections 解决“怎么连接、怎么发命令更高效”，redis-clustering 解决“多键命令在分片集群上为什么报错、怎么设计键避免”，两者互补，排查生产问题时常一起用到 |
redis-clustering 的差异化在于把集群拓扑差异转化为具体的键设计规则：不是抽象地讲“Redis Cluster 会分片”，而是直接给出“什么时候该加 hash tag、tag 范围该多大、副本读什么时候安全”的可执行判断，减少从官方文档逐条摸索的过程。
8. 用户评价
越南语开发者社区平台 viblo.asia 上一篇署名 Chính Nguyễn Quốc（网名 chinhnq2）、2026-07-20 发布的技术文章详细拆解了 redis/agent-skills 全部子技能，其中关于 redis-clustering 的段落具体点出该技能“专注于 Redis Cluster：hash slot、hash tag、多键操作、避免 CROSSSLOT 错误”，并记录了作者本人用 Codex 实测该技能时，Codex 依据技能内容主动提示“不应该给所有分片使用同一个 hash tag”的真实使用片段。作者对整个技能包的总体评价是：真正的价值不是让 AI 变成全能专家，而是“在 AI 处理 Redis 相关任务的关键时刻，把专业知识、生产实践与护栏注入 context”。除此之外，该技能目前在 Reddit、Hacker News 等平台尚无具名用户评价。
9. 其他补充
本技能随 redis-development 插件包分发，同包还含 redis-core、redis-connections、redis-search、redis-security、redis-observability、redis-semantic-cache、iris-development 共 7 个姊妹技能，覆盖数据建模、连接管理、搜索、安全、可观测性等 Redis 使用全生命周期。
10. 安装使用方式
- Agent Skills CLI：
npx skills add redis/agent-skills（安装整个合集，含 redis-clustering） - Claude Code 插件市场：
/plugin marketplace add redis/agent-skills，再执行/plugin install redis-development@redis - Cursor：在对话中使用
/add-plugin redis - 手动安装：将
skills/redis-clustering目录复制到对应 agent 的技能目录
安装后注意事项：redis-clustering 属于 redis-development 插件包的一部分，按插件方式安装会连带装入其余 7 个 Redis 子技能；若只需要集群相关能力，可只手动复制 redis-clustering 子目录。安装后无需重启，agent 会在涉及 Redis Cluster 键设计、CROSSSLOT 排查或副本读取配置的对话中自动触发。
11. 注意事项
- 技能内容聚焦客户端如何设计键与路由读取以适配已有集群拓扑，不涉及集群本身的部署、加节点或重新分片操作，需要该层面指导应结合 Redis 官方运维文档
- 副本读取存在最终一致性延迟，正文已提醒不要用于余额、幂等状态等强一致场景，使用前需按实际业务确认可接受的陈旧度
- Codex 支持基于官方博客声明与第三方文章的实际使用记录，未见仓库内针对 Codex 的专用清单目录佐证，建议使用前自行验证实际安装效果
- OpenClaw、Hermes Agent 的兼容性目前均无官方或可靠第三方材料佐证，两个生态的用户使用前建议先自行验证基本安装流程
- 该技能子目录自身提交历史较短（2 次提交、单一作者），长期独立维护节奏有待观察