Agent Skills › bacoco/BMad-Skills › bmad-observability-readiness

bmad-observability-readiness

GitHub

建立监控、日志和追踪基础，提供可观测性计划、SLO 定义及告警策略。适用于缺失监控、发布前检查或告警噪音治理场景。

.claude/skills/bmad-observability-readiness/SKILL.md bacoco/BMad-Skills

Trigger Scenarios

提及日志、指标或追踪缺失发布前请求监控/告警设置需要 SLO 或告警降噪

Install

npx skills add bacoco/BMad-Skills --skill bmad-observability-readiness -g -y

More Options

Non-standard path

npx skills add https://github.com/bacoco/BMad-Skills/tree/main/.claude/skills/bmad-observability-readiness -g -y

Use without installing

npx skills use bacoco/BMad-Skills@bmad-observability-readiness

指定 Agent (Claude Code)

npx skills add bacoco/BMad-Skills --skill bmad-observability-readiness -a claude-code -g -y

安装 repo 全部 skill

npx skills add bacoco/BMad-Skills --all -g -y

预览 repo 内 skill

npx skills add bacoco/BMad-Skills --list

SKILL.md

Frontmatter

{
    "name": "bmad-observability-readiness",
    "metadata": {
        "outputs": [
            "observability-plan",
            "instrumentation-backlog",
            "slo-dashboard-spec"
        ],
        "triggers": {
            "keywords": [
                "observability",
                "logging",
                "monitoring",
                "tracing",
                "metrics",
                "alerting",
                "telemetry"
            ],
            "patterns": [
                "add logging",
                "monitoring setup",
                "no telemetry",
                "instrument this",
                "observability gaps",
                "alert fatigue",
                "SLO dashboard"
            ]
        },
        "auto-invoke": true,
        "capabilities": [
            "instrumentation-design",
            "metrics-cataloging",
            "logging-standards",
            "alert-tuning",
            "slo-definition"
        ],
        "prerequisites": [
            "bmad-architecture-design",
            "bmad-test-strategy"
        ]
    },
    "description": "Establishes instrumentation, monitoring, and alerting foundations.",
    "allowed-tools": [
        "Read",
        "Write",
        "Grep",
        "Bash"
    ]
}

BMAD Observability Readiness Skill

When to Invoke

Use this skill when the user:

Mentions missing or low-quality logging, metrics, or tracing.
Requests monitoring/alerting setup before a launch or major release.
Needs SLOs, dashboards, or on-call runbooks.
Reports alert fatigue or noise that needs rationalization.
Wants to ensure performance and reliability work has data coverage.

If instrumentation already exists and only specific bug fixes are required, hand over to bmad-development-execution with the backlog produced here.

Mission

Deliver a comprehensive observability plan that enables diagnosis, alerting, and measurement across the system. Ensure downstream performance, reliability, and security work has trustworthy telemetry.

Inputs Required

Architecture diagrams and component inventory.
Existing logging/monitoring/tracing configuration (if any).
Current incidents, outages, or blind spots experienced by the team.
SLAs/SLOs, business KPIs, or compliance reporting requirements.

Outputs

Observability plan detailing metrics, logs, traces, dashboards, and retention policies.
Instrumentation backlog with implementation tasks, owners, and acceptance criteria.
SLO dashboard specification covering golden signals, alert thresholds, and runbook links.
Updated runbook or escalation paths if gaps were discovered.

Process

Audit current telemetry coverage, tooling, and data retention. Document gaps.
Define observability objectives aligned with user journeys and business KPIs.
Design instrumentation strategy: metrics taxonomy, structured logging, trace spans, event schemas.
Establish SLOs, SLIs, and alerting strategy with on-call expectations and noise controls.
Produce dashboards/reporting requirements and data governance notes.
Create backlog with prioritized instrumentation tasks and verification approach.

Quality Gates

Every critical user journey has metrics and alerts defined (latency, errors, saturation, traffic).
Logging standards specify structure, PII handling, and retention.
Alert runbooks documented or flagged for creation.
Observability plan references integration with performance, security, and incident workflows.

Error Handling

If telemetry tooling is undecided, present comparative options with trade-offs.
Highlight dependencies on platform teams or infrastructure before finalizing timeline.
Escalate when observability requirements conflict with compliance or privacy constraints.