🔔 GitHub 알림 액션 허브

GitHub 이벤트에 대한 알림을 다양한 플랫폼으로 전송하는 GitHub Actions 모음입니다.

🌟 주요 기능

• 다중 플랫폼 지원: Slack, Discord, Telegram
• 다양한 GitHub 이벤트 알림:
  • 🐞 이슈 생성/수정
  • 🔄 PR 생성/업데이트
  • 🚀 릴리스 배포
  • 💬 커밋 댓글
  • ⬆️ 코드 푸시
  • ❌ 워크플로우 실패
  • 🗑️ 브랜치 삭제

🧱 기술 표준

• 모든 액션은 runs.using: node20 기준으로 동작합니다.
• action.yml의 실행 엔트리는 dist/index.js로 통일되어 있습니다.
• 배포 시 ncc로 번들된 dist/ 산출물을 함께 커밋하는 방식을 사용합니다.
• PR/메인 브랜치 푸시 시 .github/workflows/metadata-consistency.yml에서 메타데이터 정합성과 워크플로 구문(actionlint)을 자동 검증합니다.

로컬에서도 아래 명령으로 동일 검증을 실행할 수 있습니다.

bash scripts/validate-actions-metadata.sh

🔧 설정 방법

Slack 웹훅 설정

1. Slack API에서 앱 생성
2. "Incoming Webhooks" 활성화
3. 웹훅 URL을 GitHub Secrets에 추가 (SLACK_WEBHOOK_URL)

Discord 웹훅 설정

1. Discord 서버 설정 → 통합 → 웹훅
2. 새 웹훅 생성 및 URL 복사
3. GitHub Secrets에 추가 (DISCORD_WEBHOOK_URL)

Telegram 봇 설정

1. @BotFather에서 봇 생성
2. 봇 토큰을 GitHub Secrets에 추가 (TELEGRAM_BOT_TOKEN)
3. 채팅 ID 확인 후 GitHub Secrets에 추가 (TELEGRAM_CHAT_ID)

📜 라이선스

이 프로젝트는 MIT 라이선스를 따릅니다.