返回
提供对 Redis 缓存的深度诊断能力，支持主缓存与系统缓存双模式查询，可检索键值、类型、过期时间、哈希结构、集合成员、列表内容等，并能获取服务器状态信息，适用于缓存问题排查、数据验证及运行时状态监控…
简介
提供对 Redis 缓存的深度诊断能力，支持主缓存与系统缓存双模式查询，可检索键值、类型、过期时间、哈希结构、集合成员、列表内容等，并能获取服务器状态信息，适用于缓存问题排查、数据验证及运行时状态监控…
核心能力速览
✓所属分类：🗄️ 数据库
✓通过 Agent Skills 协议，将「能力」封装为可复用、可安装的 AI 组件
✓支持按需加载领域知识与工具，让通用模型转变为特定任务的专家
适用场景
适用于「🗄️ 数据库」相关场景，可作为可复用的 AI 能力组件，接入支持 Agent Skills 的 AI 客户端（如 Claude、Cursor、Cline 等），按需调用以扩展模型能力。
Skills.MD
| name | redis-inspect |
| description | Inspect Redis cache keys, values, and TTLs for debugging. Supports both main cache and system cache. Use for debugging cache issues, checking cached values, and monitoring cache state. Read-only by default. |
Redis Cache Inspector
Use this skill to inspect Redis cache state for debugging purposes.
Running Commands
node .claude/skills/redis-inspect/query.mjs <command> [options]
Commands
| Command | Description |
|---|---|
get <key> |
Get a string value |
keys <pattern> |
Find keys matching pattern (use * as wildcard) |
ttl <key> |
Get TTL (-1 = no expiry, -2 = not found) |
type <key> |
Get the type of a key |
exists <key> |
Check if key exists |
hgetall <key> |
Get all fields from a hash |
hget <key> <field> |
Get a specific hash field |
scard <key> |
Get set cardinality (count) |
smembers <key> |
Get all set members |
llen <key> |
Get list length |
lrange <key> |
Get list elements |
del <key> |
Delete a key (requires --writable) |
info |
Get Redis server info |
Options
| Flag | Description |
|---|---|
--sys |
Use system cache instead of main cache |
--writable |
Allow write operations (required for del) |
--json |
Output raw JSON |
--limit <n> |
Limit results (default: 100) |
Cache Types
The project has two Redis instances:
| Cache | Flag | Env Variable | Purpose |
|---|---|---|---|
| Main Cache | (default) | REDIS_URL |
Regular cache, cluster mode, can be lost |
| System Cache | --sys |
REDIS_SYS_URL |
Persistent system values, single node |
Main Cache (default)
Regular application cache. Data here can be regenerated if lost.
- User sessions
- Cached queries
- Temporary data
- Rate limiting counters
System Cache (--sys)
Persistent system configuration and state. More critical data.
- Feature flags
- Generation limits/status
- System permissions
- Job state
- Event configurations
Examples
# Find keys matching a pattern
node .claude/skills/redis-inspect/query.mjs keys "user:*" --limit 20
node .claude/skills/redis-inspect/query.mjs keys "packed:caches:*"
# Get a value
node .claude/skills/redis-inspect/query.mjs get "session:data2:123456"
# Check system cache values
node .claude/skills/redis-inspect/query.mjs --sys get "system:features"
node .claude/skills/redis-inspect/query.mjs --sys hgetall "system:entity-moderation"
# Check TTL
node .claude/skills/redis-inspect/query.mjs ttl "generation:count:123"
# Inspect a hash
node .claude/skills/redis-inspect/query.mjs hgetall "packed:caches:cosmetics"
node .claude/skills/redis-inspect/query.mjs hget "system:entity-moderation" "entities"
# Check set size
node .claude/skills/redis-inspect/query.mjs scard "queues:seen-images"
# Get server info
node .claude/skills/redis-inspect/query.mjs info
node .claude/skills/redis-inspect/query.mjs --sys info
Common Key Patterns
Main Cache
| Pattern | Description |
|---|---|
user:* |
User data |
session:* |
Session data |
packed:caches:* |
Packed/compressed cached data |
packed:user:* |
Packed user cache |
generation:* |
Generation-related cache |
tag:* |
Tag cache |
System Cache
| Pattern | Description |
|---|---|
system:* |
System configuration |
generation:* |
Generation limits/status |
download:limits |
Download limits |
job:* |
Job state |
event:* |
Event configurations |
new-order:* |
New Order game state |
daily-challenge:* |
Daily challenge config |
Debugging Tips
# Check if a user's session exists
node .claude/skills/redis-inspect/query.mjs keys "session:data2:*" --limit 10
# Check generation status
node .claude/skills/redis-inspect/query.mjs --sys get "generation:status"
# Check feature flags
node .claude/skills/redis-inspect/query.mjs --sys hgetall "system:features"
# Check cache memory usage
node .claude/skills/redis-inspect/query.mjs info
Write Operations
Write operations require --writable flag and user approval:
# Delete a specific key (requires approval)
node .claude/skills/redis-inspect/query.mjs del "some:key" --writable
IMPORTANT: Always ask the user for permission before using --writable.
快捷安装
在终端执行以下命令，即可将本 Skill 安装到本地 AI 客户端：
npx skills add civitai/civitai