mcpField
E
eng-runbook

eng-runbook

github.com/mphinanceドキュメント3284 回インストール3 日前に更新
リポジトリ

eng-runbook について

サービス概要とDESIGN.mdを基に、1ページのHTML形式のエンジニアリング運用手順書を作成するスキルです。サービス情報、アラート、ダッシュボード、手順、オンコール体制、インシデント対応を指定の構成でまとめます。

主な機能

  1. 01DESIGN.mdとサービス概要を読む
  2. 02サービスと依存関係を要約
  3. 03アラート表を作成
  4. 04ダッシュボードとリンクを列挙
  5. 05手順とオンコール情報を記載
  6. 06インシデント対応チェックリストを追加

活用シーン

  1. 01簡潔なサービス運用手順書の作成
  2. 02アラート対応と手順の文書化
  3. 03オンコール体制とインシデント対応の整理

インストール

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

$npx skills add https://github.com/mphinance/alpha-skills --skill eng-runbook

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

同梱ファイルexample.htmlREADME.md

詳細

エンジニアリング運用手順書スキル

1 ページのエンジニアリング運用手順書を作成します。

ワークフロー

  1. DESIGN.md を読みます。
  2. 概要説明からサービスを特定します。
  3. レイアウト：
    • ヘッダー：サービス名、担当チーム、重大度ティア、バージョン。
    • サービス概要の段落 + 依存関係のリスト。
    • アラートの表：アラート名 / 重大度 / 意味 / 初動対応。
    • ダッシュボードとリンクのリスト。
    • 一般的な手順のブロック（3〜4 件）。コードブロックを含めます（デプロイ、ロールバック、キーのローテーション）。
    • オンコールローテーションの表（週 / 主担当 / 副担当 / バックアップ）。
    • インシデント対応チェックリスト（番号付きの 5 ステップ）。
  4. インラインの <style> を 1 つ使用し、セマンティック HTML を使い、コードブロックには等幅フォントを指定します。

出力仕様

<artifact identifier="runbook-name" type="text/html" title="Service Runbook">
<!doctype html>...</artifact>

コメント

Markdown 対応