lumina_observability SKILL.md skillA
lumina_observability 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_observability@git:20260713.24dee5fPins git:20260713.24dee5f in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- zwl467135974/lumina
- Path
.agents/skills/lumina_observability/SKILL.md- Versions recorded
- 1
- Latest version
- git:20260713.24dee5f, committed Jul 13, 2026
- Size
- 4,763 bytes
- Repository stars
- 91
- License
- Apache-2.0
Use this skill when adding logging, audit, or metrics instrumentation. Covers MDC traceId injection, @Audit annotation for declarative audit logging, and Micrometer Timer/Counter for Prometheus metrics.
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 可观测性规范
## 功能概述
本技能包用于规范 Lumina 框架的日志、审计和指标埋点，包括 MDC 链路追踪注入、`@Audit` 声明式审计日志、Micrometer 指标采集（Prometheus），确保系统运行状态可观测、可追溯。
## 日志规范（MDC）
### traceId 自动注入
`LogContextInterceptor` 拦截器在每个 HTTP 请求进入时自动注入 MDC 上下文：
| MDC Key | 来源 | 说明 |
|---------|------|------|
| `traceId` | 自动生成（UUID 短格式） | 链路追踪 ID，贯穿整个请求 |
| `tenantId` | 请求头 / Token | 当前租户 ID |
| `userId` | Token 解析 | 当前用户 ID |
### 日志 Pattern 配置
```xml
<pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level [%X{traceId:--}] %logger{36} - %msg%n</pattern>
```
- 使用 `%X{traceId:--}` 输出 traceId，无值时显示 `--`
- 所有日志自动携带 traceId，便于全链路问题排查
- 业务日志中无需手动输出 traceId
### 日志使用规范
```java
private static final Logger log = LoggerFactory.getLogger(UserService.class);
log.info("用户创建成功, userId={}, username={}", userId, username);
log.warn("租户配额即将用尽, tenantId={}, used={}/{}", tenantId, used, quota);
log.error("Agent 执行失败, agentId={}", agentId, e);
```
- 使用 SLF4J + 占位符（`{}`），禁止字符串拼接
- 关键操作记录 INFO，异常记录 ERROR（带异常堆栈）
## 审计日志（@Audit）
### 声明式审计标注
```java
@Audit(module = "用户管理", action = "CREATE", description = "创建用户")
@PostMapping("/users")
public Result<UserVO> create(@RequestBody @Valid CreateUserDTO dto) {
// ...
}
```
…Read the whole file at its exact version.
How to install
mdr add zwl467135974/lumina/lumina_observability@sha256:8e8c1ce4e9351149The 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_dl56ofg62nvud4qe)
2 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
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (4763 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
Source
zwl467135974/lumina · 91 stars · license Apache-2.0 · pushed 2026-09-28 · branch master
API
GET https://markdownregistry.com/api/v1/artifacts/art_dl56ofg62nvud4qe GET https://markdownregistry.com/api/v1/resolve?ref=zwl467135974/lumina/lumina_observability GET https://markdownregistry.com/api/v1/blob/8e8c1ce4e9351149c7b715978689af6e0f1cea2061d81545ed22be561f9e001d
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.