القائمة
shiguredo/github-actions リポジトリの Slack Notify Composite Action の開発・修正・レビュー。入力パラメータ、notify_mode、Fixed 通知、色判定、フィールド制御、ペイロード構築、テストワークフローに関する質問で使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | github-actions-slack-notify |
| description | shiguredo/github-actions リポジトリの Slack Notify Composite Action の開発・修正・レビュー。入力パラメータ、notify_mode、Fixed 通知、色判定、フィールド制御、ペイロード構築、テストワークフローに関する質問で使用。 |
shiguredo/github-actions リポジトリで提供される Slack 通知用 Composite Action。
.github/actions/slack-notify/action.yml.github/workflows/test-slack-notify.ymlslack-notify:
needs: ci
if: always()
runs-on: ubuntu-slim
timeout-minutes: 5
permissions:
actions: read
steps:
- uses: shiguredo/github-actions/.github/actions/slack-notify@main
with:
status: ${{ job.status }}
slack_webhook: ${{ secrets.SLACK_WEBHOOK }}
slack_channel: ruri
notify_mode: failure_and_fixed
env:
GH_TOKEN: ${{ github.token }}
プライベートリポジトリの場合はコミットメッセージ取得のために contents: read 権限を追加する:
permissions:
actions: read
contents: read
| 名前 | 必須 | デフォルト | 説明 |
|---|---|---|---|
status | 必須 | - | ジョブステータス (job.status を渡す。別ジョブの失敗・キャンセルは自動検出) |
slack_webhook | 必須 | - | Slack Incoming Webhook URL |
slack_channel | 必須 | - | Slack チャネル名 (# なし) |
slack_title | - | '' | メッセージタイトル (空なら自動生成: コミットメッセージ) |
slack_message | - | '' | メッセージ本文 |
slack_color | - | '' | 色の手動指定 (指定時は自動判定を上書き) |
slack_username | - | GitHub Actions | ボット名 |
slack_icon_emoji_success | - | :large_green_circle: | Success 時のボットアバター |
slack_icon_emoji_failure | - | :red_circle: | Failure 時のボットアバター |
slack_icon_emoji_fixed | - | :large_blue_circle: | Fixed 時のボットアバター |
slack_footer | - | Powered by shiguredo/github-actions | フッター |
msg_minimal | - | '' | true で最小表示、カンマ区切りで個別指定 (repository,workflow,ref,event,commit) |
notify_mode | - | failure_and_fixed | 通知モード |
| モード | 動作 |
|---|---|
all | 全ステータスで通知 |
failure_and_fixed | failure と fixed のみ |
failure_only | failure のみ |
success_only | success のみ |
スキップ時はログにステータスや前回結論を出力する:
failure_only: 通知をスキップ (ステータス=success)failure_and_fixed: 通知をスキップ (ステータス=success, 前回結論=success, fixed=false)success_only: 通知をスキップ (ステータス=failure)gh api で同一ワークフロー実行内の他ジョブの結果を確認)gh run list で前回のワークフロー実行結果を取得 (Fixed 判定用)notify_mode に基づく送信スキップ判定 (スキップ時はステータス・前回結論・fixed 判定結果をログ出力)msg_minimal に応じたフィールド配列構築jq -n で安全に JSON ペイロード生成curl で Slack Webhook に POSTicon_emoji はカスタム絵文字に非対応。標準 Slack 絵文字のみ使用可能gh run list --workflow --branch --status completed --limit 10 で前回結果を取得 (現在の実行を databaseId で除外)PREV_CONCLUSION) の値: 具体値 (success, failure 等) / none (初回実行) / unknown (API 失敗)#2196F3 (青)Fixedactions: read 権限が必要 (gh run list のため)concurrency の設定を推奨skipped 状態にはできない (GitHub Actions の仕様上、ジョブのスキップ判定はジョブ実行前の if: でのみ行われる)exit 0 してもジョブは success として完了するため、ワークフロー全体が緑に見えて実態と乖離するif: に needs.*.result != 'skipped' を列挙するstatus 入力をそのまま使用)| 条件 | 色 |
|---|---|
slack_color 指定済み | 指定値 |
| success + 前回 failure (Fixed) | #2196F3 |
| success | good |
| failure | danger |
| その他 | #808080 |
true: Status のみref,commit): 指定フィールド + Statustest-slack-notify.yml は workflow_dispatch で手動実行する。
入力:
force_failure (boolean): 意図的にジョブを失敗させるnotify_mode (choice): failure_and_fixed / all / failure_only / success_onlyslack_channel (string): 通知先チャネル (# なし)必要な権限: actions: read
runs-on: ubuntu-slim
notify_mode を追加 (all / failure_and_fixed / failure_only / success_only)with で入力を渡すjq で安全に JSON を構築 (rtCamp は Go / シェル文字列連結)actions/checkout 不要 (コミットメッセージは GitHub API で取得)env: で INPUT_* にマッピング)actions: read 権限が必要 (gh run list による Fixed 判定のため)contents: read 権限はプライベートリポジトリでのみ必要 (コミットメッセージ取得の gh api /repos/{owner}/{repo}/commits/{sha} のため)
contents: read なしでも動作するcontents: read がないと 403 エラーになりコミットメッセージが取得できないset -euo pipefail で厳密なエラーハンドリングjq -n による安全な JSON 生成 (シェルインジェクション防止)::warning:: で通知