1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | spring-data-redis-rrezartprebreza-spring-boot-skills |
| 作者/维护者 | rrezartprebreza（个人开发者） |
| 来源链接 | https://github.com/rrezartprebreza/spring-boot-skills/tree/main/skills/spring-boot-4/spring-data-redis |
| 许可证 | MIT（GitHub API 获取） |
| GitHub Stars | 197（整个 spring-boot-skills 合集仓库；该数字属整个合集，不代表本技能自身热度，GitHub API 获取） |
| Forks | 35（同上，合集整体，GitHub API 获取） |
| 最新版本 | 无独立版本号，仓库不使用 GitHub Release 标签；整体最近一次修订为 2026-07-30（GitHub API 获取） |
| 安装方式 | 复制该子目录到 agent 的 skills 目录，或用 npx skills add 单独拉取（见第 10 章） |
2. 功能介绍与亮点
这是一份 Spring Boot 应用接入 Redis 做缓存、会话存储与限流的编码规范，把配置装配、命名约定与常见性能陷阱整理成可直接对照执行的清单。核心内容：
- 基础装配：
RedisTemplate与RedisCacheManager的完整 Bean 配置，指定 JSON 序列化（而非 Java 原生序列化）、按缓存分别设置 TTL（如订单 5 分钟、商品 1 小时） - Key 命名规范：
{app}:{domain}:{id}一套贯穿业务数据、列表查询、会话与限流场景的统一键名格式，避免团队各写各的导致键冲突或难以批量清理 - 声明式缓存与手动 Cache-Aside 两种路径：
@Cacheable/@CachePut/@CacheEvict注解式用法，以及需要更细粒度控制时的手动读写代码模板 - 限流实现：基于
INCR+EXPIRE的 Redis 限流器示例代码 - 缓存击穿防护：说明热点 key 过期瞬间大量并发请求同时穿透到数据库的“惊群”问题，给出
@Cacheable(sync = true)单机方案与跨实例 Redis 锁思路，并建议给批量写入的 key 加随机抖动的 TTL，避免同时过期 - 12 条“agent 常犯错误”清单：用 Java 原生序列化存值、缓存 JPA 实体的懒加载字段、不设 TTL、忘记
@EnableCaching、缓存空值未处理，以及 Boot 3→4 迁移期 Jackson 3 序列化器改名、Spring Session 配置键路径变化等易踩坑点
全部内容为纯 Markdown 文档配 Java 代码示例，无外部脚本或可执行文件。
3. 适用场景
所属分类：工程效率与代码质量——内容是缓存/会话/限流场景下的技术栈编码规范，不涉及 agent 自身配置，也不是“连接 Redis 服务”这类集成任务本身，而是围绕业务代码怎么写。
适合任何用 Redis 做缓存、会话存储或接口限流的 Spring Boot 团队——这几乎是主流后端服务的通用需求，覆盖面比“是否采用 DDD/六边形架构/OpenAPI-first”这类特定方法论选择更广，也不局限于某个细分业务场景。尤其对高并发接口，缓存击穿防护与 TTL 抖动这类容易被 agent 生成代码时忽略、只有在大流量下才暴露的性能隐患，这份清单能提前规避。
4. 跨 Agent 兼容性
- Claude Code：原生支持——仓库明确提供
.claude/skills/安装路径与徽章标注兼容 - Codex：原生支持——仓库同时提供
.codex/skills/安装路径与徽章标注兼容 - OpenClaw：未验证——SKILL.md 遵循标准 YAML front matter + Markdown 正文格式，理论上可迁移，但仓库文档未点名支持
- Hermes Agent：未验证——同上，未见任何提及
5. 推荐理由
Redis 缓存、会话存储与限流是绝大多数 Spring Boot 后端服务都会用到的基础能力，而序列化方式选错、TTL 遗漏、热点 key 过期引发的缓存击穿，都是 agent 生成缓存代码时容易忽略、又要等到高并发场景才会暴露的问题。这份技能把装配、命名规范、声明式与手动两种缓存路径、限流实现和击穿防护整理成可直接照做的规范，另外单列一份 Boot 3→4 迁移期的 Jackson 序列化器改名与 Session 配置键路径变化清单，对正在升级到 Boot 4 的团队同样实用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 5 | 该技能所属子目录本身尚无独立的第三方评测或引用；所属合集仓库由单一开发者维护，197 星与 35 复刻数字属整体仓库，不可归给单个子技能；第三方技能市场 skills.sh 显示该子技能被独立安装 55 次，是本仓库 19 个 Spring Boot 4 子技能中安装数最高的一个，但仍属起步阶段的小体量数字 |
| 可用性 | 9 | 复制单个文件夹即可安装，无需配置或付费依赖（Redis 本身是团队自行部署的开源组件，非该技能强加的付费依赖）；仓库最近一次修订为 2026-07-30，内容随 Spring Boot 4 当前版本同步维护；正文含完整可直接复制的配置、注解与手动缓存代码示例 |
| 安全性 | 9 | 纯 Markdown 文档配 Java 示例，技能自身不执行任何命令、不联网、不要求任何凭据；许可证明确（MIT）；第三方平台 skills.sh 显示 Socket 与 Snyk 两项独立安全审计均为 Pass；内容未见任何可疑指令或误导性说明 |
综合评分：7.7
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| redis-core-redis-agent-skills（Redis 官方维护，redis/agent-skills 合集） | 面向任意语言/技术栈的 Redis 数据结构选型与通用 key 命名规范 | 内容停在 Redis 协议与数据结构层面，不涉及任何具体应用框架；本技能专注 Spring Boot 的 @Cacheable/RedisTemplate 装配、Jackson 序列化配置与 Boot 4 迁移细节，服务 Java/Spring 技术栈开发者这一更具体的群体 |
| spring-data-jpa（同仓库另一子技能） | Spring Data JPA 持久化层编码规范，覆盖 N+1 查询修复、深分页与批量写入 | 服务的是关系型数据库访问这一完全不同的数据层；两者在同一应用中通常配合使用（JPA 管持久化、Redis 管缓存），而非相互替代 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 其他补充
仓库同时维护 Spring Boot 3 分支下的等价版本（skills/spring-boot-3/spring-data-redis），核心缓存模式与 key 命名规范不变，Boot 4 专属的 Jackson 3 序列化器写法在 Boot 3 分支不适用。
10. 安装使用方式
Claude Code：
mkdir -p "$PROJECT_DIR/.claude/skills"
cp -r skills/spring-boot-4/spring-data-redis "$PROJECT_DIR/.claude/skills/"Codex：
mkdir -p "$PROJECT_DIR/.codex/skills"
cp -r skills/spring-boot-4/spring-data-redis "$PROJECT_DIR/.codex/skills/"也可用第三方技能市场 skills.sh 提供的命令单独拉取：
npx skills add https://github.com/rrezartprebreza/spring-boot-skills --skill spring-data-redis安装后无需重启 agent，下次涉及缓存、会话存储或限流相关代码的对话会自动触发该技能。
11. 注意事项
- 内容假定项目已部署或计划部署独立的 Redis 实例，技能本身不涉及 Redis 部署或运维，只覆盖 Spring Boot 应用侧的接入代码
- 跨实例（多副本部署）场景下的缓存击穿防护仅给出思路（Redis 分布式锁），未提供完整的锁实现代码，需自行补全
- Boot 4 迁移清单覆盖的是仓库 2026-07-30 最近一次更新时已知的变化；Spring Boot 4.x 后续小版本若继续调整相关 API 或属性名，需自行核实是否有新变化
- 仓库由单一个人开发者维护，无官方或厂商背书，长期维护延续性依赖作者个人投入