mcpField
M
major-incident-email

major-incident-email

github.com/happy-technologies-llc生産性4141 回インストール2 日前に更新
リポジトリ

major-incident-email について

ServiceNow の重大インシデントに関するメールを作成するスキルです。インシデント管理者や関係者への連絡を担うチーム向けに、初報、状況更新、復旧通知、事後報告を受信者に合わせて作成します。

主な機能

  1. 01重大インシデントの初報作成
  2. 02定期的な状況更新の作成
  3. 03サービス復旧通知の準備
  4. 04事後報告メールの作成
  5. 05受信者に応じたトーンと詳細の調整

活用シーン

  1. 01重大インシデント発生時の関係者通知
  2. 02対応中の定期的な進捗連絡
  3. 03復旧後の影響と解決状況の確認
  4. 04事後レビュー後の結果共有

MCP 対応

ServiceNow MCP ツールでインシデント、影響を受けた構成アイテム、タイムライン、宛先グループを取得し、送信した連絡をインシデントの作業メモに記録します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/happy-technologies-llc/happy-platform-skills --skill major-incident-email

インストール後、Claude Code で/major-incident-emailを入力して読み込まれたか確認します。

詳細

重大インシデントのメールコミュニケーションの作成

概要

このスキルでは、ServiceNow で重大インシデントに関するプロフェッショナルなメールコミュニケーションを作成する方法を説明します。

  • 影響、範囲、緊急性を明確に伝える初回通知メールを作成する
  • 進捗、実施した対応、次のステップを含む定期的な状況更新メールを作成する
  • サービスの復旧を確認する解決通知メールを作成する
  • 根本原因と改善措置を含むインシデント後の概要コミュニケーションを作成する
  • 対象者(経営幹部、技術担当者、エンドユーザー)に合わせて、コミュニケーションのトーンと詳細度を調整する
  • すべてのインシデントコミュニケーションで、一貫したブランディングと書式を維持する

使用する場面: 重大インシデントが宣言され、関係者への通知が必要な場合、継続中のインシデント管理で定期的な更新を行う場合、サービスが復旧した場合、またはインシデント後レビューが完了した後に使用します。

前提条件

  • ロール: incident_manager、major_incident_manager、itil、または admin
  • アクセス権: incident、sys_journal_field、task_ci、cmdb_ci テーブルへの読み取りアクセス権。コミュニケーションの記録用に sys_journal_field への書き込みアクセス権
  • データ: 必要なフィールドが入力済みの、アクティブな重大インシデントまたは最近解決された重大インシデント
  • 関連スキル: 重大インシデントのプロセス全体については itsm/major-incident、通知の自動設定については development/notifications

手順

ステップ 1:インシデントの詳細を取得する

コミュニケーションに必要な関連インシデントデータをすべて取得します。

MCP を使用する方法:

Tool: SN-Get-Record
Parameters:
  table_name: incident
  sys_id: [INC_SYS_ID]
  fields: sys_id,number,short_description,description,state,priority,impact,urgency,business_service,cmdb_ci,assignment_group,assigned_to,opened_at,resolved_at,closed_at,major_incident_state,business_impact,close_notes,resolution_code,u_major_incident

REST を使用する方法:

GET /api/now/table/incident/[INC_SYS_ID]
  ?sysparm_fields=sys_id,number,short_description,description,state,priority,impact,urgency,business_service,cmdb_ci,assignment_group,assigned_to,opened_at,resolved_at,closed_at,major_incident_state,business_impact,close_notes
  &sysparm_display_value=true
ステップ 2:影響を受けるサービスとユーザーへの影響を特定する

コミュニケーションで伝える影響範囲全体を特定します。

MCP を使用する方法:

Tool: SN-Query-Table
Parameters:
  table_name: task_ci
  query: task=[INC_SYS_ID]
  fields: ci_item,ci_item.name,ci_item.sys_class_name,ci_item.busines_criticality
  limit: 20
Tool: SN-Query-Table
Parameters:
  table_name: cmdb_ci
  query: sys_id=[CI_SYS_ID]
  fields: name,sys_class_name,used_for,support_group,location,busines_criticality
ステップ 3:タイムラインとアクティビティを取得する

状況更新や概要の作成に必要なインシデントのタイムラインを取得します。

MCP を使用する方法:

Tool: SN-Query-Table
Parameters:
  table_name: sys_journal_field
  query: element_id=[INC_SYS_ID]^elementINwork_notes,comments^ORDERBYsys_created_on
  fields: value,element,sys_created_on,sys_created_by
  limit: 50
ステップ 4:宛先グループを特定する

各種コミュニケーションの送信先を決定します。

MCP を使用する方法:

Tool: SN-Query-Table
Parameters:
  table_name: sys_user_group
  query: nameINExecutive Leadership,IT Management,Service Desk,Major Incident Management
  fields: sys_id,name,email,manager
  limit: 10

コミュニケーションマトリックス:

対象者初回通知更新解決通知PIR の概要
経営幹部はい(概要)2 時間ごとはいはい
IT 管理者はい(詳細)1 時間ごとはいはい
影響を受けるユーザーはい(簡潔)1 時間ごとはいいいえ
技術チームはい(詳細)30 分ごとはいはい
サービスデスクはい(案内事項)30 分ごとはいいいえ
外部顧客ケースバイケース2 時間ごとはい任意
ステップ 5:初回通知メールを作成する

重大インシデントの宣言時に送信する最初のコミュニケーションを作成します。

=== INITIAL NOTIFICATION EMAIL ===

Subject: [MAJOR INCIDENT] [INC Number] - [Service Name] Disruption

---

MAJOR INCIDENT NOTIFICATION

Incident: [INC Number]
Severity: Priority [1/2] - Major Incident
Declared: [date/time] [timezone]

IMPACT
[Service/System Name] is currently experiencing [outage/degradation/intermittent issues].

Affected Service: [business_service]
Impact Scope: [Approximate number of affected users/locations/regions]
Business Functions Affected: [List key affected functions]

CURRENT STATUS
Status: Investigating
Our [team/group] is actively investigating the root cause.

[If known]: Preliminary analysis indicates [brief technical indicator without
speculative root cause].

WORKAROUND
[If available]: Users can [workaround description] as a temporary measure.
[If unavailable]: No workaround is currently available.

NEXT STEPS
- Technical teams are engaged and actively troubleshooting
- A bridge call has been established for coordinated response
- Next status update will be provided by [time]

CONTACTS
Incident Commander: [Name] ([email/phone])
Service Desk: [contact info] for urgent assistance

---
Reference: [INC Number]
Classification: [Internal/Confidential]
ステップ 6:状況更新メールを作成する

インシデントの継続中に送信する定期的な更新を作成します。

=== STATUS UPDATE EMAIL ===

Subject: [UPDATE #X] [INC Number] - [Service Name] - [Status]

---

MAJOR INCIDENT STATUS UPDATE #[X]

Incident: [INC Number]
Status: [Investigating / Root Cause Identified / Fix in Progress / Monitoring]
Time: [date/time] [timezone]
Duration: [time since incident declared]

CURRENT SITUATION
[1-2 sentences describing current state of the incident]

PROGRESS SINCE LAST UPDATE ([previous update time])
- [Action taken 1 and result]
- [Action taken 2 and result]
- [Key finding or diagnosis update]

ROOT CAUSE
[If identified]: The issue has been identified as [brief, non-speculative description].
[If not identified]: Root cause investigation is ongoing. [What has been ruled out].

IMPACT UPDATE
Current Impact: [Current state of impact - improved/unchanged/worsened]
Affected Users: [Updated count if changed]
[If partial restoration]: [X]% of services have been restored.

PLANNED ACTIONS
- [Next action being taken]
- [Expected outcome and timeline]

ESTIMATED TIME TO RESOLUTION
[If estimable]: We estimate service will be restored by [time estimate with caveat].
[If not estimable]: ETR is currently under assessment. We will provide an estimate
in the next update.

WORKAROUND
[Updated workaround information if available]

NEXT UPDATE
Next status update: [time] or sooner if significant progress is made.

---
Reference: [INC Number]
Incident Commander: [Name]
ステップ 7:解決通知メールを作成する

サービスの復旧を確認するコミュニケーションを作成します。

=== RESOLUTION NOTIFICATION EMAIL ===

Subject: [RESOLVED] [INC Number] - [Service Name] Restored

---

MAJOR INCIDENT RESOLVED

Incident: [INC Number]
Status: RESOLVED
Service Restored: [date/time] [timezone]

SERVICE RESTORATION CONFIRMED
[Service/System Name] has been restored to normal operation.

RESOLUTION SUMMARY
Root Cause: [Clear, non-technical explanation of what caused the issue]
Resolution: [What was done to fix it]

INCIDENT TIMELINE
- [time] - Issue first reported / detected
- [time] - Major Incident declared
- [time] - Root cause identified
- [time] - Fix implemented
- [time] - Service restored and verified
Total Duration: [hours:minutes]

IMPACT SUMMARY
- Users Affected: [number]
- Services Affected: [list]
- Business Impact: [brief description]
- Duration of Impact: [duration]

WHAT WE ARE DOING TO PREVENT RECURRENCE
- [Immediate preventive action 1]
- [Immediate preventive action 2]
- A Post-Incident Review is scheduled for [date]
- Detailed findings and long-term improvements will be shared after the PIR

USER ACTION REQUIRED
[If action needed]: Please [specific user action, e.g., clear browser cache, restart VPN].
[If no action]: No user action is required. Services should function normally.

FEEDBACK
If you continue to experience issues, please contact the Service Desk at [contact info]
referencing [INC Number].

---
We apologize for any inconvenience this disruption may have caused.
Thank you for your patience during the resolution process.

Reference: [INC Number]
Incident Commander: [Name]
ステップ 8:インシデント後の概要メールを作成する

関係者向けの PIR 概要コミュニケーションを作成します。

=== POST-INCIDENT SUMMARY EMAIL ===

Subject: [PIR COMPLETE] [INC Number] - Post-Incident Review Summary

---

POST-INCIDENT REVIEW SUMMARY

Incident: [INC Number] - [Short Description]
PIR Completed: [date]
PIR Attendees: [list of key participants]

INCIDENT OVERVIEW
On [date], [Service Name] experienced [type of disruption] lasting [duration].
The incident affected approximately [number] users and impacted [business functions].

ROOT CAUSE ANALYSIS
The root cause was determined to be [detailed but accessible explanation].

Contributing factors:
- [Factor 1]
- [Factor 2]
- [Factor 3 if applicable]

WHAT WENT WELL
- [Positive aspect of response 1]
- [Positive aspect of response 2]
- [Positive aspect of response 3]

AREAS FOR IMPROVEMENT
- [Improvement area 1]
- [Improvement area 2]
- [Improvement area 3]

CORRECTIVE ACTIONS
| # | Action | Owner | Target Date | Status |
|---|--------|-------|-------------|--------|
| 1 | [Action description] | [Name] | [Date] | [Not Started/In Progress] |
| 2 | [Action description] | [Name] | [Date] | [Status] |
| 3 | [Action description] | [Name] | [Date] | [Status] |

METRICS
- Time to Detect: [duration from issue start to first alert]
- Time to Declare: [duration from detection to MI declaration]
- Time to Resolve: [duration from declaration to restoration]
- Total Elapsed: [end-to-end duration]
- Communications Sent: [count]
- Teams Engaged: [count]

QUESTIONS?
For questions about this review, please contact [change manager/incident manager].

---
Reference: [INC Number] | Problem: [PRB Number]
ステップ 9:送信したコミュニケーションを記録する

監査証跡として、すべてのコミュニケーションをインシデントの作業メモに記録します。

MCP を使用する方法:

Tool: SN-Add-Work-Notes
Parameters:
  sys_id: [INC_SYS_ID]
  work_notes: |
    === COMMUNICATION LOG ===
    Type: [Initial Notification / Status Update #X / Resolution / PIR Summary]
    Sent: [date/time]
    Recipients: [list or groups]
    Channel: Email
    Subject: [email subject line]
    Status: Sent successfully
ステップ 10:経営幹部向けのコミュニケーションを作成する

経営幹部向けに簡潔なバージョンを作成します。

=== EXECUTIVE BRIEF ===

Subject: [MAJOR INCIDENT] [INC Number] - Executive Brief

---

[Service Name] - [OUTAGE/DEGRADATION]
Declared: [time] | Duration: [elapsed]

IMPACT: [1 sentence impact description]
STATUS: [1 sentence current status]
ETR: [estimate or "Under assessment"]
ACTIONS: [1-2 key actions being taken]

Incident Commander: [Name] ([contact])
Next Update: [time]

---
[INC Number]

ツールの使用方法

ツール目的使用する場面
SN-Get-Recordインシデントの詳細を取得するあらゆるコミュニケーションの開始点
SN-Query-TableCI、タイムライン、グループを取得する範囲と背景情報の収集
SN-Update-Recordコミュニケーションのステータスでインシデントを更新するコミュニケーションの追跡
SN-Add-Work-Notes送信したコミュニケーションを記録する監査証跡
SN-Add-Comment顧客に表示される更新を投稿するユーザー向けのコミュニケーション

ベストプラクティス

  1. 重大インシデントの宣言から15分以内に初回通知を送信します
  2. 技術に詳しくない相手にも伝わるよう、明確で専門用語を避けた言葉を使います
  3. 追跡できるよう、件名には必ずインシデント番号を含めます
  4. 次回の更新予定を明示します。関係者が次の連絡時期を気にかけたままにならないようにします
  5. 不明な点については正直に伝えます。憶測よりも「調査中」とする方が適切です
  6. 社内向けと社外向けの連絡は分けます。社内向けでは、より技術的な説明が可能です
  7. ユーザーが自分で対処できるよう、利用可能な場合は回避策を記載します
  8. 一貫性のあるテンプレートを使います。関係者がすぐに形式を認識できるようにします
  9. PIR のため、すべての連絡内容をインシデントの作業メモに記録します
  10. 送信前に校正します。急いで送った誤りのある連絡は、信頼を損ないます

トラブルシューティング

問題原因解決策
宛先リストを利用できない配布グループが更新されていない事前に定義した重大インシデント連絡先リストを整備します
影響範囲が不明確CI 間の関係が CMDB にマッピングされていないビジネスサービスに基づいて推定し、不確実性があることを連絡に明記します
タイムラインに抜けがある作業メモが一貫して記録されていないシステム監査証跡とブリッジコールのメモから再構成します
矛盾する更新が送信された複数の担当者が連絡文を作成している連絡担当者を1人に定め、すべての草案を IC 経由にします
関係者への連絡が漏れた場当たり的な通知プロセス事前定義した通知グループとチェックリストを使います
メールを受信できないインシデントの影響でメールサービスが停止している代替チャネル(Teams、SMS、電話連絡網)を使います

例

例 1:クラウドサービスの停止

初回メール:

Subject: [MAJOR INCIDENT] INC0098765 - Cloud Platform Service Outage

IMPACT: Cloud Platform services are currently unavailable, affecting
all cloud-hosted applications including CRM, HRIS, and Document Management.
Approximately 3,000 users across all regions are impacted.

STATUS: Investigating - Cloud infrastructure team engaged.
Initial analysis points to a networking component failure in the
primary data center.

WORKAROUND: Users can access CRM via the mobile app (limited functionality).

NEXT UPDATE: By 10:30 AM EST or sooner.
例 2:決済処理の障害

ステータス更新:

Subject: [UPDATE #3] INC0098801 - Payment Processing - Fix in Progress

Root cause identified: Database connection pool exhaustion due to
a configuration change deployed at 2:00 AM.

PROGRESS: Database team is rolling back the configuration change.
Estimated 30 minutes to complete rollback and restart services.

IMPACT UPDATE: All payment processing remains offline.
Orders are being queued and will be processed once service is restored.
No data loss has occurred.

ETR: 11:45 AM EST

NEXT UPDATE: 11:30 AM EST
例 3:ネットワーク障害後の復旧

復旧メール:

Subject: [RESOLVED] INC0098812 - Corporate Network Restored

Corporate network services have been fully restored as of 3:45 PM EST.

ROOT CAUSE: A firmware bug in the core router caused a routing table
corruption during a scheduled update.

RESOLUTION: Firmware rolled back to previous stable version.
Vendor engaged for permanent fix.

DURATION: 2 hours 15 minutes (1:30 PM - 3:45 PM EST)
USERS AFFECTED: ~5,000 across headquarters and satellite offices

USER ACTION: If you experience continued connectivity issues,
please restart your VPN client. Contact Service Desk at x5555
if problems persist.

PIR scheduled for March 25, 2026.

関連スキル

  • itsm/major-incident - 重大インシデント管理の全プロセス
  • itsm/incident-lifecycle - 標準的なインシデント管理
  • development/notifications - 通知の自動化設定
  • admin/workflow-creation - 自動連絡ワークフロー

コメント