Communitygithub.com

SEV トリアージ

インシデントの重大度(SEV1〜4)を影響範囲、規模、緊急度のシグナルに基づいて分類し、誰にページを送るかを決定します。アラートが発報されたときや報告が入ったときに、重大度を迅速に判断する必要がある場合に使用します。

SEV トリアージ とは?

SEV トリアージはインシデントの重大度を迅速かつ正確に判定するためのスキルです。影響のシグナル(エラー率、データ損失リスク、支払いフローの障害など)に基づいてSEV1〜4を割り当て、原因調査より前に重大度を決定することを重視します。各重大度は具体的な定義に従い、SEV1(収益影響または全サービスの損失)からSEV4(軽微な問題)まで段階的に分類されます。このスキルは、シグナルチェックリスト、影響範囲の乗数(影響を受けるユーザー割合、拡大率、検出遅延)、ページング対象の明確な基準を提供します。適切なトリアージレコード(割り当てたSEV、根拠、影響範囲、ページング情報、再トリアージ時刻)を生成することで、インシデント対応の信頼性と効率を向上させます。ワークブックの例やDo/Don'tリストにより、実際の運用で誤った重大度評価やページングの遅延を防ぎます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SkillMedev/skills/tree/HEAD/skills/sev-triage

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

SEV トリアージ は何をしますか?

重大度はページングの判断であり、感情の指標ではありません。単一のシグナルが正当化する最高のSEVを割り当て、証拠がある場合のみダウングレードします。

重大度の定義

  • SEV1 - 収益に影響を与える、またはサービスの完全な喪失。重要なフローを5%超のユーザーが完了できない。データ損失または漏洩の可能性がある。即座にIC、エンジニアリングリーダー、エグゼクティブオンコールにページを送信。
  • SEV2 - 重大な劣化。中核機能が一部のユーザーで動作しない、SLO違反しきい値を超えるエラー率の上昇、または回避策が存在するが長期的に許容できない。5分以内にICとチームのオンコールにページを送信。
  • SEV3 - 部分的または軽微な劣化。重要でない機能が影響を受け、SLOは予算内、顧客からのエスカレーションなし。チケットを作成し、チームに非同期で通知し、次の営業日までに修正。
  • SEV4 - 外観またはエッジケース。ユーザーへの影響なし、プロアクティブに発見。チケットのみ。

シグナルチェックリスト

SEVを決定するために以下の質問に回答します。最初に「はい」となるものが優先されます。

  1. 支払い、認証、またはデータ整合性フローが任意のユーザーで壊れているか?→ SEV1候補。
  2. エラー率が過去10分間でSLOしきい値を超えているか?→ 最低でもSEV2。
  3. 複数のリージョンまたはアベイラビリティゾーンが影響を受けているか?→ 1レベル引き上げ。
  4. 能動的なデータ流出または破損のリスクがあるか?→ ユーザー数に関わらずSEV1。
  5. 単一の重要でないエンドポイントが遅いが、他の部分は正常か?→ SEV3。

影響範囲の乗数

  • 爆発半径: 影響を受けるユーザーの割合を推定する。1%未満は、その1%が有料顧客であるかデータリスクが深刻でない限り、SEV1になることは稀。
  • 成長率: 影響が拡大しているか?10分ごとに倍増するSEV3はSEV2。
  • 検出遅延: 問題が30分以上前に発生し未検出の場合、現在のシグナルが示すよりも爆発半径が大きいと想定する。

誰にページを送るか

  • SEV1: IC(インシデントコマンダー)、サービスオーナー、オンコールSRE、エンジニアリングリーダー。即座にウォールームを開設。
  • SEV2: ICとサービスオーナーオンコール。必要に応じて他のメンバーを招待。
  • SEV3: サービスのオンコールチームに非同期で通知。ウォールームなし。
  • SEV4: チケットのみ、ページなし。

実践例:判断を行う

悪い例: 「チェックアウトが一部のユーザーで壊れているようです。SEV3のように感じます - まず原因を調べて、深刻だったら誰かにページを送ります。」

良い例: 「チェックアウトのエラー率が過去15分間で12%(SLOしきい値:1%)。支払いフローが壊れている → シグナル1 → SEV1。IC、サービスオーナー、オンコールSREに14:32にページ送信。ウォールーム開設。爆発半径推定:チェックアウト試行の約12%、成長状況は不明。原因は不明 - SEVには無関係。15:00に再トリアージ予定。」

悪い例は順序を逆転し(原因を重大度より先に)、支払いフローの障害を曖昧にし、ページングを遅らせています。良い例はレベルを設定したシグナルを引用し、即座にページを送信し、爆発半径を記録し、再トリアージをスケジュールしています - すべて誰も原因を知る前に行っています。

成果物

インシデントチャンネルまたはチケットに投稿されるトリアージレコードを生成します。これには以下を含みます:割り当てたSEV、設定したチェックリストシグナルを挙げた1行の正当性、爆発半径の推定(ユーザーまたはリクエストの割合)、誰がいつページを受けたか、そしてスケジュールされた再トリアージ時刻。このレコードにより、次の対応者はレベルを再導出するのではなく信頼できます。

品質基準

  • SEVは、根本原因調査が始まる前に影響シグナルから割り当てられました。
  • 正当性は、直感ではなく特定のチェックリストシグナルを挙げています。
  • ページングは割り当て時に行われ、確認後ではありません - 潜在的なSEV1は1つのデータポイントでページを送信します。
  • 再トリアージ時刻が設定され(30分ごと)、レベルは証拠に従って上下に移動します。

すべきこと / すべきでないこと

  • すべき: 根本原因を調査する前にSEVを割り当てる。重大度は現在の影響に関するものであり、原因ではない。
  • すべき: 30分ごとに再トリアージする。解決されたSEV2はSEV4に、拡大するSEV3はSEV1になる可能性がある。
  • すべきでない: 人を起こさないために過小評価する。誤ったSEV1は、見逃したSEV1よりコストが低い。
  • すべきでない: 潜在的なSEV1に対して2つ目のデータポイントを待ってからページを送る。

Individual skills in this repo

This repo contains 19 individual skills — each has its own dedicated page.

SkillMedev/skills

Designs REST API surfaces - resource naming, HTTP method and status-code semantics, error shapes, pagination, and filtering - and delivers an endpoint spec a consumer can build against without asking questions. Use when someone asks "how should I name this endpoint", "what status code should this return", "should this be PUT or PATCH", "how do I paginate this list", or is reviewing an API before it ships to external consumers. Do NOT use for planning breaking-change rollouts and deprecation windows - use api-versioning-strategist instead; for GraphQL type and resolver design - use graphql-schema instead; for generating client SDKs from an existing spec - use api-client-generator instead; for designing inbound webhook endpoints - use webhook-receiver-hardener instead.

SkillMedev/skills

Produce an accurate, properly timed caption track (SRT or WebVTT) from a video's audio - transcribing or aligning to the voiceover script, timing cues to speech, and enforcing line-length and reading-speed rules so captions are readable and in sync. Use when someone says "generate captions", "make subtitles from the audio", "transcribe and caption this", "export an SRT or VTT", "the captions are out of sync", or "the subtitles flash by too fast to read". Do NOT use to burn-in, style, reframe, or position an existing caption track for a platform (9:16, brand styling, safe areas) - that is social-video-formatter; do NOT use to animate text word-by-word as a motion graphic - that is kinetic-typography; do NOT use to write the spoken script in the first place - that is narration-script.

SkillMedev/skills

Turns data and charts into a decision-driving narrative structured as headline finding, trend, implication, and recommended action - with finding-led chart titles, context for every number, annotation guidance, and honest flags on any conclusion the data cannot support. Use when someone says "turn these numbers into a story", "what's the takeaway from this data", "help me present these results to leadership", or has charts but no narrative. Do NOT use for compressing a long document into a one-pager - use executive-summary instead - or for running the analysis that produces the findings - use eda-playbook instead.

SkillMedev/skills

Use when a task needs live or historical money data - "convert USD to EUR", "current/past exchange rate", "FX rate on this date / over this range", or "current price of Bitcoin/Ethereum, market cap, 24h change". Frankfurter (ECB reference rates, no key) is the FX default; CoinGecko's free keyless tier covers crypto. Do NOT use for stock quotes or equities - no keyless stock API survives verification, say so instead of guessing; do NOT use for country economic indicators like GDP or inflation series - use government-open-data instead; if the request is a vague "I need live data", route through public-data-api-picker.

SkillMedev/skills

Builds a driver-based FP&A operating model linking business inputs to P&L, balance sheet, and cash flow outputs. Use when building an annual plan, preparing investor materials, running scenario analysis, or stress-testing the business.

SkillMedev/skills

Use when a task needs live geographic lookups - "geocode this address", "what's at these coordinates" (reverse geocoding), "lat/lon for this city", "which country/state is this ZIP or postal code in", or "country facts: capital, currency, population, flag". Nominatim (OpenStreetMap) is the geocoding default; Zippopotam for postal codes; APICountries for country facts. All keyless. Do NOT use for weather at a location - use weather-climate instead; do NOT use for country-level statistics over time (GDP, population trends) - use government-open-data instead; if the request is a vague "I need live data", route through public-data-api-picker.

SkillMedev/skills

Runs the full Getting Things Done loop - capture, clarify, organize, reflect, engage - building a trusted system of context lists, a projects list with defined next actions, and a weekly review habit. Use when someone says "I'm overwhelmed and things are slipping through the cracks", "set up GTD for me", "help me do a brain dump and organize it", or "my to-do list is a mess". Do NOT use for just running the weekly review ritual itself - use weekly-review instead - or for clearing an email backlog - use inbox-zero.

SkillMedev/skills

Processes any email backlog to zero using the 4Ds - Delete, Delegate, Defer, Do - with a mass-archive strategy for the obvious, a touch-each-email-once discipline, and a keep-it-clear system of batched processing windows, ruthless unsubscribing, filters, and a minimal folder setup. Use when someone says "I have 5,000 unread emails", "help me get to inbox zero", "email is eating my whole day", or treats their inbox as a to-do list. Do NOT use for drafting the reply emails themselves or prioritization rules for an ongoing support queue - use email-triage instead - or for protecting focus time around the email windows - use deep-work-planner instead.

SkillMedev/skills

Write landing-page copy section by section - hero, social proof, features-as-benefits, objections, CTA - leading with one promise and proving it down the page. Use when someone asks "write my landing page", "improve my hero headline", "what should the homepage say", "turn these features into benefits", or is shipping a new page for a launch or campaign. Do NOT use for testing and optimizing an existing page's conversion rate - use landing-page-cro instead; for the one-line claim itself use positioning-statement; for the full message ladder use messaging-hierarchy.

SkillMedev/skills

Improves an existing landing page's conversion rate through evidence-first CRO - audit heatmaps and recordings, write structured hypotheses, prioritize with ICE scoring, and run one-variable tests to statistical significance. Use when someone asks "why isn't my landing page converting", "audit this page before we scale spend", "which A/B test should we run first", or after a CVR drop or ahead of a paid-traffic push. Do NOT use for writing a new landing page from scratch - use landing-page-copy instead. Do NOT use for auditing the ad accounts sending the traffic - use paid-acquisition-audit instead. Do NOT use for reading the results of a finished experiment - use ab-test-analyzer instead.

SkillMedev/skills

Runs structured coaching sessions using values clarification and the GROW model, ending every session with one committed action, a deadline, and an if-then plan for the likely obstacle. Use when someone says "I feel stuck in my life", "help me figure out what I want", "hold me accountable to my goals", or "coach me through this decision". Do NOT use for building a stress toolkit - use stress-management instead - or a journaling practice - use journal-framework; for a standing goal-tracking system, use goals-accountability. Coaching, not therapy: signs of clinical distress route to a licensed professional.

SkillMedev/skills

Adapts English content for a target language and region - swapping idioms, setting the right formality register, replacing cultural references, converting dates, units, and currency - and delivers the localized text with a notes column explaining each adaptation and flagging what needs a native reviewer. Use when someone asks "localize this copy for the Japanese market", "adapt our marketing copy for the Mexican market", "make this translation sound native instead of literal", or a literal translation reads foreign, stiff, or risky. Do NOT use for auditing in-product UI text quality - use ux-writing-audit instead.

SkillMedev/skills

Turns a natural-language video brief into a complete, ready-to-preview Remotion composition - extracts duration, scenes, brand colors, aspect ratio, and real copy; plans the frame budget; and writes data-driven React/TypeScript using useCurrentFrame, interpolate, spring, AbsoluteFill, and Sequence, registered in Root.tsx. Use when someone says "build a 20-second product demo video", "animate a feature walkthrough", "write the Remotion code for this marketing clip", or wants a scene-by-scene composition they can scrub in Studio. Do NOT use for rendering, iterating, or batching the finished MP4 - use remotion-render instead - or for installing and scaffolding the project - use remotion-setup instead.

SkillMedev/skills

Scaffolds a new Remotion video project wired for Claude Code Agent Skills - Node check, create-video scaffold, skills install, folder conventions, Google Fonts, and a smoke-test render. Use whenever someone wants to start making videos with Remotion and Claude, even just "make product videos with Claude.

SkillMedev/skills

Use the Skill Me catalog from inside any conversation - discover, install, and manage Claude skills through the Skill Me MCP, and load installed skills automatically each session.

SkillMedev/skills

Write one platform-native caption from a topic and brand voice, with a front-loaded hook, native length, and a single earned CTA. Use when the user gives a topic (and optionally brand voice or a described image/video) and asks for an Instagram, LinkedIn, X/Twitter, or TikTok caption. Do NOT use when the user wants a dedicated standalone LinkedIn post - use linkedin-post-writer instead; or a multi-post X thread - use tweet-thread-builder instead; or to adapt one existing piece of content into versions for several channels - use cross-platform-reformatter instead.

SkillMedev/skills

Reframe and export a finished video for social platforms - 9:16 ↔ 16:9 cropping, burned-in captions, a platform-native first frame, loop design, and per-platform specs (aspect, length, safe areas) for TikTok, Reels, Shorts, X, and LinkedIn. Use when someone says "make this vertical", "crop to 9:16", "format for TikTok/Reels/Shorts", "add captions/subtitles", "why is my video cut off on mobile", "resize for Instagram", or "export for social". Do NOT use when the question is about the storyboard or shot order before any video exists (use video-storyboard); the animation craft of how elements move (use motion-design-principles); animated word-by-word caption styling (use kinetic-typography); palette, contrast, or lighting (use motion-color-and-light); directing the product-demo content and screen choreography (use product-demo-director); or scoring, beat-syncing, or audio (use sound-and-music-sync) - this is the craft layer that decides WHAT to format for the feed, then hands a concrete spec to remotion-compo...

SkillMedev/skills

Writes and tunes PySpark jobs - join strategy and broadcast size limits, shuffle-partition sizing, skew diagnosis and salting, UDF avoidance, caching, and output file layout - with concrete size and skew thresholds. Use when someone asks "why is my Spark job slow", "should I broadcast this join", "one task takes forever while the rest finish", "my job OOMs during a join", or is writing a new PySpark ETL job. Do NOT use for Kafka topic, consumer-group, or streaming-pipeline design - use kafka-pipelines instead; do NOT use for single-machine dataframe work that fits in memory - use pandas-expert instead.

SkillMedev/skills

Builds clean, performant, accessible SwiftUI views with correct state ownership, scoped invalidation, and smooth list scrolling, and reviews existing SwiftUI code against a concrete frame-time and re-render budget. Use when someone asks "why does my SwiftUI list stutter", "should this be @State or @Observable", "my whole screen re-renders when one row changes", "how do I animate this transition", or wants a SwiftUI view built or refactored. Do NOT use for cross-platform React Native apps - use react-native-pro instead; do NOT use for Flutter widget trees - use flutter-widget-architect instead; do NOT use for Android Compose UIs - use jetpack-compose-builder instead.

関連スキル