Grafana Readonly
Use this skill as the default Grafana entrypoint for analytics work.
Core workflow
- 1. Find the relevant dashboard.
- Inspect its panels and variables.
- Prefer reading or rerunning an existing panel before writing a new query.
- Stay read-only unless the user explicitly asks for creation or modification work.
Default task order
1. Locate the dashboard
Use dashboard search/list actions first.
Prefer this when the user asks things like:
- - “这个指标在哪个看板里?”
- “有没有收入/LTV/注册转化相关看板?”
- “帮我找睡眠内容消费的图表”
2. Inspect the dashboard structure
After finding a likely dashboard, read:
- - dashboard title / uid
- panel list
- variable list
- default time range or refresh settings if available
Do this before answering confidently. Many mistakes come from grabbing the wrong panel.
3. Inspect the panel query
Before explaining a metric definition, extract the panel query/config.
Look for:
- - datasource
- query language / query text
- ref IDs / multiple queries
- variable references
- transformations
Use this when the user asks:
- - “这个图怎么算的?”
- “这个 DAU 的口径是什么?”
- “这个 panel 背后查的是哪张表/哪个 datasource?”
4. Rerun the panel query
When the user wants the same chart under another condition, rerun the existing panel query with:
- - a different time range
- different variables
- a different format if supported
Prefer rerunning an existing panel over inventing a new query.
Read-only rules
- - Do not create dashboards in this skill.
- Do not update dashboards in this skill.
- Do not delete dashboards, panels, alerts, or annotations.
- If the task requires new dashboard creation, hand off to a build-oriented skill or explicit implementation flow.
Answering rules
When replying after Grafana reads, provide:
- - the answer first
- the panel/dashboard used
- any key variable or time-range assumptions
- uncertainty if the panel does not fully match the question
Do not dump raw Grafana JSON unless the user explicitly wants it.
Minimum action coverage
This skill is expected to support these read paths:
- - search dashboards
- get dashboard details
- list panels
- get panel query
- list variables
- run panel query
If an installed Grafana skill does not cover most of these, treat it as partial coverage and plan a local supplement.
When Grafana is not enough
Escalate beyond this skill when:
- - no matching dashboard/panel exists
- the user needs an arbitrary new SQL query
- the needed split is not supported by existing variables
- the user is asking for a new dashboard design
In those cases, switch to the analytics workflow skill and decide whether to use Grafana datasource queries or direct ClickHouse.
References
Read these only when needed:
- -
references/action-checklist.md for the concrete Grafana action matrix and MVP coverage - INLINECODE1 for why
rpe-grafana is a lightweight candidate and where it likely falls short
Grafana 只读
将此技能作为分析工作的默认 Grafana 入口点。
核心工作流程
- 1. 找到相关看板。
- 检查其面板和变量。
- 在编写新查询之前,优先读取或重新运行现有面板。
- 除非用户明确要求创建或修改工作,否则保持只读状态。
默认任务顺序
1. 定位看板
首先使用看板搜索/列表操作。
当用户提出如下问题时优先使用此方法:
- - “这个指标在哪个看板里?”
- “有没有收入/LTV/注册转化相关看板?”
- “帮我找睡眠内容消费的图表”
2. 检查看板结构
找到可能的看板后,读取:
- - 看板标题 / uid
- 面板列表
- 变量列表
- 默认时间范围或刷新设置(如有)
在自信回答之前执行此操作。许多错误源于抓取了错误的面板。
3. 检查面板查询
在解释指标定义之前,提取面板查询/配置。
查找:
- - 数据源
- 查询语言 / 查询文本
- 引用 ID / 多个查询
- 变量引用
- 转换
当用户提出如下问题时使用此方法:
- - “这个图怎么算的?”
- “这个 DAU 的口径是什么?”
- “这个 panel 背后查的是哪张表/哪个 datasource?”
4. 重新运行面板查询
当用户想要在另一种条件下查看相同图表时,使用以下方式重新运行现有面板查询:
- - 不同的时间范围
- 不同的变量
- 不同的格式(如果支持)
优先重新运行现有面板,而不是发明新的查询。
只读规则
- - 不要在此技能中创建看板。
- 不要在此技能中更新看板。
- 不要删除看板、面板、警报或注释。
- 如果任务需要创建新看板,请移交给面向构建的技能或明确的实现流程。
回答规则
在 Grafana 读取后回复时,提供:
- - 首先给出答案
- 所使用的面板/看板
- 任何关键变量或时间范围假设
- 如果面板不完全匹配问题,说明不确定性
除非用户明确要求,否则不要转储原始的 Grafana JSON。
最小操作覆盖范围
此技能应支持以下读取路径:
- - 搜索看板
- 获取看板详情
- 列出面板
- 获取面板查询
- 列出变量
- 运行面板查询
如果已安装的 Grafana 技能未涵盖大部分这些功能,则视为部分覆盖,并计划本地补充。
当 Grafana 不足时
在以下情况下升级到此技能之外:
- - 不存在匹配的看板/面板
- 用户需要任意的新 SQL 查询
- 所需的分割不受现有变量支持
- 用户要求设计新看板
在这些情况下,切换到分析工作流技能,并决定是使用 Grafana 数据源查询还是直接使用 ClickHouse。
参考资料
仅在需要时阅读这些内容:
- - references/action-checklist.md 了解具体的 Grafana 操作矩阵和 MVP 覆盖范围
- references/evaluation-notes.md 了解为什么 rpe-grafana 是一个轻量级候选方案及其可能的不足之处