---

name: metrics-schema-generator description: 为Prometheus、OpenTelemetry和Grafana仪表板生成指标模式 allowed-tools:

• Bash
• Read
• Write
• Glob

---

指标模式生成器技能

概述

为Prometheus、OpenTelemetry指标定义、SLI/SLO规范以及Grafana仪表板配置生成指标模式。

能力

• 生成Prometheus指标模式
• OpenTelemetry指标定义
• SLI/SLO规范生成
• Grafana仪表板生成
• 指标命名约定
• 标签/标记标准化
• 记录规则生成
• 告警规则生成

目标流程

• 可观测性实施
• 性能优化

输入模式

{
  "type": "object",
  "required": ["services"],
  "properties": {
    "services": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": { "type": "string" },
          "type": { "type": "string" },
          "endpoints": { "type": "array" },
          "slos": { "type": "array" }
        }
      }
    },
    "format": {
      "type": "string",
      "enum": ["prometheus", "opentelemetry", "both"],
      "default": "prometheus"
    },
    "options": {
      "type": "object",
      "properties": {
        "includeStandardMetrics": {
          "type": "boolean",
          "default": true
        },
        "generateDashboards": {
          "type": "boolean",
          "default": true
        },
        "generateAlerts": {
          "type": "boolean",
          "default": true
        },
        "namingConvention": {
          "type": "string",
          "enum": ["prometheus", "opentelemetry"],
          "default": "prometheus"
        }
      }
    }
  }
}

输出模式

{
  "type": "object",
  "properties": {
    "metrics": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": { "type": "string" },
          "type": { "type": "string" },
          "description": { "type": "string" },
          "labels": { "type": "array" },
          "unit": { "type": "string" }
        }
      }
    },
    "sloDefinitions": {
      "type": "array"
    },
    "recordingRules": {
      "type": "string",
      "description": "Prometheus记录规则YAML"
    },
    "alertRules": {
      "type": "string",
      "description": "Prometheus告警规则YAML"
    },
    "dashboards": {
      "type": "array",
      "description": "Grafana仪表板JSON定义"
    }
  }
}

使用示例

{
  kind: 'skill',
  skill: {
    name: 'metrics-schema-generator',
    context: {
      services: [
        {
          name: 'api-gateway',
          type: 'http',
          endpoints: ['/api/users', '/api/orders'],
          slos: [{ name: 'availability', target: 99.9 }]
        }
      ],
      format: 'prometheus',
      options: {
        generateDashboards: true,
        generateAlerts: true
      }
    }
  }
}