Redis Skill用户操作文档
更新时间：2026-07-22
概述
bce-redis Skill是面向百度智能云 Redis/SCS 实例运维的 Agent Skill，覆盖 Redis 控制面与数据面操作。安装并配置凭证后，用户可以直接用自然语言向 Agent 描述诉求，Agent 会按 Skill 内置流程完成任务。
能力概览
| 核心能力 | 说明 |
|---|---|
| 环境自检 | 无副作用检查凭证来源、region、endpoint、入口路径和 Redis 密码来源，敏感信息脱敏展示。 |
| 实例查询 | 查询实例列表、详情、状态、规格、拓扑、可用区、计费等信息。 |
| 连接与访问诊断 | 查询连接端点、参数、白名单和公网绑定状态。 |
| 参数与账号管理 | 支持参数查询/修改、账号创建、权限调整和删除。 |
| 备份管理 | 支持备份列表、备份策略、备份 URL 查询，以及手动备份和策略设置。 |
| 规格与拓扑变更 | 支持重启、变配、升级、企业集群版分片调整、普通副本增删。 |
| 生命周期管理 | 支持实例创建和释放。 |
Skill调用
1.安装
压缩包下载地址：https://bce-paas-skills.bj.bcebos.com/v1/bce-redis-skill.zip ，用户可自行下载解压到客户端的 skills 目录下使用，解压即用，无需 npm install。
如使用 Claude/Codex 可直接通过如下命令安装：
Claude：
Bash
1# 用户级安装（推荐，所有项目可用）
2mkdir -p ~/.claude/skills
3curl -fSL -o /tmp/bce-redis-skill.zip \
4 https://bce-paas-skills.bj.bcebos.com/v1/bce-redis-skill.zip
5unzip -oq /tmp/bce-redis-skill.zip -d ~/.claude/skills/
6rm -f /tmp/bce-redis-skill.zip如只想装到当前项目，把上面的 ~/.claude/skills/ 换成项目根目录下的 .claude/skills/ 即可。
验证安装：
Bash
1ls ~/.claude/skills/bce-redis
2# 应看到 SKILL.md README.md dist/ references/ node_modules/ package.jsonCodex：
Bash
1mkdir -p ~/.codex/skills
2curl -fSL -o /tmp/bce-redis-skill.zip \
3 https://bce-paas-skills.bj.bcebos.com/v1/bce-redis-skill.zip
4unzip -oq /tmp/bce-redis-skill.zip -d ~/.codex/skills/
5rm -f /tmp/bce-redis-skill.zip验证安装：
Bash
1ls ~/.codex/skills/bce-redis
2# 应看到 SKILL.md README.md dist/ references/ node_modules/ package.json- 解压后 zip 内含
bce-redis/顶层目录，因此最终路径为<skills 目录>/bce-redis/。 unzip -o会覆盖旧版本，可直接用于升级。
2.配置凭证
用户在配置本 Skill 时，应准备具备 Redis/SCS 相关权限的 AK（Access Key ID）/SK（Secret Access Key）。
参考文档链接：https://cloud.baidu.com/doc/Reference/s/9jwvz2egb
获取步骤
- 登录百度智能云控制台。
- 进入右上角头像菜单，选择“安全认证”。
- 点击“创建 Access Key”。
- 完成安全验证。
- 在创建弹窗中复制或下载保存 Access Key ID 和 Secret Access Key。
推荐做法
- 优先使用子用户 AK/SK，不建议使用主账号 AK/SK。
- 为子用户授予最小必要权限，只开放 Redis/SCS 运维所需权限。
- 创建后立即安全保存 Secret Key，Secret Key 明文仅在创建 AccessKey 时提供，后续不再支持明文查询。
- 不要把 AK/SK 写入代码仓库、聊天对话、命令参数、脚本日志或共享文档。
- AccessKey 不再使用时及时禁用或删除。
Skill 绝不要求把 AK/SK/Redis 密码贴进对话或写入命令参数，凭证通过环境变量提供，缺失时会回落读取 ~/.bce/credentials。
环境变量配置：
Bash
1export BCE_ACCESS_KEY_ID=<your-access-key-id> # 百度智能云 Access Key ID
2export BCE_SECRET_ACCESS_KEY=<your-secret-access-key> # 百度智能云 Secret Access Key
3export BCE_REGION=bj # 地域，例如 bj / gz / su
4export BCE_REDIS_PASSWORD='<redis-password>' # 数据面操作用，也可用 --password-stdin或通过 ~/.bce/credentials 写入：
Plain Text
1[default]
2access_key_id = <your-access-key-id>
3secret_access_key = <your-secret-access-key>
4region = bj安装后先做一次无副作用自检，确认凭证来源、region、endpoint 与入口路径均正确（全部脱敏、不发网络请求），路径请按你的安装位置替换。
Bash
1# Claude / Ducc（用户级）
2node ~/.claude/skills/bce-redis/dist/scripts/scsRedis.js doctor
3
4# Codex
5node ~/.codex/skills/bce-redis/dist/scripts/scsRedis.js doctor3.卸载
卸载即删除对应 skills 目录下的 bce-redis/ 子目录：
Bash
1# Claude / Ducc（用户级）
2rm -rf ~/.claude/skills/bce-redis
3
4# Claude / Ducc（项目级，在项目根目录执行）
5rm -rf .claude/skills/bce-redis
6
7# Codex
8rm -rf ~/.codex/skills/bce-redis删除后重启客户端会话即可让 skill 从可用列表移除。
评价此篇文章