GitHub Actions Notification Integration Skill

GitHub Actions から Slack、Discord、MS Teams、Email 等への通知統合を提供するスキル。

ディレクトリ構造

notification-integration-gha/
├── SKILL.md                          # このファイル（コマンドリファレンス・概要）
├── resources/
│   ├── slack-integration.md          # Slack Webhook・Actions・フォーマット詳細
│   └── discord-teams.md              # Discord・MS Teams統合パターン
├── templates/
│   └── notification-workflow.yaml    # 通知ワークフロー実例集
└── scripts/
    └── test-webhook.mjs              # Webhook動作テストスクリプト

コマンドリファレンス

リソース参照（詳細知識）

# Slack統合詳細（Webhook URL、actions、メッセージフォーマット）
cat .claude/skills/notification-integration-gha/resources/slack-integration.md

# Discord・MS Teams統合パターン
cat .claude/skills/notification-integration-gha/resources/discord-teams.md

テンプレート活用

# 通知ワークフロー実例（Slack/Discord/Teams/Email）
cat .claude/skills/notification-integration-gha/templates/notification-workflow.yaml

スクリプト実行

# Webhook動作テスト（Slack/Discord）
node .claude/skills/notification-integration-gha/scripts/test-webhook.mjs <webhook-url> <message>

通知統合パターン

1. Slack 通知（公式 Action 使用）

- name: Slack Notification
  uses: slackapi/slack-github-action@v1.24.0
  with:
    channel-id: "C1234567890"
    slack-message: |
      *${{ github.workflow }}* - ${{ job.status }}
      Repository: ${{ github.repository }}
      Commit: ${{ github.sha }}
      Author: ${{ github.actor }}
  env:
    SLACK_BOT_TOKEN: ${{ secrets.SLACK_BOT_TOKEN }}

2. Discord 通知（Webhook）

- name: Discord Notification
  if: always()
  run: |
    curl -X POST "${{ secrets.DISCORD_WEBHOOK_URL }}" \
      -H "Content-Type: application/json" \
      -d '{
        "content": "**Workflow Status**: ${{ job.status }}",
        "embeds": [{
          "title": "${{ github.workflow }}",
          "description": "Repository: ${{ github.repository }}",
          "color": ${{ job.status == 'success' && 3066993 || 15158332 }}
        }]
      }'

3. MS Teams 通知（Webhook Connector）

- name: MS Teams Notification
  if: failure()
  run: |
    curl -X POST "${{ secrets.TEAMS_WEBHOOK_URL }}" \
      -H "Content-Type: application/json" \
      -d '{
        "@type": "MessageCard",
        "themeColor": "FF0000",
        "summary": "Workflow Failed",
        "sections": [{
          "activityTitle": "${{ github.workflow }} Failed",
          "facts": [
            {"name": "Repository", "value": "${{ github.repository }}"},
            {"name": "Branch", "value": "${{ github.ref }}"},
            {"name": "Commit", "value": "${{ github.sha }}"}
          ]
        }]
      }'

4. 条件付き通知（成功時・失敗時）

- name: Notify on Success
  if: success()
  uses: slackapi/slack-github-action@v1.24.0
  with:
    channel-id: "success-channel"
    slack-message: "✅ Deployment succeeded!"
  env:
    SLACK_BOT_TOKEN: ${{ secrets.SLACK_BOT_TOKEN }}

- name: Notify on Failure
  if: failure()
  uses: slackapi/slack-github-action@v1.24.0
  with:
    channel-id: "alert-channel"
    slack-message: "❌ Deployment failed! @here"
  env:
    SLACK_BOT_TOKEN: ${{ secrets.SLACK_BOT_TOKEN }}

通知設計のベストプラクティス

セキュリティ

• Webhook URL は Secrets 管理: ${{ secrets.WEBHOOK_URL }}
• トークンは暗号化保存: GitHub Secrets で管理
• 公開リポジトリでの露出防止: ハードコード禁止

メッセージ設計

• 視認性: 絵文字・色・フォーマットで状態を明示
• コンテキスト: リポジトリ名・ブランチ・コミット SHA・実行者情報
• アクション可能: ログ URL・PR URL・デプロイ URL をリンク

条件制御

• if: always(): 成功・失敗問わず通知
• if: failure(): 失敗時のみアラート
• if: success(): 成功時のみ通知

リトライとエラーハンドリング

• continue-on-error: true: 通知失敗でもワークフロー継続
• timeout-minutes: 長時間ハングアップ防止

関連スキル

通知統合と併用すると効果的なスキル:

使用上の注意

このスキルが提供すること

• Slack/Discord/Teams/Email 統合パターン
• Webhook 設定とメッセージフォーマット
• 条件付き通知（成功/失敗時）
• セキュリティベストプラクティス

このスキルが提供しないこと

• 通知サービス側のアカウント設定（Slack App 作成等）
• 複雑なメッセージテンプレート言語（Liquid/Handlebars 等）
• カスタムボット実装（Node.js/Python 等）

推奨される使用フロー

1. 通知チャネル決定: Slack/Discord/Teams/Email
2. Webhook URL 取得: 各サービスで設定
3. GitHub Secrets に保存: SLACK_WEBHOOK_URL等
4. テンプレート適用: templates/notification-workflow.yaml参照
5. メッセージカスタマイズ: プロジェクト固有情報追加
6. テスト実行: scripts/test-webhook.mjsで動作確認

詳細な統合手順とメッセージフォーマットは、resources ディレクトリ内のファイルを参照してください。