1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | upstash-redis-js-upstash-skills |
| 作者/维护者 | Upstash(Serverless Redis 厂商官方) |
| 来源链接 | https://github.com/upstash/skills/tree/main/skills/upstash-redis-js |
| 许可证 | MIT |
| GitHub Stars / Forks | 31 / 7(属 upstash/skills 整个仓库,非本技能独有;GitHub API) |
| 底层 SDK | upstash/redis-js 980 stars;@upstash/redis npm 周下载约 547 万(GitHub API / npm API) |
| 技能安装量 | skills.sh 显示约 1.98 万次安装 |
| 最近更新 | 本技能目录最近一次提交 2026-10-01;仓库发布 1.0.0(2026-08-28) |
| 安装方式 | npx skills add https://github.com/upstash/skills --skill upstash-redis-js 或 Claude Code 插件 |
2. 功能介绍与亮点
面向 @upstash/redis(基于 HTTP 的 Serverless Redis 客户端)的编码指南,适用于 Next.js、Vercel、Cloudflare Workers 等无连接池环境。SKILL.md 作入口,约 31 个参考文件按需读取:
- 数据结构:字符串、哈希、列表、集合、有序集合、JSON、Streams、稀疏数组(ARSET/ARRING)、Redis 内向量索引
- 高级特性:自动 pipeline、事务(MULTI/EXEC)、Lua 脚本
- 场景模式:缓存、会话、排行榜、分布式锁、限流
- 性能与排错:批量操作、序列化细节、错误与重试、只读副本、TTL
- Redis Search:全文检索、聚合、索引别名,另含 node-redis / ioredis 适配器
- 迁移指南:从 ioredis、node-redis 迁移
- 专设“LLM 常见错误”一节,纠正手动 JSON 序列化、把数字当字符串处理等写法
3. 适用场景
分类:工程效率与代码质量。
- 在 Serverless / Edge 函数里加缓存、会话、计数器、排行榜
- 用 Redis 做分布式锁、队列、Streams 消费组
- 从 ioredis / node-redis 迁移到 HTTP 客户端
- 给 Upstash Redis 加全文搜索与聚合
受益人群:使用 Upstash Redis 的全栈与前端开发者。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 仓库带 Claude Code 插件清单,也可用 skills CLI 安装 |
| Codex | 原生支持 | 仓库带 Codex 插件清单 |
| OpenClaw | 未验证 | 遵循通用 Agent Skills 格式,理论可复制使用,未见官方说明 |
| Hermes Agent | 未验证 | 同上 |
5. 推荐理由
Serverless 下用 Redis 的坑(HTTP 客户端的自动序列化、pipeline 返回结构、副本读写一致性)LLM 凭印象常写错。该技能由 SDK 厂商维护,覆盖面从基础命令到搜索、向量、迁移,且有“常见错误”对照,能直接减少返工。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 厂商官方出品;技能安装量约 1.98 万,底层 SDK 周下载约 547 万 |
| 可用性 | 9 | 一条命令安装;文档含大量示例与反例;近一个月有提交;需要一个 Upstash Redis(有免费额度) |
| 安全性 | 8 | 纯文档型技能,无脚本;SKILL.md 建议 agent 在用户没提供数据库时向 upstash.com 发一次 POST 申请 3 天临时库 |
综合 = 三项均值 = 8.33。
安全检查清单:
- 执行 shell:无,仅文档
- 运行时联网:技能本身不联网;示例中的 SDK 访问用户自己的 Upstash Redis;另有一处建议向 upstash.com/start-redis 申请临时库(扣分项)
- 凭据:示例用
Redis.fromEnv()读取环境变量,不要求硬编码 - 可疑指令:通读 32 个文件,除上述临时库提示外未发现
- 作者信誉:Upstash 为知名 Serverless 数据服务商
- License:MIT
- 维护:2026 年 9~10 月持续有提交
7. 跟同类 Skills 相比的优势
| 方案 | 定位 | 差异 |
|---|---|---|
| 本技能(Upstash 官方) | @upstash/redis HTTP 客户端 |
覆盖 Serverless 特有用法、Redis Search、向量、迁移 |
| Upstash 的 upstash-ratelimit-js 技能 | @upstash/ratelimit 专用 |
专注限流算法与成本,不涉及其他数据结构 |
| Redis 官方 agent skills(redis-core 等) | 通用 Redis 开发与运维 | 面向 TCP 客户端与自建/云端 Redis,不讲 HTTP 客户端的序列化与 Edge 约束 |
| Azure Cache for Redis 类技能 | 云厂商托管 Redis | 绑定 Azure 服务,与 Upstash 无关 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。可参考的间接信号:@upstash/redis 在 npm 上周下载约 547 万次,skills.sh 安装量约 1.98 万。
9. 其他补充
- 同一仓库还有 QStash、Workflow、Vector、Search、Ratelimit 等 Upstash SDK 技能,以及合并全部内容的
upstash总技能 - 仓库同时提供插件清单,可同时安装 Upstash 官方 MCP 服务
10. 安装使用方式
# 仅安装本技能
npx skills add https://github.com/upstash/skills --skill upstash-redis-js
# Claude Code 插件(技能 + MCP)
/plugin marketplace add upstash/skills
/plugin install upstash@upstash
安装后在项目里说“用 Upstash Redis 加个缓存”“做个排行榜”等即可触发;使用前需 npm install @upstash/redis 并设置 UPSTASH_REDIS_REST_URL / UPSTASH_REDIS_REST_TOKEN。
11. 注意事项
- 仅覆盖
@upstash/redis(TS/JS HTTP 客户端),不适用于 TCP 客户端的通用 Redis 用法(Search 部分有适配器说明) - 依赖 Upstash Redis;超出免费额度后按命令数计费
- 技能中提到 agent 可自行申请 3 天临时库,使用前建议确认是否允许 agent 自动创建外部资源
- 技能内容随 SDK 迭代,建议定期更新