notification-hub

Files (1)

• SKILL.md

SKILL.md (first lines)

# notification-hub

**알림 통합** — 모든 스킬의 알림을 하나로 모아 우선순위별로 형님에게 효율적으로 전달합니다.

## 🎯 목적

각 스킬이 생성하는 다양한 알림을 중앙에서 관리하고, 중요도에 따라 적절한 타이밍과 채널로 전달하여 알림 피로도를 줄입니다.

## 📥 알림 소스

`events/` 디렉토리의 모든 이벤트 파일을 수집:

```
events/
  ├── health-2026-02-14.json         (health-monitor)
  ├── scrape-result-2026-02-14.json  (data-scraper)
  ├── dm-check-2026-02-14.json       (insta-post)
  ├── competitor-2026-02-14.json     (competitor-watch)
  └── workflow-2026-02-14.json       (skill-composer)
```

## 🚦 우선순위 필터

### 1. `urgent` — 즉시 Discord DM

**조건:**
- 보안 이슈 (비정상 로그인, 의심스러운 접근)
- 시스템 에러 (OpenClaw 다운, 브라우저 연결 끊김)
- 비용 초과 (API 사용량 90% 이상)
- 중요 멘션

**전송:**
- Discord DM (채널 ID는 `TOOLS.md`에 설정)
- 즉시 전송 (1분 이내)

**예시:**
```
🚨 긴급: 브라우저 연결 끊김
포트 18800 응답 없음. 자동 복구 시도했으나 실패.
수동 확인 필요: openclaw browser start
```

### 2. `important` — 다음 heartbeat에 포함

**조건:**
- 새로운 인스타 DM (읽지 않음)
- 트렌드 급상승 키워드 발견
- 경쟁사 신규 서비스 출시
- Git push 필요 (unpushed commits 10개 이상)

**전송:**
- 다음 heartbeat 응답에 포함 (~30분 간격)
- 여러 알림을 묶어서 한 번에 전송

**예시:**
```
📢 업데이트 3건

📩 인스타 DM 2건 (iam.dawn.kim, partner_xyz)
📈 트렌드: "AI 에이전트" 급상승 (+150%)
🔄 Git: 12개 커밋 push 대기중
```

### 3. `info` — daily-report에만 포함

**조건:**
- 정기 통계 업데이트
- 일일 토큰 사용량
- 완료된 워크플로우
- 일반 시스템 로그

**전송:**
- daily-report 스킬 실행 시 포함
- 하루 1회 요약 전송

**예시:**
```
📊 일일 리포트 (2026-02-14)

✅ 워크플로우 3건 완료
📊 토큰 사용: 45,230 / 100,000 (45%)
📝 메모리 사용: 3.2 GB
🔧 헬스 체크: 정상
```

## 🔕 중복 알림 방지

동일한 이벤트에 대해 2번 이상 알림을 보내지 않습니다.

### 중복 판정 기준

```json
{
  "event_id": "health-check-2026-02-14-07:00",
  "fingerprint": "sha256(source + type + key_data)",
  "notified_at": "2026-02-14T07:05:00+09:00"
}
```

### 히스토리 저장

```
memory/notifications/
  ├── sent-2026-02-14.json
  ├── sent-2026-02-13.json
  └── ...
```

**sent-YYYY-MM-DD.json 구조:**
```json
{
  "date": "2026-02-14",
  "notifications": [
    {
      "id": "health-check-2026-02-14-07:00",
      "priority": "info",
      "sent_at": "2026-02-14T07:05:00+09:00",
      "channel": "discord_dm",
      "source": "health-monitor"

From mupengi-bot/mupengism, MIT.

More from mupengi-bot/mupengism