← 返回 Skills 市场

Kansodata Grafana Authoring Operations

Name: Kansodata Grafana Authoring Operations
Author: kansodata

作者 Marcos CF. · GitHub ↗ · v0.1.0 · MIT-0

cross-platform ✓ 安全检测通过

总下载

当前安装

版本数

在 OpenClaw 中安装

/install kansodata-grafana-authoring-operations

功能描述

Gestiona de forma segura la inspección, diagnóstico, propuesta y aplicación controlada de cambios en dashboards y alertas de Grafana usando tooling habilitado.

使用说明 (SKILL.md)

Skill: kansodata-grafana-authoring-operations

Propósito

Esta skill guía al agente para:

inspeccionar estado real de Grafana,
diagnosticar dashboards y alerting,
generar/refactorizar JSON de dashboard,
proponer cambios seguros,
aplicar cambios solo cuando la herramienta write exista y esté habilitada.

Modos operativos

inspect_grafana

Objetivo: estado base de salud, dashboards, datasources, folders y alert rules.
Herramientas: grafana_health_check, grafana_list_dashboards, grafana_list_datasources, grafana_list_alert_rules, grafana_list_folders.

diagnose_dashboard

Objetivo: analizar dashboard por UID y detectar señales de rotura o deuda técnica.
Herramientas: grafana_get_dashboard, grafana_export_dashboard_json.

generate_dashboard_json

Objetivo: producir propuesta JSON para nuevo dashboard (sin aplicar en v1).
Regla: marcar salida como draft o review_ready según contexto disponible.

refactor_dashboard_json

Objetivo: proponer refactor lógico de dashboard existente.
Regla: usar estado actual leído desde Grafana antes de proponer.

propose_alert_rule

Objetivo: proponer reglas de alerta con justificación y riesgo.
Regla: no afirmar aplicabilidad sin verificar datasource/queries/contexto.

apply_dashboard_change

Objetivo: aplicar cambios en dashboard.
Estado v1: restringido; requiere herramienta write habilitada y gate activo.

apply_alerting_change

Objetivo: aplicar cambios de alerting.
Estado v1: restringido; requiere herramienta write habilitada y gate activo.

Niveles de confianza del contexto

grafana_state_confirmed: datos actuales obtenidos por tools read-only.
grafana_state_partial: parte del estado verificado, parte inferido.
grafana_state_assumed: no hay evidencia reciente del entorno.

Estados de madurez de salida

draft: propuesta preliminar; contexto insuficiente o ambiguo.
review_ready: propuesta consistente para revisión humana.
apply_ready: aplicable técnicamente con tooling/gates habilitados.
human_review_required: cambio sensible o riesgo no mitigado.

Reglas de comportamiento obligatorias

Leer estado actual antes de proponer cambios.
No inventar dashboards, folders, datasources ni alert rules.
No borrar recursos en v1.
No afirmar compatibilidad/viabilidad sin verificación real.
Proponer cambios como diff lógico cuando aplique.
Pedir operación write solo si existe tool habilitada y contexto suficiente.
Si falta contexto real, degradar salida a draft.

Degradación segura

Si falla una tool de lectura: reportar bloqueo y continuar con lo verificable.
Si el estado es parcial: marcar explícitamente incertidumbre.
Si se requiere write y no hay gate o tool habilitada: detener y emitir human_review_required.

Casos de uso

Listar dashboards disponibles.
Revisar dashboard por UID.
Exportar JSON para respaldo o versionado lógico.
Detectar dashboard roto (queries/panels inválidos observables en JSON).
Revisar alert rules existentes.
Proponer nueva alerta con justificación.
Preparar clon de dashboard como propuesta (sin aplicar en v1).

安全使用建议

This skill appears coherent for inspecting and proposing Grafana dashboard/alert changes and sensibly restricts write actions, but you should: (1) confirm how the grafana_* tools are provided by your agent/runtime and who controls them; (2) verify where Grafana API credentials live, what scopes they have, and that only minimal read/write scopes are granted; (3) keep write/apply gates disabled until a human review workflow is in place; (4) test in read-only mode first and review any generated JSON/diffs before enabling apply operations. If you cannot confirm how credentials/tooling are provisioned, treat the skill as potentially risky and require additional review.

功能分析

Type: OpenClaw Skill Name: kansodata-grafana-authoring-operations Version: 0.1.0 The skill bundle provides a structured framework for managing Grafana dashboards and alerts. The instructions in SKILL.md prioritize safety by requiring read-only verification before proposing changes, mandating human review for sensitive operations, and explicitly forbidding the deletion of resources. No evidence of data exfiltration, malicious execution, or harmful prompt injection was found; the logic is strictly aligned with its stated purpose of Grafana operations.

能力评估

ℹ Purpose & Capability

The SKILL.md describes read-only inspection, diagnosis, JSON generation/refactor, and gated apply flows using a set of grafana_* tools (e.g., grafana_get_dashboard, grafana_list_dashboards, grafana_export_dashboard_json). That capability set matches the name/description. However, the skill declares no required env vars, binaries, or install steps — it therefore assumes the host/agent runtime provides those grafana_* tools and any necessary credentials. Confirm how those tools and credentials are provisioned; otherwise there is an information gap.

✓ Instruction Scope

Instructions stay on-topic: they instruct the agent to read Grafana state before proposing changes, avoid inventing resources, degrade to drafts when context is lacking, and require a write tool/gate before applying. The SKILL.md does not instruct the agent to read unrelated files, environment variables, or exfiltrate data to unknown endpoints.

✓ Install Mechanism

No install spec and no code files (instruction-only). This is the lowest-risk pattern: nothing is downloaded or written by the skill itself. Any execution risk depends on the platform-provided grafana_* tooling, not on this skill's package.

ℹ Credentials

The skill lists no required environment variables or credentials. Practically, Grafana operations normally require an API URL and token (or similar auth). The absence of declared credentials is acceptable if the platform supplies and controls the grafana_* tools and their secrets, but you should verify where Grafana API credentials live, what scopes they have, and that the agent isn't granted broader secrets than necessary.

✓ Persistence & Privilege

always is false and the skill does not request persistent or elevated platform presence. The SKILL.md explicitly gates write operations and requires tooling/gates to be enabled before applying changes, which limits autonomous destructive capability.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install kansodata-grafana-authoring-operations
安装完成后，直接呼叫该 Skill 的名称或使用 /kansodata-grafana-authoring-operations 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v0.1.0

Initial public release of the Kansodata Grafana skill for OpenClaw. Highlights: - Safe Grafana inspection and diagnosis workflows - Dashboard JSON authoring and refactoring guidance - Read-first operational behavior - Controlled change proposal patterns - Fail-closed posture for write operations without verified tooling - Alignment with the Kansodata Grafana plugin This release focuses on inspection, diagnosis, and proposal workflows. It does not perform write operations by itself.

元数据

Slug kansodata-grafana-authoring-operations

版本 0.1.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题