alert-design
アラート設計とAlert Fatigue回避の専門スキル。Mike Julianの『入門 監視』に基づく、アクション可能で過負荷を避けるアラートシステム設計を提供します。Anchors:• 『入門 監視』(Mike Julian)/ 適用: アラート設計とAlert Fatigue回避戦略 / 目的: アクション可能で過負荷を避けるアラートシステム構築Triggers:- アラートシステムを設計する時、Alert Fatigueを回避したい時に使用- アラート閾値を統計的に設定する時に使用- 通知ルーティング戦略を定義する時に使用- 既存アラートの有効性を改善する時に使用
When & Why to Use This Skill
This Claude skill provides expert guidance on alert system design and alert fatigue prevention, based on Mike Julian's 'Practical Monitoring.' It enables SRE and DevOps teams to build actionable, noise-free monitoring systems by defining statistical thresholds, optimizing notification routing, and ensuring every alert triggers a clear, meaningful response.
Use Cases
- Designing a new alerting framework from scratch to prevent alert fatigue and ensure high signal-to-noise ratios.
- Setting statistical thresholds for system metrics to reduce false positives and improve incident detection accuracy.
- Developing notification routing policies to ensure critical incidents reach the correct responders without overwhelming the team.
- Reviewing and auditing existing alert rules to transform vague notifications into actionable operational tasks.
- Improving the effectiveness of legacy monitoring systems by applying industry-standard best practices for observability.
| name | alert-design |
|---|---|
| description | | |
| • 『入門 監視』(Mike Julian)/ 適用 | アラート設計とAlert Fatigue回避戦略 / 目的: アクション可能で過負荷を避けるアラートシステム構築 |
Alert Design - アラート設計とAlert Fatigue回避
概要
アラート設計とAlert Fatigue回避の専門スキル。Mike Julianの『入門 監視』に基づく、アクション可能で過負荷を避けるアラートシステム設計を提供します。
このスキルは以下の領域をカバーします:
- アラートルール設計: ビジネスロジックに基づく適切なアラート条件の定義
- 閾値設定方法論: 統計的根拠に基づいた閾値設定プロセス
- Alert Fatigue回避: 過度な通知を減らし、重要なアラートのシグナル-ノイズ比を改善
- アクション可能なアラート: オペレーターが即座に対応可能なアラート設計
- 通知ルーティング: 適切なチームメンバーへのアラート配信戦略
ワークフロー
Phase 1: 目的と前提の整理
目的: タスクの目的と前提条件を明確にする
アクション:
- タスクの背景と現状を把握
- 関連リソース(Level 1-4)を確認して知識ベースを整理
- 必要なスクリプトやテンプレートを特定
Task: agents/analyze-alert-context.md を参照
Phase 2: スキル適用と実装
目的: スキルの指針に従って具体的なアラート設計を実施
アクション:
references/actionable-alert-design.mdを参照しながらアラート条件を定義references/threshold-setting-guide.mdに従って統計的根拠のある閾値を設定references/alert-fatigue-prevention.mdでよくあるアンチパターンを確認assets/alert-rules-template.yamlを使用してアラートルールを記述
Task: agents/design-alerts.md を参照
Phase 3: 検証と記録
目的: 成果物の検証と実行記録の保存
アクション:
scripts/validate-skill.mjsでスキル構造を確認scripts/analyze-alert-effectiveness.mjsでアラート有効性を検証- 成果物が目的に合致するか確認
scripts/log_usage.mjsを実行して記録を残す
Task: agents/validate-alerts.md を参照
Task仕様ナビ
| タスクタイプ | 説明 | 参照リソース | テンプレート | 検証スクリプト |
|---|---|---|---|---|
| アラートルール設計 | 監視対象のメトリクスに対するアラート条件を定義 | Level1_basics.md, actionable-alert-design.md | alert-rules-template.yaml | validate-skill.mjs |
| 閾値設定 | 統計的手法に基づいた適切な閾値値を決定 | Level2_intermediate.md, threshold-setting-guide.md | alert-rules-template.yaml | analyze-alert-effectiveness.mjs |
| Alert Fatigue回避 | 過度な通知を削減し、信号対ノイズ比を改善 | Level3_advanced.md, alert-fatigue-prevention.md | - | analyze-alert-effectiveness.mjs |
| 通知ルーティング設計 | アラートを適切なチームメンバーへ配信するポリシーを定義 | Level2_intermediate.md, actionable-alert-design.md | alert-rules-template.yaml | validate-skill.mjs |
| アラート有効性レビュー | 既存アラートの実効性を測定・改善 | Level4_expert.md, alert-fatigue-prevention.md | - | analyze-alert-effectiveness.mjs |
ベストプラクティス
すべきこと
- 明確な目的を持つ: アラートが何を検知し、誰がどのように対応すべきかを明確にする
- 統計的根拠を用いる: ランダムな値ではなく、過去データに基づいた閾値を設定
- アクション可能な設計: アラート受信者が即座に対応できる明確な指示を含める
- 段階的エスカレーション: 重大度に応じた通知ルーティングを設計
- 定期的なレビュー: アラート有効性を定期的に測定し、改善を繰り返す
- ノイズ削減: 無視されているアラートや頻出するアラートを積極的に排除
- ドキュメント化: アラートルールの意図と設定理由を記録
避けるべきこと
- 任意の閾値設定: 根拠のない数値でアラートを設定しない
- 過度な感度: システムを揺さぶるノイズの多い設定を避ける
- 不足した感度: 実際の問題を見落とすほど鈍感な設定を避ける
- アクション不可能な設計: 受信者が対応できないアラートを作成しない
- チーム間の混乱: 誰が何に対応すべきかが不明なルーティングを避ける
- スタティック化: ビジネス環境の変化に対応できない固定化されたルール
リソース参照
レベル別ガイド
- Level 1 (基礎):
references/Level1_basics.md- アラート設計の基本概念 - Level 2 (実務):
references/Level2_intermediate.md- 実装的なガイドと事例 - Level 3 (応用):
references/Level3_advanced.md- 複雑なシステムでの設計パターン - Level 4 (専門):
references/Level4_expert.md- 業界標準と先進的なテクニック
領域別リソース
- アラート設計:
references/actionable-alert-design.md - Alert Fatigue対策:
references/alert-fatigue-prevention.md - 閾値設定方法論:
references/threshold-setting-guide.md - 過去ドキュメント:
references/legacy-skill.md
スクリプト
# スキル構造の検証
node .claude/skills/alert-design/scripts/validate-skill.mjs
# アラート有効性の分析
node .claude/skills/alert-design/scripts/analyze-alert-effectiveness.mjs
# 使用記録の保存
node .claude/skills/alert-design/scripts/log_usage.mjs
テンプレート
- アラートルール定義:
assets/alert-rules-template.yaml
変更履歴
| Version | Date | Changes |
|---|---|---|
| 2.0.0 | 2025-12-31 | agents/3ファイル追加、Phase別Task参照を追加 |
| 1.0.0 | 2025-12-31 | 18-skills.md仕様に準拠した完全リファイン。Task仕様ナビを追加、Triggers・allowed-toolsを実装、本文構成を統一 |
| 0.9.0 | 2025-12-24 | 初期実装とアーティファクト統合 |