Redis 设计与使用助手

触发条件

当用户出现以下意图时激活本 Skill：
- 设计 Redis 缓存方案
- Key 命名规范 / TTL 策略设计
- 分布式锁 / 限流 / 队列方案
- Redis 数据结构选型
- "如何设计 xxx 的缓存"

设计流程（Agent 执行路径）

0. 版本检查 → 加载 references/version-major.md 对比用户版本，识别废弃项和重大变更。同时加载所有 version-X.Y.md（X.Y ≤ 用户目标版本），后续设计过程中 Agent 从已加载的上下文中自主匹配深度特性
1. 需求分析 → 理解缓存场景（读加速/写缓冲/会话/排行榜/队列）
2. 数据结构选型 → String/Hash/Set/ZSet/Stream/Bitmap 适用场景匹配
3. Key体系设计 → 加载 references/design-spec.md，按规范设计Key命名和TTL
4. 架构设计 → Cache-Aside/Write-Through/Write-Behind 选择
5. 使用指引 → 加载 references/usage-guide.md，给出场景化操作流程
6. 生产建议 → 加载 references/best-practices.md，给出持久化/集群/内存建议
7. 模板参考 → 加载 references/patterns.md，匹配业务模式模板

快速参考

数据结构选型速查

Key 命名铁律

Value 设计铁律

1. 拒绝 bigkey — String ≤ 10KB，集合元素 ≤ 5000
2. 对象用 Hash — 不用多个 String
3. 实体存储用 Hash，不用多个 String

# ❌ 反例：多个String存对象
SET user:1:name "tom"
SET user:1:age "19"

# ✅ 正例：Hash存对象
HSET user:1 name "tom" age "19"

缓存模式速查

缓存问题三件套

渐进式加载

详细内容按需加载 references/：

版本参考文档启用规则

1. 模块激活时 — 始终加载 references/version-major.md，Agent 需主动对比用户使用的 Redis 版本，若存在废弃项或重大变更，立即提示用户
2. 深度特性 Step 0 自动加载 — 版本检查时加载所有 version-X.Y.md（X.Y ≤ 用户目标版本）。设计过程中 Agent 从已加载的上下文中自主检索匹配相关特性，用户无需指定版本号
3. 深度特性按大版本拆分，小版本持续追加 — 如 version-8.0.md 包含该大版本下所有小版本的设计级特性。更新时在文件中新增 ## X.Y.Z 版本节即可，不单开文件

硬规则

1. 设计规范内容来自权威资料（阿里云Redis开发规范/Redis官方文档/AWS最佳实践），不编造
2. 所有 Key 必须设置 TTL，Redis 不是垃圾桶
3. 禁止 bigkey（String > 10KB / 集合 > 5000 元素）
4. 禁止 KEYS *，使用 SCAN
5. 集群环境 Lua 脚本 Key 必须在同一 slot（用 Hash Tag）
6. 分布式锁必须设置超时 + 原子释放（Lua脚本）
7. Pipeline 批量操作 ≤ 500 条