前言¶
在 DSH 里让智能体接入 Upstash 的 Redis、向量库、消息队列或工作流时，常见做法是反复贴文档片段，或在对话里手动说明 SDK 用法。文档分散在多个产品线下，智能体容易混淆 API、漏掉初始化步骤，或在 QStash、Workflow 等场景里选错接入方式。
下面介绍 upstash/skills。它把 Upstash 各产品线整理成一组可加载的 Agent Skills，并附带 MCP 服务器配置，让编码智能体按任务读取对应说明，而不是从零拼凑文档。
这是什么¶
upstash/skills 是 upstash 维护的技能集合，面向使用 Upstash SDK 的 AI 编码智能体。仓库自述将其定位为「packaged instructions and resources that extend agent capabilities」。
同一仓库同时兼容 Agent Skills、Claude Code 插件、Cursor 插件、OpenAI Codex 插件和 DeepSeek Harness bundle 等分发方式。在 SkillHub 社区目录中归类为「联网工具」，当前 GitHub 星标 21、fork 7。
包含哪些技能¶
仓库 README 列出以下子技能，每个对应一个 Upstash 产品或工具链：
| 技能 | 说明 |
|---|---|
| upstash | 覆盖全部 Upstash SDK 的综合技能 |
| upstash-box-js | 带 AI 智能体、shell、文件系统和 git 的沙箱云容器（JavaScript） |
| upstash-box-py | 同上，Python SDK |
| upstash-cli | 通过 upstash CLI 调用 Upstash Developer API |
| upstash-qstash-js | 基于 HTTP 端点的无服务器消息与调度 |
| upstash-ratelimit-js | Redis Rate Limit TypeScript SDK 限流 |
| upstash-redis-js | 无服务器 Redis：缓存、会话、排行榜、全文检索等 |
| upstash-redis-start | 为智能体快速开通零配置、免注册的临时 Redis |
| upstash-search-js | 全文检索入门、核心概念与 TypeScript SDK |
| upstash-vector-js | 向量库功能、SDK 用法与框架集成 |
| upstash-workflow-js | 持久化工作流：定义、触发与管理多步流程 |
智能体按任务加载相关子技能，避免一次性塞入全部文档。
在 DeepSeek Harness 中安装¶
DSH 安装会同时写入技能包和 Upstash MCP 服务器，需要系统 PATH 中已有 pnpm。
1、将插件加入指定 profile（web 为 dsh web 启动时使用的 profile）：
dsh plugin --profile web add github:upstash/skills
2、启动 Harness：
dsh web
3、在会话内写入 Upstash 凭据（可选，仅 MCP 连账号时需要）：
/upstash-login YOUR_EMAIL YOUR_API_KEY
凭据保存在 ~/.dsh/.credentials.yaml。README 写明：技能本身不依赖凭据即可使用；邮箱与 API Key 齐备后，MCP 服务器会自动连接，用于创建数据库、查看 QStash 日志等账号级操作。
典型用法¶
按产品线提问¶
安装并启动 DSH 后，在对话中直接描述目标，例如「用 upstash-redis-js 做会话缓存」或「用 QStash 定时调用 webhook」。智能体应加载对应子技能中的 SDK 说明与示例，而不是泛读整份 Upstash 文档。
临时 Redis¶
需要快速验证 Redis 逻辑、又不想先走完整注册流程时，可指向 upstash-redis-start 技能，按其中步骤开通 scratch 数据库。
账号级操作需 MCP¶
创建生产库、发布消息、查询向量等需调用 Upstash API 的操作，在登录后由捆绑的 @upstash/mcp-server 完成。未执行 /upstash-login 时，技能仍可提供代码与概念指导，但无法代你操作账号资源。
其他客户端（参考）¶
同一仓库也支持通用 Agent Skills CLI：
npx skills add upstash/skills
OpenCode、Zed 等客户端可通过 --agent 参数安装；Claude Code、Codex 各有独立 marketplace 命令。若你不在 DSH 环境工作，可查阅 GitHub README 选择对应段落。
适用场景与注意¶
适合谁
- 已在或计划使用 Upstash Redis、Vector、Search、QStash、Workflow、Box 等服务的全栈或后端开发者；
- 希望在 DSH、Cursor、Claude Code 等编码智能体里减少「查文档—复制—改参数」循环的团队。
使用前请确认
- 插件以当前 DSH 进程权限运行；安装前建议阅读 github.com/upstash/skills 源码与许可证，确认符合你的安全与合规要求。
- Cursor 官方市场尚未收录该插件（README 称等待上架）；DSH 用户应使用上文
dsh plugin --profile web add路径，而非假设已在 Cursor Marketplace 一键安装。 - 涉及真实账号与数据时，API Key 仅写入本地凭据文件，勿提交到版本库。
结尾¶
upstash/skills 把 Upstash 多产品线的 SDK 与操作说明打包成可按需加载的技能，并在 DSH 中与 MCP 服务器一并安装，适合需要智能体协助编写、调试 Upstash 集成代码的场景。
- 社区目录：skillhub.cn/plugins/upstash/skills
- 源码与完整安装说明：github.com/upstash/skills
