lumina_redis SKILL.md skillC
lumina_redis from zwl467135974/lumina is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add zwl467135974/lumina/lumina_redis@git:20260713.24dee5fPins git:20260713.24dee5f in mdr.lock. Pin the fingerprint instead.
- Audit grade
- C, 14 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- zwl467135974/lumina
- Path
.agents/skills/lumina_redis/SKILL.md- Versions recorded
- 1
- Latest version
- git:20260713.24dee5f, committed Jul 13, 2026
- Size
- 3,186 bytes
- Repository stars
- 91
- License
- Apache-2.0
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Lumina Redis 操作规范
## 核心原则
**所有 Redis 操作必须通过 `RedisCacheManager` 统一封装，禁止在业务代码中直接注入 `RedisTemplate` 或 `RedissonClient`。**
## 为什么
项目使用 Redisson 作为 Redis 客户端，`RedisConfig` 中配置了 `RedisTemplate` 使用 Jackson 序列化器。如果业务代码直接用 `RedisTemplate`，会导致：
1. **序列化器不兼容** — RedisTemplate 的 Jackson 序列化器与 Redisson 原生编码器格式不同，跨服务读写失败
2. **操作分散** — 同一个 Redis 操作逻辑散落在各 Service 中，无法统一管理（过期策略、key 命名、日志）
3. **测试困难** — 直接依赖底层客户端，Mock 困难
## RedisCacheManager 位置
```
lumina-framework/src/main/java/io/lumina/framework/cache/RedisCacheManager.java
```
## 支持的操作
| 方法 | 用途 | 示例 |
|------|------|------|
| `set(key, value, ttl)` | KV 缓存 | 权限缓存、配置缓存 |
| `get(key)` | KV 读取 | |
| `delete(key)` | KV 删除 | |
| `exists(key)` | 判断存在 | |
| `expire(key, ttl)` | 设置过期 | |
| `zAdd(key, score, member)` | ZSET 添加 | 在线用户记录 |
| `zRemove(key, member)` | ZSET 删除 | 强制下线 |
| `zRange(key)` | ZSET 查询 | 在线用户列表 |
| `zScore(key, member)` | ZSET 分数 | 登录时间 |
| `cacheUserPermissions(userId, perms)` | 业务专用 | 权限缓存 |
| `addTokenToBlacklist(token, ttl)` | 业务专用 | Token 黑名单 |
## 正确用法
```java
// ✅ 正确：通过 RedisCacheManager
@RequiredArgsConstructor
public class OnlineUserServiceImpl {
private final RedisCacheManager redisCacheManager;
…Read the whole file at its exact version.
How to install
mdr add zwl467135974/lumina/lumina_redis@sha256:714cce4485eb9ee3The line at the top of this page pins the label git:20260713.24dee5f, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_nan4hjikbcnpdmok)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Jul 13, 2026.
Audit of the latest version
- fail: Frontmatter block present
- fail: Frontmatter declares a name
- fail: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (3186 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.
Source
zwl467135974/lumina · 91 stars · license Apache-2.0 · pushed 2026-09-28 · branch master
API
GET https://markdownregistry.com/api/v1/artifacts/art_nan4hjikbcnpdmok GET https://markdownregistry.com/api/v1/resolve?ref=zwl467135974/lumina/lumina_redis GET https://markdownregistry.com/api/v1/blob/714cce4485eb9ee38ef9fca9c4cd33e1f1a33c579759d849ac6f08e9225ef655
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.